This is a Grafana datasource for showing metrics from Instana AI-Powered APM for dynamic applications.
Attention: For On-premise customers Instana Release 146 is required.
- Dynamic Focus queries
- Applications and Websites
- Automatic completion for available types and metrics
- Utilizes Instana REST API
- Security via access token
This datasource uses the Instana REST API to query the metric values. First of all you will need to generate an API token. Use this token along with the URL for your Instana account e.g. https://prod-acme.instana.io
To use the Grafana server as a proxy for querying Instana REST API please check Use proxy.
To enable metrics for offline snapshots please check Enable offline snapshots. For On-premise customers Instana Release 156 is required.
To start, enter the Dynamic Focus query. This is exactly the same as used in the Instana dashboard; you can test your queries in Instana and then copy and paste them into Grafana. NOTE Saved filters are not currently supported by the Grafana datasource plugin.
Once you filled in the query the available types dropdown will be automatically populated, select the type you want.
As you select the type, the available metrics dropdown will be automatically populated, select the metric you want.
If your Dynamic Focus query matches multiple instances then, the returned dataset will include metrics from all those matching instances, providing graphs with multiple plots like the example below.
To choose custom metrics matching your query you need to select "Infrastructure custom metrics" from the category dropdown, which will automatically populate the available types dropdown.
As you select the type, the available metrics dropdown will be automatically populated, select the metric you want. As there might be a huge amount of custom metrics, you can specify an optional filter to reduce to a corresponding subset.
If your Dynamic Focus query matches, the returned dataset will include metrics providing graphs like the example below.
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $host - the corresponding host
- $pid - the corresponding PID
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $type - the entity type
- $service - the service label (for endpoints only)
- $name - a label alternative
- $index - index in the list
A simple version of getting metrics related to one or multiple applications. Once an application and a metric are selected, the graphs will be drawn (see example below).
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $application - application label
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $key - metric key with aggregation and rollup
- $index - index in the list
If no custom format is provided the default label '$label ($application) $metric' will be shown.
Allows to show metrics related to a service. Services can either be selected as standalone or in combination with an Application Perspective to show more detailed metric data. The latter is only possible with an Instana version of at least than 1.163.
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $service - service label
- $application - application label
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $key - metric key with aggregation and rollup
- $index - index in the list
If no custom format is provided the default label '$label ($service) $metric' will be shown.
Allows to show metrics related to an endpoint. Endpoint can either be selected as standalone or in combination with an Application Perspective to show more detailed metric data. Since multiple endpoints can have the same name, the service name is shown in brackets after each endpoint to make the selection more clear.
The latter is only possible with an Instana version of at least than 1.163.
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $endpoint - endpoint label
- $application - application label
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $key - metric key with aggregation and rollup
- $index - index in the list
If no custom format is provided the default label '$label ($endpoint) $metric' will be shown.
To choose application metrics you need to select "Analyze application calls" from the category dropdown. This will populate the other dropdown lists.
The "Application" dropdown will contain a list of all applications sorted by their name.
Most metrics will have more than one aggregation type (SUM, MEAN, ...) and you can choose which one to use.
It's also possible to add additional filters via "add Filter". Multiple filters are concatenated using "AND".
If your selection matches, the returned dataset will include metrics providing graphs like the example below.
If more then 20 metics are fetched, a warning appears that not all results are shown. Add Filter to narrow down the data.
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $application - application label
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $key - metric key with aggregation and rollup
- $index - index in the list
If no custom format is provided the default label '$label ($application) $metric' will be shown.
To choose EUM website metrics you need to select "Analyze websites" from the category dropdown. This will populate the other dropdown lists.
The "Website" dropdown will contain a list of all websites sorted by their pageloads.
Most metrics will have more than one aggregation type (SUM, MEAN, ...) and you can choose which one to use.
It's also possible to add additional filters via "add Filter". Multiple filters are concatenated using "AND".
If your selection matches, the returned dataset will include metrics providing graphs like the example below.
A default label '$label ($website) $metric' will be shown.
To adjust the legend display you can provide an own "Legend format". Supported values for replacement are:
- $label - the entity label
- $website - website label
- $type - entity type
- $timeShift - corresponding timeShift
- $metric - the displayed metric
- $key - metric key with aggregation and rollup
- $index - index in the list
If no custom format is provided the default label '$label ($website) $metric' will be shown.
While using the "Singlestat" visualization an additional metric aggregation is selectable. For showing a correct SUM metric, configuration on two different places is needed:
- on metric selection: "SUM" to adjust our mean calculated rollup values
- on Singlestat configuation: "Total" to tell the panel to aggregate all given values
While using the "Table" visualization an additional metric aggregation is selectable.
The time shift option allows going back in different points of time for each query.
This new feature can be used to compare two identical queries while one shows the query's outcome of a day earlier.
This plugin also supports the ability to select different granularity values to provide a even deeper look into metrics.
Aggregate graphs on query level and choose to show everything or only the aggregated graph.
