As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Início rápido: instale e configure o agente CloudWatch Logs em uma instância do EC2 Linux na inicialização
**dica**
O antigo agente do CloudWatch Logs discutido nesta seção está prestes a ser descontinuado. É altamente recomendável que você use o novo CloudWatch agente unificado que pode coletar registros e métricas. Além disso, o agente CloudWatch Logs mais antigo exige o Python 3.3 ou anterior, e essas versões não são instaladas em novas instâncias do EC2 por padrão. Para obter mais informações sobre o CloudWatch agente unificado, consulte [Instalando o CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
O restante desta seção explica o uso do antigo agente CloudWatch Logs.
## Instalando o agente CloudWatch Logs antigo em uma instância Linux do EC2 na inicialização
Você pode usar os dados do usuário do Amazon EC2, um recurso do Amazon EC2 que permite que informações paramétricas sejam passadas para a instância na inicialização, para instalar e configurar CloudWatch o agente Logs nessa instância. Para passar as informações de instalação e configuração do agente CloudWatch Logs para o Amazon EC2, você pode fornecer o arquivo de configuração em um local de rede, como um bucket do Amazon S3.
A configuração de várias fontes de log para enviar dados a um único stream de logs não é suportada.
**Pré-requisito**
Crie um arquivo de configuração do agente que descreva todos os seus grupos e streams de logs. Trata-se de um arquivo de texto que descreve os arquivos de log a serem monitorados, bem como os grupos e os streams de logs para os quais será feito upload deles. O agente consome esse arquivo de configuração e inicia o monitoramento e o upload de todos os arquivos de log descritos nele. Para obter mais informações sobre as configurações no arquivo de configuração do agente, consulte [CloudWatch Referência do agente de registros](AgentReference.md).
Veja a seguir o exemplo de um arquivo de configuração do agente para o Amazon Linux 2
```
[general]
state_file = /var/lib/awslogs/state/agent-state
[/var/log/messages]
file = /var/log/messages
log_group_name = /var/log/messages
log_stream_name = {instance_id}
datetime_format = %b %d %H:%M:%S
```
Veja a seguir uma amostra de um arquivo de configuração do agente para o Ubuntu
```
[general]
state_file = /var/awslogs/state/agent-state
[/var/log/syslog]
file = /var/log/syslog
log_group_name = /var/log/syslog
log_stream_name = {instance_id}
datetime_format = %b %d %H:%M:%S
```
**Para configurar sua função do IAM**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, escolha **Políticas**, **Criar política**.
1. Na página **Criar política**, em **Criar sua própria política**, escolha **Selecionar**. Para obter mais informações sobre a criação de políticas personalizadas, consulte [Políticas do IAM para o Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policies-for-amazon-ec2.html) no *Manual do usuário do Amazon EC2*.
1. Na página **Revisar política**, em **Nome da política**, digite um nome para a política.
1. Em **Documento da política**, cole a política a seguir:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Resource": [
"arn:aws:logs:*:*:*"
]
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
1. Escolha **Criar política**.
1. No painel de navegação, escolha **Funções**, **Criar nova função**.
1. Na página **Definir nome da função**, digite um nome para a função e escolha **Próxima etapa**.
1. Na página **Selecionar tipo de função**, escolha **Selecionar** ao lado de **Amazon EC2**.
1. Na página **Anexar política**, no cabeçalho da tabela escolha **Tipo de política**, **Gerenciado pelo cliente**.
1. Selecione a política do IAM que você acabou de criar e escolha **Next Step** (Próxima etapa).
1. Selecione **Criar função**.
Para obter mais informações sobre usuários e políticas, consulte [Usuários e grupos do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_WorkingWithGroupsAndUsers.html) e [Gerenciar políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html) no *Guia do usuário do IAM*.
**Para iniciar uma nova instância e ativar CloudWatch os registros**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Escolha **Executar instância**.
Para obter mais informações, consulte [Iniciar uma instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/launching-instance.html) no *Manual do usuário do Amazon EC2*.
1. Na página **Etapa 1: escolher uma Imagem de Máquina da Amazon (AMI)**, selecione o tipo de instância Linux para iniciar e, em seguida, na página **Etapa 2: escolher um tipo de instância**, selecione **Próximo: configurar detalhes da instância**.
Certifique-se de que [cloud-init](http://cloudinit.readthedocs.org/en/latest/index.html) seja incluído na sua Imagem de máquina da Amazon (AMI). O Amazon Linux AMIs e AMIs o Ubuntu e o RHEL já incluem o cloud-init, mas o CentOS e outros talvez não. AMIs AWS Marketplace
1. Na página **Etapa 3: Configurar detalhes da instância**, em **IAM role** (Função do IAM), selecione a função do IAM que você criou.
1. Em **Detalhes avançados**, em **Dados do usuário**, cole o script a seguir na caixa. Em seguida, atualize esse script alterando o valor da opção **-c** para o local do seu arquivo de configuração do agente:
```
#!/bin/bash
curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/awslogs-agent-setup.py -O
chmod +x ./awslogs-agent-setup.py
./awslogs-agent-setup.py -n -r us-east-1 -c {{s3://amzn-s3-demo-bucket/my-config-file}}
```
1. Faça todas as outras alterações para a instância, revise suas configurações de execução e, em seguida, escolha **Iniciar**.
1. Você deve ver o grupo de registros e o stream de registros recém-criados no CloudWatch console depois que o agente estiver em execução por alguns instantes.
Para obter mais informações, consulte [Exibir dados de registro enviados para CloudWatch Logs](Working-with-log-groups-and-streams.md#ViewingLogData).