Metrics

Execute Prometheus query.

post

Executes a Prometheus query (instant or range) against the metrics server. Accepts either a direct 'promql' string or components ('pipeline', 'filters', 'conditions', 'subPipelines') to build the query.

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

QueryRequest represents a request to query metrics

Endstring · date-timeOptional

End time for the query

FiltersstringOptional

GCQL filters to apply

PromqlstringOptional

Direct PromQL query string

QueryTypestring · enumOptional

Query type: either "range" or "instant" range MetricsQueryTypeRange instant MetricsQueryTypeInstant

Possible values:

Startstring · date-timeOptional

Start time for the query

StepstringOptional

Step duration for range queries (e.g., "1m", "5m")

Responses

200Success

application/json

400

ErrorResponse defines a common error response structure.

application/json

500

ErrorResponse defines a common error response structure.

application/json

post

/api/metrics/query

HTTPcURLJavaScriptPython

POST /api/metrics/query HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1529

{
  "Conditions": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "End": "2026-03-27T20:44:38.869Z",
  "Filters": "text",
  "Pipeline": {
    "conditions": [
      {
        "additionalFilter": "text",
        "autoComplete": true,
        "filterKeys": [
          "text"
        ],
        "filters": [
          {
            "op": "text",
            "value": null
          }
        ],
        "isNullable": true,
        "key": "text",
        "origin": "text",
        "type": "text"
      }
    ],
    "function": {
      "args": [
        "text"
      ],
      "name": "text",
      "pipelines": [
        {
          "conditions": [
            {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "filters": [
                {
                  "op": "text",
                  "value": null
                }
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            }
          ],
          "function": {
            "args": [
              "text"
            ],
            "name": "text",
            "pipelines": "[Circular Reference]"
          },
          "metric": "text",
          "template": "text"
        }
      ]
    },
    "metric": "text",
    "template": "text"
  },
  "Promql": "text",
  "QueryType": "range",
  "Start": "2026-03-27T20:44:38.869Z",
  "Step": "text",
  "SubPipelines": {
    "ANY_ADDITIONAL_PROPERTY": {
      "conditions": [
        {
          "additionalFilter": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "filters": [
            {
              "op": "text",
              "value": null
            }
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "type": "text"
        }
      ],
      "function": {
        "args": [
          "text"
        ],
        "name": "text",
        "pipelines": [
          {
            "conditions": [
              {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "filters": [
                  {
                    "op": "text",
                    "value": null
                  }
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            ],
            "function": {
              "args": [
                "text"
              ],
              "name": "text",
              "pipelines": "[Circular Reference]"
            },
            "metric": "text",
            "template": "text"
          }
        ]
      },
      "metric": "text",
      "template": "text"
    }
  }
}

No content

GetMetricValues retrieves metric values based on the provided request parameters.

post

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

endstring · date-timeOptional

filterstringOptional

keystringOptional

limitinteger · uint32Optional

namestringOptional

startstring · date-timeOptional

Responses

200Success

application/json

isLimitReachedbooleanOptional

keystringOptional

namestringOptional

valuesstring[]Optional

400

ErrorResponse defines a common error response structure.

application/json

500

ErrorResponse defines a common error response structure.

application/json

post

/api/metrics/values

HTTPcURLJavaScriptPython

POST /api/metrics/values HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 489

{
  "conditions": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "end": "2026-03-27T20:44:38.869Z",
  "filter": "text",
  "key": "text",
  "limit": 1,
  "name": "text",
  "sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "start": "2026-03-27T20:44:38.869Z"
}

{
  "isLimitReached": true,
  "key": "text",
  "name": "text",
  "values": [
    "text"
  ]
}

GetKeys retrieves metric keys based on the provided request parameters.

post

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

endstring · date-timeOptional

End specifies the end time for the metric keys query.

filterstringOptional

Filter specifies a search filter to apply to the metric keys.

limitinteger · uint32Optional

Limit specifies the maximum number of results to return.

namestringOptional

Name specifies the metric name to get keys for.

startstring · date-timeOptional

Start specifies the start time for the metric keys query.

Responses

200Success

application/json

isLimitReachedbooleanOptional

IsLimitReached indicates whether the query limit was reached.

keysstring[]Optional

Keys is the list of metric keys.

namestringOptional

Name is the metric name.

400

ErrorResponse defines a common error response structure.

application/json

500

ErrorResponse defines a common error response structure.

application/json

post

/api/metrics/keys

HTTPcURLJavaScriptPython

POST /api/metrics/keys HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 291

{
  "end": "2026-03-27T20:44:38.869Z",
  "filter": "text",
  "limit": 1,
  "name": "text",
  "sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "start": "2026-03-27T20:44:38.869Z"
}

{
  "isLimitReached": true,
  "keys": [
    "text"
  ],
  "name": "text"
}

GetNames retrieves metric names based on the provided request parameters.

post

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

endstring · date-timeOptional

End specifies the end time for the metric names query.

filterstringOptional

Filter specifies a search filter to apply to the metric names.

limitinteger · uint32Optional

Limit specifies the maximum number of results to return.

requiredstring[]Optional

Required specifies a list of metric names that must be included in the results.

startstring · date-timeOptional

Start specifies the start time for the metric names query.

Responses

200Success

application/json

isLimitReachedbooleanOptional

IsLimitReached indicates whether the query limit was reached.

400

ErrorResponse defines a common error response structure.

application/json

500

ErrorResponse defines a common error response structure.

application/json

post

/api/metrics/names

HTTPcURLJavaScriptPython

POST /api/metrics/names HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "end": "2026-03-27T20:44:38.869Z",
  "filter": "text",
  "limit": 1,
  "required": [
    "text"
  ],
  "sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "start": "2026-03-27T20:44:38.869Z"
}

{
  "isLimitReached": true,
  "metrics": [
    {
      "description": "text",
      "highlights": [
        "text"
      ],
      "name": "text",
      "type": "text",
      "unit": "text"
    }
  ]
}