設定パラメーター: Zabbix web service

概要

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 がサポートする設定ファイルの文字エンコーディングは UTF-8 のみで、BOM は含められません。
  • # で始まるコメントは、行頭でのみサポートされます。

パラメーターの詳細

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

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

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

Include

設定ファイルに含めるディレクトリまたは個別のファイルを指定します。
Zabbix のインストール時、このパラメーターは /usr/local/etc に設定されますが、コンパイル時に変更した場合はその設定が反映されます。

Include パラメーターに関する一般的なルール:

  • パスは zabbix_web_service.conf ファイルの場所からの相対パスにできます。
  • 1つの設定ファイル内で複数の Include パラメーターを指定できます。
  • Zabbix は Include パラメーターを読み取るとすぐに処理するため、設定ファイルの末尾に配置することを検討してください。

含まれるファイルに関するルール:

  • 各ファイルは読み取り可能でなければなりません。
  • 各ファイルは正しい構文でなければなりません。そうでない場合、コンポーネントは起動しません。

ディレクトリまたはファイルパターンを含める際のルール:

  • 読み込み順序を想定しないでください(たとえば、ファイルはアルファベット順には読み込まれません)。
  • 同じパラメーターを複数の含まれるファイルで定義しないでください(たとえば、一般的な設定を個別の設定で上書きする場合など)。どの値が使用されるか予測できないためです。
  • テキストエディターが自動的に作成するバックアップコピーに注意してください(たとえば、include/my_specific.conf を編集すると include/my_specific.conf.BAK が作成されることがあります)。両方のファイルが含まれるためです。

ディレクトリから関連するファイルのみを含めるには、ワイルドカード (*) をパターンマッチングに使用します。

例:

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