Grafana で MariaDB のデータを扱ってみる

◆ Live配信スケジュール ◆
サイオステクノロジーでは、Microsoft MVPの武井による「わかりみの深いシリーズ」など、定期的なLive配信を行っています。
⇒ 詳細スケジュールはこちらから
⇒ 見逃してしまった方はYoutubeチャンネルをご覧ください

【4/18開催】VSCode Dev Containersで楽々開発環境構築祭り〜Python/Reactなどなど〜
Visual Studio Codeの拡張機能であるDev Containersを使ってReactとかPythonとかSpring Bootとかの開発環境をラクチンで構築する方法を紹介するイベントです。
https://tech-lab.connpass.com/event/311864/

こんにちは。サイオステクノロジー OSS サポート担当山本です。

以前の投稿では Grafana を “時間” と “数値” を元にした「グラフを描くツール」として紹介しましたが、同時に MySQL 等の一般的な RDB もデータの参照元・データソースとして扱える、と紹介していました。

今回は、Grafana 上で RDB のデータがどのように扱えるかを MariaDB を例にして確認してみたいと思います。
今回は Grafana の導入等は扱わないので、Grafana の概要につきましては以下の投稿を参照してください。

Grafana を使ってみる

1 ■Grafana と MariaDB の連携
2 ■MariaDB のレコードをグラフ表示してみる
3 ■MariaDB のレコードを表示してみる
4 ■最後に

■Grafana と MariaDB の連携

まずは Grafana のデータソースとして MariaDB を扱えるようにしましょう。
早速 Grafana のデータソースを登録…する前に、MariaDB で Grafana からアクセスするためのユーザーを作成します。

例えば、localhost にある MariaDB の「sample」というデータベースを使用する場合、以下のようなコマンドを実行します。

MariaDB [(none)]> GRANT SELECT ON sample.* TO grafanaReader@localhost identified by 'password';

上記コマンドなどで MariaDB 側のユーザーを作成したら、Grafana のインターフェースで「Configuration – Data sources」から「MySQL」のデータソースを登録します。

登録画面では、以下の項目などを設定します。

・Host：localhost:3306 (<MariaDB のあるホスト名：ポート>)
・Database：sample (<使用する Database 名>)
・User：grafanaReader (<MariaDB のユーザ名>)
・Password：password (<MariaDB のパスワード>)

必要な項目を設定したら画面下部の「Save&Test」ボタンを押下し、設定の保存と疎通の確認を行ないます。
以下のような表示がでれば連携成功です。

■MariaDB のレコードをグラフ表示してみる

さて、データソースが登録できたので、MariaDB のデータを使用してグラフを作成してみましょう。
ただし、勿論どんなデータでもグラフ化できるわけではありません。Grafana でグラフを作成できるのは「datetime 型か timestamp 型のカラム」と「数値型のカラム」を持つテーブルのみとなります。

今回はサンプルとして、以下のようなテーブルとデータを用意しました。

早速、これらのデータをグラフ表示させてみます。
「Create – Dashboard」または「Dashboards – Manage」でダッシュボード編集画面を開き、新規パネルの「Add Query」から設定を行います。

開いたページの一番上の項目「Query」の項目に MariaDB のデータソースを設定すると、A (クエリ入力項目) の入力項目がクエリビルダというものに変化します。
このクエリビルダで以下の項目を入力すると、グラフを表示することができます。

・FROM：<テーブル名>
・Time column：<datetime 型か timestamp 型のカラム名>
・SELECT：<グラフ表示したい数値データのカラム>
・Format as：Time series

また、「Metric column」に任意のカラムを入力することで、そのカラムの内容ごとにグラフを分けることができます。
同テーブル内に複数系列のデータが存在していて、その系列ごとに別のグラフを描きたいという場合などに活用することができます

■MariaDB のレコードを表示してみる

さて、先に確認したとおり Grafana でグラフ化できるのは「時間の要素を持つ数値データ」のみです。
じゃあ Grafana ではグラフ化できない文字列データを表示することはできないのか、というと、実は単純にクエリの結果を表示する機能もあったりします。
その方法を簡単に確認してみましょう。

まず、新規パネルを作成し、右側の「Choose Visualization」からパネルの設定画面に移ります。
この画面ではパネルの表示形式を設定することができますが、ここで “Table” を選択します。

次に画面左の「Queries」タブに移動します。
すると、A (クエリ入力項目) の入力項目が通常のテキストボックスになっているので、ここに任意のクエリを入力します。

・A：<任意のクエリ>
・Format as：Table

するとご覧のとおり、クエリの結果がパネルの情報として表示されるようになります。

もしダッシュボード上で表示している時間のデータのみを表示させたい場合、そのテーブルに datetime 型のカラムがあれば A (クエリ入力項目) の WHERE 句に「$__timeFilter(<datetime 型のカラム>)」を設定することでダッシュボード上の表示時間と連動するようにすることができます。