Case Statistics Manager

The Case Statistics Manager is the agent that collects system usage and billing information for Relativity. This agent must be enabled to keep your Relativity access enabled.

This page contains the following information:

See these related pages:

Billing data settings

If your company does not need us to include user, case, matter, or client names on your Relativity invoices for your own billing or record-keeping purposes, you can use Relativity instance settings to obfuscate them. Common reasons for not obfuscating include billing users and/or workspaces to your customers and ease of managing your user base. We recommend that you consult with your finance/billing department and those who manage your Relativity user base before making changes to the default values.

The instance settings are as follows:

You can also use the AgentOffHourStartTime and AgentOffHourEndTime to change the off-hours for running the Case Statistics Manager agent.

If the billing report queries consistently fail and there are SQL timeout errors in the log, you can use the LongRunningCaseStatisticsQueryTimeout instance setting to increase the timeout value.

Troubleshooting Case Statistics Manager

Case Statistics Manager failure scenarios include:

  • The Case Statistics Manager agent fails to start.
  • Individual SQL methods in the agent timeout resulting in the total failure of the agent.
  • The Case Statistics Manager attempts a retry on workspaces that initially failed while still in off-hours and workspace(s) fail again.


If Case Statistics Manager fails on a workspace, it moves on to the next workspace. If the agent is still running in off-hours, it retries the workspace(s) that failed. If the workspace(s) still fail, the CSV file is not generated and the billing file is not be produced.

Case Statistics Manager agent alerts

If Case Statistics Manager fails to complete a report for any of the workspaces in your environment, an alert appears in the Alerts section. The alert lists the failed workspaces and the date the agent failed.

Note: Case Statistic manager alerts are visible only to admin users.

If workspace count is less than or equal to five (5):

The Case Statistics Manager agent failed for workspaces XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX on 10/31/2016.

If workspace count is greater than five:

The Case Statistics Manager agent failed for 17 workspaces on 10/31/2016.

The Case Statistics Manager agent is not disabled upon failure. The alert will be reset once the agent runs again. Detailed information on Case Statistics Manager errors can be found on the Errors tab. For more information, see Errors. You can find even more granular information in the Relativity logs. For more information, see Logging.

Restricted Relativity access

If the Case Statistics Manager billing data is not sent for seven days, Relativity access becomes restricted. Once access has been restricted, only system admins are able to access the system. Other users are locked out. This limited access allows administrators to log in to Relativity and address the problem, for example, by re-enabling the agent.

Once the billing data is sent, access returns to normal.

If the Case Statistics Manager fails to generate and send data for all workspaces during the off-hour run, admin users are notified.

Note: To set or update your billing contact, contact Support.