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á.

# Enviar registros CodeDeploy do agente para CloudWatch
<a name="codedeploy-agent-operations-cloudwatch-agent"></a>

Você pode enviar dados métricos e de registro do CodeDeploy agente para CloudWatch usar o [ CloudWatch agente unificado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) ou, mais simplesmente, o CloudWatch agente.

Use as instruções a seguir para instalar o CloudWatch agente e configurá-lo para uso com CodeDeploy agentes.

## Pré-requisitos
<a name="codedeploy-agent-operations-cloudwatch-prerequisites"></a>

Antes de começar, conclua as seguintes tarefas:
+ Instale o CodeDeploy agente e verifique se ele está em execução. Para obter mais informações, consulte [Instale o CodeDeploy agente](codedeploy-agent-operations-install.md) e [Verifique se o CodeDeploy agente está em execução](codedeploy-agent-operations-verify.md).
+ Instale o CloudWatch agente. Para obter mais informações, consulte [Instalação do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Adicione as seguintes permissões ao perfil da instância CodeDeploy do IAM:
  + CloudWatchLogsFullAccess
  + CloudWatchAgentServerPolicy

  Para obter mais informações sobre o perfil da CodeDeploy instância, consulte [Etapa 4: criar um perfil de instância do IAM para as suas instâncias do Amazon EC2](getting-started-create-iam-instance-profile.md) of[Começando com CodeDeploy](getting-started-codedeploy.md).

## Configurar o CloudWatch agente para coletar CodeDeploy registros
<a name="codedeploy-agent-operations-cloudwatch-configure"></a>

Você pode configurar o CloudWatch agente percorrendo um assistente ou criando ou editando manualmente um arquivo de configuração.

**Para configurar o CloudWatch agente usando o assistente (Linux)**

1. Execute o assistente, conforme descrito em [Executar o assistente de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).

1. No atendente, quando perguntado `Do you want to monitor any log files?`, digite **1**.

1. Especifique o arquivo de log do CodeDeploy agente, da seguinte forma:

   1. Para `Log file path` inserir o caminho para o arquivo de CodeDeploy log, por exemplo:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.

   1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-log**.

   1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.

1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.

1. Especifique os registros de implantação do CodeDeploy agente, da seguinte forma:

   1. Para `Log file path` inserir o caminho para o arquivo CodeDeploy de log de implantação, por exemplo:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.

   1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-deployment-log**.

   1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.

1. Especifique os registros do atualizador do CodeDeploy agente, da seguinte forma:

   1. Para `Log file path` inserir o caminho para o arquivo de log do CodeDeploy atualizador, por exemplo:**/tmp/codedeploy-agent.update.log**.

   1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-updater-log**.

   1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-updater-log**.

**Para configurar o CloudWatch agente usando o assistente (Windows)**

1. Execute o assistente, conforme descrito em [Executar o assistente de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).

1. No atendente, quando perguntado `Do you want to monitor any customized log files?`, digite **1**.

1. Especifique o arquivo de CodeDeploy log, da seguinte forma:

   1. Para, `Log file path` insira o caminho ou o arquivo de log do CodeDeploy agente, por exemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.

   1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-log**.

   1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.

1. Quando perguntado `Do you want to specify any additional log files?`, insira **1**.

1. Especifique os registros de implantação do CodeDeploy agente, da seguinte forma:

   1. Para `Log file path` inserir o caminho do arquivo CodeDeploy de log de implantação, por exemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.

   1. Em `Log group name`, insira um nome de grupo de logs, por exemplo: **codedeploy-agent-deployment-log**.

   1. Em `Log stream name`, insira um nome de fluxo de logs, por exemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

**Para configurar o CloudWatch agente criando ou editando manualmente um arquivo de configuração (Linux)**

1. Crie ou edite o arquivo de configuração do CloudWatch agente conforme descrito em [Criar ou editar manualmente o arquivo de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).

1. Verifique se o arquivo se chama `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` e se ele contém o seguinte código:

   ```
   ...
   "logs": {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
                       "log_group_name": "codedeploy-agent-log",
                       "log_stream_name": "{instance_id}-agent-log"
                   },
                   {
                       "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
                       "log_group_name": "codedeploy-agent-deployment-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                   },
                   {
                       "file_path": "/tmp/codedeploy-agent.update.log",
                       "log_group_name": "codedeploy-agent-updater-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
                   }
               ]
           }
       }
   }
   ...
   ```

**Para configurar o CloudWatch agente criando ou editando manualmente um arquivo de configuração (Windows)**

1. Crie ou edite o arquivo de configuração do CloudWatch agente conforme descrito em [Criar ou editar manualmente o arquivo de configuração do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).

1. Verifique se o arquivo se chama `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` e se ele contém o seguinte código:

   ```
   ...
   "logs": {
           "logs_collected": {
               "files": {
                   "collect_list": [
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
                           "log_group_name": "codedeploy-agent-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-log"
                       },
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
                           "log_group_name": "codedeploy-agent-deployment-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                       }
                   ]
               },
               ...
           }
       },
   ...
   ```

## Reinicie o CloudWatch agente
<a name="codedeploy-agent-operations-cloudwatch-restart"></a>

Depois de fazer suas alterações, reinicie o CloudWatch agente conforme descrito em [Iniciar o CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).