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 は非常にモジュール構造になっており、Python プログラミングの知識があれば、この構造を多くの部分で拡張することができます。 とりわけ、Checkmk は以下のエレメントで拡張することができます。

  • 設定環境用の入力マスクを含む、独自のチェックおよびエージェントプラグイン。

  • CheckmkHW/SW インベントリ用の独自のプラグイン

  • GUI の拡張機能(ビュー、ダッシュボード、列、アイコンなど)。

  • グラフまたはパーフオメーターの定義

  • 通知およびアラートハンドラースクリプト(シェルまたはその他のスクリプト言語でも可)。

これらの拡張機能はすべて、Checkmk サイト内の~/local ディレクトリに追加ファイルを配置することで実装できます。 これらの拡張機能を管理し、分散環境に展開し、他のユーザーと共有するために、Checkmk は独自のパッケージ形式であるCheckmk 拡張パッケージ(略称MKP を提供しています。

MKP には、必要な拡張機能を任意にセットして含めることができます。たとえば、関連マニュアルページ、閾値設定環境、関連メトリック定義を含む一連のチェックプラグインなどです。 さらに、エージェントベーカリーによる配布用の設定も含めることができます。 MKP には名前とバージョン番号が付けられ、簡単な操作でインストールまたは削除することができます。

Tip

テストサイトを使用して MKP を作成およびカスタマイズし、MKP を本番用サイトにコピーしてデプロイします。 これにより、変更したファイルを MKP にタイムリーにパッケージ化しなかった場合に発生する 2 つの主な問題を防ぐことができます。

  • Checkmk のアップデート中に、ローカルで変更されたファイルが最新の MKP 状態によって上書きされます(この文章の著者にもまさにこの事態が発生しました)。

  • セントラルセットアップによる分散監視では、リモートサイトのプラグインがセントラルサイトとは異なった動作をするため、 リモートサイトには最後のパッケージ化された状態が反映されるため、不思議に思うでしょう。

1.1. Checkmk Exchange

Checkmk Exchange では、プラグインのプログラマーが他の Checkmk ユーザー向けにパッケージを提供し、それらを相互に交換することができます。 Exchange から、拡張機能を無料でダウンロードして使用することができます。 Exchange のパッケージは、他のユーザーによって自主的に共有されているものであり、いかなる保証も付随していないことにご注意ください。

不適切にプログラムされたプラグインは、CPU/システムの負荷やメモリ要件の増加につながる可能性があります。 さらに、MKP が CMK の古いバージョン用に開発されている場合、完全には互換性がない可能性があります。 極端な場合、データが失われる危険性があります。 したがって、サードパーティの MKP を本番環境で使用する前に、まずテストサイトにインストールすることを強くお勧めします。

1.2. MKPs用のツール

MKP を管理するためのツールは 2 つあります。

  • mkp コマンド

  • セットアップメニューの「Extension Packages 」項目(商業版のみ

ここでは、これらの管理ツールについて詳しく説明します。 これらのツールは互いに互換性があるため、コマンドラインコマンドとExtension Packages を「混乱させることなく」両方使用することができます。

2. セットアップメニューによる拡張パッケージの管理

GUI による MKP の管理機能は、Checkmk の商業版にのみ搭載されています。Setup メニューから、Setup > Maintenance > Extension packages を選択して MKP の管理画面を開きます。 ここでは、MKP のインストール、変更、作成を行うことができます。

mkp manager sidebar

2.1. MKP の追加

たとえば、Exchange からダウンロードした MKP は、[Upload package ] ボタンをクリックして Checkmk にアップロードすると、インストール可能になります。 そのためには、そのファイルが web ブラウザを実行しているマシンにも存在している必要があります。 パッケージのファイル名には、.mkp という拡張子を含める必要があります。

mkp manager upload

インストール後、拡張パッケージが最初に利用可能になります。これは、All packages (enabled or disabled) にあります。

mkp manager present not active

2.2. MKP の有効化

プラグアイコンをクリックすると、利用可能なパッケージが有効になります。 有効化すると、ファイルは~/local/ のフォルダ階層にインストールされます。 パッケージの説明ファイルも~/var/check_mk/packages/ に保存されます。 有効化すると、パッケージは有効化およびアクティブなMKP のリスト(Enabled (active on this site) )にも表示されます。

mkp manager list active

次に、変更のアクティブ化を実行すると、パッケージのすべての機能がシステムに固定され、使用可能になります。

2.3. パッケージの使用停止および削除

パッケージの完全な削除も 2 段階で行います。 ボタンを使用して、まずアクティブなパッケージのリストでパッケージを非アクティブにします。 このステップでは、インストールされたファイルは削除されますが、MKP は保持されます。このステップでは、アクティブ化が元に戻されるだけです。

すべてのパッケージのリストにある アイコンを使用すると、インストール済みで未使用のパッケージを再度削除することができます。 削除すると、パッケージが削除され、拡張機能も完全に削除されます。これは、パッケージの追加とは逆の操作です。

2.4. 分散環境における MKP

セントラルセットアップによる分散監視の場合、パッケージをセントラルサイトで利用可能にするだけで十分です。 セントラルサイトに関連付けられている各リモートサイトについて、そのリモートサイトにカスタマイズを反映するかどうかを個別に決定することができます。Replicate extensions オプションをアクティブにするだけです。 その後、同期時に、~/local ディレクトリ内のMKPおよびその他のすべての変更も転送されます。

mkp distr wato

特定の転送を行いたくない場合は、そのサイトまたはすべてのサイトのこのオプションをオフにしてください。

重要:中央セットアップのカスタマイズは、[Enable replication ] オプションが [Push configuration to this site] に設定されている場合にのみ転送されます。

2.5. 特別なケース:有効だが非アクティブなパッケージ

特別な状況として、使用している Checkmk バージョンと一致しないパッケージのアクティベーションが試みられる場合があります。 有効になっているものの、互換性のない Checkmk バージョンによりアクティベーションに失敗したパッケージは、Enabled (inactive on this site) リストに追加されます。

mkp manager all states

しかし、使用している Checkmk バージョンと一致しないパッケージをインストールする理由は何でしょうか? 2 つの理由が考えられます。

  1. Checkmk バージョンのアップデート: 古いバージョンと新しいバージョンの両方のパッケージを保存しておくことができます。次回アップデートを実行すると、新しいパッケージが自動的に有効になります。

  2. 分散監視: 更新を容易にするため、リモートサイトの Checkmk のメジャーバージョンは、セントラルサイトよりも 1 つ高いバージョンにすることができます。 しかし、これまでは、MKP は両方のメジャーバージョンと互換性がある必要があったため、MKP の配布が困難でした。 不一致のパッケージのロックを解除する機能により、ソースバージョンとターゲットバージョンの両方に一致するパッケージをセントラルサイトに保持することができます。 新しいバージョンは、更新時に自動的にアクティブ化されます。

上のスクリーンショットのバージョン番号から、これは Checkmk2.1.0 セントラルサイトであり、2.2.0 にすでにアップグレードされているリモートサイトにパッケージを提供していることがわかります。

3. コマンドラインから拡張パッケージを管理する

上記の操作はすべて、コマンドラインでも実行できます。 この目的には、mkp コマンドを使用します。 サブコマンドを指定せずにこのコマンドを呼び出すと、使用方法に関するヒントが表示されます。 ここでは、約 50 行ある出力をわかりやすくするために半分以下に省略しています。

OMD[mysite]:~$ mkp
usage: mkp [-h] [--debug] [--verbose] {find,inspect,show,show-all,files,list,add,...}

Command line interface for the Checkmk Extension Packages

options:
  -h, --help            show this help message and exit
  --debug, -d
  --verbose, -v         Be more verbose

available commands:
  {find,inspect,show,show-all,files,list,add,...}
    find                Show information about local files.
    inspect             Show manifest of an MKP file.
    show                Show manifest of a stored package.
    show-all            Show all manifests.
    files               Show all files beloning to a package.
    list                Show a table of all known files, including the deployment state.
    add                 Add an MKP to the collection of managed MKPs.
[...]

以下のセクションでは、MKP を管理するための最も重要なコマンドを紹介します。 便利なコマンドリファレンス表は、この記事の最後に掲載しています。

3.1. MKP の追加

パッケージの追加は、mkp add を使用して行います。 もちろん、そのためにはまず、MKP ファイルを Checkmk サーバーに(scp などで)取り込む必要があります。 次に、次のコマンドを実行します。

OMD[mysite]:~$ mkp add /tmp/hello_world-0.2.5.mkp

mkp list で、利用可能なパッケージのリストを要求します。 インストール後、拡張パッケージは最初は利用可能ですがアクティブではありません。リストでは、Disabled という状態になります。

OMD[mysite]:~$ mkp list
Name        Version Title        Author                 Req. Version Until Version Files State
----------- ------- ------------ ---------------------- ------------ ------------- ----- --------
hello_world 0.2.5   Hello world! Checkmk knowledge team 2.3.0b1      2.5.99        8     Disabled

3.2. MKP の有効化

enable サブコマンドを使用しないと、利用可能なパッケージは有効になりません。 バージョン番号を指定する必要があるのは、名前だけで一意ではない場合のみです。

OMD[mysite]:~$ mkp enable hello_world 0.2.5

アクティブ化すると、ファイルは~/local/ 内のディレクトリ階層にインストールされ、パッケージの説明ファイルは~/var/check_mk/packages/ に配置されます。 その結果、パッケージはEnabled (active on this site) 状態になります。

OMD[mysite]:~$ mkp list
Name        Version Title        Author                 Req. Version Until Version Files State
----------- ------- ------------ ---------------------- ------------ ------------- ----- -----------------------------
hello_world 0.2.5   Hello world! Checkmk knowledge team 2.3.0b1      2.5.99        8     Enabled (active on this site)

個々のパッケージの詳細は、mkp show で確認できます。実際の有効化ステータスは関係ありません。

OMD[mysite]:~$ mkp show hello_world 0.2.5
Name:                          hello_world
Version:                       0.2.5
Packaged on Checkmk Version:   2.4.0b1
Required Checkmk Version:      2.3.0b1
Valid until Checkmk version:   2.5.99
Title:                         Hello world!
Author:                        Checkmk knowledge team
Download-URL:                  https://docs.checkmk.com/latest/en/devel_check_plugins.html
Files:
  Agents
    plugins/hello_world
    windows/plugins/hello_world.cmd
  Additional Checkmk plug-ins by third parties
    hello_world/agent_based/hello_world.py
    hello_world/checkman/hello_world
    hello_world/graphing/helloworld_perfometer_graphing.py
    hello_world/rulesets/ruleset_hello_world.py
    hello_world/rulesets/ruleset_hello_world_bakery.py
  Libraries
    python3/cmk/base/cee/plugins/bakery/hello_world.py
Description:
  This is a very basic plugin with the sole purpose to be used as template for your own plugin development...

3.3. パッケージの無効化と削除

パッケージのアンインストールは 2 段階で行います。 まず、mkp disable でパッケージを使用不能にします。 これにより、インストールされているファイルは削除されますが、パッケージは残ります。これは、後で再び有効にする場合などに備えています。 ここでも、パッケージ名だけで一意でない場合にのみ、バージョン番号を指定する必要があります。

OMD[mysite]:~$ mkp disable hello_world 0.2.5

パッケージリストで、mkp list を再度呼び出すと、Disabled の状態が表示されます。

OMD[mysite]:~$ mkp list
Name        Version Title        Author                 Req. Version Until Version Files State
----------- ------- ------------ ---------------------- ------------ ------------- ----- --------
hello_world 0.2.5   Hello world! Checkmk knowledge team 2.3.0b1      2.5.99        8     Disabled

mkp remove のみがパッケージを不可逆的に削除します:

OMD[mysite]:~$ mkp remove hello_world 0.2.5

3.4. 特別なケース:有効だが非アクティブなパッケージ

使用中の Checkmk バージョンと一致しないパッケージがインストールされている場合は、特別な状況となります。

OMD[mysite]:~$ mkp install hello_world-0.3.0.mkp
The package requires Checkmk version 2.5.0, but you have 2.3.0p23 installed.

このようなパッケージは有効化できますが、Checkmk のバージョンが互換性がないため有効化は失敗し、パッケージは「Enabled (inactive on this site) 」の状態になります。

OMD[mysite]:~$ mkp list
Name        Version Title        Author                 Req. Version Until Version Files State
----------- ------- ------------ ---------------------- ------------ ------------- ----- -------------------------------
hello_world 0.3.0   Hello world! Checkmk knowledge team 2.5.0b1      2.6.99        8     Enabled (inactive on this site)
hello_world 0.2.5   Hello world! Checkmk knowledge team 2.3.0b1      2.5.99        8     Enabled (active on this site)

互換性のないパッケージをインストールする(つまり、分散環境でのアップデート)ことを選択する可能性のある状況については、上記の「セットアップ」セクションで説明しました。 セットアップの手順と同様に、mkp enable packagename version を使用してパッケージを有効にし、mkp disable packagename version を使用して既存の有効化を無効にしてください。

4. 開発者向けのMKP

プログラミングを知っている、あるいは学んでいる私たちのほとんどは、巨人の肩の上に立って、彼らよりも遠くを見通せる小人」のような存在です。 オープンソースでは、他の人が以前に作成した成果を実際に活用することができます。 Checkmk の場合、これは拡張機能に特に当てはまります。拡張機能は、GPL の文脈では Checkmk 自体から派生した作品であり、Checkmk 自体も GPL (バージョン 2.0) の対象となっています。 具体的には、Checkmk Exchangeからダウンロードしたパッケージを、お好きなように (あるいは現在のニーズに合わせて) カスタマイズすることができます。

以下のセクションでは、小さな変更を加えた再パッケージ化から、既存の(例)パッケージの解決、パッケージ化されていないファイルのコンパイルまで、関連するすべてのステップを、通常実行される順序で説明します。

Checkmk 用の独自のプラグインをプログラミングまたは変更する場合は、既存の プログラミングインターフェースおよびエージェントベーカリーへの統合に関する記事をご覧ください。

4.1. パッケージの編集

軽微なエラーの修正では、構造や名前を変更せずに既存のパッケージを適応させる必要がある場合がよくあります。 この場合、ファイルシステムに保存されている既存のファイルを変更するだけでなく、少なくともパッケージのバージョン番号も更新することをお勧めします。 Checkmk の API の変更によりパッケージの変更が必要な場合は、パッケージに保存されているサポートされる最小バージョンおよび最大バージョンのバージョン番号も調整してください。 さらに、エージェントベーカリーを使用している場合、新しい MKP が存在すると、エージェントパッケージの再構築がトリガーされます。

商業版では、アイコンを使用して変更ダイアログを表示してください。

mkp edit description

Checkmk Rawユーザーは、代わりにresolveおよびrecreate を使用して、次の 2 つの手順を実行してください。

4.2. パッケージの展開

セットアップメニュー

パッケージの展開は、~/local/ 内のパッケージ化されたファイルを「解放」し、パッケージの説明のみを削除します。 その結果、ファイルは展開され、拡張機能は有効なままになります。 これは、以前に展開されたファイルからパッケージを作成する操作の逆です。

実際には、拡張機能をカスタマイズして、その変更を反映するために再パッケージ化したい場合に、パッケージの解凍が必要になる場合がほとんどです。 たとえば、実際には何の役にも立たないが、最初のカスタムパッケージのテンプレートとして使えるHello world!の例から始めてみてください。

コマンドライン

コマンドラインでは、mkp release コマンドを使用してパッケージをリリースできます。 このコマンドを実行するには、解凍するパッケージがEnabled (active on this site) 状態である必要があります。 実際の拡張機能ファイルは保持され、パッケージの説明のみが削除されます。

OMD[mysite]:~$ mkp release hello_world

元のパッケージはそのまま残って、状態がEnabled (inactive on this site) になります。 したがって、カスタマイズ中に問題が発生した場合のバックアップとしても使用できます。 その場合は、「余分な」ファイルを削除し、パッケージを再度有効にして、最初からやり直してください。

4.3. パッケージ化されていないファイルの検索

セットアップメニュー

プログラミングやカスタマイズ作業が完了したら、既存のファイルと追加したファイルを再度見つける必要があります。 これらのファイルは現在どのパッケージにも属していないため、セットアップの「Unpackaged files 」にリストされています。

mkps unpackaged
Unpackaged files のリストと「Create package 」ボタン

コマンドライン

コマンドラインでは、mkp find を使用します。

OMD[mysite]:~$ mkp find
File                                                    Package Version Part                                         Mode
------------------------------------------------------- ------- ------- -------------------------------------------- ----------
hello_world/rulesets/ruleset_hello_world_bakery.py                      Additional Checkmk plug-ins by third parties -rw-------
hello_world/agent_based/hello_world.py                                  Additional Checkmk plug-ins by third parties -rw-------
hello_world/checkman/hello_world                                        Additional Checkmk plug-ins by third parties -rw-------
hello_world/rulesets/ruleset_hello_world.py                             Additional Checkmk plug-ins by third parties -rw-------
hello_world/graphing/helloworld_perfometer_graphing.py                  Additional Checkmk plug-ins by third parties -rw-------
plugins/hello_world                                                     Agents                                       -rwx------
windows/plugins/hello_world.cmd                                         Agents                                       -rwx------
python3/cmk/base/cee/plugins/bakery/hello_world.py                      Libraries                                    -rw-------

不要なファイルを削除するか、新しいパッケージに含めないファイルをメモします。 次のステップで、パッケージ化されていないファイルが再びパッケージに結合されます。

4.4. パッケージの作成

セットアップメニュー

パッケージ化されていないファイルの概要にある「Create package 」ボタンをクリックすると、新しいパッケージを作成するためのダイアログが表示されます。

mkps create

明らかな詳細情報に加え、パッケージ化するファイルを 1 つ以上選択することが重要です。 パッケージを作成すると、~/var/check_mk/packages/ にパッケージの説明も作成されます。 この説明には、一般的な情報および含まれるファイルのリストが含まれます。 もちろん、Checkmk のサポートする最大バージョンは、水晶玉がなければ予測することは困難です。

Tip

Checkmk2.3.0 で導入された新しい API を使用する拡張機能は、フューチャープルーフであり、Checkmk2.5.0 まで、調整なしで動作します。 この場合、Valid until Checkmk version に、サポートされる Checkmk の最大バージョンとして 2.5.99 を入力できます。 この記事の改訂時点では、それ以降の将来については何もお答えできません。

この新しく作成されたパッケージは、パッケージリストのアイコンから MKP ファイルとしてダウンロードできます。たとえば、別のシステムに転送したり、Exchange にアップロードしたりすることができます。

コマンドライン

コマンドラインで MKP を作成する手順は、セットアップメニューの手順と同様です。 まず、mkp template を使用して、これらのファイルすべてを(現時点では)含むパッケージ構成を作成します。 新しいパッケージの希望名をパラメータとして指定します。

OMD[mysite]:~$ mkp template hello_world_ng
Created 'tmp/check_mk/hello_world_ng.manifest.temp'.
You may now edit it.
Create the package using mkp package tmp/check_mk/hello_world_ng.manifest.temp.

テキストエディタでパッケージのプロパティを編集します。

tmp/check_mk/hello_world_ng.manifest.temp
{'author': 'Add your name here',
 'description': 'Please add a description here',
 'download_url': 'https://example.com/hello_world_ng/',
 'files': {'agents': ['plugins/hello_world', 'windows/plugins/hello_world.cmd'],
           'cmk_addons_plugins': ['hello_world/agent_based/hello_world.py',
                                  'hello_world/checkman/hello_world',
                                  'hello_world/graphing/helloworld_perfometer_graphing.py',
                                  'hello_world/rulesets/ruleset_hello_world.py',
                                  'hello_world/rulesets/ruleset_hello_world_bakery.py'],
           'lib': ['python3/cmk/base/cee/plugins/bakery/hello_world.py']},
 'name': 'hello_world_ng',
 'title': 'Title of hello_world_ng',
 'version': '1.0.0',
 'version.min_required': '2.3.0p27',
 'version.packaged': 'cmk-mkp-tool 0.2.0',
 'version.usable_until': None}

このファイルを必要に応じて編集します。 Python の構文に注意してください。たとえば、Unicode 文字列 (ウムラウトなどの ASCII 以外の文字を含むテキスト) の先頭には、小文字のu を付ける必要があります。

files エントリでは、パッケージ化しないファイルを削除することができます。version.min_required に、パッケージを使用するために必要な Checkmk の最小バージョンを入力します。

設定が完了したら、mkp package で MKP ファイルを作成できます。

OMD[mysite]:~$ mkp package tmp/check_mk/hello_world_ng.manifest.temp
Successfully created hello_world_ng 1.0.0
Successfully wrote package file
Removing packaged files before reinstalling...
[hello_world_ng 1.0.0]: Removed file local/share/check_mk/agents/plugins/hello_world
[hello_world_ng 1.0.0]: Removed file local/share/check_mk/agents/windows/plugins/hello_world.cmd
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk_addons/plugins/hello_world/graphing/helloworld_perfometer_graphing.py
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk_addons/plugins/hello_world/agent_based/hello_world.py
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk_addons/plugins/hello_world/rulesets/ruleset_hello_world.py
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk_addons/plugins/hello_world/rulesets/ruleset_hello_world_bakery.py
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk_addons/plugins/hello_world/checkman/hello_world
[hello_world_ng 1.0.0]: Removed file local/lib/python3/cmk/base/cee/plugins/bakery/hello_world.py
[hello_world_ng 1.0.0]: Installing
Successfully installed hello_world_ng 1.0.0

パッケージは、~/var/check_mk/packages_local に保存されます。

OMD[mysite]:~$ ll ~/var/check_mk/packages_local/*.mkp
-rw-rw---- 2 mysite mysite 4197 Mar 15 13:37 hello_world_ng-1.0.0.mkp

5. MKP パッケージ形式

新しい拡張パッケージを開発マシンでプログラムしてパッケージ化し、完成したパッケージを Checkmk サーバーに転送してテストしたい場合もあるでしょう。 MKP フォーマットは、.tar ファイルとマニフェストファイルを含む単なる.tar.gz ファイルであるため、これは非常に簡単です。

ダウンロードしたhello_world-0.2.5.mkp を調べると、その構造の最初のレベルがわかります。

user@host:~$ tar tvf hello_world-0.2.5.mkp
-rw-r--r-- 0/0            1715 2025-03-07 16:19 info
-rw-r--r-- 0/0            1311 2025-03-07 16:19 info.json
-rw-r--r-- 0/0           10240 2025-03-07 16:19 agents.tar
-rw-r--r-- 0/0           20480 2025-03-07 16:19 cmk_addons_plugins.tar
-rw-r--r-- 0/0           10240 2025-03-07 16:19 lib.tar

パッケージを一時ディレクトリに解凍すると、含まれている tar アーカイブの内容をビューできます。 ファイルパスは、それぞれのコンポーネントを含むディレクトリを基準としています。

user@host:~$ tar tvf cmk_addons_plugins.tar
-rw------- mysite/mysite 3711 2025-03-07 10:59 hello_world/agent_based/hello_world.py
-rw------- mysite/mysite 1079 2025-03-07 10:59 hello_world/checkman/hello_world
-rw------- mysite/mysite 1179 2025-03-07 10:59 hello_world/graphing/helloworld_perfometer_graphing.py
-rw------- mysite/mysite 3373 2025-03-07 10:59 hello_world/rulesets/ruleset_hello_world.py
-rw------- mysite/mysite 2634 2025-03-07 10:59 hello_world/rulesets/ruleset_hello_world_bakery.py

infoinfo.json という 2 つのマニフェストファイルについてはどうでしょうか。info ファイルとその Python Dict 形式のフィールドはすでに上で確認しました。 JSON 形式のinfo.json には、まったく同じフィールドと値が含まれていますが、JSON 形式でシリアル化されています。 スクリプトの一部としてパッケージを構築する場合は、Python dict ファイルinfo を入力し、パッケージ化する前に、このファイルから JSON ファイルinfo.json を生成する必要があります。

アーカイブを再パッケージ化するときは、~/local フォルダ階層に含まれていないファイルパスが含まれないように注意してください。 最上位レベルには、マニフェストファイルと tar ファイルのみが含まれている必要があります。

6. コマンドリファレンス

6.1. 管理

サブコマンド パラメータ 機能

add

追加するパッケージのファイル名

パッケージを使用可能にしますが、まだ有効にはしません。

enable

パッケージの名前(バージョン番号がある場合はその番号も)

バージョン互換性に応じて、ローカルで使用するため、またはリモートサイトに配布するためにパッケージをアクティブにします。

disable

パッケージの名前とバージョン番号

パッケージを無効にします。パッケージはファイルシステムには残ります。

remove

パッケージ名とバージョン番号

以前に使用不能にしたパッケージを完全に削除します。

install

追加するパッケージのファイル名

このサブコマンドは非推奨となり、近日中に削除されます!

list

なし

使用可能なすべてのパッケージとその有効化状態をリストします。

inspect

検査するパッケージのファイル名

アンインストールされた MKP に関する情報を表示します。

show

パッケージの名前(バージョン番号がある場合はその番号も)

利用可能な MKP に関する情報を表示します。

show-all

なし

利用可能なすべての MKP に関する情報を表示します。

files

パッケージ名(バージョン番号がある場合)

パッケージに属するすべてのファイルをリストします。

6.2. 開発

サブコマンド パラメーター 機能

release

パッケージの名前

アクティブなパッケージを解決します。

find

なし

どのパッケージにも属していないすべてのファイルをリストします。

template

作成する新しいパッケージの名前

新しいパッケージのベースとなるマニフェストファイルを作成します。

package

マニフェストファイルへのパス

マニフェストファイルの内容に基づいて MKP を作成します。

6.3. 更新

サブコマンド パラメーター 関数

disable-outdated

なし

更新後に Checkmk バージョンと一致しなくなったパッケージを無効にします。

update-active

なし

更新後に Checkmk バージョンと一致するパッケージを有効にします。

このページでは