Documentation
7 リアルタイムエクスポートプロトコル
このセクションではリアルタイムエクスポートプロトコルの詳細を改行区切りのJSON形式で示します。
すべてのファイルの拡張子は.ndjsonです。 エクスポートファイルの各行はJSONオブジェクトです。
トリガーイベント
障害イベントについて、次の情報がエクスポートされます。
| フィールド | タイプ | 説明 | ||
|---|---|---|---|---|
| clock | number | エポックから障害が検出されるまでの秒数（整数部） | ||
| ns | number | 正確な障害検出時間を取得するためにclockに追加されるナノ秒数。 |
||
| value | number | 1 (常に) | ||
| eventid | number | 障害イベントID | ||
| name | string | 障害イベント名 | ||
| severity | number | 障害イベントの深刻度（0 - 未分類,1 - 情報,2 - 警告,3 - 軽度の障害,4 - 重度の障害,5 - 致命的な障害） | ||
| hosts | array | トリガー式に関係するホストのリスト。 配列には少なくとも1つの要素が必要です。 | ||
| - | object | |||
| host | string | ホスト名 | ||
| name | string | 表示用ホスト名 | ||
| groups | array | トリガー式に関係するすべてのホストのホストグループのリスト。 配列には少なくとも1つの要素が必要です。 | ||
| - | string | ホストグループ名 | ||
| tags | array | 障害タグのリスト (空白可) | ||
| - | object | |||
| tag | string | タグ名 | ||
| value | string | タグ値 (空白可). | ||
次の情報は、リカバリイベント用にエクスポートされます。
| フィールド | タイプ | 説明 |
|---|---|---|
| clock | number | エポックから障害が解決するまでの秒数（整数部） |
| ns | number | 正確な障害解決時間を取得するためにclockに追加されるナノ秒数。 |
| value | number | 0 (常に) |
| eventid | number | リカバリイベントID |
| p_eventid | number | 障害イベントID |
例
障害:
{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}リカバリ:
障害 (多重障害イベントの生成):
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}リカバリ:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}アイテム値
収集されたアイテム値について次の情報がエクスポートされます。
| フィールド | タイプ | 説明 | |
|---|---|---|---|
| host | object | アイテムホストのホスト名 | |
| host | string | ホスト名 | |
| name | string | 表示ホスト名 | |
| groups | array | アイテムホストのホストグループのリスト。 配列には少なくとも1つの要素が必要です。 | |
| - | string | ホストグループ名 | |
| itemid | number | アイテムID | |
| name | string | 表示アイテム名 | |
| clock | number | エポックから値が収集されるまでの秒数（整数部） | |
| ns | number | 正確な値の収集時間を取得するためにclockに追加されるナノ秒数 |
|
| timestamp (Log only) |
number | 利用できない場合は0 | |
| source (Log only) |
string | 使用できない場合は空の文字列 | |
| severity (Log only) |
number | 利用できない場合は0 | |
| eventid (Log only) |
number | 利用できない場合は0 | |
| value | number (for numeric items) or string (for text items) |
収集したアイテム値 | |
| type | number | 収集された値のタイプ： 0 - 浮動小数点,1 - 文字,2 - ログ, 3 - 符号なしの数値, 4 - テキスト |
|
例
数字 (符号なし) 値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}数字 (浮動小数) 値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}文字,テキスト 値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}ログ値:
{"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}トレンド
計算されたトレンド値について次の情報がエクスポートされます。
| フィールド | タイプ | 説明 | |
|---|---|---|---|
| host | object | アイテムホストのホスト名 | |
| host | string | ホスト名 | |
| name | string | 表示ホスト名 | |
| groups | array | アイテムホストのホストグループのリスト。 配列には少なくとも1つの要素が必要です。 | |
| - | string | ホストfグループ名 | |
| itemid | number | アイテムID | |
| name | string | 表示アイテム名 | |
| clock | number | エポックから値が収集されるまでの秒数（整数部） | |
| count | number | 特定の時間に収集された値の数 | |
| min | number | 特定の時間の最小アイテム値 | |
| avg | number | 特定の時間の平均アイテム値 | |
| max | number | 特定の時間の最大アイテム値 | |
| type | number | 値のタイプ: 0 - 浮動小数, 3 - 符号なしの整数 |
|
例
数字 (符号なし)値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}数字 (浮動小数点) 値: