On this page:


Related pages:

 

If you want to execute an analytics search repeatedly to monitor its value, you can create a metric from the search. The search will execute once per minute and report the results as a metric. You can create alerts on the metric in the usual way using Health Rules to trigger Policies and Actions. The analytics metric list is searchable.

You can create metrics for all Analytics event types - Browser, Mobile, Transaction, Log and Custom.

Although the metrics calculated by scheduled queries may have decimal point precision, we only save and report whole numbers.

 

You can create a metric from an analytics search for the functions shown in the following table. For a discussion of metric rollup types see Metric Data Resolution over Time.

FunctionMetric Rollup TypeExample
count(* | field_name)sumSELECT count( activeMacUsers) FROM dummyTransactions

distinctcount(field_name)

averageSELECT distinctcount(activeMacUsers) FROM dummyTransactions

sum(numeric_field_name)

sumSELECT sum(responseTime)where userExperience = "NORMAL" FROM transactions

avg(numeric_field_name)

average

SELECT avg(responseTime) FROM transactions
min(numeric_field_name)

average

SELECT min(responseTime) FROM transactions

max(numeric_field_name)

average

SELECT max(responseTime) FROM transactions
(exp1)/(exp2)average

SELECT (count(activeMacUsers)) / (avg(activeWindowsUsers)) FROM dummyTransactions
SELECT (avg(responseTime)*2)/((avg(segments.transactionTime)+3)/2) FROM transactions
SELECT (sum(responseTime)*2)/(filter(sum(responseTime), where userExperience = "NORMAL") + 0.5) FROM transactions

Each side of the expression must be enclosed in parenthesis.

Permissions

To create metrics from analytics searches, you need the following permissions:

For more information, see:

Creating an Analytics Metric

  1. Working in the Analytics > Search editor, set the search criteria to select the appropriate data.
  2. Click Actions > Create Metric in the search action toolbar.
  3. In the popup window, give your metric a name and a description.
    The name determines how the metric appears in the Metrics screen and the Metric Browser. Keep in mind:

 

Metrics created from aggregations on eventTimestamp do not work as expected.

 

Monitoring Analytics Metrics

For performance reasons, the scheduled queries used in analytics metrics can be disabled as follows:

To monitor the metric:
  1. Click Metrics in the left navigation bar. 
    The Metrics list appears. 
  2. Search, edit, enable, disable, or delete metrics from here. 
    You can edit only the description of the selected metric.

    To enable or disable metrics in a batch, select the corresponding rows in the grid and click the Enable or Disable button in the toolbar. Use Shift+ click or Command + click rows to select multiple rows.

    If you see a status that says "Disabled due to repetitive failures", you can re-enable it by clicking Enable.
  3. To see the metric in the Metric Browser, click the Metric Browser. For more details, see the section "Metric Data Point Details" in Metric Browser.