Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

item.create

Descripción

object item.create(object/array items)

Este método permite crear nuevas métricas.

Las métricas web no se pueden crear a través de la API de Zabbix.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(objeto/array) Métricas a crear.

Además de las propiedades estándar de la métrica, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
preprocessing array Opciones de preprocesamiento de la métrica.
tags array Etiquetas de la métrica.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de las métricas creadas bajo la propiedad itemids. El orden de los IDs devueltos coincide con el orden de las métricas enviadas.

Ejemplos

Creando una métrica

Cree una métrica numérica de Zabbix agent con 2 etiquetas de métrica para monitorizar el espacio libre en disco en el equipo con ID "30074".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "name": "Espacio libre en disco en /home/joe/",
               "key_": "vfs.fs.size[/home/joe/,free]",
               "hostid": "30074",
               "type": 0,
               "value_type": 3,
               "interfaceid": "30084",
               "tags": [
                   {
                       "tag": "component",
                       "value": "storage"
                   },
                   {
                       "tag": "equipment",
                       "value": "workstation"
                   }
               ],
               "delay": "30s"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "24758"
               ]
           },
           "id": 1
       }

Creando una métrica de inventario de equipo

Cree una métrica de agente Zabbix para rellenar el campo de inventario "SO" del equipo.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "name": "uname",
               "key_": "system.uname",
               "hostid": "30021",
               "type": 0,
               "interfaceid": "30007",
               "value_type": 1,
               "delay": "10s",
               "inventory_link": 5
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "24759"
               ]
           },
           "id": 1
       }

Creando una métrica con preprocesamiento

Cree una métrica utilizando un multiplicador personalizado.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "name": "Tiempo de actividad del dispositivo",
               "key_": "sysUpTime",
               "hostid": "11312",
               "type": 4,
               "snmp_oid": "SNMPv2-MIB::sysUpTime.0",
               "value_type": 1,
               "delay": "60s",
               "units": "uptime",
               "interfaceid": "1156",
               "preprocessing": [
                   {
                       "type": 1,
                       "params": "0.01",
                       "error_handler": 1,
                       "error_handler_params": ""
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "44210"
               ]
           },
           "id": 1
       }

Creando una métrica dependiente

Cree una métrica dependiente para la métrica principal con ID 24759. Solo se permiten dependencias en el mismo equipo, por lo tanto, la métrica principal y la dependiente deben tener el mismo hostid.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
             "hostid": "30074",
             "name": "Métrica de prueba dependiente",
             "key_": "dependent.item",
             "type": 18,
             "master_itemid": "24759",
             "value_type": 2
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "44211"
               ]
           },
           "id": 1
       }

Crear métrica de agente HTTP

Crear una métrica de método de solicitud POST con preprocesamiento de respuesta JSON.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "url":"http://127.0.0.1/http.php",
               "query_fields": [
                   {
                       "name": "mode",
                       "value": "json"
                   },
                   {
                       "name": "min",
                       "value": "10"
                   },
                   {
                       "name": "max",
                       "value": "100"
                   }
               ],
               "interfaceid": "1",
               "type": 19,
               "hostid": "10254",
               "delay": "5s",
               "key_": "json",
               "name": "Ejemplo de agente HTTP JSON",
               "value_type": 0,
               "output_format": 1,
               "preprocessing": [
                   {
                       "type": 12,
                       "params": "$.random",
                       "error_handler": 0,
                       "error_handler_params": ""
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "23865"
               ]
           },
           "id": 1
       }

Crear métrica de script

Cree una recopilación de datos simple utilizando una métrica de script.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "name": "Ejemplo de script",
               "key_": "custom.script.item",
               "hostid": "12345",
               "type": 21,
               "value_type": 4,
               "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",
               "parameters": [
                   {
                       "name": "host",
                       "value": "{HOST.CONN}"
                   }
               ],
               "timeout": "6s",
               "delay": "30s"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "23865"
               ]
           },
           "id": 1
       }

Fuente

CItem::create() en ui/include/classes/api/services/CItem.php.