

# Coleta de métricas, logs e rastreamentos usando o agente do CloudWatch
<a name="Install-CloudWatch-Agent"></a>

O agente do CloudWatch é um componente de software que coleta métricas, logs e rastreamentos de suas instâncias do Amazon EC2, servidores on-premises e aplicações em contêineres. Esse componente possibilita que você monitore a infraestrutura e as aplicações de forma mais abrangente em comparação com o monitoramento básico fornecido por padrão. 

**Benefícios principais**
+ Coletar métricas em nível de sistema (incluindo CPU, memória, disco e rede) 
+ Reunir métricas personalizadas provenientes das suas aplicações
+ Coletar e centralizar logs provenientes de várias fontes
+ Monitorar ambientes da AWS e on-premises com uma única ferramenta 
+ Configurar alarmes e notificações com base nos dados coletados 

O agente do CloudWatch possibilita que você realize as seguintes ações:
+ Colete métricas internas no nível do sistema de instâncias do Amazon EC2 entre sistemas operacionais. As métricas podem incluir métricas de convidados, além das métricas para instâncias do EC2. As métricas adicionais que podem ser coletadas são listadas em [Métricas coletadas pelo atendente do CloudWatch](metrics-collected-by-CloudWatch-agent.md).
+ Colete métricas no nível do sistema dos servidores on-premises. Isso pode incluir servidores em um ambiente híbrido, bem como servidores não gerenciados pela AWS.
+ Recupere métricas personalizadas de suas aplicações ou serviços usando os protocolos `StatsD` e `collectd`. O protocolo `StatsD` é compatível com os servidores Linux e que executam o Windows Server. `collectd` tem suporte somente em servidores Linux.
+ Colete os logs das instâncias do Amazon EC2 e dos servidores on-premises que executam o Linux ou o Windows Server.
**nota**  
O atendente do CloudWatch não é compatível com a coleta de logs de pipes FIFO.
+ Envie as métricas para o CloudWatch ou o Amazon Managed Service for Prometheus, ou para ambos. O arquivo de configuração do agente do CloudWatch contém um parâmetro `metrics_destinations` na seção de `metrics`. Você pode especificar `cloudwatch`, `amp` ou ambos nesse parâmetro.
+ A versão 1.300031.0 e as versões posteriores podem ser usadas para habilitar o CloudWatch Application Signals. Para obter mais informações, consulte [Application Signals](CloudWatch-Application-Monitoring-Sections.md).
+ A versão 1.300025.0 e posteriores podem coletar rastros dos SDKs do cliente [OpenTelemetry](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-opentel) ou do [X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-xray-sdk) e enviá-los ao X-Ray.

  O uso do agente do CloudWatch permite coletar rastreamentos sem a necessidade de executar um daemon separado para a coleta de rastreamento, o que ajuda a reduzir o número de agentes que você executa e gerencia.

As métricas enviadas para o CloudWatch podem ser visualizadas no CloudWatch da mesma forma que quaisquer outras métricas do CloudWatch. O namespace do CloudWatch padrão para métricas coletadas pelo atendente do CloudWatch é `CWAgent`, embora seja possível especificar um namespace diferente quando você configura o atendente.

Os logs coletados pelo agente do CloudWatch são processados e armazenados no Amazon CloudWatch Logs, assim como os logs coletados pelo antigo agente do CloudWatch Logs. Para obter informações sobre o preço do CloudWatch Logs, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing).

As métricas coletadas pelo atendente do CloudWatch são cobradas como métricas personalizadas. Para obter mais informações sobre o preço de métricas do CloudWatch, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing).

O atendente do CloudWatch tem código aberto sob a licença do MIT e é [hospedado no GitHub](https://github.com/aws/amazon-cloudwatch-agent/). Para desenvolver, personalizar ou contribuir com o atendente do CloudWatch, consulte o repositório do GitHub para obter as instruções mais recentes. Ao achar que encontrou um possível problema de segurança, não o publique no GitHub ou em qualquer fórum público. Em vez disso, siga as instruções em [Relatório de vulnerabilidade](https://aws.amazon.com/security/vulnerability-reporting/) ou [envie um e-mail diretamente para a segurança da AWS](mailto:aws-security@amazon.com).

Você pode fazer o download e instalar o agente do CloudWatch manualmente por meio da linha de comando, ou integrá-lo com o AWS Systems Manager. O fluxo geral para a instalação do agente do CloudWatch é o seguinte:

1. Crie perfis ou usuários do IAM que possibilitam ao agente coletar métricas do servidor e, opcionalmente, integrar-se com o AWS Systems Manager.

1. Fazer download do pacote do atendente.

1. Modificar o arquivo de configuração do atendente do CloudWatch e especificar as métricas que você deseja coletar.

1. Instalar e iniciar o atendente em seus servidores.

**Topics**
+ [Sistemas operacionais compatíveis](supported-operating-systems.md)
+ [Pré-requisitos](prerequisites.md)
+ [Baixar o pacote do atendente do CloudWatch](download-CloudWatch-Agent-on-EC2-Instance-commandline-first.md)
+ [Verificar a assinatura do pacote do atendente do CloudWatch](verify-CloudWatch-Agent-Package-Signature.md)
+ [Instalação do atendente do CloudWatch](install-CloudWatch-Agent-on-EC2-Instance.md)
+ [Configure o agente do CloudWatch com o Linux com segurança aprimorada (SELinux)](CloudWatch-Agent-SELinux.md)
+ [Criar o arquivo de configuração do atendente do CloudWatch](create-cloudwatch-agent-configuration-file.md)
+ [Iniciar o atendente do CloudWatch](start-CloudWatch-Agent-on-premise-SSM-onprem.md)
+ [Métricas coletadas pelo atendente do CloudWatch](metrics-collected-by-CloudWatch-agent.md)
+ [Usar o agente do CloudWatch com a telemetria relacionada](CloudWatch-Agent-RelatedEntities.md)
+ [Cenários comuns com o atendente do CloudWatch](CloudWatch-Agent-common-scenarios.md)
+ [Preferência de credenciais do agente do CloudWatch](CloudWatch-Agent-Credentials-Preference.md)
+ [Solucionar problemas do atendente do CloudWatch](troubleshooting-CloudWatch-Agent.md)