Subscribed unsubscribe Subscribe Subscribe

External URL Monitoring

This feature performs monitoring in http or https format.

Configuring external URL monitors

To create a new external URL monitor click on the New Monitor button in the upper right hand corner of the Monitors page. Under the External Http tab, the following items will be displayed. Complete the form as explained below and click Create.

  • URL: select either http or https and enter the rest of the URL in the form.
  • Alert Conditions: Connect the monitor rule to a service and the response time will be submitted as a service metric. Graphs can be seen in the service metrics tab. Also, the threshold can be configured for response time.
  • Response Body Check: The response body will be checked to make sure a designated string is included. If one is not included, a notification will be sent.
  • Re-sent Notification Intervals: If there has been no change to the alert’s condition, even if the designated time is surpassed, the notification will be sent again.
  • HTTP Request Header: Any HTTP header can be specified for the request.
    • User-Agent can not be edited and will have a format similar to mackerel-http-checker/0.0.1 (the value after / is the version number and will change in the future)
    • The Cache-Control header is specified as no-cache by default.
  • Certificate Expiration Date Monitor: The SSL certificate’s expiration date will be monitored. An alert will be sent when the number of remaining days before the expiration date falls below the threshold.
  • Monitor Name: enter a descriptive name for the new monitor.

About external URL monitor specs (possible to change in the future)

  • Check intervals are fixed at 1 minute.
  • Under the following conditions an error will be recognized and an alert notification will be sent.

    • 4xx or 5xx status codes
    • a 15-second timeout
    • an invalid SSL certificate
      • in the case of a timeout, SSL certificate error will be displayed as an HTTP status code 503.
    • When response time exceeds the threshold (optional setting).
    • When a designated string isn’t included in the response body (optional setting).
    • When the number of remaining days before the SSL certificate expiration date falls below the threshold (optional setting).
  • 2xx or 3xx responses will be recognized not as errors but as normal responses

    • 3xx responses, however, will not be followed up.
  • To monitor a URL that's using Basic access authentication, use "user:password@monitor target URL"

Monitoring source IP addresses of external URL monitors

This is the same as the source IP address range for Mackerel notification requests. For more information check our FAQ page.

Subscription plans

This feature can only be used with a paid subscription or in the free trial.

Up to 20 external URL monitors can be made without additional charges being incurred. If more than 20 have been created, excess will be counted as 20 external URL monitors equals the value of one host.

Sample Alert

When a new monitor has been added it will be displayed in the list in the Monitors page. https://f.st-hatena.com/images/fotolife/m/mackerelio/20150907/20150907153553.png

If an alert arises it will be displayed as shown below, at which point the details of the alert can be viewed in the alert details screen. The 503 displayed at the top is the HTTP status code. If the alert has been resolved, the HTTP status code at the time it was resolved will be displayed.

https://f.st-hatena.com/images/fotolife/m/mackerelio/20150907/20150907154229.png

https://f.st-hatena.com/images/fotolife/m/mackerelio/20150907/20150907154532.png