---
title: "GET /api/v1/state/metric-usages-by-metric-name"
method: GET
path: "/api/v1/state/metric-usages-by-metric-name"
tags: ["MetricUsagesByMetricName"]
---

# GET /api/v1/state/metric-usages-by-metric-name

`GET /api/v1/state/metric-usages-by-metric-name`

## Request

- Base URL: `https://tenant.chronosphere.io`
- URL: `https://tenant.chronosphere.io/api/v1/state/metric-usages-by-metric-name`
- Auth: API key in header `API-Token`
- TypeScript: <https://skmtc.dev/chronosphere/apis/data-v1-api/docs/api/v1/state/metric-usages-by-metric-name/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `page.max_size` integer
- `page.token` string
- `order.ascending` boolean
- `order.by` 'VALUABLE' | 'DPPS' | 'UTILITY' | 'REFERENCES' | 'EXECUTIONS' | 'UNIQUE_VALUES' | 'UNIQUE_USERS'
- `lookback_secs` integer
- `metric_name_glob` string
- `include_counts_by_type` boolean

## Response `200`

A successful response.

- Statev1ListMetricUsagesByMetricNameResponse
  - `page` Configv1PageResult
    - `next_token` string: An opaque page token that identifies the next page of items that the client should request. An empty value indicates that there are no more items to return.
  - `usages` Statev1MetricUsageByMetricName[]
    - `dpps` number, double
    - `metric_name` string
    - `usage` Statev1MetricUsage
      - `query_execution_counts_by_type` MetricUsageQueryExecutionCountsByType
        - `dashboard` integer
        - `explorer` integer
        - `external` integer
      - `reference_counts_by_type` MetricUsageReferenceCountsByType
        - `aggregation_rules` integer
        - `dashboards` integer
        - `drop_rules` integer
        - `monitors` integer
        - `recording_rules` integer
      - `total_query_executions` integer
      - `total_references` integer
      - `total_unique_users` integer
      - `utility_score` number, double

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) - [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chronosphere/apis/data-v1-api/revisions/ee91fd539ced?raw)