Grafana に Checkmk を統合する

このタイプのインストールには、少なくとも Checkmk Cloud を使用する必要があります。 Grafana を独自のサーバーで運用している場合は、コマンドラインから Grafana プラグインコレクションからインストールすることができます。

Grafana サーバーサービスを再起動します。

プラグインが Grafana インターフェースで使用可能になり、そこで有効化および設定を行うことができます。

まず、Checkmk データソースをインストールする Grafana インスタンスにログインします。 次に、Grafana プラグインコレクションでデータソースのページを開きます。Installation （プラグインの管理）タブで、プラグインをインストールする Grafana インスタンスにチェックを入れ、Install （プラグインをインストール）ボタンをクリックします。 プラグインが Grafana インストールの web インターフェイスで使用可能になるまで、数分かかる場合があります。

GitHub リポジトリの「リリース」ページには、zip アーカイブ形式の 2 種類のプラグインがあります。

最新バージョンを zip ファイルとしてダウンロードし、scp などを使用して Grafana サーバーにコピーしてください。

ブラウザを使用する代わりに、コマンドラインから直接ファイルをロードすることもできます。 このためには、現在のバージョンを知っている必要があります。以下の例では、$plugvers 変数にバージョンを記述しています。

次に、zip アーカイブを解凍します：

プラグインディレクトリがまだ存在しない場合は作成し、Grafana プロセスが実行される ID（通常はgrafana ）の Linux ユーザーをその所有者に設定します。

結果のフォルダを Grafana プラグインディレクトリに移動します。 これは通常、ファイルパス/var/lib/grafana/plugins/ です。

所有権を Grafana ユーザーに変更します。

Git アーカイブをクローンしてインストールする（この記事の古いバージョンで説明されている方法）ことは、もうできません。 プラグインの開発に参加したい場合は、開発ガイドをお読みください。

Home > Dashboards に、プラス記号が付いたドロップダウンメニューがあります。New dashboard をクリックして、新しいダッシュボードを作成します。

最もシンプルなダッシュボードは、ホストのサービスに関する 1 つのグラフを表示します。 これは、既製のグラフが存在しないローカルチェックのメトリックでもかまいません。 既存のダッシュボードまたは作成したばかりのダッシュボードに、新しい視覚化を作成します。 まず、ここで「Add visualization 」を選択します。

視覚化を作成すると、データソースの選択画面が表示されます。Checkmk を選択すると、新しく作成したパネルのクエリの編集モードに直接移動します。 パネルは、視覚化のコンテナです。

視覚化するデータへのアクセスは、Checkmk Rawと商業版で少し異なります。 Checkmk Raw では、サイト、ホスト名、サービスなど、あらかじめ定義されたメニューを使用して作業を行います。 商業版では、フィルタのカスケードを定義するオプションがあります。 これにより、正規表現を使用して、非常に詳細な選択を行うことができます。 以下の簡単な例は、すべてのエディションで実行できるように選択されています。

まず、Site を選択し、次に監視でHostname をフィルタリングします。 最初のテストでは、WindowsまたはLinuxエージェントを使用している任意のホストを使用してください。Service としてCheck_MK を選択します。Aggregation のタイプをMaximum に設定します。 選択可能なGraph type は、Single metric またはPredefined graph です。Predefined graphs は、結合グラフも含むCheckmkからメトリックを取得します。 こちらのスクリーンショットは、エージェントの合計実行時間（Time spent waiting for Checkmk agent ）を含むSingle metric を示しています。

Grafana は結果を直接表示します。Apply ボタンを使用すると、ダッシュボードを保存せずにグラフを適用することができます。Save を選択すると、新しいDashboard のタイトルを入力する画面が表示され、新しく作成したダッシュボードを保存することができます。

Checkmk の開発者は、ユーザーが 1 つのリソースのさまざまな側面を簡単に把握できるように、関連する多くのメトリックを一般的なグラフにまとめました。 このような既製のグラフのメトリックは、Grafana で直接表示することができます。

手順は、前のセクションで説明したものと最初は同じです。 ただし、プロセスを完了するには、[Graph type ] エントリPredefined graph 、および使用するサービスの [Predefined graph ] を選択してください。

200 以上のエレメントを含む複合メトリックの選択は許可されていませんというエラーメッセージが表示された場合は、追加のフィルタを使用して選択を制限してください。 不明な場合は、結果を大幅に制限するフィルタをセットの先頭に移動してください。

選択に問題がなければ、[Apply ] ボタンをクリックします。 これで、選択したダッシュボードでグラフを使用できるようになります。

特に動的なクラスタでは、新しいノードが追加または削除されるたびにグラフをカスタマイズすることなく、参加しているすべてのホストにおけるメトリックの進捗全体を追跡できることが望ましい場合がよくあります。 これを実現するために、グラフを動的に適応させるさまざまなオプションがあります。

最初のオプションは、個々のホストを選択する代わりに、Host Labels またはHost Tags でフィルタリングすることです。 もう 1 つのオプションは、正規表現を使用することです。 正規表現は、ホストまたはサービスに適用できます。 次の例では、filesystem は、ホストがマウントしているファイルシステムの数に関係なく、filesystemを含むすべてのサービスと一致します。

filesystem.*nvme を使用すると、filesystem とnvme の間の文字列は任意であるため、使用するファイルシステムの種類に関係なく、NVMe ドライブ上のすべてのファイルシステムに選択が制限されます。

拡張フィルターオプションに加えて、Aggregation を使用してグラフに表示するメトリックを決定し、Graph を使用して参照として使用するグラフを決定します。 ホスト/サービスのメトリックは、選択したグラフも存在する場合にのみ表示されます。 グラフは、たとえば次のようになります。

各パネルの編集モードには、Transform （正規表現による編集）タブがあります。 ここで、Rename by regex （正規表現による編集）サブ項目を使用して、メトリックの名前を並べ替えたり、不要な情報を非表示にしたりすることができます。 次の例では、コンマとスペースで区切られた 2 つの文字列を検索し、それらを交換して、Service とHost を先頭に明示的に配置しています。

変数$1 および$2 は、上の行で「キャプチャ」された文字列（マッチグループまたはキャプチャグループ）に対応しています。 Grafana では、ネストしたマッチグループも使用できます。 正規表現に関する記事の対応するセクションでは、これらの機能の概要を説明しています。

各変数は、ダッシュボードのプロパティです。 ダッシュボードの設定で作成する必要があり、そのダッシュボード内でのみ使用できます。 クエリは最も広範な設定が必要であるため、この例でその使用方法を説明します。

変数に関連するプロパティは、そのタイプと名前です。その他のプロパティは、ダッシュボードの明確化のためにのみ使用されます。 名前は、変数を区別できるものにしてください。 したがって、複数の変数を使用して異なるサブセットからホストを選択する場合は、例のようにhost ではなく、このセットを参照する名前、たとえばhost_from_linuxservers を使用してください。

データソースを選択する際には、Checkmk 接続が選択されていることを確認してください。 選択したオブジェクトタイプは、正規表現などを使用してさらに制限することができます。 使用されたフィルタは、Checkmk サーバーで評価されます。 一方、Regex およびSort フィールドは、Grafana によって評価されます。

Save dashboard ページ下部の「Selection options 」の 2 つのチェックボックスは、必要に応じて後でオプションで使用できます。 これらの設定は、必要に応じていつでも変更できます。最初のテストでは、両方をデフォルト設定（空）のままにしてください。

割り当てた変数を適切なフィールドに入力して、柔軟なグラフを作成することができます。 変数は、グラフのタイトルにも使用できます。

ダッシュボードには、各変数のドロップダウン選択が表示され、ダッシュボードに表示する変数の値（ホスト、サービスなど）を設定できます。 複数選択を有効にしている場合は、パネル設定で「Repeat by variable 」オプションを有効にすると、選択した各変数の値に対応するパネルが表示されます。