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 コンポーネント間の暗号化通信で使用される、サービス秘密鍵を含むファイルの完全パス名。

特に明記されていない限り、すべてのパラメータは必須ではありません。

注意事項:

  • デフォルト値は、配布される設定ファイル内の値ではなく、プロセスのデフォルト値を反映しています。
  • 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アドレスを許可します。'0.0.0.0/0'はすべてのIPv4アドレスを許可します。

例:

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

必須:必須

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 ファイルの場所からの相対パスにできます。
指定したディレクトリ内の関連ファイルのみを含めるには、パターンマッチング用にアスタリスクのワイルドカード文字を使用できます。
制限については special notes を参照してください。

例:

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

サービスがサーバーからの接続を待機するポート

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

LogFile

ログファイルの名前。

例:

/tmp/zabbix_web_service.log

必須: はい。LogTypefile に設定されている場合。そうでない場合は不要。

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 コンポーネント間の暗号化通信に使用されるサービス秘密鍵を含むファイルのフルパス名