---
title: "Get metrics for a GraphQL query"
method: GET
path: "/dev-tools/gql-lock/metrics"
tags: ["Dev Tools", "GraphQL Locks"]
---

# Get metrics for a GraphQL query

`GET /dev-tools/gql-lock/metrics`

## Request

- Base URL: `http://dev.theverge.com:3002/api`
- URL: `http://dev.theverge.com:3002/api/dev-tools/gql-lock/metrics`
- Auth: none declared

Retrieves detailed metrics including failure counters and top variable shapes for a specific GraphQL query

## Query parameters

- `host` string, required
- `id` string, required
- `variableHash` string

## Response `200`

Successfully retrieved metrics

- object
  - `data` MetricsResponse, required
    - `identity` object, required
      - `host` string, required
      - `id` string, required
      - `variableHash` string
      - `scope` 'persisted_query' | 'variable_hash', required
    - `pqMetrics` ScopedMetrics, required
      - `counters` object, required
        - `rate60s` number, required
        - `day24` number, required
        - `consecutive` number, required
      - `lock` object, nullable, required
        - `reason` string, required
        - `at` number, required
        - `trigger` string
        - `scope` string
      - `lockTtl` number, required
    - `vhMetrics` ScopedMetrics
      - `counters` object, required
        - `rate60s` number, required
        - `day24` number, required
        - `consecutive` number, required
      - `lock` object, nullable, required
        - `reason` string, required
        - `at` number, required
        - `trigger` string
        - `scope` string
      - `lockTtl` number, required
    - `topVars` TopVariable[], required
      - `hash` string, required
      - `count` number, required

## Other responses

- `400`: Invalid input parameters
- `500`: Internal server error

---

[API](https://skmtc.dev/theverge/apis/the-verge-api-documentation.md) - [All operations](https://skmtc.dev/theverge/apis/the-verge-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/theverge/apis/the-verge-api-documentation/revisions/f44a9b8ebfc3?raw)