12 Métricas de captura

Descripción

Las métricas de captura aceptan datos entrantes en lugar de consultarlos. Es útil para cualquier dato que desee enviar a Zabbix.

Configuración

Para configurar un elemento trampero:

1. Vaya a Recopilación de datos → Hosts.
2. Haga clic en Elementos en la fila del host.
3. Haga clic en Crear elemento.
4. Ingrese los parámetros del artículo en el formulario de configuración.

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

Los campos que requieren información específica para los elementos del trampero son:

::: nota clásica Antes de enviar valores, es posible que deba esperar hasta 60 segundos después de guardar el elemento hasta que el servidor Zabbix recoja los cambios de una actualización de la caché de configuración. :::

Enviando datos

Enviar datos al servidor Zabbix o proxy Zabbix es posible utilizando la utilidad Zabbix sender o el protocolo Zabbix sender. Enviar datos al servidor Zabbix, también es posible utilizando el método API history.push.

Remitente Zabbix

Para enviar datos al servidor o proxy de Zabbix utilizando la utilidad de envío de Zabbix, puede ejecutar el siguiente comando para enviar el "valor de prueba":

zabbix_sender -z <server IP address> -p 10051 -s "New host" -k trap -o "test value"

Para enviar el "valor de prueba", se utilizan las siguientes parámetros del comando:

• -z para especificar la dirección IP del servidor Zabbix
• -p para especificar el número de puerto del servidor Zabbix (10051 por defecto)
• -s para especificar el equipo (asegúrese de usar el técnico en lugar del visible nombre de equipo)
• -k para especificar la clave de la métrica configurada en la métrica de captura
• -o para especificar el valor a enviar

Para obtener más información sobre la comunicación entre el remitente de Zabbix y el servidor o proxy de Zabbix, consulte protocolo del remitente de Zabbix.

historia.push

Para enviar datos al servidor Zabbix utilizando el método API history.push, puede realizar la siguiente solicitud HTTP POST que contenga algunos valores de prueba:

curl --solicitud POST \
         --url 'https://example.com/zabbix/api_jsonrpc.php' \
         --header 'Autorización: Portador 0424bd59b807674191e7d77572075f33' \
         --header 'Tipo de contenido: aplicación/json-rpc' \
         --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"valor de prueba 1"},{"itemid" :10601,"valor":"valor de prueba 2"},{"itemid":99999,"valor":"valor de prueba 3"}],"id":1}'

Si la solicitud es correcta, la respuesta devuelta por la API podría verse de la siguiente manera:

{
           "jsonrpc": "2.0",
           "resultado": {
               "respuesta": "éxito",
               "datos": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "El elemento está deshabilitado."
                   },
                   {
                       "error": "No hay permisos para el objeto referido o no existe."
                   }
               ]
           },
           "identificación": 1
       }

Los errores en los datos de respuesta indican que el envío de datos para elementos específicos no ha superado la validación del servidor Zabbix. Esto puede suceder por las siguientes razones:

• el usuario que envía los datos no tiene permiso de lectura para el host del elemento;
• el host está deshabilitado o en mantenimiento sin recopilación de datos;
• el elemento no existe o aún no está incluido en la caché de configuración del servidor;
• el elemento está deshabilitado o su tipo no es el trampero Zabbix o agente HTTP (con el trampeo habilitado);
• la IP o el DNS del usuario no están configurados en la lista Hosts permitidos del elemento;
• otro elemento tiene un valor con una marca de tiempo duplicada en el nivel de nanosegundos.

La ausencia de errores indica que los valores enviados han sido aceptados para su procesamiento, lo que incluye el preprocesamiento (si corresponde), el procesamiento de activación y el guardado en la base de datos. Tenga en cuenta que el procesamiento de un valor aceptado también puede fallar (por ejemplo, durante el preprocesamiento), lo que provoca que el valor se descarte.

Para obtener más información sobre cómo trabajar con la API de Zabbix, consulte API.

Mostrando datos

Una vez que se envían los datos, puede navegar a Monitoring → Latest data para ver el resultado:

::: nota clásica Si se envía un solo valor numérico, los datos gráfico mostrarán una línea horizontal a la izquierda y a la derecha del punto de tiempo del valor. :::