Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

itemprototype.get

Descripción

integer/array itemprototype.get(object parameters)

El método permite recuperar prototipos de métrica de acuerdo con los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
discoveryids cadena/matriz Devuelve solo prototipos de métricas que pertenecen a las reglas LLD dadas.
graphids cadena/matriz Devuelve solo los prototipos de métricas que se utilizan en los prototipos de gráficos dados.
hostids cadena/matriz Devuelve solo prototipos de métricas que pertenecen a los equipos dados.
inherited booleano Si se establece en "verdadero", devuelve solo prototipos de métricas heredados de una plantilla.
itemids cadena/matriz Devuelve solo prototipos de métricas con los ID proporcionados.
monitored booleano Si se establece en "verdadero", devolverá solo los prototipos de métricas habilitados que pertenecen a equipos monitoreados.
métricas booleano Si se establece en "verdadero", devuelve solo prototipos de métricas que pertenecen a plantillas.
templateids cadena/matriz Devuelve solo prototipos de métricas que pertenecen a las plantillas dadas.
triggerids cadena/matriz Devuelve solo los prototipos de métricas que se utilizan en los prototipos de iniciadores dados.
selectDiscoveryRule query Devuelve una propiedad discoveryRule con la regla de descubrimiento de bajo nivel a la que pertenece el prototipo de la métrica.
selectGraphs query Devuelve una propiedad graphs con prototipos de gráficos en los que se utiliza el prototipo de la métrica.

Admite count.
selectHosts query Devuelve una propiedad hosts con una matriz de equipos a los que pertenece el prototipo de la métrica.
selectTags query Devuelve las etiquetas del prototipo de métrica en la propiedad tags.
selectTriggers query Devuelve una propiedad triggers con prototipos de iniciador en los que se utiliza el prototipo de la métrica.

Admite count.
selectPreprocessing query Devuelve una propiedad de preprocesamiento con opciones de preprocesamiento de métricas.

Tiene las siguientes propiedades:
tipo - (cadena) El tipo de opción de preprocesamiento:
1 - Multiplicador personalizado;
2 - Recorte derecho;
3 - Recorte izquierdo;
4 - Recortar;
5 - Expresión regular;<br >6 - Booleano a decimal;
7 - Octal a decimal;
8 - Hexadecimal a decimal;
9 - Cambio simple;
10 - Cambio por segundo;
11 - XML XPath;
12 - JSONPath;
13 - Dentro del rango;
14 - Coincide con la expresión regular;
15 - No coincide con la expresión regular;
16 - Comprueba si hay errores en JSON;
17 - Verificar errores en XML;
18 - Verificar errores usando expresiones regulares;
19 - Descartar sin cambios;
20 - Descartar sin cambios con un latido;
21 - JavaScript;
22 - Prometheus patrón;
23 - Prometheus a JSON;
24 - CSV a JSON;
25 - Reemplazar;
26 - Verificar valor no admitido;
27 - XML a JSON;
28 - Valor de SNMP walk;
29 - SNMP walk a JSON.
params - (cadena) Parámetros adicionales utilizados por la opción de preprocesamiento. Múltiples parámetros están separados por el carácter de nueva línea (\n).
error_handler - (string) Tipo de acción utilizado en caso de falla en el paso de preprocesamiento:
0 - El mensaje de error lo establece el servidor Zabbix;< br>1 - Descartar valor;
2 - Establecer valor personalizado;
3 - Establecer mensaje de error personalizado.
error_handler_params - (string) Parámetros del controlador de errores.
selectValueMap consulta Devuelve una propiedad valuemap con el mapa de valores del prototipo de la métrica.
filter objeto Devuelve sólo aquellos resultados que coinciden exactamente con el filtro dado.

Acepta una matriz, donde las claves son nombres de propiedades y los valores son un valor único o una matriz de valores con los que comparar.

Admite filtros adicionales:
host: nombre técnico del host al que pertenece el prototipo del artículo.
limitSelects entero Limita el número de registros devueltos por las subselecciones.

Se aplica a las siguientes subselecciones:
selectGraphs: los resultados se ordenarán por nombre;
selectTriggers: resultados se ordenará por descripción.
sortfield cadena/matriz Ordena el resultado por las propiedades dadas.

Valores posibles: itemid, name, key_, delay, type, status.
countOutput booleano Estos parámetros, que son comunes para todos los métodos get, se describen en detalle en el comentario de referencia.
editable booleano
excludeSearch booleano
limit entero
output consulta
preservekeys booleano
search objeto
searchByAny booleano
searchWildcardsEnabled booleano
sortorder cadena/matriz
startSearch booleano

Valores de devueltos

(integer/array) Returns either:

  • una matriz de objetos;
  • la suma de los objetos devueltos, si el parámetros countOutput está siendo usado

Ejemplos

Recuperar prototipos de métrica de una regla LLD

Recupere todos los prototipos de métrica para un ID de regla LLD específica.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.get",
           "params": {
               "output": "extend",
               "discoveryids": "27426"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "23077",
                   "type": "0",
                   "snmp_oid": "",
                   "hostid": "10079",
                   "name": "Incoming network traffic on en0",
                   "key_": "net.if.in[en0]",
                   "delay": "1m",
                   "history": "1w",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "3",
                   "trapper_hosts": "",
                   "units": "bps",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "0",
                   "description": "",
                   "evaltype": "0",
                   "jmx_endpoint": "",
                   "master_itemid": "0",
                   "timeout": "3s",
                   "url": "",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "200",
                   "follow_redirects": "1",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "0",
                   "output_format": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               },
               {
                   "itemid": "10010",
                   "type": "0",
                   "snmp_oid": "",
                   "hostid": "10001",
                   "name": "Processor load (1 min average per core)",
                   "key_": "system.cpu.load[percpu,avg1]",
                   "delay": "1m",
                   "history": "1w",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "0",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "0",
                   "description": "The processor load is calculated as system CPU load divided by number of CPU cores.",
                   "evaltype": "0",
                   "jmx_endpoint": "",
                   "master_itemid": "0",
                   "timeout": "3s",
                   "url": "",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "200",
                   "follow_redirects": "1",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "0",
                   "output_format": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 1
       }

Encontrar métrica dependiente

Busque una métrica dependiente para una ID de métrica específica.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.get",
           "params": {
               "output": "extend",
               "filter": {
                   "type": 18,
                   "master_itemid": "25545"
               },
               "limit": "1"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "25547",
                   "type": "18",
                   "snmp_oid": "",
                   "hostid": "10116",
                   "name": "Seconds",
                   "key_": "apache.status.uptime.seconds",
                   "delay": "0",
                   "history": "90d",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "3",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "0",
                   "description": "",
                   "evaltype": "0",
                   "master_itemid": "25545",
                   "jmx_endpoint": "",
                   "timeout": "3s",
                   "url": "",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "200",
                   "follow_redirects": "1",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "0",
                   "output_format": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 1
       }

Buscar prototipo de métrica de agente HTTP

Encuentre el prototipo de métrica del agente HTTP con el método de solicitud HEAD para una ID de equipo específica.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.get",
           "params": {
               "hostids": "10254",
               "filter": {
                   "type": 19,
                   "request_method": 3
               }
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "28257",
                   "type": "19",
                   "snmp_oid": "",
                   "hostid": "10254",
                   "name": "discovered",
                   "key_": "item[{#INAME}]",
                   "delay": "{#IUPDATE}",
                   "history": "90d",
                   "trends": "30d",
                   "status": "0",
                   "value_type": "3",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "28255",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "flags": "2",
                   "interfaceid": "2",
                   "description": "",
                   "evaltype": "0",
                   "jmx_endpoint": "",
                   "master_itemid": "0",
                   "timeout": "3s",
                   "url": "{#IURL}",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "",
                   "follow_redirects": "0",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "3",
                   "output_format": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 1
       }

Ver también

Fuente

CItemPrototype::get() en ui/include/classes/api/services/CItemPrototype.php.