[comment]: # ({94469ada-ed2f6c13})
# 2 Webインターフェースモジュール

[comment]: # ({/94469ada-ed2f6c13})

[comment]: # ({8c4f6bda-1060eddf})
#### 概要

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

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

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

[comment]: # ({/8c4f6bda-1060eddf})

[comment]: # ({5e6af176-cffdc09c})
#### インストール

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

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

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

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

-   Zabbix frontend の `modules` フォルダ内に、モジュールごとの専用フォルダを作成して展開します
-   モジュールフォルダに少なくとも manifest.json ファイルが含まれていることを確認します
-   [モジュール
    管理](/manual/web_interface/frontend_sections/administration/general#modules) に移動し、*ディレクトリをスキャン* ボタンをクリックします
-   新しいモジュールが、バージョン、作成者、説明、ステータスとともに一覧に表示されます
-   ステータスをクリックしてモジュールを有効化します

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

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

[comment]: # ({/5e6af176-cffdc09c})

[comment]: # ({5ca56638-26c922c0})
#### モジュールの開発

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

[comment]: # ({/5ca56638-26c922c0})