9 Zabbix Webサービス

概要

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

このセクションでは、Zabbix Webサービスの設定ファイル(zabbix_web_service.conf)でサポートされているパラメータを一覧表示します。

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

パラメータ 説明
AllowedIP ZabbixサーバーおよびZabbixプロキシの、カンマ区切りのIPアドレス(必要に応じてCIDR表記)またはDNS名のリスト。
DebugLevel デバッグレベル。
IgnoreURLCertErrors WebインターフェースのURLにアクセスする際のTLS証明書検証エラーの処理方法を指定します。
Include 設定ファイルに個別のファイル、またはディレクトリ内のすべてのファイルを含めることができます。
ListenPort サーバーからの接続をこのポートで待ち受けます。
LogFile ログファイルの名前。
LogFileSize ログファイルの最大サイズ。
LogType ログ出力の種類。
Timeout ダッシュボードのPDF レポートのフォーマットにかける最大時間(秒)。
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 ファイルの場所からの相対パスにできます。
  • 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

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