Checkmk
to checkmk.com
Important

This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved.

1. 概要

Checkmk では、すべてのホストおよびサービスについて、個別に、またはグループごとにカスタムメモを保存することができます。 これらのメモは、Custom services notes およびCustom host notes という別々の列に表示されます。 デフォルトでは、これらの列は、ホスト (Status of Host myhost) およびサービス (Service myservice, myhost)の詳細ビューにすでに表示されています。 これらは標準の列であるため、Checkmk の他の多くのビューにも挿入することができます。

2. メモの作成

メモは、Checkmk サイトの構成ディレクトリに直接作成できます。 これを行うには、まず、~/etc/check_mk/notes ディレクトリを作成します。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes

2.1. ホストメモ

次に、ホストのメモを作成するには、notes ディレクトリ内にhosts ディレクトリを作成します。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hosts

特定のホストに関するメモを作成するには、Checkmk でのそのホストの名前とまったく同じ名前のファイルを作成します。 お好みのエディタ、または次の例のようにシェルリダイレクトを使用してください。

OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhost

Status of Host ビューの一番下に、次のようなメモが表示されます。

A note in the 'Status of Host' view.

このようなファイルを 1 つだけ作成して、複数のホストで一度に参照および表示したい場合は、アスタリスク、疑問符、および文字クラスなどのシェルパターンを使用することができます。 これを行うには、それぞれのディレクトリ内のファイル名に、これらの文字が実際に含まれている必要があります。 したがって、~/etc/check_notes/hosts/ ディレクトリに'*' という名前のファイルを作成すると、すべてのホストが参照されます。 その結果、'*' ファイルの内容は、サイト内の各ホストに個別に表示されます。

重要:このようなファイルの名前はシングルクォートで囲む必要があります

何らかの理由で、名前がt で終わるすべてのホストに特定のメモを表示したい場合は、'*t' という名前のファイルを作成してください。

OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'

複数のファイルがホスト名と一致する場合、Custom host notes フィールドには、一致するすべてのメモも表示されます。 異なるメモは、横線で区切られます。

Notes from different source files are separated by a horizontal line.

2.2. サービスノート

サービスについても同様のメモを作成するには、~/etc/check_mk/notes/ 内にservices ディレクトリが必要です。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services

ホストとは異なり、このディレクトリでは、メモ用のファイルの作成をすぐに開始することはできません。 ここでは、サービスメモを表示するホストを定義する、別のディレクトリレベルが必要です。

次に、1 台のホスト、または上記のパターンに従って複数のホストを指定するディレクトリを作成します。

したがって、'*' というディレクトリは、再びすべてのホストを参照することになります。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'

ホスト名と完全に一致するディレクトリには、その 1 つのホストのサービスに関するメモのみを作成できます。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhost

したがって、my で始まるすべてのホストのサービスに関するメモを作成するには、'my*' というディレクトリを作成する必要があります。

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'

ここでも、ディレクトリ名は単一引用符で囲んでください。

要件に応じてホストレベルを作成したら、ホストのメモと同様に、今度は目的のService description に対応するファイルを作成します。 同様に、アスタリスク、疑問符、および文字クラスも使用できます。

次の例では、サイト内の各ホストに、Check_MK サービス用のノートを作成しています。

OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK

3. 使用できるマクロ

メモ内では、ビューで適切に置き換えられるマクロを使用できます。 ここでは、以下のマクロを使用できます。

$HOSTNAME$

ホスト名

$HOSTNAME_LOWER$

小文字のホスト名

$HOSTNAME_UPPER$

大文字のホスト名

$HOSTNAME_TITLE$

最初の文字を大文字、残りを小文字にしたホスト名

$HOSTADDRESS$

監視対象のホストの IP アドレス。

$SERVICEDESC$

サービス内容 (サービスノートのみ)

$SITE$

Checkmk サイトの ID

$URL_PREFIX$

サイトの URL プレフィックス

$HOSTOUTPUT$

チェックプラグインの出力 (ホストメモのみ)

$SERVICEOUTPUT$

チェックプラグインの出力(サービスノートのみ

たとえば、1 つのファイルを使用して、社内 Wiki の異なるエントリを参照することができます。各エントリは、常に現在開いているホストと一致します。

~/etc/check_mk/notes/hosts/'*'
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>
このページでは