View log data for CodeDeploy EC2/On-Premises deployments
You can view the log data created by a CodeDeploy deployment by setting up the Amazon CloudWatch agent to view aggregated data in the CloudWatch console or by logging into an individual instance to review the log file.
Note
Logs are not supported for AWS Lambda or Amazon ECS deployments. They can be created for EC2/On-Premises deployments only.
View log file data in the Amazon CloudWatch console
When the Amazon CloudWatch agent is installed on an instance, deployment data for all deployments to that instance becomes available for viewing in the CloudWatch console. For simplicity, we recommend using CloudWatch to centrally monitor log files instead of viewing them instance by instance. For more information, see Send CodeDeploy agent logs to CloudWatch.
View log files on an instance
To view deployment log data for an individual instance, you can sign in to the instance and browse for information about errors or other deployment events.
Topics
To view deployment log files on Amazon Linux, RHEL, and Ubuntu Server instances
On Amazon Linux, RHEL, and Ubuntu Server instances, deployment logs are stored in the following location:
/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log
To view or analyze deployment logs on Amazon Linux, RHEL, and Ubuntu Server instances, sign in to the instance, and then type the following command to open the CodeDeploy agent log file:
less /var/log/aws/codedeploy-agent/codedeploy-agent.log
Type the following commands to browse the log file for error messages:
Command | Result |
---|---|
& ERROR |
Show just the error messages in the log file. Use a single space
before and after the word ERROR . |
/ ERROR |
Search for the next error message.¹ |
? ERROR |
Search for the previous error message.² Use a single space
before and after the word ERROR . |
G |
Go to the end of the log file. |
g |
Go to the start of the log file. |
q |
Exit the log file. |
h |
Learn about additional commands. |
¹ After you type ² After you type |
You can also type the following command to open a CodeDeploy scripts log file:
less /opt/codedeploy-agent/deployment-root/
deployment-group-ID
/deployment-ID
/logs/scripts.log
Type the following commands to browse the log file for error messages:
Command | Result |
---|---|
&stderr |
Show just the error messages in the log file. |
/stderr |
Search for the next error message.¹ |
?stderr |
Search for the previous error message.² |
G |
Go to the end of the log file. |
g |
Go to the start of the log file. |
q |
Exit the log file. |
h |
Learn about additional commands. |
¹After you type ² After you type |
To view deployment log files on Windows Server instances
CodeDeploy agent log file: On Windows Server instances, the CodeDeploy agent log file is stored at the following location:
C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
To view or analyze the CodeDeploy agent log file on a Windows Server instance, sign in to the instance, and then type the following command to open the file:
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
To browse the log file for error messages, press CTRL+F, type ERROR
[
, and then press Enter to find the first error.
CodeDeploy scripts log files: On Windows Server instances, deployment logs are stored at the following location:
C:\ProgramData\Amazon\CodeDeploy\
deployment-group-id
\deployment-id
\logs\scripts.log
Where:
-
deployment-group-id
is a string such asexamplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4
-
deployment-id
is an identifier such asd-12EXAMPLE
Type the following command to open a CodeDeploy scripts log file:
notepad C:\ProgramData\Amazon\CodeDeploy\
deployment-group-ID
\deployment-ID
\logs\scripts.log
To browse the log file for error messages, press CTRL+F, type
stderr
, and then press Enter to find the first error.