Documentation
Table of Contents
モジュールの作成 (チュートリアル)
これは、シンプルなZabbixフロントエンドモジュールを作成する方法を示すステップバイステップのチュートリアルです。 このモジュールのすべてのファイルをZIPアーカイブとしてダウンロードできます: MyAddress.zip。
作成するもの
このチュートリアルでは、まず新しいMy Addressメニューセクションを追加するフロントエンドモジュールを構築し、次にそれをより高度なフロントエンドモジュールに変換します。このモジュールは、https://api.seeip.orgにHTTPリクエストを送信し、レスポンス(コンピューターのIPアドレス)を新しく作成されたMy Addressメニューセクションの新しいページに表示します。 完成したモジュールは次のようになります:
パート I - 新しいメニューセクション
Zabbixフロントエンドに空のモジュールを追加
ZabbixフロントエンドインストールのmodulesディレクトリにMyAddressディレクトリを作成します (例: zabbix/ui/modules)。
基本モジュールのメタデータを含むmanifest.jsonファイルを作成します (サポートされているパラメーターの説明を参照)。
ui/modules/MyAddress/manifest.json
{
"manifest_version": 2.0,
"id": "my-address",
"name": "My IP Address",
"version": "1.0",
"namespace": "MyAddress",
"description": "My External IP Address"
}- Zabbixフロントエンドで、管理 → 一般 → モジュールセクションに移動し、ディレクトリのスキャンボタンをクリックします。
- リスト内で新しいモジュールMy IP Addressを見つけ、"無効"ハイパーリンクをクリックしてモジュールのステータスを"無効"から"有効"に変更します。
これで、モジュールがフロントエンドに登録されました。ただし、モジュールの機能を定義する必要があるため、まだ表示されていません。 モジュールディレクトリにコンテンツを追加し、ページを更新すると、Zabbixフロントエンドの変更がすぐに表示されます。
メニューセクションの作成
- MyAddressディレクトリにModule.phpファイルを作成します。
このファイルは、デフォルトのCModuleクラスを拡張する新しいModuleクラスを実装します。 Moduleクラスは、新しいMy Addressメニューセクションをメインメニューに挿入します。
setAction()メソッドは、メニューセクションをクリックしたときに実行されるアクションを指定します。 まず、事前定義されたアクションuserprofile.editを使用すると、ユーザープロファイルページが開きます。 このチュートリアルのパートIIIでは、カスタムアクションの作成方法を学習します。
ui/modules/MyAddress/Module.php
<?php
namespace Modules\MyAddress;
use Zabbix\Core\CModule,
APP,
CMenuItem;
class Module extends CModule {
public function init(): void {
APP::Component()->get('menu.main')
->add((new CMenuItem(_('My Address')))
->setAction('userprofile.edit'));
}
}'userprofile.edit'を他のアクション、たとえば'charts.view'(カスタムグラフを開く)、'problems.view'(データ監視 → 障害を開く)、または 'report.status'(システム情報レポートを開く)に置き換えることができます。
- Zabbixフロントエンドを更新します。Zabbixメインメニューの下部に、新しいMy Addressセクションが追加されました。 My Addressをクリックして、User profileページを開きます。
パート II - メニューセクションの位置変更
このパートでは、My Addressメニューセクションを監視データセクションに移動します。 その結果、ユーザーは監視データ → マイ アドレスメニューセクションから2つのサブメニューページにアクセスできるようになります。
- Module.phpファイルを開いて編集します。
ui/modules/MyAddress/Module.php
<?php
namespace Modules\MyAddress;
use Zabbix\Core\CModule,
APP,
CMenuItem;
class Module extends CModule {
public function init(): void {
APP::Component()->get('menu.main')
->findOrAdd(_('Monitoring'))
->getSubmenu()
->insertAfter(_('Discovery'),
(new CMenuItem(_('My Address')))->setAction('userprofile.edit')
);
}
}- Zabbixフロントエンドを更新します。 監視データメニューセクションを展開し、My addressセクションがディスカバリセクションの下にあることを確認します。
パート III - モジュールアクション
アクションは、actions/MyAddress.phpとviews/my.address.phpの2つのファイルに実装されます。 actions/MyAddress.phpファイルはビジネスロジックの実装を担当し、views/my.address.phpファイルはビューを担当します。
MyAddressディレクトリにactionsディレクトリを作成します。
actionsディレクトリにMyAddress.phpファイルを作成します。
アクションロジックはMyAddressクラスで定義されます。 このアクションクラスは、init()、checkInput()、checkPermissions()、doAction()の4つの関数を実装します。 Zabbixフロントエンドは、アクションが要求されるとdoAction()関数を呼び出します。 この関数は、モジュールのビジネスロジックを担当します。
データは連想配列として編成する必要があります。 配列は多次元にすることができ、ビューで予期される任意のデータを含めることができます。
ui/modules/MyAddress/actions/MyAddress.php
<?php
namespace Modules\MyAddress\Actions;
use CController,
CControllerResponseData;
class MyAddress extends CController {
public function init(): void {
$this->disableCsrfValidation();
}
protected function checkInput(): bool {
return true;
}
protected function checkPermissions(): bool {
return true;
}
protected function doAction(): void {
$data = ['my-ip' => file_get_contents("https://api.seeip.org")];
$response = new CControllerResponseData($data);
$this->setResponse($response);
}
}MyAddressディレクトリに新しいディレクトリviewsを作成します。
viewsディレクトリにmy.address.phpファイルを作成し、モジュールビューを定義します。
変数$dataは、特に定義しなくてもビューで使用できることに注意してください。 フレームワークは自動的に連想配列をビューに渡します。
ui/modules/MyAddress/views/my.address.php
<?php
(new CHtmlPage())
->setTitle(_('The HTML Title of My Address Page'))
->addItem(new CDiv($data['my-ip']))
->show();- モジュールアクションはmanifest.jsonファイルに登録する必要があります。 manifest.jsonを開き、以下を含む新しいオブジェクト
actionsを追加します。
- 小文字(a~z)で書かれ、単語がドットで区切られたアクション名を持つアクションキー (例:
my.address) my.addressオブジェクトのclassキーの値としてのアクションクラス名 (MyAddress)my.addressオブジェクトのviewキーの値としてのアクションビュー名 (my.address)
ui/modules/MyAddress/manifest.json
{
"manifest_version": 2.0,
"id": "my-address",
"name": "My IP Address",
"version": "1.0",
"namespace": "MyAddress",
"description": "My External IP Address",
"actions": {
"my.address": {
"class": "MyAddress",
"view": "my.address"
}
}
}- Module.phpを開き、setAction()メソッドのアクション名をmy.addressに変更します。
ui/modules/MyAddress/Module.php
<?php
namespace Modules\MyAddress;
use Zabbix\Core\CModule,
APP,
CMenuItem;
class Module extends CModule {
public function init(): void {
APP::Component()->get('menu.main')
->findOrAdd(_('Monitoring'))
->getSubmenu()
->insertAfter(_('Discovery'),
(new CMenuItem(_('My Address')))->setAction('my.address')
);
}
}- Zabbixフロントエンドを更新します。My addressメニューセクションをクリックして、コンピュータのIPアドレスを確認します。