Proxyオブジェクト

次のオブジェクトは、proxyAPIに直接関連しています。

プロキシ

プロキシオブジェクトには、次のプロパティがあります。

プロパティ タイプ 説明
proxyid ID プロキシのID。

プロパティの動作:
- 読み取り専用
- 更新操作では必須
name string プロキシの名前。

プロパティの動作:
- 作成操作では必須
proxy_groupid ID プロキシグループのID。

0 - プロキシはどのプロキシグループにも割り当てられていません。
local_address string アクティブエージェント用のアドレス。接続先のIPアドレスまたはDNS名。

プロパティの動作:
- proxy_groupid が 0 でない場合は必須
local_port string 接続先のローカルプロキシポート番号。

ユーザーマクロがサポートされています。

デフォルト: 10051。

プロパティの動作:
- proxy_groupid が 0 でない場合にサポート
operating_mode integer プロキシのタイプ。

指定可能な値:
0 - アクティブプロキシ;
1 - パッシブプロキシ。

プロパティの動作:
- 作成操作では必須
description text プロキシの説明。
lastaccess timestamp プロキシが最後にサーバーへ接続した時刻。

プロパティの動作:
- 読み取り専用
address string 接続先のIPアドレスまたはDNS名。

ユーザーマクロがサポートされています。

プロパティの動作:
- Zabbixプロキシの動作モードがパッシブの場合は必須
port string 接続先のポート番号。

ユーザーマクロがサポートされています。

デフォルト: 10051。

プロパティの動作:
- Zabbixプロキシの動作モードがパッシブの場合にサポート
allowed_addresses string アクティブなZabbixプロキシのIPアドレスまたはDNS名をコンマ区切りで指定します。
tls_connect integer プロキシへの接続。

指定可能な値:
1 - (デフォルト) 暗号化なし;
2 - PSK;
4 - 証明書。
tls_accept integer プロキシからの接続。

指定可能なビットマップ値:
1 - (デフォルト) 暗号化なし;
2 - PSK;
4 - 証明書。

これはビットマスクフィールドです。指定可能なビットマップ値の合計を指定できます(例: PSKと証明書の場合は6)。
tls_issuer string 証明書の発行者。
tls_subject string 証明書のサブジェクト。
tls_psk_identity string PSK ID。1つのPSKとのみ組み合わせる必要があります(自動登録、ホスト、プロキシ全体で)。

PSK IDには機密情報を含めないでください。使用するPSKを受信側に通知するため、PSK IDは暗号化されずにネットワーク経由で送信されます。

プロパティの動作:
- 書き込み専用
- tls_connect が「PSK」に設定されている場合、または tls_accept に「PSK」ビットが含まれている場合は必須
tls_psk string 事前共有鍵(PSK)。32桁以上の16進数である必要があります。

プロパティの動作:
- 書き込み専用
- tls_connect が「PSK」に設定されている場合、または tls_accept に「PSK」ビットが含まれている場合は必須
custom_timeouts integer プロキシレベルでグローバルなアイテムのタイムアウトを上書きするかどうか。

指定可能な値:
0 - (デフォルト) グローバル設定を使用;
1 - タイムアウトを上書き。
timeout_zabbix_agent string 処理に timeout_* 秒を超える時間を費やさないようにします。
1、60、300 などの秒数、または時間のサフィックス付きの値(30s、1m など)を指定できます。ユーザーマクロも使用できます。
custom_timeouts が「タイムアウトを上書き」に設定されている場合にのみ使用されます。それ以外の場合、この値は無視されます。

指定可能な値の範囲: 1~600秒。

プロパティの動作:
- custom_timeouts が「タイムアウトを上書き」に設定されている場合は必須
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
timeout_telemetry_query
version integer プロキシのバージョン。

3つの部分で構成されるZabbixバージョン番号。各部分には2桁の10進数を使用します。例: バージョン6.4.1は60401、バージョン7.0.2は70002など。
0 - 不明なプロキシバージョン。

プロパティの動作:
- 読み取り専用
compatibility integer Zabbixサーバーのバージョンと比較したプロキシのバージョン。

指定可能な値:
0 - 未定義;
1 - 現行バージョン(プロキシとサーバーのメジャーバージョンが同じ);
2 - 古いバージョン(プロキシのバージョンがサーバーより古いが、一部サポートされている);
3 - サポート対象外のバージョン(プロキシのバージョンがサーバーの以前のLTSリリースバージョンより古い、またはサーバーのメジャーバージョンがプロキシのメジャーバージョンより古い)。

プロパティの動作:
- 読み取り専用
state integer プロキシの状態。

指定可能な値:
0 - 不明;
1 - オフライン;
2 - オンライン。

プロパティの動作:
- 読み取り専用

アプリケーションパフォーマンス監視(APM)

APMオブジェクトには、次のプロパティがあります。

Property Type Description
data_collection_status integer プロキシでテレメトリデータの収集が有効かどうか。

指定可能な値:
0 - (デフォルト) 無効;
1 - 有効。
max_messages_per_second integer プロキシが1秒あたりに受け入れるメッセージの最大数。

指定可能な値の範囲: 0(無制限)– 2147483647。

デフォルト: 0。

プロパティの動作:
- data_collection_status が「Enabled」に設定されている場合は supported
additional_resource_attributes array 受信テレメトリデータに追加するリソース属性の配列。

プロパティの動作:
- data_collection_status が「Enabled」に設定されている場合は supported

リソース属性

リソース属性オブジェクトには、次のプロパティがあります。

プロパティ 型 説明
key string リソース属性名。
指定した signal_type に対して一意である必要があります。

プロパティの動作:
- 必須
value string リソース属性値。
空にすることができます。
signal_type integer 属性が適用されるテレメトリデータの種類。

指定可能な値:
0 - トレース;
1 - メトリクス;
2 - ログ。

プロパティの動作:
- 必須