assign-metrics.md

description
This page provides the technical details of the Assign Metrics policy

Assign Metrics

{% hint style="warning" %} This feature requires Gravitee's Enterprise Edition. {% endhint %}

Overview

You can use the assign-metrics policy to push extra metrics in addition to the natively provided request metrics.

These metrics can then be used from analytics dashboards to create custom widgets and, optionally, apply aggregations based on their value.

Functional and implementation information for the assign-metrics policy is organized into the following sections:

• Examples
• Configuration
• Compatibility Matrix

Examples

{% hint style="warning" %} This policy can be applied to v2 APIs and v4 proxy APIs. It cannot be applied to v4 message APIs. {% endhint %}

{% tabs %} {% tab title="Proxy API example" %} To display your request distribution based on a particular HTTP header in your dashboards, create the custom metric shown below.

"assign-metrics": {
    "metrics": [
        {
            "name": "myCustomHeader,
            "value": "{#request.headers['X-MyCustomHeader'] != null ? #request.headers['X-MyCustomHeader'][0] : null}"
        }
    ]
}

{% endtab %} {% endtabs %}

Configuration

You can enable or disable the policy with policy identifier policy-assign-metrics.

Phases

The phases checked below are supported by the assign-metrics policy:

v2 Phases	Compatible?	v4 Phases	Compatible?
onRequest	true	onRequest	true
onResponse	true	onResponse	true
onRequestContent	true	onMessageRequest	false
onResponseContent	true	onMessageResponse	false

Compatibility matrix

The following is the compatibility matrix for APIM and the assign-metrics policy:

Plugin Version	Supported APIM versions
1.x	Up to 3.1.7
2.x	3.18 to 3.20
3.x	4.0+