Documentation
Table of Contents
item.create
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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 Áú»¢¶Ä²©.
Este m¨¦todo solo est¨¢ disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al m¨¦todo se pueden revocar en la configuraci¨®n del rol de usuario. Ver Roles de usuario para m¨¢s informaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(objeto/matriz) ²Ñ¨¦³Ù°ù¾±³¦²¹s a crear.
Adem¨¢s de las propiedades est¨¢ndar de la m¨¦trica, el m¨¦todo acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| preprocessing | matriz | Opciones de preprocesamiento de la m¨¦trica. |
| tags | matriz | 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 pasadas.
Ejemplos
Creaci¨®n de una m¨¦trica
Cree una m¨¦trica de agente Áú»¢¶Ä²© num¨¦rica con 2 etiquetas de m¨¦trica para monitorear el espacio libre en disco en el equipo con ID "30074".
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Free disk space on /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:
Creando un m¨¦trica de inventario de equipo
Cree una m¨¦trica de agente Áú»¢¶Ä²© para completar el campo de inventario "SO" del equipo.
{
"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:
Creando una m¨¦trica con preprocesamiento
Crea una m¨¦trica usando un multiplicador personalizado.
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Device uptime",
"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:
Creando elemento dependiente
Cree una m¨¦trica dependiente para la m¨¦trica principal con ID 24759. S¨®lo se permiten dependencias en el mismo equipo, por lo tanto, la m¨¦trica principal y la dependiente deben tener el mismo ID de host.
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"hostid": "30074",
"name": "Dependent test item",
"key_": "dependent.item",
"type": 18,
"master_itemid": "24759",
"value_type": 2
},
"id": 1
}Respuesta:
Crear m¨¦trica de agente HTTP
Cree una m¨¦trica con m¨¦todo de solicitud POST con preprocesamiento de respuesta JSON.
{
"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": "HTTP agent example JSON",
"value_type": 0,
"output_format": 1,
"preprocessing": [
{
"type": 12,
"params": "$.random",
"error_handler": 0,
"error_handler_params": ""
}
]
},
"id": 1
}Respuesta:
Crear una m¨¦trica de script
Cree una colecci¨®n de datos simple utilizando una m¨¦trica de script.
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Script example",
"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:
Fuente
CItem::create() en ui/include/classes/api/services/CItem.php.