Zabbix API/Stream

Zabbix API/Stream を呼び出して Zabbix の監視データを収集します

インストール設定¶

Zabbix は 2 つの方法でデータを送信できます

Zabbix API：バージョン要件 ≥ 5.0
Zabbix Stream：バージョン要件 ≥ 6.4

Guance は 2 つの方法で Zabbix の監視データを収集できます

DataKit
DataFlux Function

DataKit 方式¶

pythond 設定ファイルの設定¶

DataKit の設定ファイルディレクトリ conf.d に移動し、samples ディレクトリで pythond.conf.sample を pythond.conf としてコピーし、次の設定に変更します

[[inputs.pythond]]
# Python 入力名
name = 'zabbix_collect'  # 必須

# Python を実行するためのシステム環境変数
#envs = ['LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH',]
envs = ['ZABBIX_HOST=http://127.0.0.1/zabbix', 'ZABBIX_USER=Admin', 'ZABBIX_PASSWD=zabbix', 'ZABBIX_VERSION=7.0', 'COLLECT_TYPE=api']

# Python のパス（抽象化された Python パスを推奨）
cmd = "python3" # 必須。python3 を推奨します。

# Python スクリプトの相対パス
dirs = ["zabbix"]

ここで ZABBIX_HOST、ZABBIX_USER、ZABBIX_PASSWD、ZABBIX_VERSION には、実際の Zabbix のアドレス、ユーザー名、パスワード、バージョン、種類 を入力します。
COLLECT_TYPE に api を指定すると、その後 Zabbix API を呼び出してデータを取得します。stream を指定すると、Zabbix Stream を呼び出してデータを取得します。
バージョン要件として、Zabbix では 6.4 以上のバージョンでのみ stream 方式を使用できます。

スクリプトをコピーする¶

DataKit ディレクトリに移動し、python.d ディレクトリで zabbix ディレクトリを作成し、下のリンクからスクリプトを zabbix ディレクトリへダウンロードします

wget https://static.guance.com/integrations/zabbix/zabbix-collector.py

ディレクトリ構成は次のとおりです：

conf.d/
├── pythond.conf
python.d/
└── zabbix/
  └── zabbix-collector.py

設定が完了したら DataKit を再起動します。

DataFlux Function 方式¶

Func のインストール¶

Guance 統合 - 拡張 - マネージド版 Func の利用を推奨します。前提条件はすべて自動で導入されるため、そのままスクリプトのインストールを続けてください

Func を自前でデプロイする場合は、Func の自前デプロイを参照してください

Zabbix API 方式でメトリクスを取得する¶

Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance スクリプトマーケットに入り、integration_zabbix を検索します
【インストール】をクリックしたあと、対応するパラメータを入力します：
zabbix host
zabbix user
zabbix password
zabbix version
【デプロイしてスクリプトを起動】をクリックすると、システムが自動的に Startup スクリプトセットを作成し、対応する起動スクリプトを自動で設定します。
起動後は、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。しばらくすると、実行タスクの記録と対応するログを確認できます。

Zabbix Stream 方式でメトリクスを取得する¶

Zabbix Stream 方式でメトリクスを取得するには、Zabbix サーバーに実行可能な stream URL を設定する必要があります。現在は Function で API を作成する方法でこの URL を生成します。

Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance スクリプトマーケットに入り、integration_zabbix_stream を検索してインストールします；
API を作成します。func にログインし、管理 -> 同期API（非同期 API の使用を推奨）-> 新規作成 をクリックし、実行欄ではインポートしたスクリプト内の Zabbix Receiver メソッドを選択します。パラメータ指定では収集タスク関連の設定を行い、次のパラメータ情報を指定する必要があります：
zabbix_host
zabbix_user
zabbix_passwd
zabbix_version は実際の値

base64 は Zabbix の入力パラメータ。ここでは INPUT_BY_CALLER を入力します

{
  "configs": {
    "zabbix_host": "<your-zabbix-host>",
    "zabbix_user": "<your-zabbix-user>",
    "zabbix_passwd": "<your-zabbix-password>",
    "zabbix_version": "7.0",
    "base64": "INPUT_BY_CALLER"
  }
}

Zabbix コネクタを作成する

Zabbix にログインし、管理 -> 一般 -> コネクタ をクリックしてコネクタを作成します。URL には前の手順で作成した URL を入力し、情報タイプは数値と浮動小数点数を選択して、追加をクリックします;
zabbix_server.conf を変更し、StartConnectors を 10 に設定して保存し、zabbix-server サービスを再起動します.

toml StartConnectors=10