このページで
Webインターフェースモジュール
概要
Zabbixのソースコードを変更することなく、サードパーティ製モジュールを追加したり、独自のモジュールを開発したりすることで、Zabbix Webインターフェースの機能を拡張できます。
モジュールのコードは、Zabbixのソースコードと同じ権限で実行されることに注意してください。これは次を意味します。
- サードパーティ製モジュールは有害である可能性があります。インストールするモジュールは信頼できるものでなければなりません。
- サードパーティ製モジュールのコードにエラーがあると、Webインターフェースがクラッシュする場合があります。 その場合は、Webインターフェースからモジュールのコードを削除してください。 Zabbix Webインターフェースを再読み込みすると、いくつかのモジュールが存在しないことを示すメッセージが表示されます。 モジュール管理（Administration > General > Modules）に移動し、Scan directory をもう一度クリックして、存在しないモジュールをデータベースから削除してください。
インストール
特定のモジュールについては、必ずインストールマニュアルをお読みください。 失敗を簡単に検出できるよう、新しいモジュールは1つずつインストールすることを推奨します。
モジュールをインストールする直前に、次の点を確認してください。
- モジュールを信頼できるソースからダウンロードしたことを確認してください。 悪意のあるコードをインストールすると、データ損失などの結果を招く可能性があります。
- 同じモジュールの異なるバージョン（同じID）は並行してインストールできますが、有効化できるのは一度に1つのバージョンだけです。
モジュールをインストールする手順:
- モジュールを、Zabbix Webインターフェースのインストール先にある
modulesディレクトリ内の専用フォルダに展開します（例:zabbix/ui/modules）。 - モジュールフォルダに少なくとも
manifest.jsonファイルが含まれていることを確認します。 - モジュール管理 に移動し、ディレクトリをスキャン ボタンをクリックします。
- 新しいモジュールが、バージョン、作成者、説明、ステータスとともに一覧に表示されます。
- ステータスをクリックしてモジュールを有効化します。
トラブルシューティング:
| 問題 | 解決策 |
|---|---|
| モジュールが一覧に表示されない | モジュールが一覧に表示されない場合は、manifest.json が modules/your-module/ に存在することを確認してください。存在しない場合、モジュールを誤ったディレクトリに展開した可能性があります。存在する場合は、そのモジュールが使用中の Zabbix バージョンと互換性がない可能性があります。また、Webサーバーのユーザーに、モジュールフォルダおよびすべてのサブディレクトリに対する少なくとも読み取りおよび検索権限 (r-x) があり、フォルダ内のすべてのファイルに対する読み取り権限 (r--) があることも確認してください。 |
| Webインターフェースがクラッシュした | モジュールのコードが現在の Zabbix バージョンまたはサーバー設定と互換性がありません。モジュールファイルを削除して、Webインターフェースを再読み込みしてください。いくつかのモジュールが存在しないという通知が表示されます。モジュール管理 に移動し、もう一度 ディレクトリをスキャン をクリックして、存在しないモジュールをデータベースから削除してください。 |
| 同一の namespace、ID、または actions に関するエラーメッセージが表示される | 新しいモジュールが、他の有効なモジュールによってすでに登録されている namespace、ID、または actions を登録しようとしました。新しいモジュールを有効化する前に、競合しているモジュール（エラーメッセージに記載）を無効化してください。 |
| 技術的なエラーメッセージが表示される | エラーをモジュールの開発者に報告してください。 |
モジュールの開発
カスタムモジュールの開発の詳細については、開発者センターを参照してください。