龙虎赌博

Table of Contents

3 パッシブおよびアクティブエージェントチェック

3 パッシブおよびアクティブエージェントチェック

概要

このセクションでは、龙虎赌博 agentによって実行されるパッシブおよびアクティブチェックの詳細について説明します。

龙虎赌博は、龙虎赌博エージェントとの通信に JSON ベースの通信プロトコルを使用します。

参照: 龙虎赌博 agent 2 プロトコルの详细。

パッシブチェック

パッシブチェックは単純なデータリクエストです。龙虎赌博サーバーまたはプロキシがデータ（CPU負荷など）を要求し、龙虎赌博エージェントがデータをサーバーに送り返します。

サーバーリクエスト

ヘッダーとデータ长の定义については、プロトコルの详细を参照してください。

<item key>

エージェントの応答

<DATA>[\0<ERROR>]

上记の角括弧内の部分はオプションであり、サポートされていないアイテムに対してのみ送信されます。

サポートされているアイテムの场合：

サーバーが罢颁笔接続を开きます
サーバーが<HEADER><DATALEN>agent.pingを送信します
エージェントはリクエストを読み取り、<HEADER><DATALEN>1で応答します
サーバーはデータを処理して値を取得します。今回の场合は"1"です。
罢颁笔接続が闭じられます

サポートされていないアイテムの场合：

サーバーが罢颁笔接続を开きます
サーバーは<HEADER><DATALEN>vfs.fs.size[/nono]を送信します
エージェントはリクエストを読み取り、次のレスポンスを返します。<HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
サーバーはデータを処理し、アイテムの状态をサポートされていない状态に変更し、指定されたエラーメッセージを表示します
罢颁笔接続が闭じられます

アクティブチェック

アクティブチェックには、より複雑な処理が必要です。エージェントは、最初にサーバーから独立した処理でアイテムのリストを取得します。

アクティブチェックを取得するサーバーは、エージェント构成ファイルの"ServerActive"パラメーターにリストされています。これらのチェックを要求する頻度は、同じ构成ファイルの"RefreshActiveChecks"パラメーターによって设定されます。ただしアクティブチェックの更新に失敗した場合は、ハードコードされた60秒後に再試行されます。

その后、エージェントは定期的に新しい値をサーバーに送信します。

エージェントがファイアウォールの背后にいる场合は、アクティブチェックのみを使用することを検讨してください。そうすることで最初の着信接続を许可するためにファイアウォールを変更する必要がなくなります。

In order to decrease network traffic and resources usage 龙虎赌博 server or 龙虎赌博 proxy will provide configuration only if 龙虎赌博 agent still hasn't received configuration or if something has changed in host configuration, global macros or global regular expressions.

The agent then periodically sends the new values to the server(s).

If an agent is behind the firewall you might consider using only Active checks because in this case you wouldn't need to modify the firewall to allow initial incoming connections.

アイテムのリスト取得

エージェントリクエスト

アクティブチェック要求は、エージェントによって処理されるアクティブチェックを取得するために使用されます。この要求は、開始時にエージェントによって送信され、その後 RefreshActiveChecks 间隔で送信されます。

{
         "request": "active checks",
         "host": "龙虎赌博 server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

フィールド	タイプ	必须	値
request	string	yes	`active checks`
host	string	yes	ホスト名
host_metadata	string	no	设定パラメーター HostMetadata または HostMetadataItem メトリック値
hostinterface	string	no	设定パラメーター HostMetadata または HostMetadataItem メトリック値
ip	string	no	设定パラメーターListenIPが设定されている場合は最初のIP
port	number	no	设定パラメーター ListenPort(设定されている場合)に设定されている値であり、デフォルトのエージェント?リスニング?ポートではありません。

サーバーレスポンス

アクティブチェック応答は、アクティブチェック要求を処理した後、サーバーによってエージェントに返されます。

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "key_orig": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

フィールド		タイプ	必须	値
response		string	yes	`success` \| `failed`
info		string	no	失败した场合のエラー情报
data		array of objects	no	アクティブなチェック项目
	key	string	no	マクロが展开された项目キー
	key_orig	string	no	展开されたマクロのない项目キー
	itemid	number	no	アイテム滨顿
	delay	string	no	アイテムの更新间隔
	lastlogsize	number	no	アイテムの最终ログサイズ
	mtime	number	no	アイテムの最终修正日时
refresh_unsupported		number	no	サポートされていないアイテムの更新间隔
regexp		array of objects	no	グローバル正规表现项目
	name	string	no	グローバル正规表现名
	expression	string	no	グローバル正规表现
	expression_type	number	no	グローバル正规表现タイプ
	exp_delimiter	string	no	グローバル正规表现区切り文字
	case_sensitive	number	no	グローバル正规表现の大文字と小文字の区別设定

サーバーは成功で応答する必要があります。

例: 1. エージェントがTCP接続を開きます 2. エージェントがチェックのリストを要求します 3. サーバーはアイテムのリスト（アイテムキー、遅延）で応答します 4. エージェントが応答を解析します 5. 罢颁笔接続が闭じられます 6. エージェントが定期的なデータ収集を開始します

アクティブチェックを使用する際、龙虎赌博サーバのトラッパーポートへアクセスは、（慎重に扱うべき）设定データを利用できるようになりますので、注意してください。これができるのは、誰もがアクティブエージェントに成りすまし、アイテム设定データをリクエストできるためです。暗号化オプションを使用しない限り、认証は行われません。

収集データの送信

エージェント送信

エージェントデータリクエストには、収集されたアイテムの値が含まれます。

{
         "request": "agent data",
         "data": [
           {
             "host": "龙虎赌博 server",
             "key": "agent.version",
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "host": "龙虎赌博 server",
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting 龙虎赌博 Agent [<hostname>]. 龙虎赌博 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "session": "1234456akdsjhfoui"
       }

フィールド		タイプ	必须	値
request		string	yes	`agent data`
session		string	yes	エージェントが開始されるたびに生成される固有のセッション ID
data		array of objects	yes	アイテム値
	id	number	yes	値の識別子 (ネットワークの問題が発生した場合に、重複した値をチェックするために使用されるインクリメンタルカウンター)。
	host	string	yes	ホスト名
	key	string	yes	アイテムキー
	value	string	no	アイテム値
	lastlogsize	number	no	アイテムの最终ログサイズ
	mtime	number	no	アイテム最终更新日时
	state	number	no	アイテムステータス
	source	string	no	値のイベントログソース。
	eventid	number	no	値のイベントログ ID
	severity	number	no	値のイベントログ深刻度
	timestamp	number	no	値のイベントログタイムスタンプ
	clock	number	yes	値のタイムスタンプ (エポックからの秒数)
	ns	number	yes	値のタイムスタンプ (ナノ秒)

各値には仮想IDが割り当てられます。値IDは、1つのデータセッション（セッショントークンで識別される）内で一意の単純な昇順カウンターです。このIDは、接続性の低い環境で送信される可能性のある重複値を破棄するために使用されます。

サーバー応答

エージェントデータ応答は、エージェントデータ要求を処理した后、サーバーによってエージェントに送り返されます。

{
         "response": "success",
         "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }

フィールド	タイプ	必须	値
response	string	yes	`success` \| `failed`
info	string	yes	アイテム処理结果

サーバーで一部の値の送信が失败した场合（たとえば、ホストまたはアイテムが无効化または削除されたため）、エージェントはそれらの値の送信を再试行しません。

例:

エージェントが罢颁笔接続を开きます。
エージェントが値のリストを送信します。
サーバがそのデータを処理し、ステータスを返します。
罢颁笔接続を闭じます。

上记の例では、惫蹿蝉.蹿蝉.蝉颈锄别摆/苍辞苍辞闭がサポートされていないステータスであることを、"蝉迟补迟别"の値が1および"惫补濒耻别"プロパティのエラーメッセージによって指摘されています。

エラーメッセージは、サーバー侧で2048シンボルにトリミングされます。

Heartbeat message

The heartbeat message is sent by an active agent to 龙虎赌博 server/proxy every HeartbeatFrequency seconds (configured in the 龙虎赌博 agent configuration file).

It is used to monitor the availability of active checks.

{
         "request": "active check heartbeat",
         "host": "龙虎赌博 server",
         "heartbeat_freq": 60
       }

Field	Type	Mandatory	Value
request	string	yes	`active check heartbeat`
host	string	yes	The host name.
heartbeat_freq	number	yes	The agent heartbeat frequency (HeartbeatFrequency configuration parameter).

古い XML プロトコル

龙虎赌博は、 Base64にエンコードされたXMLのデータを16MBまで取得しますが、デコードされる値は1つが64KB以下でなければなりません。そうでないと、デコード中にそれが64KBに切り捨てられます。