> ## 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.

# Interroger les données de série d’un graphique

> Récupère les données de séries temporelles selon les paramètres de série configurés



## OpenAPI

````yaml /fr/_specs/hyperdx-openapi.json post /api/v2/charts/series
openapi: 3.0.0
info:
  description: API de gestion des alertes et des tableaux de bord HyperDX
  title: HyperDX External API
  version: 2.0.0
servers:
  - description: Serveur d’API de production
    url: https://api.hyperdx.io
  - description: Serveur actuel
    url: /
security:
  - BearerAuth: []
tags:
  - description: >-
      Points de terminaison permettant de gérer les tableaux de bord et leurs
      visualisations
    name: Dashboards
  - description: Points de terminaison permettant de gérer les alertes de supervision
    name: Alerts
paths:
  /api/v2/charts/series:
    post:
      tags:
        - Charts
      summary: Interroger les données de série d’un graphique
      description: >-
        Récupère les données de séries temporelles selon les paramètres de série
        configurés
      operationId: queryChartSeries
      requestBody:
        content:
          application/json:
            examples:
              basicTimeSeries:
                summary: Requête simple de série temporelle
                value:
                  endTime: 1647100800000
                  granularity: 1h
                  series:
                    - aggFn: count
                      groupBy: []
                      sourceId: 65f5e4a3b9e77c001a123456
                      where: SeverityText:error
                  startTime: 1647014400000
              metricSeries:
                summary: Série de données métriques
                value:
                  endTime: 1647100800000
                  granularity: 5m
                  series:
                    - aggFn: avg
                      groupBy: []
                      metricDataType: gauge
                      metricName: http_requests_total
                      sourceId: 65f5e4a3b9e77c001a789012
                      where: service:api
                  startTime: 1647014400000
              multiSeriesWithGroupBy:
                summary: Plusieurs séries avec 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 provenant de plusieurs sources
                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: Données de série temporelle groupées
                  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: Points de données de série temporelle
                  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: Données de séries temporelles récupérées avec succès
        '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: Paramètres de requête invalides
        '403':
          content:
            application/json:
              example:
                error: Team context missing
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Non autorisé
        '404':
          content:
            application/json:
              example:
                error: Source not found
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Source introuvable
        '500':
          content:
            application/json:
              example:
                error: Internal server error
              schema:
                properties:
                  error:
                    type: string
                type: object
          description: Erreur serveur
components:
  schemas:
    SeriesQueryRequest:
      properties:
        endTime:
          description: Horodatage de fin en millisecondes
          example: 1647100800000
          type: number
        granularity:
          description: Taille de l’intervalle temporel pour les agrégations
          enum:
            - 30s
            - 1m
            - 5m
            - 10m
            - 15m
            - 30m
            - 1h
            - 2h
            - 6h
            - 12h
            - 1d
            - 2d
            - 7d
            - 30d
            - auto
          example: 1h
          type: string
        series:
          description: Tableau des configurations de séries
          items:
            $ref: '#/components/schemas/ChartSeries'
          maxItems: 5
          minItems: 1
          type: array
        seriesReturnType:
          description: Format des données renvoyées
          enum:
            - ratio
            - column
          example: column
          type: string
        startTime:
          description: Horodatage de début en millisecondes
          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: Fonction d’agrégation à utiliser sur les données
          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: Champ à agréger
          example: duration
          type: string
        groupBy:
          description: Champs selon lesquels regrouper les résultats
          example:
            - service
            - host
          items:
            type: string
          type: array
        metricDataType:
          description: Type de données métriques
          enum:
            - sum
            - gauge
            - histogram
          example: gauge
          type: string
        metricName:
          description: Nom de la métrique (pour les sources de données de métriques)
          example: http_requests_total
          type: string
        sourceId:
          description: ID de la source de données pour cette série
          example: 65f5e4a3b9e77c001a123456
          type: string
        type:
          enum:
            - time
            - table
            - number
            - histogram
            - search
            - markdown
          example: time
          type: string
        where:
          description: Condition de filtrage en syntaxe de requête Lucene
          example: level:error
          type: string
        whereLanguage:
          description: Langage de requête utilisé dans la clause WHERE
          enum:
            - lucene
            - sql
          example: lucene
          type: string
      required:
        - sourceId
        - aggFn
        - where
        - groupBy
      type: object
    SeriesDataPoint:
      properties:
        group:
          description: Valeurs de regroupement si groupBy est spécifié
          example:
            - api
            - prod-host-1
          items:
            type: string
          type: array
        series_0.data:
          description: Valeur de la première série
          example: 42
          type: number
        series_1.data:
          description: Valeur de la deuxième série
          example: 18
          type: number
        ts_bucket:
          description: Horodatage du point de données (heure de début de l’intervalle)
          example: 1647014400000
          type: number
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API Key
      scheme: bearer
      type: http

````