Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch

role_arn: especifica o nome do recurso da Amazon (ARN) de um perfil do IAM a ser usado para autenticação ao enviar métricas, logs e rastreamentos a uma conta da AWS diferente. Para obter mais informações, consulte Envio de métricas, logs e rastreamentos a uma conta 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}" define o ID da AMI da instância como o valor da dimensão ImageId.

"InstanceId":"${aws:InstanceId}" define o ID da instância como o valor da dimensão InstanceId.

"InstanceType":"${aws:InstanceType}" define o tipo de instância da instância como o valor da dimensão InstanceType.

"AutoScalingGroupName":"${aws:AutoScalingGroupName}" define o nome do grupo do Auto Scaling da instância como o valor da dimensão AutoScalingGroupName.

cloudwatch: Amazon CloudWatch.

amp: Amazon Managed Service for Prometheus.

role_arn: especifica o ARN de uma função do IAM a ser usada para autenticação ao enviar métricas a uma conta diferente. Para obter mais informações, consulte Envio de métricas, logs e rastreamentos a uma conta diferente. Se especificado aqui, esse valor substituirá o role_arn especificado na seção agent do arquivo de configuração, se houver.

service.name: opcional. Especifica o nome do serviço a ser usado para preencher a entidade para encontrar a telemetria relacionada.

deployment.environment: opcional. Especifica o nome do ambiente a ser usado para preencher a entidade para encontrar a telemetria relacionada.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

resources: opcional. Especifique esse campo com um valor de * para fazer com que as métricas por CPU sejam coletadas. O único valor permitido é *.

totalcpu: opcional. Especifica se as métricas de cpu agregadas em todos os núcleos de cpu serão relatadas. O padrão é true.

measurement: especifica a matriz de métricas de cpu a serem coletadas. Os valores possíveis são 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 e usage_user. Esse campo será obrigatório se você incluir cpu.

Por padrão, a unidade para métricas de cpu_usage_* é Percent, e as métricas cpu_time_* não têm uma unidade.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de cpu, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos. Por exemplo, a especificação de 10 faz com que as métricas sejam coletadas a cada 10 segundos. Uma configuração de 300 especifica que as métricas sejam coletadas a cada 5 minutos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de cpu. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions global que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

resources: opcional. Especifica uma matriz de pontos de montagem de disco. Esse campo limita o CloudWatch a coletar métricas apenas dos pontos de montagem listados. Você pode especificar * como o valor para coletar métricas de todos os pontos de montagem. O valor padrão é coletar métricas de todos os pontos de montagem.

measurement: especifica a matriz de métricas de disco a serem coletadas. Os valores possíveis são free, total, used, used_percent, inodes_free, inodes_used e inodes_total. Esse campo será obrigatório se você incluir disk.

Para ver as unidades padrão para cada métrica de disk, consulte Métricas coletadas pelo atendente do CloudWatch em instâncias do Linux e macOS.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

ignore_file_system_types: especifica os tipos de sistema de arquivos a serem excluídos ao coletar métricas de disco. Os valores válidos incluem sysfs, devtmpfs, e assim por diante.

drop_device: definir isso como true fará com que Device não seja incluído como uma dimensão para as métricas de disco.

Impedir que Device seja usado como uma dimensão pode ser útil em instâncias que usam o sistema Nitro porque, nessas instâncias, os nomes dos dispositivos mudam para cada montagem de disco quando a instância é reinicializada. Isso pode causar dados inconsistentes em suas métricas e fazer com que os alarmes com base nessas métricas entrem no estado INSUFFICIENT DATA.

O padrão é false.

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de disco, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações, consulte Métricas de alta resolução.

append_dimensions: opcional. Especifique pares de chave-valor para serem usadas como dimensões adicionais apenas para métricas de disco. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

Veja a seguir um par de chave-valor que você pode usar. Você também pode especificar outros pares personalizados de chave-valor.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

resources: opcional. Se você especificar uma matriz de dispositivos, o CloudWatch coletará métricas apenas desses dispositivos. Caso contrário, serão coletadas métricas para todos os dispositivos. Você também pode especificar * como valor para coletar métricas de todos os dispositivos.

measurement: especifica a matriz de métricas de e/s de disco a serem coletadas. Os valores possíveis são reads, writes, read_bytes, write_bytes, read_time, write_time, io_time e iops_in_progress. Esse campo será obrigatório se você incluir diskio.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de diskio, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de diskio. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

measurement: especifica a matriz de métricas de swap a serem coletadas. Os valores possíveis são free, used e used_percent. Esse campo será obrigatório se você incluir swap.

Para ver as unidades padrão para cada métrica de swap, consulte Métricas coletadas pelo atendente do CloudWatch em instâncias do Linux e macOS.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de memória de permuta, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de memória de permuta. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions global que é usado para todos os tipos de métricas coletadas pelo atendente. É coletado como uma métrica de alta resolução.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

measurement: especifica a matriz de métricas de memória a serem coletadas. Os valores possíveis são active, available, available_percent, buffered, cached, free, inactive, total, used e used_percent. Esse campo será obrigatório se você incluir mem.

Para ver as unidades padrão para cada métrica de mem, consulte Métricas coletadas pelo atendente do CloudWatch em instâncias do Linux e macOS.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de memória, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de memória. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

resources: opcional. Se você especificar uma matriz de interfaces de rede, o CloudWatch coletará métricas apenas dessas interfaces. Caso contrário, serão coletadas métricas para todos os dispositivos. Você também pode especificar * como o valor para coletar métricas de todas as interfaces.

measurement: especifica a matriz de métricas de redes a serem coletadas. Os valores possíveis são bytes_sent, bytes_recv, drop_in, drop_out, err_in, err_out, packets_sent e packets_recv. Esse campo será obrigatório se você incluir net.

Para ver as unidades padrão para cada métrica de net, consulte Métricas coletadas pelo atendente do CloudWatch em instâncias do Linux e macOS.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de redes, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos. Por exemplo, a especificação de 10 faz com que as métricas sejam coletadas a cada 10 segundos. Uma configuração de 300 especifica que as métricas sejam coletadas a cada 5 minutos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de redes. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

measurement: especifica a matriz de métricas de netstat a serem coletadas. Os valores possíveis são 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 e udp_socket. Esse campo será obrigatório se você incluir netstat.

Para ver as unidades padrão para cada métrica de netstat, consulte Métricas coletadas pelo atendente do CloudWatch em instâncias do Linux e macOS.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de netstat, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações sobre as métricas de alta resolução, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de netstat. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

measurement: especifica a matriz de métricas de processos a serem coletadas. Os valores possíveis são blocked, dead, idle, paging, running, sleeping, stopped, total, total_threads, wait e zombies. Esse campo será obrigatório se você incluir processes.

Para todas as métricas processes, a unidade padrão é None.

Dentro da entrada de cada métrica individual, você também poderá especificar opcionalmente uma ou ambas as opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas de processos, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

Esse valor é especificado em segundos. Por exemplo, a especificação de 10 faz com que as métricas sejam coletadas a cada 10 segundos. Uma configuração de 300 especifica que as métricas sejam coletadas a cada 5 minutos.

Se você definir esse valor abaixo de 60 segundos, cada métrica será coletada como uma métrica de alta resolução. Para obter mais informações, consulte Métricas de alta resolução.

append_dimensions: opcional. Dimensões adicionais a serem usadas somente para métricas de processo. Se você especificar esse campo, ele será usado em complemento às dimensões especificadas no campo append_dimensions que é usado para todos os tipos de métricas coletadas pelo atendente.

drop_original_metrics: opcional. Se você estiver usando o campo aggregation_dimensions na seção metrics para agrupar métricas em resultados agregados, por padrão, o agente enviará as métricas agregadas e as métricas originais que são separadas para cada valor da dimensão. Se você não quiser que as métricas originais sejam enviadas ao CloudWatch, é possível especificar esse parâmetro com uma lista de métricas. As métricas especificadas junto a esse parâmetro não têm suas métricas por dimensão relatadas ao CloudWatch. Em vez disso, somente as métricas agregadas são relatadas. Isso reduz o número de métricas que o agente coleta, reduzindo seus custos.

measurement: especifica a matriz de métricas GPU NVIDIA a serem coletadas. Para obter uma lista dos valores de uso possíveis, consulte a coluna Metric (Métrica) na tabela em Colete métricas de GPU NVIDIA.

Na entrada de cada métrica individual, você também poderá especificar uma ou ambas das seguintes opções:

metrics_collection_interval: opcional. Especifica a frequência da coleta de métricas GPU NVIDIA, substituindo o metrics_collection_interval global especificado na seção agent do arquivo de configuração.

files: especifica os arquivos de log regulares que deverão ser coletados pelo atendente do CloudWatch. Contém um campo, collect_list, que define melhor esses arquivos.

A seção windows_events especifica os tipos de eventos do Windows a serem coletados de servidores que executam o Windows Server. Isso inclui os seguintes campos:

role_arn: especifica o ARN de uma função do IAM a ser usada para autenticação ao enviar logs para outra conta da AWS. Para obter mais informações, consulte Envio de métricas, logs e rastreamentos a uma conta diferente. Se especificado aqui, isso substitui o role_arn especificado na seção agent do arquivo de configuração, se houver.

application_signals (Opcional) Especifica que você deseja habilitar o CloudWatch Application Signals. Para obter mais informações sobre essa configuração, consulte Habilitar o CloudWatch Application Signals.

kubernetes: esse campo pode conter um parâmetro do enhanced_container_insights, que você pode usar para ativar o Container Insights com observabilidade aprimorada para o Amazon EKS.

emf – Para coletar métricas incorporadas em logs, não é mais necessário adicionar esse campo emf. um campo herdado que especifica que o atendente deve coletar logs que estão em formato de métrica incorporada. É possível gerar dados de métrica a partir desses logs. Para obter mais informações, consulte Incorporação de métricas em logs.

otlp: opcional. Especifica que você deseja coletar métricas do SDK do OpenTelemetry. Para obter mais informações sobre os campos que você pode usar nesta seção, consulte Coletar métricas e rastreamentos com o OpenTelemetry.

application_signals: opcional. Especifica que você deseja habilitar o CloudWatch Application Signals. Para obter mais informações sobre essa configuração, consulte Habilitar o CloudWatch Application Signals.

xray: opcional. Especifica que você deseja coletar rastreamentos do SDK do X-Ray. A seção pode incluir os seguintes campos:

otlp: opcional. Especifica que você deseja coletar rastreamentos do SDK do OpenTelemetry. Para obter mais informações sobre os campos que você pode usar nesta seção, consulte Coletar métricas e rastreamentos com o OpenTelemetry. Para obter mais informações sobre o AWS Distro for OpenTelemetry, consulte AWS Distro for OpenTelemetry. Para obter mais informações sobre o AWS Distro para SDKs do OpenTelemetry, consulte a Introdução.

A seção pode incluir os seguintes campos:

role_arn: especifica o ARN de um perfil do IAM a ser usado para autenticação ao enviar rastreamentos para outra conta da AWS. Para obter mais informações, consulte Envio de métricas, logs e rastreamentos a uma conta diferente. Se especificado aqui, isso substitui o role_arn especificado na seção agent do arquivo de configuração, se houver.