Skip to content


Monitors are playbooks that contain either a cron or a rate setting in the settings section. They are especially useful to assert that the behavior of live systems is working as expected with a certain frequency.

Cron or Rate Settings

Your playbooks can run with a predefined frequency

Rate Setting

This is the easiest way of speaking of frequency:

Rate expression examples:

Every 10 minutesrate: 10 minutes
Every hourrate: 1 hour
Every seven daysrate: 7 days

For example, the following file monitor.yml checks that the Satori website is live and showing its name every 10 minutes:

    name: "Verify Satori's website"
    rate: 10 minutes

    assertStdoutContains: "Satori CI"
    - curl -s

To install this playbook, you just need to run it:

satori run monitor.yml

Run Monitor

List your monitors

Once you have added a monitor, you can list them with the monitor command like this:

satori monitors

List Monitor

In case you want to list those monitors that are in a failed state and have pending actions, you would use --pending the parameter:

satori monitors --pending

Pending Actions on Monitor

Stop and Start Monitors

Now, besides listing your monitors, you may want to stop them.

satori monitor MONITOR_ID stop

Or restart them:

satori monitor MONITOR_ID start

Start and Stop a Monitor

Clean reports and Delete Monitors

Delete all the reports launched by your monitor with clean:

satori monitor MONITOR_ID clean

And delete your monitor (that should be already on a stopped state) with delete:

satori monitor MONITOR_ID delete

Clean and Delete a Monitor

If you need any help, please reach out to us on Discord or via Email