---
sourceDocument: Xanadu ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/servicenow-platform

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Exploring MetricBase

# Exploring MetricBase {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Collect, retain, analyze, and act on time-series data using MetricBase.

## MetricBase overview {#exploring-metricbase__section_yjq_xdz_kwb}

MetricBase helps you work with large amounts of data by using a smaller summary of that data that is stored in the MetricBase database.

* Integrate MetricBase seamlessly with ServiceNow IoT-based applications that monitor or act on large amounts of machine-generated data.
* Trigger flows in Workflow Studio based on time-series data in MetricBase.
  * Generate an email if the average CPU usage is more than 85% in the last 5 minutes.
  * Generate an email if MetricBase detects a gap in data submitted for 10 minutes or more.
  * Generate an alert if the average of the collected data is less than 10 or greater than 500 in the last 5 minutes.
  * Generate an alert if memory usage is likely to exceed 90% in the next 10 minutes.
  {#exploring-metricbase__ul_ikz_sgf_lwb}
* Visualize MetricBase data using time-series charts.
* Use the Reporting application to graph the time-series data that is stored in MetricBase.
* Detect anomalies by training a machine language model and execute a Workflow Studio trigger when an anomaly is detected.

{#exploring-metricbase__ul_xpc_wzt_kgb}  
MetricBase works with:

* An instance that stores machine-generated data
* A server that has the MetricBase application and database
{#exploring-metricbase__ul_b2y_mqz_kwb}

## MetricBase users {#exploring-metricbase__cf-exploring-parent-users}

{#exploring-metricbase__table_djn_f1n_5bc__entry__2}

| User | Description |
|-|-|
| Administrator | An administrator collects, retains, analyzes, and acts on time-series data using MetricBase. |
[Table 1. Users]

{#exploring-metricbase__table_djn_f1n_5bc}

## MetricBase workflow {#exploring-metricbase__cf-exploring-parent-workflow}

The following figure shows that machine-generated data is sampled every 4 seconds. You send the average of the values in each sampling period to the MetricBase database, which stores the data until its expiration date.
Figure 1. Storing time series data  
1. The administrator specifies a metric to store and how often to collect it by creating a time-series definition in MetricBase.
2. The administrator sends data from the instance to the MetricBase server using the MetricBase REST or JavaScript APIs.
3. The administrator configures trigger definitions that execute flows based on time-series data in MetricBase.
4. The administrator configures and trains predictive models in MetricBase to detect anomalies and execute flows when new data is significantly different than the trained data.
5. The administrator monitors collected data using time-series charts in MetricBase. Time-series data remains in the MetricBase database for a prescribed amount of time, after which MetricBase deletes the data.
{#exploring-metricbase__cf-exploring-parent-workflow-ol}

## MetricBase benefits {#exploring-metricbase__cf-exploring-parent-benefits}

{#exploring-metricbase__table_gjn_f1n_5bc__entry__3}

| Benefit | Feature | Users |
|-|-|-|
| Store time series summary of a large collection of data | [Create a time-series definition in MetricBase](https://www.servicenow.com/docs/BDwUdEn6NvW9PSYx4sh2Pg "Specify the metric that you want to store, how often to collect it, and how long to store it in MetricBase.") | Administrator |
| Insert and retrieve time-series data from the MetricBase database | [Developer resources](https://www.servicenow.com/docs/baVdemveuACJKBKkuZvy6Q "Developers can use JavaScript or REST APIs to insert and retrieve time-series data from the MetricBase database and to run transforms on the data. The transformations enable you to visualize time-series data in a variety of ways.") | Administrator |
| Access and visualize time-series data in the MetricBase database | [Accessing MetricBase data](https://www.servicenow.com/docs/MfEP6C3SZzXu1EjCMffGGA "Access the time-series data that you sent to the MetricBase database in the way that is convenient to you.") | Administrator |
| Trigger flows when new data is significantly different than the trained data | [Detecting anomalies in MetricBase data using predictive models](https://www.servicenow.com/docs/8IqBMLaH5B3eJtIY43qyVw "MetricBase creates a model by training a representative sample of your time series data to determine the model parameters. The training process determines the model parameters that best fit your data, to distinguish normal data from anomalous data.") | Administrator |
| Trigger flows that can log incidents, send emails, and create other alerts | [Triggering flows using MetricBase data](https://www.servicenow.com/docs/oJrEMgAnEPm3dxFQvvESgQ "Time-series data that is stored in the MetricBase database can trigger Workflow Studio flows. These triggers can log incidents, send emails, and create other alerts.") | Administrator |
[Table 2. MetricBase benefits]

{#exploring-metricbase__table_gjn_f1n_5bc}

## What to explore next {#exploring-metricbase__cf-exploring-parent-links}

To learn more about configuring and using MetricBase, see:

* [Configuring MetricBase](https://www.servicenow.com/docs/RkE5CgNU2OQaymHOxR0p0A "Plan and configure your MetricBase implementation.")
* [Defining and collecting MetricBase data](https://www.servicenow.com/docs/1phb4uW~KmJ7fpQ78Cpqgg "Store time-series summaries of much larger data collections.")
* [Triggering flows using MetricBase data](https://www.servicenow.com/docs/oJrEMgAnEPm3dxFQvvESgQ "Time-series data that is stored in the MetricBase database can trigger Workflow Studio flows. These triggers can log incidents, send emails, and create other alerts.")
* [Managing MetricBase](https://www.servicenow.com/docs/gWF7drTKwfF1irBatRsGcQ#maintain-metricbase "View the overall health and performance of MetricBase, and debug its triggers and scripts.")
* [MetricBase reference](https://www.servicenow.com/docs/9st7Jo~5q80kZlDl93geHQ "These reference topics provide additional information about MetricBase developer resources and domain separation.")
{#exploring-metricbase__ul_hjn_f1n_5bc}