Metrics

👍

Metrics V2

This page documents V2 of the Metrics Service. If you used Metrics V1 in the past, you will notice that the API is more explicit than in V1.

In case you have existing scripts or processes based on Metrics V1, we've got you covered - all Metrics V1 URLs will keep working and behave just as before.

Overview

With LeanIX Metrics, you can store time series data in LeanIX and create interactive charts to display the data. In addition the data can be linked to Fact Sheets, presented on the Dashboard or be displayed within the "Reports" area.

🚧

Note

Metrics are not standard reports but a way to create charts and visuals from your data.

To navigate to metrics, in the administration area, go to the Metrics section.

Creating a Chart

Once you've imported data points through the API, the measurement appears in your workspace. Now you can create a chart and define other parameters.

To create a chart, follow these steps:

1. On the Metrics page, on the measurement for which you want to create a chart, click the plus icon. You land on the page for creating a chart.

2. On the Chart tab, specify general chart parameters.

3. To add a data series to a chart, navigate to the Series tab and specify the required parameters. The field name corresponds to the key fields in the measure JSON object. You can add multiple series to a chart.

   

4. To preview data on the chart, click Preview.

5. Click Save.

The chart is saved. You can view, clone, or delete charts.

Developer Resources

Definitions

Importing a Metric

To import your first metric, go to the OpenAPI Explorer. To navigate to the OpenAPI Explorer from your workspace, on the user profile, select About LeanIX, and then select Browse API.

You need to generate an API Token by using the Technical User functionality and enter it on the top right to execute queries directly from the API documentation.

You can explore the full list of endpoints and associated operations in the OpenAPI Explorer.

📘

Change to Metrics V1

Schemas are what was called Measurements in Metrics V1. In contrast to V1, schemas are not created or altered implicity by writing points. Instead, a schema has to be created explicitly via the schemas API.

Use this code snippet as body to POST /schemas to create a new schema named "My First Metric":

{
  "name": "My First Metric",
  "description": "This is a test metric for LeanIX EAM docs",
  "attributes": [
    {
      "name": "Availability",
      "type": "metric"
    },
    {
      "name": "factSheetID",
      "type": "dimension"
    }
  ]
}

This call will return the UUID of the newly created schema. Then write a point to this schema by sending a POST request to /schemas/<schema_uuid>/points with the following body:

{
  "timestamp": 1621608440,
  "Availability": 100,
  "factSheetID": "<your Fact Sheet ID>"
}

You need to adapt to your context. Now, go to Admin -> Metrics, and you should see the first measurement.

Using Python to Import Metrics

We provide a Python script that enables you to import metrics. See Import Metrics in our GitHub repository.

API Documentation

For more details on the Metrics API and supported functionalities, have a look at the
OpenAPI docs. There, all endpoints are explained with examples and descriptions.

Using the Integration API

The Integration API provides the ability to import and export data using a generic LeanIX Data Interchange Format (LDIF). LDIF is a JSON format with a very simple structure described in the following sections. All mapping and processing of the incoming and outgoing data is done using "Data Processors" that are configured behind the API. Configuration of the processors can be done using the UI, please see the Setup page for more information. The configurations can be managed using the Integration API as well.

Please see the Integration API documentation for Metrics Example.

Steps to Create Integration