grafanaprometheus

Tracking events with prometheus and grafana


There's an article "Tracking Every Release" which tells about displaying a vertical line on graphs for every code deployment. They are using Graphite. I would like to do something similar with Prometheus 2.2 and Grafana 5.1. More specifically I want to get an "application start" event displayed on a graph.

Grafana annotations seem to be the appropriate mechanism for this but I can't figure out what type of prometheus metric to use and how to query it.


Solution

  • The simplest way to do this is via the same basic approach as in the article, by having your deployment tool tell Grafana when it performs a deployment.

    Grafana has a built-in system for storing annotations, which are displayed on graphs as vertical lines and can have text associated with them. It would be as simple as creating an API key in your Grafana instance and adding a curl call to your deploy script:

    curl -H "Authorization: Bearer <apikey>" \
      http://grafana:3000/api/annotations \
      -H "Content-Type: application/json" \
      -d '{"text":"version 1.2.3 deployed",\
           "tags":["deploy","production"]}'
    

    For more info on the available options check the documentation:

    http://docs.grafana.org/http_api/annotations/

    Once you have your deployments being added as annotations, you can display those on your dashboard by going to the annotations tab in the dashboard settings and adding a new annotation source: adding annotation source

    Then the annotations is shown on the panels in your dashboard: panel showing annotation