概要

InfluxDBなどのデータから生成したグラフをgrafanaで可視化する際、イベントなどをオーバーレイして表示する「annotation」と呼ばれる機能があります

grafanaの「annotation」はInfluxDB以外の、Elasticsearchなどのデータソースにも対応していますが、本エントリではInfluxDBにおける「annotation」の使い方についてまとめます

なお、grafanaを通してInfluxDBのデータが見れるようになっていること、を前提として本エントリを記述します

実現できること

「記録済みのイベント」をどのように記録するか、について記載します

grafanaで設定したdatasourceの「events」seriesに、下記のカラムを設定して保存すれば、簡単にgrafanaからイベントを取得するように設定できます

InfluxDBで通常行うように、イベントに時刻を明示的に指定する場合(現在時刻ではなく、過去や未来のイベントを作成する場合)は、timeを追加で指定してください

イベントの記録は、

など、様々な方法が考えられます
適宜記録してください

grafanaでは、annotationの有効化/無効化や、イベント情報とannotationカラムの紐付けを行います

画面右上の Configure dashboard > Features (tab) を選択し、Annotationsにチェックをつけます

画面左上に歯車のマークが表示されるようになったらうまくいっています

上記「イベント情報の登録」に設定例を示しましたが、grafanaに設定済みの任意のdatasource(多くの場合はdatabase), 任意のseries, 属性をイベント情報として利用することが出来ます

Annotations > Add (tab) からAnnotationを作成します

ここではeventsというNameを付与しています

下記のようなオーバーレイが表示されます

線やマークがカスタマイズできますので、イベント種別毎に色を変えるとか、イベント開始/終了で色を変える、などの利用方法が考えられそうですね

フィードバックいただければ、随時対応していきます
下記観点でコメントいただければと思います

ありがとうございました