---
title: "MetricsV2Dto"
url: "https://nov18-dev.movespot.fyi/apis/konnect-metrics-endpoint-4/versions/067cb7dd-3237-4170-bfaf-95928b927e78/schemas/MetricsV2Dto"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-metrics-endpoint-4/versions/067cb7dd-3237-4170-bfaf-95928b927e78.md

# MetricsV2Dto

A query to launch at the API

## OpenAPI definition

```yaml
openapi: 3.0.2
info:
  title: Konnect Metrics Endpoint
  version: 4.0.0
servers:
  - url: https://us.api.konghq.com/v1
    description: United-States Production region
  - url: https://eu.api.konghq.com/v1
    description: Europe Production region
  - url: https://au.api.konghq.com/v1
    description: Australia Production region
  - url: https://me.api.konghq.com/v1
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v1
    description: India Production region
  - url: https://sg.api.konghq.com/v1
    description: Singapore Production region
components:
  schemas:
    AdvancedFilters:
      description: A list of filters to apply to the query.
      type: array
      items:
        discriminator:
          propertyName: field
          mapping:
            api: "#/components/schemas/MetricsApiFilterByField"
            api_package: "#/components/schemas/MetricsApiPackageFilterByField"
            api_product: "#/components/schemas/MetricsApiProductFilterByField"
            api_product_version: "#/components/schemas/MetricsApiProductVersionFilterByField"
            application: "#/components/schemas/MetricsApplicationFilterByField"
            consumer: "#/components/schemas/MetricsConsumerFilterByField"
            control_plane: "#/components/schemas/MetricsControlPlaneFilterByField"
            control_plane_group: "#/components/schemas/MetricsControlPlaneGroupFilterByField"
            country_code: "#/components/schemas/MetricsCountryCodeFilterByField"
            data_plane_node: "#/components/schemas/MetricsDataPlaneNodeFilterByField"
            data_plane_node_version: "#/components/schemas/MetricsDataPlaneNodeVersionFilterByField"
            gateway_service: "#/components/schemas/MetricsGatewayServiceFilterByField"
            portal: "#/components/schemas/MetricsPortalFilterByField"
            realm: "#/components/schemas/MetricsRealmFilterByField"
            response_source: "#/components/schemas/MetricsResponseSourceFilterByField"
            route: "#/components/schemas/MetricsRouteFilterByField"
            status_code: "#/components/schemas/MetricsStatusCodeFilterByField"
            status_code_grouped: "#/components/schemas/MetricsStatusCodeGroupedFilterByField"
            upstream_status_code: "#/components/schemas/MetricsUpstreamStatusCodeFilterByField"
            upstream_status_code_grouped: "#/components/schemas/MetricsUpstreamStatusCodeGr\
              oupedFilterByField"
        oneOf:
          - $ref: "#/components/schemas/MetricsApiFilterByField"
          - $ref: "#/components/schemas/MetricsApiPackageFilterByField"
          - $ref: "#/components/schemas/MetricsApiProductFilterByField"
          - $ref: "#/components/schemas/MetricsApiProductVersionFilterByField"
          - $ref: "#/components/schemas/MetricsApplicationFilterByField"
          - $ref: "#/components/schemas/MetricsConsumerFilterByField"
          - $ref: "#/components/schemas/MetricsControlPlaneFilterByField"
          - $ref: "#/components/schemas/MetricsControlPlaneGroupFilterByField"
          - $ref: "#/components/schemas/MetricsCountryCodeFilterByField"
          - $ref: "#/components/schemas/MetricsDataPlaneNodeFilterByField"
          - $ref: "#/components/schemas/MetricsDataPlaneNodeVersionFilterByField"
          - $ref: "#/components/schemas/MetricsGatewayServiceFilterByField"
          - $ref: "#/components/schemas/MetricsPortalFilterByField"
          - $ref: "#/components/schemas/MetricsRealmFilterByField"
          - $ref: "#/components/schemas/MetricsResponseSourceFilterByField"
          - $ref: "#/components/schemas/MetricsRouteFilterByField"
          - $ref: "#/components/schemas/MetricsStatusCodeFilterByField"
          - $ref: "#/components/schemas/MetricsStatusCodeGroupedFilterByField"
          - $ref: "#/components/schemas/MetricsUpstreamStatusCodeFilterByField"
          - $ref: "#/components/schemas/MetricsUpstreamStatusCodeGroupedFilterByField"
    Granularity:
      description: >
        Force time grouping into buckets of the specified duration.  Only has an
        effect if "time" is in the "dimensions" list.


        The granularity of the result may be coarser than requested.  The finest
        allowed granularity depends on the query's time range: data farther in
        the past may have coarser granularity.  The exact result granularity
        will be reported in the response `meta.granularity_ms` field.


        If granularity is not specified and "time" is in the dimensions list, a
        default will be chosen based on the time range requested.


        Different relative times support different granularities:
          - 15m => tenSecondly, thirtySecondly, minutely
          - 1h  => tenSecondly, thirtySecondly, minutely, fiveMinutely, tenMinutely
          - 6h  => thirtySecondly, minutely, fiveMinutely, tenMinutely, thirtyMinutely, hourly
          - 12h => minutely, fiveMinutely, tenMinutely, thirtyMinutely, hourly
          - 24h => fiveMinutely, tenMinutely, thirtyMinutely, hourly
          - 7d  => thirtyMinutely, hourly, twoHourly, twelveHourly, daily
          - 30d => hourly, twoHourly, twelveHourly, daily, weekly

        For special time ranges:
          - current_week, previous_week   => thirtyMinutely, hourly, twoHourly, twelveHourly, daily
          - current_month, previous_month => hourly, twoHourly, twelveHourly, daily, weekly

        For absolute time ranges, daily will be used.
      type: string
      enum:
        - tenSecondly
        - thirtySecondly
        - minutely
        - fiveMinutely
        - tenMinutely
        - thirtyMinutely
        - hourly
        - twoHourly
        - twelveHourly
        - daily
        - weekly
    TimeRange:
      description: The time range to query.
      default:
        type: relative
        time_range: 1h
      discriminator:
        propertyName: type
        mapping:
          relative: "#/components/schemas/MetricsRelativeTimeRangeDtoV2"
          absolute: "#/components/schemas/MetricsAbsoluteTimeRangeDtoV2"
      oneOf:
        - $ref: "#/components/schemas/MetricsRelativeTimeRangeDtoV2"
        - $ref: "#/components/schemas/MetricsAbsoluteTimeRangeDtoV2"
    MetricsApiFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - api
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - api
          required:
            - operator
            - field
      title: Filter by api
    MetricsApiPackageFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_package
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_package
          required:
            - operator
            - field
      title: Filter by api_package
    MetricsApiProductFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product
          required:
            - operator
            - field
      title: Filter by api_product
    MetricsApiProductVersionFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product_version
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product_version
          required:
            - operator
            - field
      title: Filter by api_product_version
    MetricsApplicationFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - application
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - application
          required:
            - operator
            - field
      title: Filter by application
    MetricsConsumerFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: >
                The IDs to include in the results. Because gateway IDs are only
                unique within a given control plane, the filter values must be
                of the form `control_plane_id:field_id` or
                `control_plane_group_id:field_id` for data plane nodes within a
                control plane group.
              type: array
              items:
                $ref: "#/components/schemas/ScopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - consumer
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - consumer
          required:
            - operator
            - field
      title: Filter by consumer
    MetricsControlPlaneFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane
          required:
            - operator
            - field
      title: Filter by control_plane
    MetricsControlPlaneGroupFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane_group
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane_group
          required:
            - operator
            - field
      title: Filter by control_plane_group
    MetricsCountryCodeFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The values to include in the results.
              type: array
              items:
                type: string
            field:
              description: The field to filter.
              type: string
              enum:
                - country_code
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - country_code
          required:
            - operator
            - field
      title: Filter by country_code
    MetricsDataPlaneNodeFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: >
                The IDs to include in the results. Because gateway IDs are only
                unique within a given control plane, the filter values must be
                of the form `control_plane_id:field_id` or
                `control_plane_group_id:field_id` for data plane nodes within a
                control plane group.
              type: array
              items:
                $ref: "#/components/schemas/ScopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node
          required:
            - operator
            - field
      title: Filter by data_plane_node
    MetricsDataPlaneNodeVersionFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The values to include in the results.
              type: array
              items:
                type: string
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node_version
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node_version
          required:
            - operator
            - field
      title: Filter by data_plane_node_version
    MetricsGatewayServiceFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: >
                The IDs to include in the results. Because gateway IDs are only
                unique within a given control plane, the filter values must be
                of the form `control_plane_id:field_id` or
                `control_plane_group_id:field_id` for data plane nodes within a
                control plane group.
              type: array
              items:
                $ref: "#/components/schemas/ScopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - gateway_service
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - gateway_service
          required:
            - operator
            - field
      title: Filter by gateway_service
    MetricsPortalFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - portal
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - portal
          required:
            - operator
            - field
      title: Filter by portal
    MetricsRealmFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The IDs to include in the results.
              type: array
              items:
                $ref: "#/components/schemas/UnscopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - realm
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - realm
          required:
            - operator
            - field
      title: Filter by realm
    MetricsResponseSourceFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The values to include in the results.
              type: array
              items:
                type: string
            field:
              description: The field to filter.
              type: string
              enum:
                - response_source
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - response_source
          required:
            - operator
            - field
      title: Filter by response_source
    MetricsRouteFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: >
                The IDs to include in the results. Because gateway IDs are only
                unique within a given control plane, the filter values must be
                of the form `control_plane_id:field_id` or
                `control_plane_group_id:field_id` for data plane nodes within a
                control plane group.
              type: array
              items:
                $ref: "#/components/schemas/ScopedUuid"
            field:
              description: The field to filter.
              type: string
              enum:
                - route
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - route
          required:
            - operator
            - field
      title: Filter by route
    MetricsStatusCodeFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The codes to include in the results.
              type: array
              items:
                type: integer
                minimum: 0
                maximum: 999
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code
          required:
            - operator
            - field
      title: Filter by status_code
    MetricsStatusCodeGroupedFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The code groups to include in the results.
              type: array
              items:
                type: string
                pattern: ^\d[xX][xX]$
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code_grouped
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code_grouped
          required:
            - operator
            - field
      title: Filter by status_code_grouped
    MetricsUpstreamStatusCodeFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The codes to include in the results.
              type: array
              items:
                type: integer
                minimum: 0
                maximum: 999
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code
          required:
            - operator
            - field
      title: Filter by upstream_status_code
    MetricsUpstreamStatusCodeGroupedFilterByField:
      oneOf:
        - title: Multiselect filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterType"
            value:
              description: |
                The code groups to include in the results.
              type: array
              items:
                type: string
                pattern: ^\d[xX][xX]$
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code_grouped
          required:
            - operator
            - value
            - field
        - title: Empty filters
          type: object
          properties:
            operator:
              $ref: "#/components/schemas/RequestsFilterTypeEmpty"
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code_grouped
          required:
            - operator
            - field
      title: Filter by upstream_status_code_grouped
    MetricsRelativeTimeRangeDtoV2:
      description: A duration representing a relative-to-now span of time. Generally
        the start time is floored to the requested granularity. Eg 7d from now,
        with 1day granularity initiated at 2024-01-08T17:11:00+05:00 will query
        for the time range from 2024-01-01T00:00:00+05:00 to
        2024-01-08T17:11:00+05:00. The exact start and end timestamps are
        returned in the result query in the meta.start and meta.end fields. If
        the granularity for the previous query was 1hour, it would query a time
        range from 2024-01-01T17:00:00+05:00 to 2024-01-08T17:11:00+05:00.
      type: object
      properties:
        tz:
          type: string
          default: Etc/UTC
        type:
          type: string
          enum:
            - relative
        time_range:
          type: string
          default: 1h
          enum:
            - 15m
            - 1h
            - 6h
            - 12h
            - 24h
            - 7d
            - 30d
            - current_week
            - current_month
            - previous_week
            - previous_month
      required:
        - type
        - time_range
      title: Relative time range
    MetricsAbsoluteTimeRangeDtoV2:
      description: A duration representing an exact start and end time.
      type: object
      properties:
        tz:
          type: string
          default: Etc/UTC
        type:
          type: string
          enum:
            - absolute
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
      required:
        - type
      title: Absolute time range
    RequestsFilterType:
      description: The type of filter to apply.  `in` filters will limit results to
        only the specified values, while `not_in` filters will exclude the
        specified values.
      type: string
      enum:
        - in
        - not_in
    UnscopedUuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
    RequestsFilterTypeEmpty:
      description: The type of filter to apply.
      type: string
      enum:
        - empty
        - not_empty
    ScopedUuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
    MetricsV2Dto:
      description: A query to launch at the API
      type: object
      properties:
        metrics:
          description: List of aggregated metrics to collect across the requested time
            span. If no metrics are specified, request_count will be computed by
            default.
          type: array
          items:
            type: string
            enum:
              - kong_latency_average
              - kong_latency_p50
              - kong_latency_p95
              - kong_latency_p99
              - request_count
              - request_per_minute
              - request_size_average
              - request_size_p50
              - request_size_p95
              - request_size_p99
              - request_size_sum
              - response_latency_average
              - response_latency_p50
              - response_latency_p95
              - response_latency_p99
              - response_size_average
              - response_size_p50
              - response_size_p95
              - response_size_p99
              - response_size_sum
              - upstream_latency_average
              - upstream_latency_p50
              - upstream_latency_p95
              - upstream_latency_p99
          default:
            - request_count
          maxItems: 3
        dimensions:
          description: List of attributes or entity types to group by.
          type: array
          items:
            type: string
            enum:
              - api
              - api_package
              - api_product
              - api_product_version
              - application
              - consumer
              - control_plane
              - control_plane_group
              - country_code
              - data_plane_node
              - data_plane_node_version
              - gateway_service
              - portal
              - response_source
              - route
              - status_code
              - status_code_grouped
              - time
              - upstream_status_code
              - upstream_status_code_grouped
          example:
            - status_code_grouped
          maxItems: 2
        filters:
          $ref: "#/components/schemas/AdvancedFilters"
        granularity:
          $ref: "#/components/schemas/Granularity"
        time_range:
          $ref: "#/components/schemas/TimeRange"
        limit:
          description: Limits the number of distinct metric groups to return.
          type: number
          default: 50
          maximum: 1000
      example:
        time_range:
          type: relative
          time_range: 24h
          tz: EST
        dimensions:
          - time
          - gateway_service
        filters:
          - operator: in
            field: control_plane
            value:
              - d5ac5d88-efed-4e10-9dfe-0b0a6646c219
        granularity: hourly
        metrics:
          - request_count
          - response_latency_p99
      required:
        - metrics
```
