Mackerel.io Integration Guide

Mackerel is a elegantly simple and easy-to-use service that uses the concept of roles to monitor and manage hosts. By running a program called mackerel-agent on your hosts, you can manage multiple hosts either on the web or via an API as well as visualize the statuses of hosts and applications with a high degree of customization. Alerts generated in Mackerel.io can trigger incidents in PagerDuty, to alert the appropriate technician via SMS, phone, email or push notifications. The guide below describes how to integrate your Mackerel installation with PagerDuty.

In PagerDuty

1. From the Configuration menu, select Services.
2. On your Services page:If you are creating a new service for your integration, click +Add New Service.

   If you are adding your integration to an existing service, click the name of the service you want to add the integration to. then click the Integrations tab and click the +New Integration button.




3. Select your app from the Integration Type menu and enter an Integration Name.If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.
4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.
   
5. Copy the Integration Key for your new integration:

In Mackerel.io

1. Navigate to your Mackerel.io URL dashboard and select Monitors.
   
2. Click Channels Settings.
   
3. Select New Channel.
   
4. Select PagerDuty  from the list of available channels. Enter in a Channel Name of your choosing. Enter in your PagerDuty Integration Key in the service key field. Also select for which types of events status’ you would like to send alerts to your PagerDuty Account from the Available Status drop down menu. Then, click Create.
   
5. Once completed you should see a new channel created for your PagerDuty Alerts.
   
6. Congratulations! Your PagerDuty Integration should now be enabled.

 

FAQ

Will Mackerel.io incidents automatically resolve?

Yes.

Can I setup Mackerel.io to be tied to multiple PagerDuty services?

Yes, you will need to create multiple Channels in Mackerel.io and associate them with services created in PagerDuty.

Are incidents de-duplicated?

Yes, incidents are de-duplicated,  The incident key is returned for the initial alert that creates the incident.

Is there a 2-way ack-back integration?

No.

Are there logs I can reference in Mackerel.io?

No.