> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar dados de séries do gráfico

> Retorna dados de séries temporais com base nos parâmetros de série configurados



## OpenAPI

````yaml /pt-BR/_specs/hyperdx-openapi.json post /api/v2/charts/series
openapi: 3.0.0
info:
  description: API para gerenciar alertas e dashboards do HyperDX
  title: HyperDX External API
  version: 2.0.0
servers:
  - description: Servidor de API de produção
    url: https://api.hyperdx.io
  - description: Servidor atual
    url: /
security:
  - BearerAuth: []
tags:
  - description: Endpoints para gerenciar dashboards e suas visualizações
    name: Dashboards
  - description: Endpoints para gerenciar alertas de monitoramento
    name: Alerts
paths:
  /api/v2/charts/series:
    post:
      tags:
        - Charts
      summary: Consultar dados de séries do gráfico
      description: >-
        Retorna dados de séries temporais com base nos parâmetros de série
        configurados
      operationId: queryChartSeries
      requestBody:
        content:
          application/json:
            examples:
              basicTimeSeries:
                summary: Consulta básica de séries temporais
                value:
                  endTime: 1647100800000
                  granularity: 1h
                  series:
                    - aggFn: count
                      groupBy: []
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                  startTime: 1647014400000
              metricSeries:
                summary: Série de dados de métricas
                value:
                  endTime: 1647100800000
                  granularity: 5m
                  series:
                    - aggFn: avg
                      groupBy: []
                      metricDataType: gauge
                      metricName: http_requests_total
                      sourceId: 65f5e4a3b9e77c001a789012
                      where: service:api
                  startTime: 1647014400000
              multiSeriesWithGroupBy:
                summary: Múltiplas séries com group by
                value:
                  endTime: 1647100800000
                  granularity: 15m
                  series:
                    - aggFn: count
                      groupBy:
                        - service
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                    - aggFn: avg
                      field: duration
                      groupBy:
                        - service
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                  startTime: 1647014400000
              multiSourceSeries:
                summary: Séries de múltiplas fontes de dados
                value:
                  endTime: 1647100800000
                  granularity: 5m
                  series:
                    - aggFn: count
                      groupBy: []
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                    - aggFn: avg
                      groupBy: []
                      metricDataType: gauge
                      metricName: http_requests_total
                      sourceId: 65f5e4a3b9e77c001a789012
                      where: service:api
                  startTime: 1647014400000
            schema:
              $ref: '#/components/schemas/SeriesQueryRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                groupedTimeSeriesData:
                  summary: Dados de séries temporais agrupados
                  value:
                    data:
                      - group:
                          - api
                        series_0.data: 15
                        ts_bucket: 1647014400000
                      - group:
                          - frontend
                        series_0.data: 8
                        ts_bucket: 1647014400000
                      - group:
                          - api
                        series_0.data: 22
                        ts_bucket: 1647018000000
                timeSeriesData:
                  summary: Pontos de dados de séries temporais
                  value:
                    data:
                      - series_0.data: 42
                        ts_bucket: 1647014400000
                      - series_0.data: 37
                        ts_bucket: 1647018000000
                      - series_0.data: 53
                        ts_bucket: 1647021600000
              schema:
                $ref: '#/components/schemas/SeriesResponse'
          description: Dados de séries temporais recuperados com sucesso
        '400':
          content:
            application/json:
              examples:
                invalidParams:
                  value:
                    error: All series must have the same groupBy fields
                invalidTimestamp:
                  value:
                    error: Timestamp must be in milliseconds
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Parâmetros da solicitação inválidos
        '403':
          content:
            application/json:
              example:
                error: Team context missing
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Não autorizado
        '404':
          content:
            application/json:
              example:
                error: Source not found
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Fonte de dados não encontrada
        '500':
          content:
            application/json:
              example:
                error: Internal server error
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Erro do servidor
components:
  schemas:
    SeriesQueryRequest:
      properties:
        endTime:
          description: Timestamp final em milissegundos
          example: 1647100800000
          type: number
        granularity:
          description: Tamanho do bucket de tempo para agregações
          enum:
            - 30s
            - 1m
            - 5m
            - 10m
            - 15m
            - 30m
            - 1h
            - 2h
            - 6h
            - 12h
            - 1d
            - 2d
            - 7d
            - 30d
            - auto
          example: 1h
          type: string
        series:
          description: Array de configurações de séries
          items:
            $ref: '#/components/schemas/ChartSeries'
          maxItems: 5
          minItems: 1
          type: array
        seriesReturnType:
          description: Formato dos dados retornados
          enum:
            - ratio
            - column
          example: column
          type: string
        startTime:
          description: Timestamp inicial em milissegundos
          example: 1647014400000
          type: number
      required:
        - series
        - startTime
        - endTime
      type: object
    SeriesResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SeriesDataPoint'
          type: array
      type: object
    ChartSeries:
      properties:
        aggFn:
          description: Função de agregação a ser usada nos dados
          enum:
            - avg
            - count
            - count_distinct
            - last_value
            - max
            - min
            - quantile
            - sum
          example: count
          type: string
        dataSource:
          enum:
            - events
            - metrics
          example: events
          type: string
        field:
          description: Campo a ser agregado
          example: duration
          type: string
        groupBy:
          description: Campos pelos quais os resultados serão agrupados
          example:
            - service
            - host
          items:
            type: string
          type: array
        metricDataType:
          description: Tipo de dado da métrica
          enum:
            - sum
            - gauge
            - histogram
          example: gauge
          type: string
        metricName:
          description: Nome da métrica (para fontes de dados de métricas)
          example: http_requests_total
          type: string
        sourceId:
          description: ID da fonte de dados desta série
          example: 65f5e4a3b9e77c001a123456
          type: string
        type:
          enum:
            - time
            - table
            - number
            - histogram
            - search
            - markdown
          example: time
          type: string
        where:
          description: Condição de filtro na sintaxe de consulta do Lucene
          example: level:error
          type: string
        whereLanguage:
          description: Linguagem de consulta usada na cláusula WHERE
          enum:
            - lucene
            - sql
          example: lucene
          type: string
      required:
        - sourceId
        - aggFn
        - where
        - groupBy
      type: object
    SeriesDataPoint:
      properties:
        group:
          description: Valores de agrupamento, se groupBy tiver sido especificado
          example:
            - api
            - prod-host-1
          items:
            type: string
          type: array
        series_0.data:
          description: Valor da primeira série
          example: 42
          type: number
        series_1.data:
          description: Valor da segunda série
          example: 18
          type: number
        ts_bucket:
          description: Timestamp do ponto de dados (horário de início do bucket)
          example: 1647014400000
          type: number
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API Key
      scheme: bearer
      type: http

````