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

概要

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

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

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

インストール

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

モジュールをインストールする直前に:

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

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

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

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

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

モジュールの開発

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