1. はじめに
このユーザーガイドを参考にしても、Checkmk で解決できない問題が発生した場合は、 公式のCheckmk サポートおよび Checkmk フォーラムという2 つの優れた連絡先をご利用いただけます。 どちらの場合も、エラーや問題の詳細な説明は必須です。 さらに、迅速な分析と解決には、お客様の Checkmk 環境に関する特定の情報も必要です。 最も重要な情報は、ご使用の Checkmkの バージョンおよびエディションです。 ただし、状況によっては、問題の原因を突き止めるために、さらに多くの情報が必要になる場合があります。 これまで、Checkmk サポートでは、お客様にご提供いただく必要のある情報をお知らせしておりました。
サポートが「希望リスト」をお送りし、 お客様が Checkmk のさまざまなコンポーネントを調べ回って情報を探して回る代わりに、グラフィカルユーザーインターフェースで数回クリックするだけで、お客様専用の情報パッケージ（この記事では「ダンプ」と呼びます）を作成することができます。 ここでは、機密情報が含まれている可能性のある設定ファイルを含めるかどうか、含める場合はどのファイルを含めるかを、お客様ご自身で決定することができます。
選択可能なデータの一部は、Performance Graphs of Checkmk Server 、CMC (Checkmk Microcore) 、Licensing information など、商業版でのみご利用いただけます。
 |
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. |
2. サポート情報を収集します
2.1. サイトを選択
Setup > Maintenance > Support diagnostics をクリックすると、以下の整理された画面が表示されます:
分散監視を使用している場合は、最初のフィールドで、収集するデータを選択するSite を指定できます。
2.2. 一般情報
General information （サポート情報）には、基本的に、Checkmk のバージョンおよび使用しているオペレーティングシステムに関する情報が必ず含まれるという通知のみが表示されます。 この設定のまま（つまり、いずれのオプションも選択せずに）Collect diagnostics からデータの収集を開始すると、以下のデータのみを含むファイルが作成されます。
{
"arch": "x86_64",
"core": "cmc",
"edition": "cee",
"os": "Ubuntu 22.04.2 LTS",
"python_paths": [
"/opt/omd/versions/2.2.0p1.cee/bin",
"/omd/sites/mysite/local/lib/python3",
...
"/omd/sites/mysite/lib/python3"
],
"python_version": "3.11.2 (main, Mar 14 2023, 20:27:12) [GCC 12.2.0]",
"time": 1681821714.8444054,
"time_human_readable": "2023-04-18 14:41:54.844405",
"version": "2.2.0p1"
}general.json ファイルに加えて、Checkmk はこの標準設定で、ホストおよびサービスの数、Checkmk サーバーのハードウェア、サイトで設定された環境変数、サイト内のファイルの名前とサイズ、およびそこにインストールされている Python モジュールとそのバージョンなどのパフォーマンスデータを含むさらに別のファイルを生成します。Collect diagnostics をクリックすると開くBackground job details ページには、収集されるデータが正確に表示されます。
2.3. オプションの一般情報
Optional general information には、質問に合わせて事前にコンパイルできる項目、またはサポート担当者が明示的に要求する、あるいは要求する可能性のある項目があります。
ここで「Local Files and MKPs 」を選択すると、Checkmk は、サイトの~/local/ ディレクトリにあるすべてのファイルの概要も作成します。
これは、ローカルでのカスタマイズが Checkmk の最近のアップデートと互換性がない場合に役立つことがあります。
インストールされているすべてのMKP もここに含まれます。
OMD Config を選択すると、OMD の設定に関する情報をダンプに追加することができます。
これは、コマンドラインでomd config show コマンドを実行した場合とまったく同じ内容です。
{
"CONFIG_ADMIN_MAIL": "",
"CONFIG_AGENT_RECEIVER": "on",
"CONFIG_AGENT_RECEIVER_PORT": "8000",
"CONFIG_APACHE_MODE": "own",
"CONFIG_APACHE_TCP_ADDR": "127.0.0.1",
"CONFIG_APACHE_TCP_PORT": "5000",
"CONFIG_AUTOSTART": "off",
"CONFIG_CORE": "cmc",
"CONFIG_LIVEPROXYD": "on",
"CONFIG_LIVESTATUS_TCP": "off",
"CONFIG_LIVESTATUS_TCP_ONLY_FROM": "0.0.0.0 ::/0",
"CONFIG_LIVESTATUS_TCP_PORT": "6557",
"CONFIG_LIVESTATUS_TCP_TLS": "on",
"CONFIG_MKEVENTD": "on",
"CONFIG_MKEVENTD_SNMPTRAP": "off",
"CONFIG_MKEVENTD_SYSLOG": "on",
"CONFIG_MKEVENTD_SYSLOG_TCP": "off",
"CONFIG_MULTISITE_AUTHORISATION": "on",
"CONFIG_MULTISITE_COOKIE_AUTH": "on",
"CONFIG_PNP4NAGIOS": "on",
"CONFIG_TMPFS": "on"
}Checkmk Overview チェックボックスをオンにすると、Checkmk サーバーで実行されているすべてのサイトに関する一般的な情報が含まれます。 これにより、インストールされているすべての Checkmk バージョンのリストも作成されます。 また、上記で選択したサイトがクラスタのノードである場合は、その事実もここに記録されます。
Crash Reports オプションを使用すると、さまざまなカテゴリ（base 、check 、gui 、rest_apiなど）の最新のクラッシュレポートをダンプに追加できます。
クラッシュレポートの詳細については、エージェントベースのチェックプラグインのプログラミングに関する記事をご覧ください。
Checkmk では、クラッシュレポートはMonitor > System > Crash reports にあります。
Checkmk Log files またはCheckmk Configuration files を有効にすると、Pack only Low sensitivity files を選択して、パッケージのこの部分から機密データを削除することができます。
ここで選択できるファイルは、~/var/log/ または~/etc/checkmk/ ディレクトリおよびそのサブディレクトリにあるファイルです。
ドロップダウンメニューのすぐ下に、詳細なリストが表示されます。Select individual files from list オプションを使用すると、指定したファイルのみをダンプに含めることもできます。
このオプションを使用すると、機密レベルが「高 (H)」のファイル (パスワードを含むファイルなど)、 「中 (M)」のファイル (アドレスやユーザー名を含むファイルなど)、 「低 (L)」のファイル (その他のファイル) を確認することもできます。
注：ログファイルに Checkmk の動作に関するできるだけ詳細な情報を記録するには、Checkmk のログレベルを一時的に変更する必要がある場合があります。
対応する設定は、Setup > General > Global settings で確認できます。
このページで、Filter フィールドに「logging 」と入力し、たとえば、Core のログレベルを「Debug 」に設定します。
ここで、サイトを数分間そのまま実行するか、再現可能なエラーを繰り返し発生させると、このエラーに関する情報がログファイルに表示される可能性が高くなります。
次に、ダンプに「Performance Graphs of Checkmk Server 」を追加するオプションがあります。 特に Checkmk サイトのパフォーマンスに問題がある場合、これらのレポートはほとんどの場合要求されますので、このような問題が発生した場合は、これらのレポートを含めることをお勧めします。 サポート診断は、PDF ファイルとして複数のレポートを手動で生成する作業を行います。 とりわけ、過去 25 時間および過去 35 日間の「OMD mysite performance 」サービスからのレポートが生成されます。
2.4. コンポーネント固有の情報
Component specific information セクションでは、グローバルなCheckmk設定、ホストおよびフォルダ、通知設定のうち、ダンプに含める情報を非常に詳細に決定することができます。
重要：設定によっては、ここで選択するファイルには、パスワードなどの機密情報が含まれている場合があります。 通常、このデータは、サイトユーザーと管理者だけがアクセスできるため、保護されています。 分析のためにこのデータを第三者に提供する場合は、細心の注意を払って行ってください。
「Global Settings 」サブ項目には、Checkmk サイトの個々のコンポーネント（
動的構成デーモン（DCD）やライブステータスプロキシデーモンなど）のすべての「global.mk 」ファイルがあります。
サブ項目「Hosts and Folders 」で選択できる情報は、ホスト構成の好ましくないルールセットやエラーを見つけるのに役立ちます。
Notifications セクションには、対応する設定ファイルに加えて、ログファイルを選択するためのオプションがあります。 通知に問題が発生した場合、お客様、あるいは最終的には Checkmk サポートが、これらのログから問題の原因を見つけることができる場合が多くあります。
Business Intelligence オプションを使用して、ビジネスインテリジェンス用の設定ファイルを選択してください。CMC (Checkmk Microcore) またはLicensing information のいずれかのオプションを有効にした後、Pack only Medium and Low sensitivity files またはPack only Low sensitivity files を選択して、パッケージのそれぞれの部分から機密性の高いデータを削除することができます。
3. コマンドラインによるサポート診断
Checkmk ではよくあることですが、このタスクはターミナルから簡単に実行できます。
これは、cmk コマンドと--create-diagnostics-dump オプションを使用して簡単に実行できます。
上記のすべてのオプションについては、対応するパラメータをコマンドに追加することができます。
OMD[mysite]:~$ cmk --create-diagnostics-dump --local-files --omd-config --performance-graphs以下のオプションを使用すると、コマンドの出力が完了します。
|
|
|
|
|
Checkmk サーバーの HW/SW インベントリノードSoftware > Applications > Checkmk からの情報。 |
|
|
|
|
|
Checkmk サーバーのパフォーマンスグラフ (CPU 負荷、CPU 使用率など) — 商業版でのみ利用可能です。 |
上記、およびcmk コマンドのその他のオプションは、通常どおり、cmk --help の出力で確認できます。
4. ダンプに欠落している情報
4.1. 現在のエージェントが必要
サポート診断で完全な情報を出力するには、Checkmk サーバーにインストールされているエージェントのバージョン番号が Checkmk サーバーのバージョン番号と同じであることを確認する必要があります。 特に、Checkmk サーバーの HW/SW インベントリから取得される情報は、古いバージョンのエージェントではまだ提供されていない場合があります。
4.2. ラベル cmk/check_mk_server:yes
サポート診断は、お使いの環境の Checkmk サーバーに適切なラベルが付けられているかどうかによって異なります。
ダンプにデータの一部が欠落している場合は、Checkmk サーバーにcmk/check_mk_server:yes ラベルが付けられているかどうかを確認してください。