Grafana recipe


Install with composer

composer require deployer/recipes --dev

Add to your deploy.php

require 'recipe/grafana.php';

Configuration options

  • url (required): the URL to the creates annotation api endpoint.
  • token (required): authentication token. Can be created at Grafana Console.
  • time (optional) – set deploy time of annotation. specify epoch milliseconds. (Defaults is set to the current time in epoch milliseconds.)
  • tags (optional) – set tag of annotation.
  • text (optional) – set text of annotation. (Defaults is set to "Deployed " + git log -n 1 --format="%h")
// deploy.php

set('grafana', [
    'token' => 'eyJrIj...',
    'url' => 'http://grafana/api/annotations',
    'tags' => ['deploy', 'production'],


  • grafana:annotation create annotation to Grafana


If you want to create annotation about successful end of deployment.

after('success', 'grafana:annotation');