7 改行区切りJSONエクスポートプロトコル
このセクションでは、以下で使用される改行区切りJSON形式のエクスポートプロトコルの詳細を説明します。
エクスポートできるものは次のとおりです。
すべてのファイルの拡張子は .ndjson です。エクスポートファイルの各行はJSONオブジェクトです。
トリガーイベント
障害イベントについては、以下の情報がエクスポートされます。
| Field | Type | Description | ||
|---|---|---|---|---|
| clock | number | 障害が検出された時点までのEpochからの経過秒数(整数部)。 | ||
| 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 | タグの値(空の場合があります)。 | ||
復旧イベントについては、以下の情報がエクスポートされます。
| Field | Type | Description |
|---|---|---|
| clock | number | 障害が復旧した時点までのEpochからの経過秒数(整数部)。 |
| 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":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}
障害 (多重障害イベントの生成):
{"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}
アイテムの値
収集されたアイテムの値について、以下の情報がエクスポートされます。
| Field | Type | Description | ||
|---|---|---|---|---|
| host | object | アイテムのホストのホスト名。 | ||
| host | string | ホスト名。 | ||
| name | string | 表示用ホスト名。 | ||
| groups | array | アイテムのホストが属するホストグループの一覧。配列には少なくとも1つの要素が含まれている必要があります。 | ||
| - | string | ホストグループ名。 | ||
| item_tags | array | アイテムタグの一覧(空の場合があります)。 | ||
| - | object | |||
| tag | string | タグ名。 | ||
| value | string | タグの値(空の場合があります)。 | ||
| itemid | number | アイテムID。 | ||
| name | string | 表示用アイテム名。 | ||
| clock | number | 値が収集された時点までの、Epochからの経過秒数(整数部)。 | ||
| ns | number | 正確な値の収集時刻を取得するために clock に加算されるナノ秒数。 |
||
| timestamp (Log のみ) |
number | 利用できない場合は0。 | ||
| source (Log のみ) |
string | 利用できない場合は空文字列。 | ||
| severity (Log のみ) |
number | 利用できない場合は0。 | ||
| eventid (Log のみ) |
number | 利用できない場合は0。 | ||
| value | number (数値アイテムの場合) または string (テキストアイテムの場合) |
収集されたアイテムの値。 | ||
| type | number | 収集された値のタイプ: 0 - 数値(浮動小数点), 1 - 文字列, 2 - ログ, 3 - 数値(符号なし), 4 - テキスト, 5 - バイナリ |
||
例
数値(符号なし)値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}
トレンド
計算されたトレンド値について、以下の情報がエクスポートされます。
| Field | Type | Description | ||
|---|---|---|---|---|
| host | object | アイテムのホストのホスト名。 | ||
| host | string | ホスト名。 | ||
| name | string | 表示用ホスト名。 | ||
| groups | array | アイテムのホストに属するホストグループの一覧。配列には少なくとも1つの要素が含まれている必要があります。 | ||
| - | string | ホストグループ名。 | ||
| item_tags | array | アイテムタグの一覧(空の場合があります)。 | ||
| - | object | |||
| tag | string | タグ名。 | ||
| value | string | タグの値(空の場合があります)。 | ||
| itemid | number | アイテムID。 | ||
| name | string | 表示用アイテム名。 | ||
| clock | number | 値が収集された時点までの、Epochからの経過秒数(整数部)。 | ||
| count | number | 指定された1時間に収集された値の数。 | ||
| min | number | 指定された1時間におけるアイテムの最小値。 | ||
| avg | number | 指定された1時間におけるアイテムの平均値。 | ||
| max | number | 指定された1時間におけるアイテムの最大値。 | ||
| type | number | 値のタイプ: 0 - 数値(浮動小数), 3 - 数値(符号なし) |
||
例
数値(符号なし)値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}
数値(浮動小数点)値:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}