Viewing App Runner logs streamed to CloudWatch Logs - AWS App Runner

Viewing App Runner logs streamed to CloudWatch Logs

You can use Amazon CloudWatch Logs to monitor, store, and access log files that your resources in various AWS services generate. For more information, see Amazon CloudWatch Logs User Guide.

AWS App Runner collects the output of your application deployments and of your active service and streams it to CloudWatch Logs. The following sections list App Runner log streams and show you how to view them in the App Runner console.

App Runner log groups and streams

CloudWatch Logs keeps log data in log streams that it further organizes in log groups. A log stream is a sequence of log events from a specific source. A log group is a group of log streams that share the same retention, monitoring, and access control settings.

App Runner defines two CloudWatch Logs log groups, each with multiple log streams, for each one of your App Runner services in your AWS account.

Service logs

The service log group contains logging output generated by App Runner as it manages your App Runner service and acts on it.

Log group name Example

/aws/apprunner/service-name/service-id/service

/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/service

Within the service log group, App Runner creates an events log stream to capture activity in the lifecycle of your App Runner service. For example, this might be launching your application or pausing it.

In addition, App Runner creates a log stream for each long-running asynchronous operation that's related to your service. The log stream name reflects the operation type and specific operation ID.

A deployment is a type of operation. Deployment logs contain the logging output of the build and deployment steps that App Runner performs when you create a service or deploy a new version of your application. Deployment log stream names start with deployment/, and end with the ID of the operation that performs the deployment. This operation is either a CreateService call for the initial application deployment or a StartDeployment call for each further deployment.

Within a deployment log, each log message starts with a prefix:

  • [AppRunner] – Output that App Runner generates during the deployment.

  • [Build] – Output of your own build scripts.

Log stream name Example

events

N/A (fixed name)

operation-type/operation-id

deployment/c2c8eeedea164f459cf78f12a8953390

Application logs

The application log group contains the output of your running application code.

Log group name Example

/aws/apprunner/service-name/service-id/application

/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/application

Within the application log group, App Runner creates a log stream for each instance (scaling unit) that's running your application.

Log stream name Example

instance/instance-id

instance/1a80bc9134a84699b7b3432ebeebb591

Viewing App Runner logs in the console

The App Runner console displays a summary of all logs for your service and allows you to view, explore, and download them.

To view logs for your service

  1. Open the App Runner console, and in the Regions list, select your AWS Region.

  2. In the navigation pane, choose Services, and then choose your App Runner service.

    The console displays the service dashboard with a Service overview.

    
      App Runner service dashboard page showing Activity list
  3. On the service dashboard page, choose the Logs tab.

    The console displays a few types of logs in several sections:

    • Event log – Activity in the lifecycle of your App Runner service. The console displays the latest events.

    • Deployment logs – Source repository deployments to your App Runner service. The console displays a separate log stream for each deployment.

    • Application logs – The output of the web application that's deployed to your App Runner service. The console combines the output from all running instances into a single log stream.

    
        The Logs tab on the App Runner service dashboard page
  4. To find specific deployments, scope down the deployment log list by entering a search term. You can search for any value that appears in the table.

  5. To view a log's content, choose View full log (event log) or the log stream name (deployment and application logs).

  6. Choose Download to download a log. For a deployment log stream, select a log stream first.

  7. Choose View in CloudWatch to open the CloudWatch console and use its full capabilities to explore your App Runner service logs. For a deployment log stream, select a log stream first.

    Note

    The CloudWatch console is particularly useful if you want to view application logs of specific instances instead of the combined application log.