Metricfire logo

Pingdom

Table of Contents

  1. How to set up a Pingdom webhook
    1. Adding an Alerting Endpoint
    2. Adding an Integration
    3. To Enable Pingdom Annotations in Your Dashboards

If your site goes down, is it reflected on your graphs? With a pingdom webhook add-on, you can now flag your graphs when pingdom fires an alert.

   

How to set up a Pingdom webhook

The webhook provided by Hosted Graphite can be used in Pingdom both as an alerting endpoint, and with integrations. To get Pingdom alert information added to Hosted Graphite as annotations, follow these instructions:

  • Copy your Pingdom webhook location by clicking the ‘Copy Webhook Location’ button
undefined

Adding an Alerting Endpoint

  • Browse to your Pingdom account, visit ‘alerting’ section, and click ‘Alerting Endpoints’
       
undefined
  
  • On the top right-hand side, click “Add Alerting Endpoint”
      
undefined
  
  • Click ‘Add Contact Method’, select ‘URL / Webhook’ and paste your Hosted Graphite Pingdom webhook location, click ‘Add’
        
undefined
  
  • Save the endpoint
      
undefined

  

You’ve now saved a Hosted Graphite webhook for your alerting endpoint. Assign this alerting endpoint as one of your contact methods for an outage, and then add the pingdom annotations to your alerts.

  

Adding an Integration

  • Browse to your Pingdom account, visit ‘Integrations’ section, and click ‘Integrations’
       
undefined
  
  • On the top right-hand side, click “Add integration”
      
undefined
  
  • Select Type: ‘URL / Webhook’, give your integration a name (e.g. ‘Hosted Graphite’) and paste your Hosted Graphite Pingdom webhook location. Make sure the Active box is ticked, and click ‘Save integration’
        
undefined
  
  • Select one of your checks or create a new one, and scroll to the bottom of the Edit window. Your new integration should appear in the ‘Connect integrations’ list. Select the integration, and click ‘Create Check’/’Modify Check’
      
    undefined    

Your PIngdom check will now send detailed event information to Hosted Graphite, including all your specified check tags and the following check-type specific information, as searchable annotation tags:

  • HTTP: full URL (including http(s) prefix)
  • DNS: expected IP, name server
  • UDP: sent string, expect response

To Enable Pingdom Annotations in Your Dashboards

  • Browse to your Hosted Graphite graph, and enable Annotations
        
undefined
  
  • Enable Pingdom Annotations
        
undefined

  

Use the tag “Pingdom” to see all pingdom alerts, or the hostname of the pingdom check to see tagged annotations for that host. If you are using Pingdom Integrations, you can also search by your check tags or any of the specific fields listed above.

  • Finally, you will see site outages on your graphs
      
      
    undefined

  

More information on annotations can be found by following our annotations documentation.