COcortex
Custom Metrics

Retrieve a custom metric definition

Changed on

API key must have the View Eng Intelligence permission. A draft metric returns 404 unless the key also has the Configure Eng Intelligence custom metrics permission.

get/api/v1/eng-intel/custom-metrics/{customMetricKey}

Request

  • Base URL
    https://api.getcortexapp.com
  • URL
    https://api.getcortexapp.com/api/v1/eng-intel/custom-metrics/{customMetricKey}
  • Auth
    HTTP bearer

Path parameters

customMetricKeystring required

Key of the custom metric

Response

The custom metric definition

categorystring

Free-text group for the metric

cqlExpressionstring

The CQL expression behind a CQL metric. Null for PUBLIC_API.

descriptionstring

What the metric measures

isDraftboolean required

A draft metric is hidden from Eng Intelligence

keystring required

Unique key that data points are recorded against

namestring required

Display name

type'CQL' | 'PUBLIC_API' required

PUBLIC_API metrics take data points through the API. CQL metrics compute their values from a CQL expression and are read-only through the API.

valence'POSITIVE' | 'NEGATIVE' | 'NEUTRAL' required

Whether a higher value is better

Example response

{
  "category": "Delivery",
  "key": "deploy-frequency",
  "name": "Deploy frequency"
}

Changes