Récupération de métriques personnalisées avec StatsD - Amazon CloudWatch
Afficher les métriques StatsD importées par l'agent CloudWatch

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.

Récupération de métriques personnalisées avec StatsD

Vous pouvez récupérer des métriques personnalisées supplémentaires à partir de vos applications ou services à l'aide de l' CloudWatchagent associé au StatsD protocole. StatsD est une solution open source populaire qui peut collecter des métriques à partir d'une grande variété d'applications. StatsD est particulièrement utile pour instrumenter vos propres métriques. Pour un exemple d'utilisation conjointe de l' CloudWatch agent et de StatsD, consultez Comment mieux surveiller les métriques personnalisées de votre application à l'aide d'Amazon CloudWatch Agent.

StatsDest pris en charge à la fois sur les serveurs Linux et sur les serveurs exécutant Windows Server. CloudWatch prend en charge le StatsD format suivant :

MetricName:value|type|@sample_rate|#tag1:
  value,tag1...

  • MetricName – Une chaîne sans signe deux-points, sans barre, sans caractère # ou @.

  • value – Il peut s'agir d'un nombre entier ou à virgule flottante.

  • type – Spécifie c pour compteur, g pour jauge, ms pour minuteur, h pour histogramme ou s pour définir.

  • sample_rate – (Facultatif) Une valeur à virgule flottante comprise entre 0 et 1, inclus. À réserver aux métriques de compteur, d'histogramme et de minuteur. La valeur par défaut est 1 (échantillonnage 100 % du temps).

  • tags— (Facultatif) Liste de balises séparées par des virgules. StatsDles balises sont similaires aux dimensions de CloudWatch. Utilisez le signe deux-points pour les balises clé/valeur, telles que env:prod.

Vous pouvez utiliser n'importe quel StatsD client utilisant ce format pour envoyer les métriques à l' CloudWatch agent. Pour plus d'informations sur certains des StatsD clients disponibles, consultez la page du client StatsD sur. GitHub

Pour collecter ces métriques personnalisées, ajoutez une ligne "statsd": {} à la section metrics_collected du fichier de configuration de l'agent. Vous pouvez ajouter cette ligne manuellement. Si vous utilisez l'assistant pour créer le fichier de configuration, cette opération est faite à votre place. Pour de plus amples informations, consultez Création du fichier de configuration de CloudWatch l'agent.

La configuration par défaut du protocole StatsD fonctionne pour la plupart des utilisateurs. Il existe des champs facultatifs que vous pouvez ajouter à la section statsd du fichier de configuration de l'agent, le cas échéant :

  • service_address— L'adresse de service que l' CloudWatch agent doit écouter. Le format est le suivant ip:port. Si vous omettez l'adresse IP, l'agent écoute sur toutes les interfaces disponibles. Seul le UDP format est pris en charge, il n'est donc pas nécessaire de spécifier de UDP préfixe.

    La valeur par défaut est :8125.

  • metrics_collection_interval – Indique la fréquence, en secondes, d'exécution et de collecte des métriques par le plugin StatsD. La valeur par défaut est de 10 secondes. La plage est comprise entre 1 et 172 000.

  • metrics_aggregation_interval— À quelle fréquence, en secondes, CloudWatch agrège les métriques en points de données uniques. La valeur par défaut est de 60 secondes.

    Par exemple, si la valeur metrics_collection_interval est égale à 10 et metrics_aggregation_interval à 60, CloudWatch collecte des données toutes les 10 secondes. Après chaque minute, les six relevés de données de cette minute sont agrégés en un seul point de données, qui est envoyé à CloudWatch.

    La plage est comprise entre 0 et 172 000. Le fait de définir metrics_aggregation_interval sur zéro désactive le regroupement de métriques StatsD.

  • allowed_pending_messages— Le nombre de UDP messages autorisés à être placés en file d'attente. Lorsque la file d'attente est pleine, le serveur StatsD commence à supprimer des paquets. La valeur par défaut est 10 000.

  • drop_original_metrics : facultatif. Si vous utilisez le champ aggregation_dimensions de la section metrics pour regrouper les métriques dans des résultats agrégés, l'agent envoie par défaut les métriques agrégées et les métriques d'origine qui sont séparées pour chaque valeur de la dimension. Si vous ne souhaitez pas que les mesures d'origine soient envoyées à CloudWatch, vous pouvez spécifier ce paramètre avec une liste de mesures. Les mesures spécifiées avec ce paramètre ne sont pas signalées à CloudWatch. Au lieu de cela, seules les métriques agrégées sont signalées. Cela réduit le nombre de métriques collectées par l'agent, ce qui réduit vos coûts.

Voici un exemple de la section statsd du fichier de configuration de l'agent, qui utilise le port par défaut et des intervalles de collecte et de regroupement personnalisés.

{
   "metrics":{
      "metrics_collected":{
         "statsd":{
            "service_address":":8125",
            "metrics_collection_interval":60,
            "metrics_aggregation_interval":300
         }
      }
   }
}

Afficher les métriques StatsD importées par l'agent CloudWatch

Après avoir importé les métriques StatsD dans CloudWatch, vous pouvez les visualiser sous forme de graphiques chronologiques et créer des alarmes qui peuvent surveiller ces métriques et vous avertir si elles dépassent un seuil que vous spécifiez. La procédure suivante montre comment afficher les métriques StatsD sous la forme d'un graphique de séries chronologiques. Pour plus d'informations sur la configuration des alertes, consultez Utilisation des CloudWatch alarmes Amazon.

Pour afficher les métriques StatsD dans la console CloudWatch

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, sélectionnez ‎Métriques.

  3. Sélectionnez l'espace de noms pour les métriques collectées par l'agent. C'est le cas par défaut CWAgent, mais vous avez peut-être spécifié un espace de noms différent dans le fichier de configuration de l' CloudWatch agent.

  4. Sélectionnez une dimension de métrique (Per-Instance Metrics (Métriques par instance) par exemple).

  5. L'onglet All metrics (Toutes les métriques) affiche toutes les métriques pour cette dimension dans l'espace de nom. Vous pouvez effectuer les actions suivantes :

    1. Pour représenter graphiquement une métrique, cochez la case en regard de la métrique. Pour sélectionner toutes les métriques, cochez la case dans la ligne d’en-tête du tableau.

    2. Pour trier le tableau, utilisez l’en-tête de colonne.

    3. Pour filtrer par ressource, sélectionnez l'ID de ressource, puis Add to search Ajouter à la recherche).

    4. Pour filtrer par métrique, choisissez le nom de la métrique, puis Add to search (Ajouter à la recherche).

  6. (Facultatif) Pour ajouter ce graphique à un CloudWatch tableau de bord, choisissez Actions, puis Ajouter au tableau de bord.