Documentation
Table of Contents
2 Transmisi¨®n a sistemas externos
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general
Es posible transmitir valores de m¨¦tricas y eventos desde Áú»¢¶Ä²© a sistemas externos a trav¨¦s de HTTP (consulte detalles del protocolo).
El filtro de etiquetas se puede utilizar para transmitir subconjuntos de valores de m¨¦tricas o eventos.
Dos procesos del servidor Áú»¢¶Ä²© son responsables de la transmisi¨®n de datos: "administrador de conectores" y "trabajador de conectores". Una m¨¦trica interna de Áú»¢¶Ä²© zabbix[connector_queue] permite monitorear el recuento de valores en cola en la cola del conector.
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô
Se requieren los siguientes pasos para configurar la transmisi¨®n de datos a un sistema externo:
1. Tener un sistema remoto configurado para recibir datos de Áú»¢¶Ä²©.
Consulte la documentaci¨®n de un simple. Actualmente, el receptor registra la informaci¨®n recibida en los archivos events.ndjson y history.ndjson.
2. Establezca el n¨²mero de trabajadores del conector requeridos en Áú»¢¶Ä²© ajustando el par¨¢metro StartConnectors en zabbix_server.conf. El n¨²mero de trabajadores del conector debe coincidir (o exceder si las sesiones simult¨¢neas son m¨¢s del 1) recuento de conectores configurado en la interfaz de Áú»¢¶Ä²©. Luego, reinicie el servidor Áú»¢¶Ä²©.
3. Configure un nuevo conector en la interfaz de Áú»¢¶Ä²© (´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨®²Ô -> General -> Conectores) y vuelva a cargar la cach¨¦ del servidor con el comando "zabbix_server -R config_cache_reload".
Los campos obligatorios est¨¢n marcados con un asterisco.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Nombre | Ingrese el nombre del conector. |
| Tipo de datos | Seleccione el tipo de datos: Valores de m¨¦tricas o Eventos. |
| URL | Ingrese la URL del receptor. Se admiten macros de usuario. |
| Filtro de etiquetas | Exporta solo valores o eventos que coincidan con el filtro de etiquetas. Si no est¨¢ configurado, exporte todo. Es posible incluir y excluir etiquetas y valores de etiquetas espec¨ªficos. Se pueden establecer varias condiciones. La coincidencia de nombres de etiquetas siempre distingue entre may¨²sculas y min¨²sculas. Hay varios operadores disponibles para cada condici¨®n: Existe: incluye los nombres de etiquetas especificados Igual: incluye los nombres de etiquetas especificados y valores (distingue entre may¨²sculas y min¨²sculas) Contiene: incluye los nombres de etiqueta especificados donde los valores de etiqueta contienen la cadena ingresada (coincidencia de subcadena, no distingue entre may¨²sculas y min¨²sculas) No existe: excluye lo especificado nombres de etiquetas No es igual: excluye los nombres y valores de etiquetas especificados (distingue entre may¨²sculas y min¨²sculas) No contiene: excluye los nombres de etiquetas especificados donde los valores de etiqueta contienen la cadena ingresada ( coincidencia de subcadena, no distingue entre may¨²sculas y min¨²sculas) Hay dos tipos de c¨¢lculo para las condiciones: Y/O: se deben cumplir todas las condiciones, las condiciones que tengan el mismo nombre de etiqueta se agrupar¨¢n por la condici¨®n O<br >O - suficiente si se cumple una condici¨®n |
| ´¡³Ü³Ù±ð²Ô³Ù¾±³¦²¹³¦¾±¨®²Ô HTTP | Seleccione la opci¨®n de autenticaci¨®n: Ninguno: no se utiliza autenticaci¨®n; µþ¨¢²õ¾±³¦´Ç: se utiliza autenticaci¨®n b¨¢sica; NTLM - NTLM ( se utiliza autenticaci¨®n; Kerberos: se utiliza autenticaci¨®n Kerberos; Digest: autenticaci¨®n impl¨ªcita se utiliza; Portador - Se utiliza autenticaci¨®n de portador. |
| Nombre de usuario | Ingrese el nombre de usuario. Este campo est¨¢ disponible si autenticaci¨®n HTTP est¨¢ configurada en B¨¢sica, NTLM, Kerberos o Digest. Se admiten macros de usuario. |
| Contrase?a | Ingrese la contrase?a de usuario. Este campo est¨¢ disponible si autenticaci¨®n HTTP est¨¢ configurada en B¨¢sica, NTLM, Kerberos o Digest. Se admiten macros de usuario. |
| Token de portador | Ingrese el token de portador. Este campo est¨¢ disponible y es obligatorio si autenticaci¨®n HTTP est¨¢ configurado en Portador. Se admiten macros de usuario. |
| °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada | Marque esta casilla de verificaci¨®n para mostrar las opciones de configuraci¨®n avanzadas. |
| Registros m¨¢ximos por mensaje | Especifique el n¨²mero m¨¢ximo de valores o eventos que se pueden enviar dentro de un mensaje. |
| Sesiones simult¨¢neas | Seleccione el n¨²mero de procesos de remitente que se ejecutar¨¢n para este conector. Se pueden especificar hasta 100 sesiones; el valor predeterminado es '1'. |
| Intentos | N¨²mero de intentos para intentar enviar los datos. Se pueden especificar hasta 5 intentos; el valor predeterminado es '1'. |
| Tiempo de espera | Especifique el tiempo de espera del mensaje (1-60 segundos, predeterminado 5 segundos). Se admiten sufijos de tiempo, p. 30s, 1m. Se admiten macros de usuario. |
| Proxy HTTP | Puede especificar un proxy HTTP para usar, usando el formato [protocolo://][nombre de usuario[:contrase?a]@]proxy.example.com[:puerto].El opcional El prefijo protocolo:// se puede utilizar para especificar protocolos de proxy alternativos (la compatibilidad con el prefijo de protocolo se agreg¨® en cURL 7.21.7). Sin ning¨²n protocolo especificado, el proxy ser¨¢ tratado como un proxy HTTP.De forma predeterminada, se utilizar¨¢ el puerto 1080. Si se especifica, el proxy sobrescribir¨¢ las variables de entorno relacionadas con el proxy, como http_proxy, HTTPS_PROXY. Si no se especifica, el proxy no sobrescribir¨¢ las variables de entorno relacionadas con el proxy. El valor ingresado se transmite "tal cual", no se realiza ninguna verificaci¨®n de idoneidad. Tambi¨¦n puede ingresar una direcci¨®n de proxy SOCKS. Si especifica el protocolo incorrecto, la conexi¨®n fallar¨¢ y el elemento dejar¨¢ de ser compatible. Tenga en cuenta que solo se admite la autenticaci¨®n simple con el proxy HTTP. Se admiten macros de usuario. |
| SSL verificar par | Marque la casilla de verificaci¨®n para verificar el certificado SSL del servidor web. El certificado del servidor se tomar¨¢ autom¨¢ticamente de la ubicaci¨®n de la autoridad certificadora (CA) de todo el sistema. Puede anular la ubicaci¨®n de los archivos CA utilizando el servidor Áú»¢¶Ä²© o el par¨¢metro de configuraci¨®n del proxy SSLCALocation. |
| SSL verificar equipo | Marque la casilla de verificaci¨®n para verificar que el campo Nombre com¨²n o el campo Nombre alternativo del sujeto del certificado del servidor web coincidan. Esto establece el opci¨®n cURL. |
| Archivo de certificado SSL | Nombre del archivo de certificado SSL utilizado para la autenticaci¨®n del cliente. El archivo del certificado debe estar en formato PEM1. Si el archivo de certificado contiene tambi¨¦n la clave privada, deje el campo archivo de clave SSL vac¨ªo. Si la clave est¨¢ cifrada, especifique la contrase?a en el campo contrase?a de clave SSL. El directorio que contiene este archivo lo especifica el servidor Áú»¢¶Ä²© o el par¨¢metro de configuraci¨®n del proxy SSLCertLocation. Se admiten macros de usuario. |
| Archivo de clave SSL | Nombre del archivo de clave privada SSL utilizado para la autenticaci¨®n del cliente. El archivo de clave privada debe estar en formato PEM1. El directorio que contiene este archivo lo especifica el servidor Áú»¢¶Ä²© o el par¨¢metro de configuraci¨®n del proxy SSLKeyLocation. Se admiten macros de usuario. |
| Contrase?a de la clave SSL | Contrase?a del archivo de clave privada SSL. Se admiten macros de usuario. |
| ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | Ingrese la descripci¨®n del conector. |
| Habilitado | Marque la casilla de verificaci¨®n para habilitar el conector. |
Protocolo
La comunicaci¨®n entre el servidor y el receptor se realiza a trav¨¦s de HTTP utilizando REST API, NDJSON, "Content-Type: application/x-ndjson".
Para obtener m¨¢s detalles, consulte el protocolo de exportaci¨®n JSON delimitado por salto de l¨ªnea.
Solicitud del servidor
Ejemplo de valores de elementos de transmisi¨®n:
POST /v1/historia HTTP/1.1
´¡²Ô´Ú¾±³Ù°ù¾±¨®²Ô: localhost: 8080
Aceptar: */*
Aceptar ³¦´Ç»å¾±´Ú¾±³¦²¹³¦¾±¨®²Ô: deflate, gzip, br, zstd
Longitud del contenido: 628
Tipo de contenido: ²¹±è±ô¾±³¦²¹³¦¾±¨®²Ô/³æ-²Ô»åÂá²õ´Ç²Ô
{"host":{"host":"servidor Áú»¢¶Ä²©","name":"servidor Áú»¢¶Ä²©"},"groups":["servidores Áú»¢¶Ä²©"],"item_tags":[{"tag":"foo", "valor":"prueba"}],"itemid":44457,"nombre":"foo","reloj":1673454303,"ns":800155804,"valor":0,"tipo":3}
{"host":{"host":"servidor Áú»¢¶Ä²©","name":"servidor Áú»¢¶Ä²©"},"groups":["servidores Áú»¢¶Ä²©"],"item_tags":[{"tag":"foo", "valor":"prueba"}],"itemid":44457,"nombre":"foo","reloj":1673454303,"ns":832290669,"valor":1,"tipo":3}
{"host":{"host":"servidor Áú»¢¶Ä²©","name":"servidor Áú»¢¶Ä²©"},"groups":["servidores Áú»¢¶Ä²©"],"item_tags":[{"tag":"bar", "valor":"prueba"}],"itemid":44458,"nombre":"bar","reloj":1673454303,"ns":867770366,"valor":123,"tipo":3}Ejemplo de eventos de streaming:
POST /v1/eventos HTTP/1.1
´¡²Ô´Ú¾±³Ù°ù¾±¨®²Ô: localhost: 8080
Aceptar: */*
Aceptar ³¦´Ç»å¾±´Ú¾±³¦²¹³¦¾±¨®²Ô: deflate, gzip, br, zstd
Longitud del contenido: 333
Tipo de contenido: ²¹±è±ô¾±³¦²¹³¦¾±¨®²Ô/³æ-²Ô»åÂá²õ´Ç²Ô
{"clock":1673454303,"ns":800155804,"value":1,"eventid":5,"name":"activador para que foo sea 0","severity":0,"hosts":[{" host":"servidor Áú»¢¶Ä²©","name":"servidor Áú»¢¶Ä²©"}],"groups":["servidores Áú»¢¶Ä²©"],"tags":[{"tag":"foo_trig","value":"test "},{"tag":"foo","valor":"prueba"}]}
{"reloj":1673454303,"ns":832290669,"valor":0,"eventid":6,"p_eventid":5}Respuesta del receptor
La respuesta consta del c¨®digo de estado de respuesta HTTP y la carga ¨²til JSON. El c¨®digo de estado de respuesta HTTP debe ser "200", "201", "202", "203" o "204" para las solicitudes que se manejaron correctamente y otro para las solicitudes fallidas.
Ejemplo de ¨¦xito:
localhost:8080/v1/history": HTTP/1.1 200 OK
Fecha: ³¾¾±¨¦°ù³¦´Ç±ô±ð²õ 11 de enero de 2023 16:40:30 GMT
Longitud del contenido: 0Ejemplo con errores: