Création ou modification manuelle du fichier de configuration de CloudWatch l'agent

role_arn – Spécifie l'Amazon Resource Name (ARN) d'un rôle IAM à utiliser pour l'authentification lors de l'envoi des métriques, des journaux et des traces à un compte AWS différent. Pour plus d’informations, consultez Envoi de métriques, de journaux et de traces à un autre compte.

LogDebug

LogDebugWithSigning

LogDebugWithHTTPBody

LogDebugRequestRetries

LogDebugWithEventStreamBody

Linux : /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log

Windows Server : c:\\ProgramData\\Amazon\\CloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log

"ImageId":"${aws:ImageId}" définit l'ID d'AMI de l'instance comme valeur de la dimension ImageId.

"InstanceId":"${aws:InstanceId}" définit l'ID d'instance de l'instance comme valeur de la dimension InstanceId.

"InstanceType":"${aws:InstanceType}" définit le type d'instance de l'instance comme valeur de la dimension InstanceType.

"AutoScalingGroupName":"${aws:AutoScalingGroupName}" définit le nom du groupe Auto Scaling de l'instance comme valeur de la dimension AutoScalingGroupName.

role_arn – Spécifie l'ARN d'un rôle IAM à utiliser pour l'authentification lors de l'envoi de métriques à un compte différent. Pour de plus amples informations, consultez Envoi de métriques, de journaux et de traces à un autre compte. Si elle est spécifiée ici, cette valeur remplace le role_arn spécifié dans la section agent du fichier de configuration, le cas échéant.

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.

resources : facultatif. Spécifiez ce champ avec la valeur * pour déclencher la collecte des métriques par uc. La seule valeur autorisée est *.

totalcpu – Facultatif. Indique s'il est nécessaire de signaler les métriques agrégées entre tous les cœurs de cpu. Par défaut, la valeur est true.

measurement – Spécifie l'éventail de métriques d'UC à collecter. Les valeurs possibles sont time_active, time_guest, time_guest_nice, time_idle, time_iowait, time_irq, time_nice, time_softirq, time_steal, time_system, time_user, usage_active, usage_guest, usage_guest_nice, usage_idle, usage_iowait, usage_irq, usage_nice, usage_softirq, usage_steal, usage_system et usage_user. Ce champ est obligatoire si vous incluez cpu.

Par défaut, l'unité pour les métriques cpu_usage_* est Percent et les métriques cpu_time_* n'ont pas d'unité.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques cpu, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes. Par exemple, en spécifiant 10, les métriques sont collectées toutes les 10 secondes, et en le fixant à 300, les métriques sont collectées toutes les 5 minutes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques cpu. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions global qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

resources – Facultatif. Spécifie un ensemble de points de montage de disque. Ce champ CloudWatch se limite à collecter des métriques uniquement à partir des points de montage répertoriés. Vous pouvez spécifier * comme valeur pour la collecter des métriques de tous les points de montage. La valeur par défaut consiste à collecter les métriques de tous points de montage.

measurement – Spécifie l'éventail de métriques de disque à collecter. Les valeurs possibles sont : free, total, used, used_percent, inodes_free, inodes_used et inodes_total. Ce champ est obligatoire si vous incluez disk.

Pour voir les unités par défaut de chaque métrique disk, consultez Métriques collectées par l' CloudWatchagent sur les instances Linux et macOS.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

ignore_file_system_types – Spécifie les types de systèmes de fichiers à exclure lors de la collecte des métriques de disque. Les valeurs valides sont sysfs, devtmpfs et ainsi de suite.

drop_device – Si vous définissez ce paramètre sur true, Device n'est pas inclus comme dimension pour les métriques de disque.

Empêcher Device d'être utilisé comme dimension peut être utile sur les instances qui font appel au système Nitro, car sur ces instances, les noms d'appareil changent pour chaque montage de disque lors du redémarrage de l'instance. Cela peut entraîner des données incohérentes dans vos métriques et faire en sorte que les alertes basées sur ces métriques passent à l'état INSUFFICIENT DATA.

La valeur par défaut est false.

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques disque, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour de plus amples informations, consultez Métriques haute résolution.

append_dimensions – Facultatif. Spécifiez les paires clé-valeur à utiliser comme dimensions supplémentaires uniquement pour les métriques du disque. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions qui est utilisé pour tous les types de métriques collectées par l'agent.

Voici une paire clé-valeur que vous pouvez utiliser. Vous pouvez également spécifier d'autres paires clé-valeur personnalisées.

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.

resources : facultatif. Si vous spécifiez un ensemble d'appareils, CloudWatch collecte les métriques uniquement à partir de ces appareils. Dans le cas contraire, les métriques de tous les appareils sont collectées. Vous pouvez aussi spécifier * comme valeur pour la collecter des métriques de tous les appareils.

measurement – Spécifie l'éventail de métriques diskio à collecter. Les valeurs possibles sont : reads, writes, read_bytes, write_bytes, read_time, write_time, io_time et iops_in_progress. Ce champ est obligatoire si vous incluez diskio.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques diskio, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques diskio. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

measurement – Spécifie l'éventail de métriques de swap à collecter. Les valeurs possibles sont free, used et used_percent. Ce champ est obligatoire si vous incluez swap.

Pour voir les unités par défaut de chaque métrique swap, consultez Métriques collectées par l' CloudWatchagent sur les instances Linux et macOS.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques swap, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques swap. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions global qui est utilisé pour tous les types de métriques collectées par l'agent. Elle est collectée sous la forme d'une métrique haute résolution.

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.

measurement – Spécifie l'éventail de métriques de mémoire à collecter. Les valeurs possibles sont : active, available, available_percent, buffered, cached, free, inactive, total, used et used_percent. Ce champ est obligatoire si vous incluez mem.

Pour voir les unités par défaut de chaque métrique mem, consultez Métriques collectées par l' CloudWatchagent sur les instances Linux et macOS.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques mem, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques mem. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions global qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

resources : facultatif. Si vous spécifiez un ensemble d'interfaces réseau, CloudWatch collecte les métriques uniquement à partir de ces interfaces. Dans le cas contraire, les métriques de tous les appareils sont collectées. Vous pouvez aussi spécifier * comme valeur pour collecter des métriques de toutes les interfaces.

measurement – Spécifie l'éventail de métriques de réseautage à collecter. Les valeurs possibles sont : bytes_sent, bytes_recv, drop_in, drop_out, err_in, err_out, packets_sent et packets_recv. Ce champ est obligatoire si vous incluez net.

Pour voir les unités par défaut de chaque métrique net, consultez Métriques collectées par l' CloudWatchagent sur les instances Linux et macOS.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques net, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes. Par exemple, en spécifiant 10, les métriques sont collectées toutes les 10 secondes, et en le fixant à 300, les métriques sont collectées toutes les 5 minutes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques net. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

measurement – Spécifie l'éventail de métriques netstat à collecter. Les valeurs possibles sont tcp_close, tcp_close_wait, tcp_closing, tcp_established, tcp_fin_wait1, tcp_fin_wait2, tcp_last_ack, tcp_listen, tcp_none, tcp_syn_sent, tcp_syn_recv, tcp_time_wait et udp_socket. Ce champ est obligatoire si vous incluez netstat.

Pour voir les unités par défaut de chaque métrique netstat, consultez Métriques collectées par l' CloudWatchagent sur les instances Linux et macOS.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques netstat, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour plus d'informations sur les métriques haute résolution, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques netstat. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

measurement – Spécifie l'éventail de métriques de processus à collecter. Les valeurs possibles sont : blocked, dead, idle, paging, running, sleeping, stopped, total, total_threads, wait et zombies. Ce champ est obligatoire si vous incluez processes.

Pour toutes les métriques processes, l'unité par défaut est None.

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval – Facultatif. Indique la fréquence de collecte des métriques processes, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

Cette valeur est spécifiée en secondes. Par exemple, en spécifiant 10, les métriques sont collectées toutes les 10 secondes, et en le fixant à 300, les métriques sont collectées toutes les 5 minutes.

Si vous définissez une valeur inférieure à 60 secondes, chaque métrique est collectée sous la forme d'une métrique haute résolution. Pour de plus amples informations, consultez Métriques haute résolution.

append_dimensions – Facultatif. Autres dimensions à utiliser pour seulement les métriques process. Si vous spécifiez ce champ, il est utilisé en plus des dimensions spécifiées dans le champ append_dimensions qui est utilisé pour tous les types de métriques collectées par l'agent.

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.

measurement – Spécifie l'éventail de métriques GPU NVIDIA à collecter. Pour obtenir une liste des valeurs possibles à utiliser ici, consultez la colonne Metric (Métrique) du tableau dans Collecter des métriques GPU NVIDIA .

Dans l'entrée de chaque métrique, vous pouvez, si vous le souhaitez, spécifier l'une des valeurs suivantes :

metrics_collection_interval : facultatif. Indique la fréquence de collecte des métriques GPU NVIDIA, en remplaçant la valeur metrics_collection_interval globale spécifiée dans la section agent du fichier de configuration.

files— Spécifie les fichiers journaux réguliers que l' CloudWatch agent doit collecter. Il contient un champ, collect_list, qui définit plus précisément ces fichiers.

La section windows_events indique le type d'événements Windows à collecter depuis les serveurs exécutant Windows Server. Il inclut les champs suivants :

role_arn— Spécifie l'ARN d'un rôle IAM à utiliser pour l'authentification lors de l'envoi de journaux vers un autre AWS compte. Pour plus d’informations, consultez Envoi de métriques, de journaux et de traces à un autre compte. S'il est spécifié ici, il remplace le role_arn spécifié dans la section agent du fichier de configuration, le cas échéant.

application_signals(Facultatif) Spécifie que vous souhaitez activer les signaux CloudWatch d'application. Pour plus d'informations sur cette configuration, consultezActiver les signaux CloudWatch d'application.

kubernetes : ce champ peut contenir un paramètre enhanced_container_insights que vous pouvez utiliser pour activer Container Insights avec une observabilité améliorée pour Amazon EKS.

emf : pour collecter des métriques intégrées dans des journaux, il n'est plus nécessaire d'ajouter ce champ emf. Il s'agit d'un champ hérité spécifiant que l'agent doit collecter les journaux au format de métrique intégrée. Vous pouvez générer des données de métriques à partir de ces journaux. Pour de plus amples informations, consultez Intégration de métriques dans les journaux.

application_signals : facultatif. Spécifie que vous souhaitez activer les signaux CloudWatch d'application. Pour plus d'informations sur cette configuration, consultezActiver les signaux CloudWatch d'application.

xray : facultatif. Spécifie que vous souhaitez collecter des traces à partir du kit SDK X-Ray. Cette section peut inclure les champs suivants :

otlp : facultatif. Spécifie que vous souhaitez collecter des traces à partir du OpenTelemetry SDK. Pour plus d'informations sur la AWS distribution pour OpenTelemetry, consultez la section AWS Distribution pour. OpenTelemetry Pour plus d'informations sur la AWS distribution pour les OpenTelemetry SDK, consultez la section Introduction.

Cette section peut inclure les champs suivants :

role_arn— Spécifie l'ARN d'un rôle IAM à utiliser pour l'authentification lors de l'envoi de traces vers un autre AWS compte. Pour plus d’informations, consultez Envoi de métriques, de journaux et de traces à un autre compte. S'il est spécifié ici, il remplace le role_arn spécifié dans la section agent du fichier de configuration, le cas échéant.