

# 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 rastros das instâncias do Amazon EC2, servidores on-premises e aplicações conteinerizadas. 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.

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 in-guest, além das métricas das instâncias do Amazon EC2. Para obter uma lista de todas as métricas que podem ser coletadas, consulte [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 vulnerabilidades](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)