This is a translation of the original English documentation page. Help us make it better.

1 ローダブルプラグインのビルド

概要

このページでは、ソースからロード可能なプラグインのバイナリを構築するために必要な手順を説明します。

ソースtarballをダウンロードしていれば、プラグインをオフラインで、つまりインターネットに接続せずに構築できます。

PostgreSQLプラグインが例として使用されます。他のロード可能なプラグインも同様の方法で構築できます。

手順

1. Zabbix Cloud Images and Appliancesからソースをダウンロードする。 公式なダウンロードページはすぐに用意します。

2. プラグインをビルドするサーバーにアーカイブを転送する。

3. tarボールを以下のようにして展開する:

tar xvf zabbix-agent2-plugin-postgresql-1.0.0.tar.gz

ファイル名"zabbix-agent2-plugin-postgresql-1.0.0.tar.gz"は、ダウンロードしたファイルのファイル名に読み替えてください。

4. 展開したディレクトリ内に移動する:

cd <path to directory>

5. 実行:

make

6. プラグインの実行可能ファイルは、Zabbixエージェント2が読み込める場所であればどこでも配置できます。プラグインの設定ファイルでプラグインのバイナリへのパスを設定します。例えば、PostgreSQL用のプラグインでは、postgresql.confに記述します:

Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql

7. プラグイン設定ファイルへのパスは、Zabbixエージェント2の設定ファイルのIncludeパラメーターで指定する必要があります:

Include=/path/to/plugin/configuration/file/postgresql.conf

Makefileのターゲット

Zabbixが用意しているローダブルモジュールの基本的なMakefileには以下のようなターゲットを用意しています:

ターゲット 説明
make プラグインをビルドします。
make clean プラグインのビルド時に通常作成されたすべてのファイルを削除します。
make check セルフテストを実行します。実際のPostgreSQLデータベースが必要です。
make style 'golangci-lint'を用いてGo言語の文法チェックを行います。
make format 'go fmt'を用いてGo言語のコードのフォーマッティングを行います。
make dist プラグインのソースと、プラグインとそのセルフテストのビルドに必要なすべてのパッケージのソースを含むアーカイブを作成します。