> ## 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 datos de series de un gráfico

> Obtiene datos de series temporales según los parámetros de serie configurados



## OpenAPI

````yaml /es/_specs/hyperdx-openapi.json post /api/v2/charts/series
openapi: 3.0.0
info:
  description: API para gestionar alertas y dashboards de HyperDX
  title: HyperDX External API
  version: 2.0.0
servers:
  - description: Servidor de API de producción
    url: https://api.hyperdx.io
  - description: Servidor actual
    url: /
security:
  - BearerAuth: []
tags:
  - description: Endpoints para gestionar dashboards y sus visualizaciones
    name: Dashboards
  - description: Endpoints para gestionar alertas de monitorización
    name: Alerts
paths:
  /api/v2/charts/series:
    post:
      tags:
        - Charts
      summary: Consultar datos de series de un gráfico
      description: >-
        Obtiene datos de series temporales según los parámetros de serie
        configurados
      operationId: queryChartSeries
      requestBody:
        content:
          application/json:
            examples:
              basicTimeSeries:
                summary: Consulta básica de series temporales
                value:
                  endTime: 1647100800000
                  granularity: 1h
                  series:
                    - aggFn: count
                      groupBy: []
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                  startTime: 1647014400000
              metricSeries:
                summary: Serie de datos 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: Varias series con 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: Series de varias fuentes
                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: Datos de series temporales 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: Puntos de datos de series temporales
                  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: Datos de series temporales obtenidos correctamente
        '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 de solicitud no válidos
        '403':
          content:
            application/json:
              example:
                error: Team context missing
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: No autorizado
        '404':
          content:
            application/json:
              example:
                error: Source not found
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Fuente no encontrada
        '500':
          content:
            application/json:
              example:
                error: Internal server error
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Error del servidor
components:
  schemas:
    SeriesQueryRequest:
      properties:
        endTime:
          description: Marca de tiempo de fin en milisegundos
          example: 1647100800000
          type: number
        granularity:
          description: Tamaño del bucket de tiempo para las agregaciones
          enum:
            - 30s
            - 1m
            - 5m
            - 10m
            - 15m
            - 30m
            - 1h
            - 2h
            - 6h
            - 12h
            - 1d
            - 2d
            - 7d
            - 30d
            - auto
          example: 1h
          type: string
        series:
          description: Array de configuraciones de series
          items:
            $ref: '#/components/schemas/ChartSeries'
          maxItems: 5
          minItems: 1
          type: array
        seriesReturnType:
          description: Formato de los datos devueltos
          enum:
            - ratio
            - column
          example: column
          type: string
        startTime:
          description: Marca de tiempo de inicio en milisegundos
          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: Función de agregación que se usará en los datos
          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 que se va a agregar
          example: duration
          type: string
        groupBy:
          description: Campos por los que se agruparán los resultados
          example:
            - service
            - host
          items:
            type: string
          type: array
        metricDataType:
          description: Tipo de dato de la métrica
          enum:
            - sum
            - gauge
            - histogram
          example: gauge
          type: string
        metricName:
          description: Nombre de la métrica (para fuentes de datos de métricas)
          example: http_requests_total
          type: string
        sourceId:
          description: ID de la fuente de datos de esta serie
          example: 65f5e4a3b9e77c001a123456
          type: string
        type:
          enum:
            - time
            - table
            - number
            - histogram
            - search
            - markdown
          example: time
          type: string
        where:
          description: Condición de filtro en sintaxis de consulta de Lucene
          example: level:error
          type: string
        whereLanguage:
          description: Lenguaje de consulta usado en la cláusula WHERE
          enum:
            - lucene
            - sql
          example: lucene
          type: string
      required:
        - sourceId
        - aggFn
        - where
        - groupBy
      type: object
    SeriesDataPoint:
      properties:
        group:
          description: Valores de agrupación si se especificó groupBy
          example:
            - api
            - prod-host-1
          items:
            type: string
          type: array
        series_0.data:
          description: Valor de la primera serie
          example: 42
          type: number
        series_1.data:
          description: Valor de la segunda serie
          example: 18
          type: number
        ts_bucket:
          description: Marca de tiempo del punto de datos (hora de inicio del bucket)
          example: 1647014400000
          type: number
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API Key
      scheme: bearer
      type: http

````