9 Zabbix Webサービス

概要

Zabbix web service は、外部の web サービスとの通信に使用されるプロセスです。

Zabbix web service の設定ファイル (zabbix_web_service.conf) でサポートされるパラメータを、このセクションに示します。

パラメータは追加情報なしで一覧表示されています。パラメータをクリックすると、詳細を確認できます。

Parameter Description
AllowedIP カンマ区切りの IP アドレスの一覧。必要に応じて CIDR 表記、または Zabbix サーバーおよび Zabbix プロキシの DNS 名を指定できます。
DebugLevel デバッグレベル。
IgnoreURLCertErrors Webインターフェースの URL にアクセスする際の TLS 証明書検証エラーの処理方法を指定します。
Include 設定ファイル内で個別のファイル、またはディレクトリ内のすべてのファイルを含めることができます。
ListenPort このサービスがサーバーからの接続を待ち受けるポートです。
LogFile ログファイル名。
LogFileSize ログファイルの最大サイズ。
LogType ログ出力の種類。
Timeout ダッシュボードの PDF report を整形するのに費やす最大時間(秒)。
TLSAccept 受け入れる受信接続の種類。
TLSCAFile Zabbix コンポーネント間の暗号化通信で使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルの完全パス名。
TLSCertFile Zabbix コンポーネント間の暗号化通信で使用される、サービス証明書または証明書チェーンを含むファイルの完全パス名。
TLSKeyFile Zabbix コンポーネント間の暗号化通信で使用される、サービス秘密鍵を含むファイルの完全パス名。

すべてのパラメータは、パラメータが必須であると明示されていない限り、必須ではありません。

注意:

  • デフォルト値は、配布される設定ファイルの値ではなく、プロセスのデフォルト値を反映しています。
  • 値は environment variables をサポートします。
  • Zabbix は、BOM なしの UTF-8 エンコーディングでのみ設定ファイルをサポートします。
  • "#" で始まるコメントは、行頭でのみサポートされます。

パラメータの詳細

AllowedIP

ZabbixサーバーおよびZabbixプロキシのIPアドレス(カンマ区切り、CIDR表記も可)またはDNS名のリスト。ここにリストされたホストからのみ接続を受け付けます。
IPv6サポートが有効な場合、127.0.0.1::127.0.0.1::ffff:127.0.0.1は同等に扱われ、::/0は任意のIPv4またはIPv6アドレスを許可します。任意のIPv4アドレスを許可するには0.0.0.0/0を使用できます。

例:

127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

必須: yes

DebugLevel

デバッグレベルを指定します:
0 - Zabbixプロセスの開始と停止に関する基本情報
1 - 重大な情報;
2 - エラー情報;
3 - 警告;
4 - デバッグ用 (大量の情報を出力);
5 - 拡張デバッグ (さらに多くの情報を出力)。

デフォルト: 3
範囲: 0-5

IgnoreURLCertErrors

フロントエンドURLにアクセスする際のTLS証明書検証エラーの処理を指定します:
0 - 証明書エラーを無視しない;
1 - 証明書エラーを無視する。

デフォルト: 0
範囲: 0-1

Include

個々のファイルやディレクトリ内のすべてのファイルを設定ファイルに含めることができます。 インストール時に、Zabbixはコンパイル時に変更されていない限り、/usr/local/etcにincludeディレクトリを作成します。 パスはzabbix_web_service.confファイルの場所からの相対パスにすることができます。
指定したディレクトリ内の関連ファイルのみを含めるために、アスタリスクワイルドカード文字によるパターンマッチングがサポートされています。
制限事項については特記事項を参照してください。

例:

Include=/absolute/path/to/config/files/*.conf
ListenPort

サービスはこのポートでサーバーからの接続を待ち受けます。

デフォルト:10053
範囲:1024-32767

LogFile

ログファイルの名前。

例:

/tmp/zabbix_web_service.log

必須: LogTypeがfileに設定されている場合は必須。それ以外の場合は不要

LogFileSize

ログファイルの最大サイズ(MB単位)。
0 - 自動ログローテーションを無効にします。
注意: ログファイルサイズの上限に達し、何らかの理由でファイルのローテーションに失敗した場合、既存のログファイルは切り詰められ、新たに開始されます。

デフォルト: 1
範囲: 0-1024

LogType

ログ出力のタイプ:
file - LogFileパラメータで指定されたファイルにログを書き込む;
system - syslogにログを書き込む;
console - 標準出力にログを書き込む。

デフォルト:file

タイムアウト

ダッシュボードのPDFレポートのフォーマットに費やす最大時間(秒)。

デフォルト: 10
範囲: 1-30

TLSAccept

受け入れる接続の種類:
unencrypted - 暗号化なしの接続を受け入れる(デフォルト)
cert - TLSおよび証明書付きの接続を受け入れる

デフォルト:unencrypted

TLSCAFile

Zabbixコンポーネント間の暗号化通信に使用される、ピア証明書の検証のための最上位CA証明書を含むファイルのフルパス名。

TLSCertFile

Zabbixコンポーネントとの暗号化通信に使用されるサービス証明書または証明書チェーンを含むファイルのフルパス名。

TLSKeyFile

Zabbixコンポーネント間の暗号化通信に使用されるサービス秘密鍵を含むファイルのフルパス名。