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

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

概要

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

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

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

Steps

1. Download the plugin sources from Zabbix Cloud Images and Appliances. The official download page will be available soon.

2. Transfer the archive to the machine where you are going to build the plugin.

3. Unarchive the tarball, e.g.:

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

Make sure to replace "zabbix-agent2-plugin-postgresql-1.0.0.tar.gz" with the name of the downloaded archive.

4. Enter the extracted directory:

cd <path to directory>

5. Run:

make

6. The plugin executable may be placed anywhere as long as it is loadable by Zabbix agent 2. Specify the path to the plugin binary in the plugin configuration file, e.g. in postgresql.conf for the PostgreSQL plugin:

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

7. Path to the plugin configuration file must be specified in the Include parameter of the Zabbix agent 2 configuration file:

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 プラグインのソースと、プラグインとそのセルフテストのビルドに必要なすべてのパッケージのソースを含むアーカイブを作成します。