Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation d'un pipeline d' OpenSearch ingestion avec Amazon Managed Service pour Prometheus

Vous pouvez utiliser Amazon Managed Service for Prometheus comme destination pour OpenSearch votre pipeline d'ingestion afin de stocker les métriques sous forme de séries chronologiques. Le récepteur Prometheus vous permet d' OpenTelemetry envoyer des métriques ou d'autres séries chronologiques de votre pipeline vers un espace de travail Amazon Managed Service for Prometheus à des fins de surveillance, d'alerte et d'analyse.

Le plugin prometheus sink permet aux pipelines d' OpenSearch ingestion d'écrire des données métriques dans les espaces de travail Amazon Managed Service for Prometheus à l'aide du protocole d'écriture à distance Prometheus. Cette intégration vous permet de :

Conditions préalables

Avant de configurer le récepteur Prometheus, assurez-vous que vous disposez des éléments suivants :

Étape 1 : configurer le rôle du pipeline

Le récepteur Prometheus hérite automatiquement des autorisations IAM du rôle de pipeline pour l'authentification. Aucune configuration de rôle supplémentaire n'est donc requise dans les paramètres sts_role_arn du récepteur.

L'exemple de politique suivant indique les autorisations requises pour utiliser Amazon Managed Service for Prometheus comme récepteur :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AMPRemoteWrite",
      "Effect": "Allow",
      "Action": [
        "aps:RemoteWrite"
      ],
      "Resource": "arn:aws:aps:region:account-id:workspace/workspace-id"
    }
  ]
}

Remplacez les espaces réservés suivants :

Vous devez associer ces autorisations à votre rôle de pipeline.

Assurez-vous que votre rôle dans le pipeline repose sur une relation de confiance qui permet OpenSearch à Ingestion de l'assumer :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "osis-pipelines.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Étape 2 : Création du pipeline

Après avoir défini vos autorisations, vous pouvez configurer un pipeline d' OpenSearch ingestion pour utiliser Amazon Managed Service for Prometheus comme récepteur.

Configuration de base

L'exemple suivant montre une configuration minimale du récepteur Prometheus :

version: "2"
sink:
  - prometheus:
      url: "https://aps-workspaces.region.amazonaws.com/workspaces/workspace-id/api/v1/remote_write"
      aws:
        region: "region"

Vous devez spécifier l'urloption dans la configuration du prometheus récepteur, à savoir le point de terminaison d'écriture à distance Amazon Managed Service for Prometheus. Pour formater l'URL, recherchez l'ID de votre espace de travail dans la console Amazon Managed Service for Prometheus et créez l'URL comme suit : https://aps-workspaces.region.amazonaws.com/workspaces/workspace-id/api/v1/remote_write

Options de configuration

Utilisez les options suivantes pour configurer le comportement de traitement par lots et de rinçage pour le récepteur Prometheus :

Exemples de pipelines

Exemple 1 : OpenTelemetry statistiques relatives à Amazon Managed Service pour Prometheus

Ce pipeline reçoit OpenTelemetry les métriques d'un agent externe et les écrit sur Amazon Managed Service for Prometheus :

version: "2"
source:
  otel_metrics_source:
    path: "/v1/metrics"
    output_format: otel

sink:
  - prometheus:
      url: "https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/api/v1/remote_write"
      aws:
        region: "us-east-1"

Exemple 2 : double récepteur OpenSearch et Amazon Managed Service pour Prometheus

Ce pipeline achemine les métriques à la fois OpenSearch vers Amazon Managed Service pour Prometheus :

version: "2"
source:
  otel_metrics_source:
    path: "/v1/metrics"
    output_format: otel

sink:
  - opensearch:
      hosts:
        - "https://search-domain-endpoint.us-east-1.es.amazonaws.com"
      index: "metrics-%{yyyy.MM.dd}"
      aws:
        region: "us-east-1"
        sts_role_arn: "arn:aws:iam::123456789012:role/OSI-Pipeline-Role"

  - prometheus:
      url: "https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/api/v1/remote_write"
      aws:
        region: "us-east-1"

Exemple 3 : métriques avec filtrage

Ce pipeline filtre les métriques avant de les envoyer à Amazon Managed Service for Prometheus :

version: "2"
source:
  otel_metrics_source:
    path: "/v1/metrics"
    output_format: otel

processor:
  - drop_events:
      drop_when: '/name != "http.server.duration" and /name != "http.client.duration"'

sink:
  - prometheus:
      url: "https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/api/v1/remote_write"
      aws:
        region: "us-east-1"

Vous pouvez utiliser un plan Amazon Managed Service for Prometheus préconfiguré pour créer ces pipelines. Pour de plus amples informations, veuillez consulter Travailler avec des plans.

Création d'un pipeline avec Amazon Managed Service pour Prometheus sink

Utilisation de la AWS console

Utilisation de la AWS CLI

Créez un fichier de configuration de pipeline (par exemple,amp-pipeline.yaml) avec la configuration souhaitée, puis exécutez :

aws osis create-pipeline \
  --pipeline-name my-amp-pipeline \
  --min-units 2 \
  --max-units 4 \
  --pipeline-configuration-body file://amp-pipeline.yaml

En utilisant AWS CloudFormation

Resources:
  MyAMPPipeline:
    Type: AWS::OSIS::Pipeline
    Properties:
      PipelineName: my-amp-pipeline
      MinUnits: 2
      MaxUnits: 4
      PipelineConfigurationBody: |
        version: "2"
        source:
          otel_metrics_source:
            path: "/v1/metrics"
            output_format: otel
        sink:
          - prometheus:
              url: "https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/api/v1/remote_write"
              aws:
                region: "us-east-1"

Surveillance et résolution des problèmes

CloudWatch métriques

Surveillez les performances de votre pipeline à l'aide de CloudWatch métriques :

Problèmes courants

Problème : Pipeline ne parvient pas à écrire dans Amazon Managed Service pour Prometheus

Solutions :

Problème : erreurs d'authentification

Solutions :

Problème : latence ou étranglement élevés

Solutions :

Limitations

Tenez compte des limites suivantes lorsque vous configurez un pipeline d' OpenSearch ingestion pour Amazon Managed Service for Prometheus :

Bonnes pratiques