Status Notification

Monika sends status notifications periodically based on a set schedule with the following information:

• Host
• Number of probes
• Average response time in the last 24 hours
• Incidents in the last 24 hours
• Recoveries in the last 24 hours
• Number of sent notifications in the last 24 hours
• Application version

By default the schedule is set to 6:00 AM everyday. You can configure the schedule with cron syntax via command line argument like so:

 monika --status-notification "0 6 * * *"

or via the configuration file with the status-notification field like below:

1 notifications:
2   - id: desktop
3     type: desktop
4 probes:
5   - requests:
6       - url: http://example.com
7 status-notification: 0 6 * * *

You can also choose to disable this feature altogether. Just set the value to false

 monika --status-notification false

or

1 notifications: ...
2 probes: ...
3 status-notification: false

Cron Syntax

To schedule the status notification we use standard cron syntax. You can try out your configuration on crontab.guru.

In addition to the standard 5 cron syntax, Monika supports an optional seconds field. So if you wrote 6 cron syntax, please be advised that the status notification could be sent very frequently.

1 ┌────────────── second (optional)
2  │ ┌──────────── minute
3  │ │ ┌────────── hour
4  │ │ │ ┌──────── day of month
5  │ │ │ │ ┌────── month
6  │ │ │ │ │ ┌──── day of week
7  │ │ │ │ │ │
8  │ │ │ │ │ │
9  * * * * * *

Valid Field Values

Examples:

 status-notification "1,2,5,7 * * * *"

Notifies every minute 1, 2, 5 and 7. In other words every xx:01, xx:02, xx:05, xx:07 of every hour.

 status-notification "1-5 * * * *"

Notifies with the range of minute 1 to 5.

 status-notification "*/2 * * * *"

Notifies every two minutes.

 status-notification "* * * Feb,Mar Sun"

Notifies every Sunday in February and March.