LeanIX - Product Documentation

Welcome to the LeanIX Product Documentation. Here you will find all the basic information you need to start working with LeanIX. We provide you with well-structured information on how to get more out of LeanIX, best-practices and use-case specific guidelines. Feel free to spread this product documentation in your company and use it as a common information source to answer your colleagues’ most urgent questions.

Get Started

Getting Started with Metrics

LeanIX Metrics can consume data from an arbitrary source via an open API and link that to a Fact Sheet type.

Overview of Functionality

In modern IT organizations, a wide range of expert tools generate high amounts of data. The big challenge is to leverage this data. According to Gartner, 90% of the information assets from big data analytics efforts through 2017 will be siloed and inaccessible. LeanIX Metrics allows to display time series data in the context of Fact Sheets and thereby establish a useful business context.

With 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.

Definitions

Key

Definition

Measurement

Measurements contain data-points stored over time, which are related to the same topic. Each data-point is stored for a specific moment and has one or more values for that instant of time. The values are stored in fields.

Fields

Each data-point stores has one or more fields, which contain values that have been collected for the instant of time associated with the data-point. When creating a chart the values of the fields can be displayed as a series. For that different aggregation functions are available such as COUNT or SUM.

Tags

Furthermore a data-point has tags consisting of a key and a value.

The tags further describe that data-point and enables to filter for certain data-point when displaying a chart for different context.

Steps to Create Integration

Steps

Notes

Review Swagger API documentation

https://dev.leanix.net/docs/available-apis#section-metrics-api-real-time-data

Measurements should contain the uploaded data, split into Points

Each Point has a unique time stamp

Charts describe how to represent the Measurement graphically

For example as a Bar Chart

Charts contain Rules which define how the measurement data is mapped to your Fact Sheets (one option is to map using the External ID)

Create Chart

Navigate over to the Administration area, by selecting the person icon available in the upper right hand corner. Then select Metrics from the left hand panel.

Once you have imported the measurements into your workspace. You can create a chart and define other specifics.

To do so select the plus icon next to the measurement that you would like to graphically represent.

Associate a chart to a measurement.Associate a chart to a measurement.

Associate a chart to a measurement.

Give the chart a name, define the Y axis and time span.Give the chart a name, define the Y axis and time span.

Give the chart a name, define the Y axis and time span.

Associate series information, by using the drop downs. The field name directly corresponds to the key fields in the measure JSON. Define the color for this particular field and the Type of chart, the options are bar, line and area, as well as other information.

Associate Series informationAssociate Series information

Associate Series information

Use the Add button to continue adding Series information to your chart.

Use Cases

Quantify the Engagement of Users with your Applications

You can objectify the functional fit of your applications by pulling in metrics on a variety of data points.

Some examples of the possible options are below:

Quantify Engagment of Users with your Applications

User By Country

Events/User Logins

User Logins

Provide Technical and Operational Details to the Relevant Stakeholders

Number of Incidents by Criticality

Availability

Response Time

Developer Resources

To import your first metric, go to https://<base_url>/services/metrics/v1/docs/#/points. You also need to create an API Token and enter it on the top right to execute queries directly from the API documentation. Please see Available APIs for more information.

The endpoint URL depends on the instance you are using. We use the variable base_url, which has one of the following values:

https://eu-svc.leanix.net - If you are using the default instance of LeanIX
https://us-svc.leanix.net - If you are using the US instance of LeanIX
https://au-svc.leanix.net - If you are using the Australian instance of LeanIX
https://.leanix.net - If you have a dedicated instance of LeanIX

In the documentation, enter the following JSON and select "try it out".

{
    "measurement": "My First Metric",
    "workspaceId": "<your workspace ID>",
    "time": "2018-02-14T07:15:00.544Z",
    "tags": [
        {
            "k": "factSheetID",
            "v": "<your fact sheet ID>"
        }
    ],
    "fields": [
        {
            "k": "Availability",
            "v": "99"
        },
        {
            "k": "ResponseTime",
            "v": "123"
        },
        {
            "k": "NumberOfUsers",
            "v": "12"
        }
    ]
}

You need to adapt and to your context. Now, go to Administration then Metrics, and you should see the first measurement.

Export Data from Metrics

Similarly, we provide an endpoint to export data from Metrics via API: https://eu.leanix.net/openapi-explorer/#/measurements/getMeasurements. You would need to provide a query, e.g. to get all available data for a certain fact sheet ID:

{
    "q": "\"factSheetID\"='<your fact sheet id>'",
    "workspaceId": "<your workspace ID>"
}

Import a Point to the Metrics API

The table below directly corresponds to the screenshot of the measurement "Application KPIs".

Metrics/measurement JSON Structure

Key

Notes

More Information/Examples

measurement

Can be an arbitrary key to describe your measurement

workspaceId

Can be extracted from LeanIX

Access the Administration area, then select API Tokens

time

Refers to the unique timestamp of the uploaded point

tags

Refers to the tag that is being used to map the data to the Fact Sheets

Examples are fact sheet ID, fact sheet name, external ID, and factsheet type. This is linked within "Rules" area of the chart set-up

fields

A point can have multiple fields, all represented as key value pairs

Application KPIs' ExampleApplication KPIs' Example

Application KPIs' Example

Utilize 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 a Metrics Example.

Available Python Script

In the public script repository there is a script available in Python that can quickly get you started.

Updated 26 days ago

Getting Started with Metrics


LeanIX Metrics can consume data from an arbitrary source via an open API and link that to a Fact Sheet type.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.