14 プラグイン

概要

プラグインは、Zabbixの監視機能を拡張するためのオプションです。プラグインはGoプログラミング言語で記述され、
Zabbix agent 2のみでサポートされています。

プラグインはloadable modules (C言語で記述)に代わるもので、Zabbix機能を拡張するその他の方法として、
user parameters（agent メトリクス）、external checks（agent レス監視）や
system. run[] Zabbix agent item があります。

以下の機能は、agent 2およびそのプラグインに固有のものです:

• passive および active なチェックのためのスケジュールされた柔軟な間隔のサポート
• スケジュールとタスクの同時実行に関するタスクキュー管理
• プラグインレベルのタイムアウト

Zabbix6.0.0以降、プラグインは agent 2に直接組み込む必要はなく、別の外部アドオン（ローダブルプラグイン）として
追加できるため、新しい監視指標を収集するための追加プラグインの作成作業が容易になりました。

このページでは、Zabbixネイティブプラグインの一覧と、ユーザの視点からのプラグイン設定の原則を説明します。
独自のプラグインを作成する方法については、Plugin development guidelinesを参照してください。

プラグインの設定

このセクションでは、一般的なプラグイン設定の原則とベストプラクティスについて説明します。

すべてのプラグインは Plugins.* パラメータを使用して設定します。このパラメータは、Zabbix agent 2の[configuration file]（/manual/appendix/config/zabbix_agent2）の一部、
またはプラグイン自身の[configuration file]（/manual/appendix/config/zabbix_agent2_plugins）のいずれかに設定することが
できます。プラグインが別の設定ファイルを使用する場合、Zabbix agent 2設定ファイルのIncludeパラメータにこのファイルへの
パスを指定する必要があります。

各プラグインのパラメータは、以下のような構造になっている必要があります:

Plugins.<PluginName>.<Parameter>=<Value>

パラメータ名は、以下の要件を満たす必要があります:

• プラグイン名は大文字にすることを推奨します。
• パラメータは大文字にする必要があります。
• 特殊文字は使用できません。
• ネストは最大レベルによって制限されません。
• パラメータの数は制限されません。

名前付きセッション

名前付きセッションは、プラグインパラメータの追加レベルを表し、監視対象の各インスタンスに対して個別の認証パラメータ
セットを定義するために使用することができます。各名前付きセッションのパラメータは、以下のような構造になっている
必要があります:

Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>

URI、ユーザー名、パスワードを別々に指定する代わりに、セッション名を connString の item キーパラメーターとして
使用することができます。item キーでは、最初のパラメータは connString または Uri のいずれかにすることができます。
最初のキーパラメータが設定ファイルで指定されたセッション名と一致する場合、名前付きセッションパラメータを使用して
チェックが実行されます。最初のキーパラメータがどのセッション名にも一致しない場合、それはUri として扱われます。

ただし、:

• キーパラメーターに connString (セッション名) を指定する場合、ユーザー名とパスワードのキーパラメーターは空である 必要があります。
• 埋め込み URI の認証情報を渡すことはサポートされていませんので、代わりに名前付きセッションの使用を検討してください。
• 名前付きセッションで認証パラメータが指定されない場合、ハードコードされたデフォルト値が使用されます。

使用可能な名前付きセッションパラメータのリストはプラグインによって異なります。詳細は
各プラグインの configuration files を参照してください。

例: 2つのインスタンス "MySQL1" と "MySQL2" の監視は、以下のように設定することができます。:

Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
       Plugins.Mysql.Sessions.MySQL1.User=<UsernameForMySQL1>
       Plugins.Mysql.Sessions.MySQL1.Password=<PasswordForMySQL1>    
       Plugins.Mysql.Sessions.MySQL2.Uri=tcp://127.0.0.1:3307   
       Plugins.Mysql.Sessions.MySQL2.User=<UsernameForMySQL2>
       Plugins.Mysql.Sessions.MySQL2.Password=<PasswordForMySQL2>

これらの名前は、URIの代わりにキーの connString として使用することができます:

mysql.ping[MySQL1]
       mysql.ping[MySQL2]

ハードコードされたデフォルト値

認証に必要なパラメータが item キーや名前付きセッションパラメータで提供されない場合、プラグインはハードコードされた
デフォルト値を使用します。

コネクション

プラグインによっては、複数のインスタンスから同時にメトリクスを収集することをサポートしています。
ローカルとリモートの両方のインスタンスを監視することができます。TCP および Unix ソケット接続がサポートされています。

インスタンスへの接続をオープン状態に保つようにプラグインを設定することをお勧めします。その利点は、ネットワークの輻輳、
レイテンシー、およびCPUとメモリの使用量を削減できることです。クライアントライブラリは、この処理を行います。

すぐに使えるプラグイン

Zabbix agent 2がサポートする全てのメトリクスはプラグインによって収集されます。
Zabbix agent 2用の以下のプラグインがすぐに利用可能です
: