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_web_service.conf ファイルの場所からの相対パスにできます。
インストール時、Zabbix はコンパイル時に変更されていない限り、/usr/local に include ディレクトリを作成します。
Include ステートメントは、検出されるとすぐに処理されます。
予測可能な動作にするため、Include パラメータは設定ファイルの末尾に配置することを推奨します。
設定ファイルには複数の Include ステートメントを指定できます。
含まれるすべてのファイルは正しい構文でなければなりません。そうでない場合、エージェントは起動しません。
含まれるすべてのファイルは読み取り可能でなければなりません。
ディレクトリまたはパターンに一致するファイルを含める場合、読み込み順序は特に保証されません(たとえば、ファイルがアルファベット順に読み込まれるとは限りません)。 そのため、複数の含まれるファイルに同じパラメータを定義しないでください(たとえば、一般的な設定を個別の設定で上書きする場合など)。
ディレクトリを含める場合、一部のテキストエディタが自動作成するバックアップコピーに注意してください。
たとえば、include/my_specific.conf ファイルを編集すると、バックアップコピー include/my_specific_conf.BAK が作成されることがあります。この場合、両方のファイルが含まれます。
Linux では、ls -al コマンドを使用して include ディレクトリの内容を確認し、不要なファイルがないかチェックしてください。
指定したディレクトリから関連するファイルのみを含めるには、パターンマッチング用のアスタリスク (*) ワイルドカード文字をサポートしています。
例:
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 コンポーネント間の暗号化通信に使用されるサービス秘密鍵を含むファイルのフルパス名