View a markdown version of this page

The cron expression for monitoring schedule - Amazon SageMaker AI

The cron expression for monitoring schedule

Note

After careful consideration, we have made the decision to close new customer access to Amazon Sagemaker Model Monitor, effective 7/30/26. Existing customers can continue to use the service as normal. AWS continues to invest in security and availability improvements for Model Monitor, but we do not plan to introduce new features. For more information, see Amazon SageMaker Model Monitor availability change.

To provide details for the monitoring schedule, use ScheduleConfig, which is a cron expression that describes details about the monitoring schedule.

Amazon SageMaker Model Monitor supports the following cron expressions:

  • To set the job to start every hour, use the following:

    Hourly: cron(0 * ? * * *)

  • To run the job daily, use the following:

    cron(0 [00-23] ? * * *)

  • The run the job one time, immediately, use the following keyword:

    NOW

For example, the following are valid cron expressions:

  • Daily at 12 PM UTC: cron(0 12 ? * * *)

  • Daily at 12 AM UTC: cron(0 0 ? * * *)

To support running every 6, 12 hours, Model Monitor supports the following expression:

cron(0 [00-23]/[01-24] ? * * *)

For example, the following are valid cron expressions:

  • Every 12 hours, starting at 5 PM UTC: cron(0 17/12 ? * * *)

  • Every two hours, starting at 12 AM UTC: cron(0 0/2 ? * * *)

Notes

  • Although the cron expression is set to start at 5 PM UTC, note that there could be a delay of 0-20 minutes from the actual requested time to run the execution.

  • If you want to run on a daily schedule, don't provide this parameter. SageMaker AI picks a time to run every day.

  • Currently, SageMaker AI only supports hourly integer rates between 1 hour and 24 hours.