Table of Contents
Objeto conector
Los siguientes objetos están directamente relacionados con la API de connector.
Conector
El objeto conector tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| connectorid | ID | ID del conector. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización |
| name | string | Nombre del conector. Comportamiento de la propiedad: - requerido para operaciones de creación |
| url | string | URL del endpoint, es decir, URL del receptor. Se admiten macros de usuario. Comportamiento de la propiedad: - requerido para operaciones de creación |
| protocol | integer | Protocolo de comunicación. Valores posibles: 0 - (por defecto) Protocolo de transmisión Zabbix v1.0. |
| data_type | integer | Tipo de datos. Valores posibles: 0 - (por defecto) Valores de métricas; 1 - Eventos. |
| item_value_type | integer | Una suma de los tipos de valores de métricas a enviar. Valores posibles: 1 - Numérico (coma flotante); 2 - Carácter; 4 - Registro; 8 - Numérico (sin signo); 10 - Texto; 20 - Binario. Por defecto: 31 - Todos los tipos de métricas (excepto binario). Comportamiento de la propiedad: - soportado si data_type está establecido en "Valores de métricas". |
| max_records | integer | Número máximo de eventos o métricas que se pueden enviar en un solo mensaje. Valores posibles: 0-2147483647 (valor máximo de un entero con signo de 32 bits). Por defecto: 0 - Ilimitado. |
| max_senders | integer | Número de procesos de envío a ejecutar para este conector. Valores posibles: 1-100. Por defecto: 1. |
| max_attempts | integer | Número de intentos. Valores posibles: 1-5. Por defecto: 1. |
| attempt_interval | string | El intervalo entre intentos de reintento. Acepta segundos. Valores posibles: 0s-10s. Por defecto: 5s. Comportamiento de la propiedad: - soportado si max_attempts es mayor que 1. |
| timeout | string | Tiempo de espera. Se admiten sufijos de tiempo (por ejemplo, 30s, 1m). Se admiten macros de usuario. Valores posibles: 1s-60s. Por defecto: 5s. |
| http_proxy | string | Cadena de conexión proxy HTTP(S) dada como [protocolo]://[usuario[:contraseña]@]proxy.ejemplo.com[:puerto]. Se admiten macros de usuario. |
| authtype | integer | Método de autenticación HTTP. Valores posibles: 0 - (por defecto) Ninguno; 1 - Básico; 2 - NTLM; 3 - Kerberos; 4 - Digest; 5 - Bearer. |
| username | string | Nombre de usuario. Se admiten macros de usuario. Comportamiento de la propiedad: - soportado si authtype está establecido en "Básico", "NTLM", "Kerberos" o "Digest" |
| password | string | Contraseña. Se admiten macros de usuario. Comportamiento de la propiedad: - soportado si authtype está establecido en "Básico", "NTLM", "Kerberos" o "Digest" |
| token | string | Token Bearer. Se admiten macros de usuario. Comportamiento de la propiedad: - requerido si authtype está establecido en "Bearer" |
| verify_peer | integer | Si se debe validar que el certificado del equipo es auténtico. Valores posibles: 0 - No validar; 1 - (por defecto) Validar. |
| verify_host | integer | Si se debe validar que el nombre del equipo para la conexión coincide con el del certificado del equipo. Valores posibles: 0 - No validar; 1 - (por defecto) Validar. |
| ssl_cert_file | string | Ruta del archivo de clave pública SSL. Se admiten macros de usuario. |
| ssl_key_file | string | Ruta del archivo de clave privada SSL. Se admiten macros de usuario. |
| ssl_key_password | string | Contraseña para el archivo de clave SSL. Se admiten macros de usuario. |
| description | text | Descripción del conector. |
| status | integer | Si el conector está habilitado. Valores posibles: 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
| tags_evaltype | integer | Método de evaluación de etiquetas. Valores posibles: 0 - (por defecto) Y/O; 2 - O. |
Filtro de etiqueta
El filtro de etiqueta permite exportar solo los valores de métricas o eventos que coincidan. Si no se establece, se exportará todo. El objeto filtro de etiqueta tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | string | Nombre de la etiqueta. Comportamiento de la propiedad: - obligatorio |
| operator | integer | Operador de condición. Valores posibles: 0 - (por defecto) Igual; 1 - No es igual; 2 - Contiene; 3 - No contiene; 12 - Existe; 1 - No existe. |
| value | string | Valor de la etiqueta. |