Exibir dados de log para implantações do CodeDeploy EC2/On-Premises - AWS CodeDeploy
Visualizar logs no console do Amazon CloudWatch Visualizar arquivos de log em uma instância

Exibir dados de log para implantações do CodeDeploy EC2/On-Premises

É possível visualizar os dados de log criados por uma implantação do CodeDeploy configurando o agente do Amazon CloudWatch Logs para visualizar dados agregados no console do CloudWatch ou fazendo login em uma instância individual para examinar o arquivo de log.

nota

Logs não têm suporte para implantações da Lambda AWS ou Amazon ECS. Eles podem ser criados apenas para implantações de EC2/On-Premises.

Visualizar logs no console do Amazon CloudWatch

Quando o agente do Amazon CloudWatch está instalado em uma instância, os dados de implantação de todas as implantações nessa instância se tornam disponíveis para visualização no console do CloudWatch. Por questões de simplicidade, recomendamos usar o CloudWatch para monitorar arquivos de log centralmente em vez de visualizá-los caso a caso. Para obter mais informações, consulte Enviar logs do agente do CodeDeploy ao CloudWatch.

Visualizar arquivos de log em uma instância

Para visualizar dados de log de implantação para uma instância individual, você pode entrar nessa instância e procurar informações sobre erros ou outros eventos de implantação.

Para visualizar arquivos de log de implantação em instâncias do Amazon Linux, RHEL e Ubuntu Server

Em instâncias do Amazon Linux, do RHEL e do Ubuntu Server, os logs de implantação são armazenados no seguinte local:

/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log

Para visualizar ou analisar logs de implantação em instâncias do Amazon Linux, RHEL e do Ubuntu Server, faça login na instância e digite o seguinte comando para abrir o arquivo de log do agente do CodeDeploy:

less /var/log/aws/codedeploy-agent/codedeploy-agent.log

Digite os seguintes comandos para ver se há mensagens de erro no arquivo de log:

Command Resultado
& ERROR Mostrar apenas as mensagens de erro no arquivo de log. Use um único espaço antes e depois da palavra ERROR.
/ ERROR Procurar a próxima mensagem de erro.¹
? ERROR Pesquise a mensagem de erro anterior.² Use um único espaço antes e depois da palavra. ERROR
G Ir para o final do arquivo de log.
g Ir para o início do arquivo de log.
q Sair do arquivo de log.
h Saber mais sobre comandos adicionais.

¹ Depois de digitar / ERROR , digite n para a próxima mensagem de erro. Digite N para a mensagem de erro anterior.

² Depois de digitar ? ERROR , digite n para a próxima mensagem de erro ou digite N para a mensagem de erro anterior.

Você também pode digitar o seguinte comando para abrir um arquivo de log de scripts do CodeDeploy:

less /opt/codedeploy-agent/deployment-root/deployment-group-ID/deployment-ID/logs/scripts.log

Digite os seguintes comandos para ver se há mensagens de erro no arquivo de log:

Command Resultado
&stderr Mostrar apenas as mensagens de erro no arquivo de log.
/stderr Procurar a próxima mensagem de erro.¹
?stderr Procurar a mensagem de erro anterior.
G Ir para o final do arquivo de log.
g Ir para o início do arquivo de log.
q Sair do arquivo de log.
h Saber mais sobre comandos adicionais.

¹Depois de digitar /stderr, digite n para a próxima mensagem de erro adiante. Digite N para a mensagem de erro anterior retroativamente.

² Depois de digitar ?stderr, digite n para a próxima mensagem de erro anterior. Digite N para a mensagem de erro anterior adiante.

Para visualizar arquivos de logs de implantação em instâncias do Windows Server

Arquivo de log do agente do CodeDeploy: em instâncias do Windows Server, o arquivo de log do agente do CodeDeploy é armazenado no seguinte local:

C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt

Para visualizar ou analisar o arquivo de log do agente do CodeDeploy em uma instância do Windows Server, faça login nessa instância e digite o seguinte comando para abrir o arquivo:

notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt

Para procurar mensagens de erro no arquivo de log, pressione CTRL+F, digite ERROR [ e, em seguida, pressione Enter para encontrar o primeiro erro.

Arquivos de log de scripts do CodeDeploy: em instâncias do Windows Server, os logs de implantação são armazenados no seguinte local:

C:\ProgramData\Amazon\CodeDeploy\deployment-group-id\deployment-id\logs\scripts.log

Em que:

  • deployment-group-id é uma string como examplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4

  • deployment-id é um identificador como d-12EXAMPLE

Digite o seguinte comando para abrir um arquivo de log de scripts do CodeDeploy:

notepad C:\ProgramData\Amazon\CodeDeploy\deployment-group-ID\deployment-ID\logs\scripts.log

Para procurar mensagens de erro no arquivo de log, pressione CTRL+F, digite stderr e, em seguida, pressione Enter para encontrar o primeiro erro.