history.push

Descripció

object history.push(object/array itemHistoryData)

Aquest mètode permet enviar la informació de l'historial dels elements al servidor Zabbix.

Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu Rols d'usuari.

Paràmetres

(object/array) Informació de l'historial de l'element a enviar.

Paràmetre	Tipus	Descripció
itemid	ID	ID de l'element referenciat. Comportament de la propietat: - obligatori si `host` i `key` no s'han pas definit
host	string	Nom tècnic de l'equip. Comportament de la propietat: - obligatori si `itemid` no s'ha establert
key	string	clau de l'element. Comportament de la propietat: - obligatori si `itemid` no s'ha pas definit
value	mixed	Item value. Comportament de la propietat: - obligatori
clock	timestamp	Hora en que s'ha rebut el valor.
ns	integer	Nanosegons des que el valor s'ha rebut.

Valor de retorn

(object) Torna el resultat de l'operació d'enviament d'informació.

Exemples

Enviar la informació de l'historial de l'element

Envia la informació de l'historial de l'element al servidor Zabbix dels elements "10600", "10601", i "999999".

Petició:

{
           "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] L'arxiu no existeix pas: /var/www/html/robots.txt"
               },
               {
                   "itemid": 999999,
                   "value": 123
               }
           ],
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "data": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "Element deshabilitat."
                   },
                   {
                       "error": "No hi ha permisos de l'objecte referit, o no existeix pas."
                   }
               ]
           },
           "id": 1
       }

Veieu també

Font

CHistory::push() in ui/include/classes/api/services/CHistory.php.

Documentation