Check monitoring

Posting Monitoring Check Reports

This will transmit a monitoring check’s report to Mackerel. Monitoring reports are restricted to hosts.

POST /api/v0/monitoring/checks/report

Implementation described in Adding a monitoring check item by script is being used. The agent will periodically transmit the list of configured monitoring checks to the Updating Host Information API and, any monitoring checks that aren’t included in that list and do not have open alerts will be deleted from Mackerel at that time. If a new monitoring timestamp has already been posted with the same name/host, posting will be ignored.

Required permissions for the API key

  • Read
  • Write


  "reports": [ <report>, <report>, … ]

<report> : an object that holds the following keys. Up to 100 <report> can be sent with one API request.

source source refer to the note below
name string monitor name
status string alert status of the monitor report. "OK", "CRITICAL", "WARNING", or "UNKNOWN"
message string auxiliary text attached to the alert status of the monitor report, under 1024 characters
occurredAt number unix timestamp of execution
notificationInterval number [optional] Notifications will not be re-sent if the time interval (in minutes) is omitted. If the time interval is set for less than 10 minutes, the notifications will be re-sent at an interval of 10 minutes.
maxCheckAttempts number [optional] number of consecutive Warning/Critical instances before an alert is made. Default setting is 1 (1-10)

source : an object that holds the following keys

type string fixed character string "host"
hostId string host ID (given by the server when the host was registered)



  "success": true


403 when the API key doesn't have the required permissions / when accessing from outside the permitted IP address range
other than 200 any error other than the above