Documentation
Table of Contents
history.push
説明
object history.push(object/array itemHistoryData)
このメソッドは、アイテムヒストリデータをZabbixサーバーに送信できます。
このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細はユーザーの役割を参照してください。
Parameters
(オブジェクト/配列) 送信するアイテム履歴データ。
このメソッドは以下のパラメータをサポートしています。
| パラメータ | タイプ | 説明 |
|---|---|---|
| itemid | ID | 関連アイテムのID パラメータの動作: - 必須 host と key が設定されていない場合 |
| host | 文字列 | ホストの技術名 パラメータの動作: - 必須 itemid が設定されていない場合 |
| key | 文字列 | アイテムキー パラメータの動作: - 必須 itemid が設定されていない場合 |
| value | mixed | アイテム値 パラメータの動作: - 必須 |
| clock | タイムスタンプ | 値を受信した時刻 |
| ns | 整数 | 値を受信したナノ秒数 |
戻り値
(object) データ送信操作の結果を返します。
例
アイテムヒストリデータの送信
Zabbixサーバーへ、アイテム"10600"、"10601"、"999999"のヒストリデータを送信します。
リクエスト :
{
"jsonrpc": "2.0",
"method": "history.push",
"params": [
{
"itemid": 10600,
"value": 0.5,
"clock": 1690891294,
"ns": 45440940
},
{
"itemid": 10600,
"value": 0.6,
"clock": 1690891295,
"ns": 312431
},
{
"itemid": 10601,
"value": "[Tue Aug 01 15:01:35 2023] [error] [client 1.2.3.4] File does not exist: /var/www/html/robots.txt"
},
{
"itemid": 999999,
"value": 123
}
],
"id": 1
}レスポンス :
{
"jsonrpc": "2.0",
"result": {
"response": "success",
"data": [
{
"itemid": "10600"
},
{
"itemid": "10600"
},
{
"itemid": "10601",
"error": "Item is disabled."
},
{
"error": "No permissions to referred object or it does not exist."
}
]
},
"id": 1
}参照
- Trapper items
- HTTP agent items
- Host
- Item
ソース
CHistory::push() in ui/include/classes/api/services/CHistory.php.