Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Debug lifecycle configurations

Focus mode
Debug lifecycle configurations - Amazon SageMaker AI

The following topics show how to get information about and debug your lifecycle configurations.

Verify lifecycle configuration process from CloudWatch Logs

Lifecycle configurations only log STDOUT and STDERR.

STDOUT is the default output for bash scripts. You can write to STDERR by appending >&2 to the end of a bash command. For example, echo 'hello'>&2.

Logs for your lifecycle configurations are published to your AWS account using Amazon CloudWatch. These logs can be found in the /aws/sagemaker/studio log stream in the CloudWatch console.

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. Choose Logs from the left navigation pane. From the dropdown menu, select Log groups.

  3. On the Log groups page, search for aws/sagemaker/studio.

  4. Select the log group.

  5. On the Log group details page, choose the Log streams tab.

  6. To find the logs for a specific app, search the log streams using the following format:

    domain-id/user-profile-name/app-type/app-name

    The following search string finds the lifecycle configuration logs for the domain d-m85lcu8vbqmz, user profile i-sonic-js, application type JupyterLab, and application name test-lcc-echo:

    d-m85lcu8vbqmz/i-sonic-js/JupyterLab/test-lcc-echo
  7. To view the script execution logs, select the log stream appended with LifecycleConfigOnStart.

Lifecycle configuration timeout

There is a lifecycle configuration timeout limitation of 5 minutes. If a lifecycle configuration script takes longer than 5 minutes to run, you get an error.

To resolve this error, make sure that your lifecycle configuration script completes in less than 5 minutes.

To help decrease the runtime of scripts, try the following:

  • Reduce unnecessary steps. For example, limit which conda environments to install large packages in.

  • Run tasks in parallel processes.

  • Use the nohup command in your script to make sure that hangup signals are ignored so that the script runs without stopping.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.