Flux de métriques AWS CloudWatch avec Kinesis Data Firehose

Les flux de métriques AWS CloudWatch avec Kinesis Data Firehose ne sont pas pris en charge sur ce site Datadog.

Avec les flux de métriques Amazon CloudWatch et Amazon Kinesis Data Firehose, vous pouvez transmettre plus rapidement des métriques CloudWatch à Datadog, avec une latence de 2 à 3 minutes. Cette approche est bien plus rapide que le processus d’interrogation de l’API Datadog, qui met à jour les métriques toutes les 10 minutes.

Présentation

Diagramme du flux de métriques
  1. Créez ces ressources AWS dans toutes les régions et tous les comptes AWS pour lesquels vous souhaitez créer un flux de métriques :
    • Créez un flux de diffusion Kinesis Data Firehose qui transmet les métriques à Datadog, ainsi qu’une sauvegarde S3 pour tout échec de diffusion des métriques.
    • Créez un flux de métriques CloudWatch lié à votre flux de diffusion.
    • Vous pouvez également spécifier un ensemble limité d’espaces de nommage pour le flux de métriques.
  2. Une fois ces ressources créées, Datadog commence immédiatement à recevoir les métriques diffusées et à les afficher sur le site de Datadog. Aucune configuration supplémentaire n’est requise.

Comparaison entre les flux de métriques et l’API (#flux-de-metriques-et-api)

Les principales différences entre les flux de métriques CloudWatch et l’API sont les suivantes :

  • Filtrage par espace de nommage sur AWS : les valeurs par défaut des espaces de nommage et les paramètres de compte de la page d’intégration AWS s’appliquent uniquement à l’API. Toutes les règles d’inclusion et d’exclusion d’espaces de nommage dans les flux doivent être gérées en utilisant la configuration des flux de métriques CloudWatch dans vos comptes AWS.

  • Métriques transmises avec plus de deux heures de retard : l’API continue de recueillir des métriques telles que aws.s3.bucket_size_bytes et aws.billing.estimated_charges lorsque les flux de métriques sont activés, étant donné qu’elles ne peuvent pas être transmises via les flux de métriques CloudWatch.

Passer de l’API aux flux de métriques

Si vous recevez déjà des métriques pour un espace de nommage CloudWatch donné via l’API, Datadog détecte ce comportement et cesse de recueillir les métriques pour cet espace de nommage dès qu’elles commencent à être transmises via un flux de métriques. Veillez à ne pas modifier vos paramètres de configuration sur la page d’intégration AWS : Datadog continuera d’utiliser l’API pour récupérer les tags personnalisés et d’autres métadonnées sur vos métriques diffusées.

Passer des flux de métriques à l’API

Si vous décidez ensuite que vous ne souhaitez plus utiliser les flux de métriques pour un compte et une région AWS donnés, ou même pour un espace de nommage spécifique, Datadog recommence automatiquement à recueillir ces métriques via l’API en fonction des paramètres définis sur la page d’intégration AWS. Si vous souhaitez désactiver complètement la diffusion de métriques pour un compte et une région AWS donnés, suivez les instructions indiquées à la rubrique Désactiver la diffusion de métriques de ce document.

Facturation

Datadog ne facture pas de frais supplémentaires pour la diffusion des métriques.

La facturation AWS est basée sur le nombre de mises à jour de métrique dans le flux de métriques CloudWatch et sur le volume de données envoyées à Kinesis Data Firehose. Il est possible que vos coûts CloudWatch augmentent pour le sous-ensemble de métriques que vous diffusez. Pour cette raison, Datadog vous recommande d’utiliser en priorité les flux de métriques pour les services, régions et comptes AWS pour lesquels vous avez le plus besoin d’une faible latence. Pour en savoir plus, consultez la page Tarification Amazon CloudWatch .

Les métriques EC2 ou Lambda du flux peuvent entraîner une augmentation du nombre d’appels Lambda et de hosts facturables (si ces hosts et fonctions ne sont pas déjà surveillés avec l’intégration AWS ou l’Agent Datadog, dans le cas d’EC2).

Configuration

Avant de commencer

  1. Lisez attentivement la section Comparaison entre les flux de métriques et l’API pour bien comprendre les différences entre les deux solutions avant d’activer les flux de métriques.

  2. Si vous ne l’avez pas encore fait, connectez votre compte AWS à Datadog. Pour en savoir plus, consultez les instructions de configuration de CloudFormation .

Installation

Datadog recommande d’utiliser CloudFormation pour bénéficier d’un processus automatique et plus pratique si vous utilisez plusieurs régions AWS.

  1. Sur votre site Datadog, accédez à l’onglet Configuration de la page d’intégration AWS .
  2. Cliquez sur le compte AWS pour configurer la diffusion de métriques.
  3. Sous Metric Collection, cliquez sur Automatically Using CloudFormation en dessous de CloudWatch Metric Streams pour lancer une pile dans la console AWS.
La section CloudWatch Metric Streams de l'onglet Metric Collection de la page d'intégration AWS avec le bouton Automatically Using CloudFormation mis en évidence
  1. Renseignez les paramètres requis :
    • ApiKey : ajoutez votre clé d’API Datadog .
    • DdSite : sélectionnez votre site Datadog , à savoir .
    • Regions : ajoutez la liste des régions, séparées par des virgules, que vous souhaitez configurer pour la diffusion de métriques. Pour obtenir la liste complète des régions prises en charge, consultez la page Utilisation des flux de métriques de la documentation AWS.
  2. Vous pouvez définir des paramètres facultatifs :
    • FilterMethod : liste d’inclusion ou d’exclusion d’espaces de nommage pour la diffusion de métriques.
    • First/Second/Third Namespace : indiquez les espaces de nommage à inclure ou exclure. Remarque : les valeurs d’espace de nommage doivent correspondre précisément aux valeurs indiquées dans la colonne d’espace de nommage de la documentation AWS. Exemple : AWS/EC2.
  3. Cochez la case d’acceptation indiquant “I acknowledge that AWS CloudFormation might create IAM resources with custom names.”
  4. Cliquez sur Create Stack.

Résultats

Une fois la pile créée, patientez cinq minutes le temps que Datadog détecte la modification. Pour vous en assurer, accédez à l’onglet Metric Collection de la page d’intégration AWS de Datadog et vérifiez que les régions activées apparaissent pour le compte sélectionné.

La section CloudWatch Metric Streams de l'onglet Metric Collection de la page d'intégration AWS avec une région activée

Si vous souhaitez configurer les flux de métriques à l’aide de la console AWS, procédez comme suit pour chaque région AWS.

  1. Créez un nouveau flux de diffusion Kinesis Data Firehose avec les caractéristiques suivantes :

    • Source : sélectionnez Direct PUT.
    • Destination :
      • Sélectionnez Datadog.
      • Sélectionnez l’URL de l’endpoint de métriques correspondant à votre site Datadog, Datadog metrics - US ou Datadog metrics - EU.
    • API key : saisissez votre clé d’API Datadog .
    • Retry duration : saisissez 60 seconds.
    • S3 backup bucket : sélectionnez Failed data only et choisissez le compartiment S3 de votre choix pour la sauvegarde.
    • Conditions de mise en mémoire tampon de l’endpoint HTTP :
      • Saisissez 4MB pour la taille du tampon et 60 seconds pour l’intervalle.
    • Conditions de mise en mémoire tampon S3 :
      • Saisissez 4MB pour la taille du tampon et 60 seconds pour l’intervalle.
    • S3 compression and encryption : sélectionnez GZIP.
    • Sous Advanced settings, activez Amazon CloudWatch error logging.
  2. Suivez les étapes suivantes pour créer votre flux de métriques CloudWatch  :

  3. Précisez si vous voulez diffuser toutes les métriques CloudWatch ou seulement certains espaces de nommage spécifiques.

    Flux de métriques CloudWatch
  4. Sélectionnez le Firehose que vous avez créé lors de la première étape et que vous souhaitez utiliser pour envoyer les métriques à Datadog.

    Firehose
  5. Créez un nouveau rôle de service pour importer des enregistrements dans Kinesis Data Firehose.

  6. Définissez le format de sortie OpenTelemetry 0.7.

  7. Sous Add additional statistics, incluez les métriques de centile AWS à envoyer à Datadog. Référez-vous au modèle CloudFormation pour consulter la liste des métriques de centile prises en charge par Datadog via le processus d’interrogation.

    Centiles
  8. Nommez votre flux de métriques.

  9. Cliquez sur Create metric stream.

Résultats

Une fois la ressource de flux de métriques créée, patientez cinq minutes le temps que Datadog détecte la modification. Pour vous en assurer, accédez à l’onglet Metric Collection de la page d’intégration AWS de Datadog et vérifiez que les régions activées sont indiquées comme tel sous CloudWatch Metric Streams pour le compte AWS spécifié.

La section CloudWatch Metric Streams de l'onglet Metric Collection de la page d'intégration AWS avec une région activée

Remarque : si vous avez déjà activé l’interrogation des API CloudWatch, le changement de méthode peut entraîner la diffusion en double des métriques configurées lors d’une courte période (cinq minutes maximum). Cette duplication est causée par l’écart entre le moment où les crawlers Datadog exécutent et envoient vos métriques CloudWatch et le moment où Datadog détecte la diffusion de ces métriques et désactive les crawlers.

Désactiver la diffusion de métriques

Pour désactiver complètement la diffusion de métriques pour un compte et une région AWS donnés, vous devez supprimer le flux de métriques AWS et les ressources associées. Pour empêcher toute perte de métriques dans Datadog, assurez-vous de bien suivre ces étapes de suppression :

Si vous avez configuré la diffusion avec CloudFormation  :

  1. Supprimez la pile créée durant la configuration.

Si vous avez configuré la diffusion avec la Console AWS  :

  1. Supprimez le flux de métriques CloudWatch lié à votre flux de diffusion.
  2. Supprimez le flux de diffusion Kinesis Data Firehose qui était utilisé pour transmettre les métriques à Datadog.
  3. Supprimez le compartiment S3 de sauvegarde où arrivaient les messages n’ayant pas pu être transmis pour le Firehose.
  4. Supprimez les rôles IAM associés au flux et toutes les autres ressources créées lors de la configuration du flux.

Une fois les ressources supprimées, patientez cinq minutes le temps que Datadog détecte la modification. Pour vous en assurer, accédez à l’onglet Metric Collection de la page d’intégration AWS de Datadog et vérifiez que les régions désactivées ne sont pas affichées sous CloudWatch Metric Streams pour le compte AWS spécifié.

Dépannage

Pour résoudre les problèmes rencontrés lors de la configuration des flux de métriques ou des ressources associées, consultez la section Dépannage de la documentation AWS.

Pour aller plus loin