3 フロントエンドモジュール

概要

サードパーティ製モジュールを追加したり独自のモジュールを開発したりすることで、Zabbixのソースコードを変更することなく、Zabbix Webインターフェースの機能を拡張できます。

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

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

インストール

必ず対象のモジュールのインストールマニュアルをお読みください。障害を容易に特定できるよう、新しいモジュールは1つずつインストールすることを推奨します。

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

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

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

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

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

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

モジュールの開発

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