Cree o edite de forma manual el archivo de configuración del agente de CloudWatch

role_arn: especifica el nombre de recurso de Amazon (ARN) de un rol de IAM que se va a utilizar para la autenticación al enviar métricas, registros y seguimientos a una cuenta de AWS diferente. Para obtener más información, consulte Envío de métricas, registros y seguimientos a una cuenta diferente.

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}" establece el ID de AMI de la instancia como el valor de la dimensión ImageId.

"InstanceId":"${aws:InstanceId}" establece el ID de instancia de la instancia como el valor de la dimensión InstanceId.

"InstanceType":"${aws:InstanceType}" establece el tipo de instancia de la instancia como el valor de la dimensión InstanceType.

"AutoScalingGroupName":"${aws:AutoScalingGroupName}" establece el nombre del grupo de Auto Scaling de la instancia como el valor de la dimensión AutoScalingGroupName.

cloudwatch: Amazon CloudWatch.

amp: Amazon Managed Service para Prometheus.

role_arn: especifica el ARN de un rol de IAM que se utilizará para la autenticación al enviar métricas a una cuenta diferente. Para obtener más información, consulte Envío de métricas, registros y seguimientos a una cuenta diferente. Si se especifica aquí, este valor sobrescribe el valor de role_arn especificado en la sección agent del archivo de configuración, si existe.

service.name: opcional. Especifica el nombre del servicio que se utilizará para rellenar la entidad y buscar la telemetría relacionada.

deployment.environment: opcional. Especifica el nombre del entorno que se utilizará para rellenar la entidad y buscar la telemetría relacionada.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

resources: opcional. Especifique este campo con un valor de * para provocar que se recopilen métricas por CPU. El único valor permitido es *.

totalcpu: opcional. Especifica si se registrarán las métricas de cpu agregadas en todos los núcleos de cpu. El valor predeterminado es true.

measurement: especifica la matriz de métricas de la cpu que se recopilarán. Los posibles valores son 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 y usage_user. Este campo es obligatorio si incluye cpu.

De forma predeterminada, la unidad de las métricas de cpu_usage_* es Percent, y las métricas de cpu_time_* no tienen una unidad.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de cpu, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos. Por ejemplo, indicar 10 hace que las métricas se deben recopilar cada 10 segundos y establecerlo en 300 especifica que las métricas se deben recopilar cada 5 minutos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de cpu. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions global que se utiliza para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

resources: opcional. Especifica una matriz de puntos de montaje de disco. Este campo limita a CloudWatch para recopilar métricas únicamente de los puntos de montaje en la lista. Puede especificar * como el valor para recopilar métricas de todos los puntos de montaje. El valor predeterminado es recopilar métricas de todos los puntos de montaje.

measurement: especifica la matriz de métricas de disco que se recopilarán. Los posibles valores son free, total, used, used_percent, inodes_free, inodes_used y inodes_total. Este campo es obligatorio si incluye disk.

Para ver las unidades predeterminadas de cada métrica de disk, consulte Métricas que el agente de CloudWatch recopila en instancias de Linux y de macOS.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

ignore_file_system_types: especifica los tipos de sistema de archivos que se excluirán al recopilar métricas de disco. Los valores válidos incluyen sysfs, devtmpfs, etc.

drop_device: cambiarlo a true hace que el Device no se incluya como una dimensión para las métricas de disco.

Evitar que el Device se utilice como dimensión puede resultar útil en las instancias que utilizan el sistema Nitro, ya que en dichas instancias los nombres de dispositivo cambian para cada montaje de disco cuando se reinicia la instancia. Esto puede provocar que los datos de las métricas sean incoherentes y que las alarmas basadas en estas métricas pasen al estado INSUFFICIENT DATA.

El valor predeterminado es false.

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de disco, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información, consulte Métricas de alta resolución.

append_dimensions: opcional. Especifique los pares de clave-valor que utilizará como dimensiones adicionales únicamente para las métricas de disco. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se usa para todos los tipos de métricas recopiladas por el agente.

Un par clave-valor que puede utilizar es el siguiente. También puede especificar otros pares de clave-valor personalizados.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

resources: opcional. Si especifica una matriz de dispositivos, CloudWatch recopila métricas solo de esos dispositivos. De lo contrario, se recopilan las métricas de todos los dispositivos. También puede especificar * como el valor para recopilar métricas de todos los dispositivos.

measurement: especifica la matriz de las métricas de disco que se recopilarán. Los valores posibles son reads, writes, read_bytes, write_bytes, read_time, write_time, io_time e iops_in_progress. Este campo es obligatorio si incluye diskio.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de entrada/salida de disco, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de entrada/salida de disco. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se usa para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

measurement: especifica la matriz de métricas de intercambio que se recopilarán. Los posibles valores son free, used y used_percent. Este campo es obligatorio si incluye swap.

Para ver las unidades predeterminadas de cada métrica de swap, consulte Métricas que el agente de CloudWatch recopila en instancias de Linux y de macOS.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de intercambio, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de intercambio. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions global que se usa para todos los tipos de métricas recopiladas por el agente. Se recopila como una métrica de alta resolución.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

measurement: especifica qué métricas de memoria se recopilarán. Los posibles valores son active, available, available_percent, buffered, cached, free, inactive, total, used y used_percent. Este campo es obligatorio si incluye mem.

Para ver las unidades predeterminadas de cada métrica de mem, consulte Métricas que el agente de CloudWatch recopila en instancias de Linux y de macOS.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de memoria, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de memoria. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se utiliza para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

resources: opcional. Si especifica una matriz de interfaces de red, CloudWatch recopila métricas solo de esas interfaces. De lo contrario, se recopilan las métricas de todos los dispositivos. También puede especificar * como el valor para recopilar métricas de todas las interfaces.

measurement: especifica la matriz de métricas de red que se recopilarán. Los valores posibles son bytes_sent, bytes_recv, drop_in, drop_out, err_in, err_out, packets_sent e packets_recv. Este campo es obligatorio si incluye net.

Para ver las unidades predeterminadas de cada métrica de net, consulte Métricas que el agente de CloudWatch recopila en instancias de Linux y de macOS.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de red, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos. Por ejemplo, indicar 10 hace que las métricas se deben recopilar cada 10 segundos y establecerlo en 300 especifica que las métricas se deben recopilar cada 5 minutos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de red. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se utiliza para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

measurement: especifica la matriz de métricas de netstat que se recopilarán. Los posibles valores son 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 y udp_socket. Este campo es obligatorio si incluye netstat.

Para ver las unidades predeterminadas de cada métrica de netstat, consulte Métricas que el agente de CloudWatch recopila en instancias de Linux y de macOS.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de estado de red, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información acerca de las métricas de alta resolución, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de estado de red. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se utiliza para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

measurement: especifica la matriz de métricas de procesos que se recopilarán. Los posibles valores son blocked, dead, idle, paging, running, sleeping, stopped, total, total_threads, wait y zombies. Este campo es obligatorio si incluye processes.

Para todas las métricas de processes, la unidad predeterminada es None.

En la entrada de cada métrica individual, puede especificar, si lo desea, uno o los dos valores siguientes:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de proceso, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

Este valor se especifica en segundos. Por ejemplo, indicar 10 hace que las métricas se deben recopilar cada 10 segundos y establecerlo en 300 especifica que las métricas se deben recopilar cada 5 minutos.

Si configura este valor por debajo de 60 segundos, cada métrica se recopila como una métrica de alta resolución. Para obtener más información, consulte Métricas de alta resolución.

append_dimensions: opcional. Las dimensiones adicionales que se utilizarán únicamente para las métricas de proceso. Si especifica este campo, se usa además de las dimensiones especificadas en el campo append_dimensions que se utiliza para todos los tipos de métricas recopiladas por el agente.

drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

measurement: especifica la matriz de métricas de GPU NVIDIA que se recopilarán. Para ver una lista de los valores posibles que se utilizarán aquí, consulte la columna Metric (Métrica) de la tabla de Recopilación de métricas de GPU NVIDIA.

En la entrada de cada métrica, puede especificar, si así lo desea, uno de los valores siguientes o ambos:

metrics_collection_interval: opcional. Especifica la frecuencia con la que se recopilarán las métricas de GPU NVIDIA, lo que anula el valor de metrics_collection_interval global especificado en la sección agent del archivo de configuración.

files: especifica qué archivos de registro regulares va a recopilar el agente de CloudWatch. Contiene un campo, collect_list, que define estos archivos.

La sección windows_events especifica el tipo de eventos de Windows que se recopilan de los servidores con Windows Server. Contiene los campos siguientes:

role_arn: especifica el ARN de un rol de IAM que se va a utilizar para la autenticación cuando se envían registros a una cuenta de AWS. Para obtener más información, consulte Envío de métricas, registros y seguimientos a una cuenta diferente. Si se especifica aquí, se sobrescribe el valor de role_arn especificado en la sección agent del archivo de configuración, si existe.

application_signals: (opcional) especifica que desea habilitar CloudWatch Application Signals. Para obtener más información sobre esta configuración, consulte Habilitación de CloudWatch Application Signals.

kubernetes: este campo puede contener un parámetro enhanced_container_insights que puede utilizar para habilitar Información de contenedores con una observabilidad mejorada en Amazon EKS.

emf: para recopilar las métricas integradas en los registros, ya no es necesario añadir este campo emf. Este es un campo legal que especifica que el agente debe recopilar los registros que están en formato de métrica integradas. Puede generar datos de métricas a partir de estos registros. Para obtener más información, consulte Incrustar métricas en los registros.

otlp: opcional. Especifica que desea recopilar métricas del SDK de OpenTelemetry. Para obtener más información sobre los campos que puede utilizar en esta sección, consulte Recopilación de métricas y seguimientos con OpenTelemetry.

application_signals: opcional. Especifica que desea habilitar CloudWatch Application Signals. Para obtener más información sobre esta configuración, consulte Habilitación de CloudWatch Application Signals.

xray: opcional. Especifica que desea recopilar seguimientos del SDK de X-Ray. Esta sección puede incluir los siguientes campos.

otlp: opcional. Especifica que desea recopilar seguimientos del SDK de OpenTelemetry. Para obtener más información sobre los campos que puede utilizar en esta sección, consulte Recopilación de métricas y seguimientos con OpenTelemetry. Para obtener más información acerca de AWS Distro para OpenTelemetry, consulte AWS Distro for OpenTelemetry. Para obtener más información sobre los SDK de AWS Distro para OpenTelemetry, consulte la Introducción.

Esta sección puede incluir los siguientes campos.

role_arn: especifica el ARN de un rol de IAM que se va a utilizar para la autenticación cuando se envían seguimientos a una cuenta de AWS. Para obtener más información, consulte Envío de métricas, registros y seguimientos a una cuenta diferente. Si se especifica aquí, se sobrescribe el valor de role_arn especificado en la sección agent del archivo de configuración, si existe.