3 Webインターフェースモジュール

概要

Zabbixのフロントエンド機能は、サードパーティ製のモジュールを追加したり、独自のモジュールを開発したりすることで拡張できます。Zabbixのソースコードを変更する必要はありません。

モジュールのコードはZabbixのソースコードと同じ権限で実行されることに注意してください。これは以下のことを意味します:

  • サードパーティ製のモジュールは有害な場合があります。インストールするモジュールを信頼できるものにしてください。
  • サードパーティ製モジュールのコードにエラーがあると、フロントエンドがクラッシュする可能性があります。その場合は、フロントエンドからモジュールのコードを削除してください。Zabbixフロントエンドをリロードすると、いくつかのモジュールが存在しないというメッセージが表示されます。モジュール管理（管理 → 一般 → モジュール）に移動し、ディレクトリのスキャンを再度クリックして、データベースから存在しないモジュールを削除してください。

インストール

特定のモジュールについては、必ずインストールマニュアルをお読みください。失敗を簡単に検出できるよう、新しいモジュールは1つずつインストールすることを推奨します。

モジュールをインストールする直前に、次の点を確認してください。

  • モジュールを信頼できるソースからダウンロードしたことを確認してください。悪意のあるコードをインストールすると、データ損失などの結果を招く可能性があります
  • 同じモジュール（同じ ID）の異なるバージョンは並行してインストールできますが、有効化できるのは一度に1つのバージョンだけです

モジュールをインストールする手順:

  • Zabbix Webインターフェースの modules フォルダ内に、モジュール専用のフォルダを作成して展開します
  • モジュールフォルダに少なくとも manifest.json ファイルが含まれていることを確認します
  • モジュール管理 に移動し、ディレクトリをスキャン ボタンをクリックします
  • 新しいモジュールが、バージョン、作成者、説明、ステータスとともに一覧に表示されます
  • ステータスをクリックしてモジュールを有効化します

トラブルシューティング:

Problem Solution
Module did not appear in the list モジュールが一覧に表示されない場合は、modules/your-module/ に manifest.json が存在することを確認してください。存在しない場合、モジュールを誤ったディレクトリに展開した可能性があります。存在する場合は、そのモジュールが使用中の Zabbix バージョンと互換性がない可能性があります。また、Webサーバーのユーザーに、モジュールフォルダおよびすべてのサブディレクトリに対して少なくとも読み取りおよび検索アクセス (r-x) があり、内部のすべてのファイルに対して読み取りアクセス (r--) があることも確認してください。
Frontend crashed モジュールのコードが現在の Zabbix バージョンまたはサーバー設定と互換性がありません。モジュールファイルを削除して Webインターフェースを再読み込みしてください。一部のモジュールが存在しないという通知が表示されます。モジュール管理 に移動し、もう一度 ディレクトリをスキャン をクリックして、存在しないモジュールをデータベースから削除してください。
Error message about identical namespace, ID or actions appears 新しいモジュールが、他の有効なモジュールによってすでに登録されている namespace、ID、または actions を登録しようとしました。新しいモジュールを有効化する前に、競合しているモジュール（エラーメッセージに記載されています）を無効化してください。
Technical error messages appear エラーをモジュールの開発者に報告してください。

モジュールの開発

カスタムモジュールの開発の詳細については、開発者センターを参照してください。