Objeto conector

Los siguientes objetos están directamente relacionados con la API de connector.

Connector

El objeto connector tiene las siguientes propiedades.

Property Type Description
connectorid ID ID del connector.

Property behavior:
- solo lectura
- obligatorio para operaciones de actualización
name string Nombre del connector.

Property behavior:
- obligatorio para operaciones de creación
url string URL del endpoint, es decir, la URL del receptor.
Se admiten macros de usuario.

Property behavior:
- obligatorio para operaciones de creación
protocol integer Protocolo de comunicación.

Valores posibles:
0 - (predeterminado) Zabbix Streaming Protocol v1.0.
data_type integer Tipo de datos.

Valores posibles:
0 - (predeterminado) Valores de item;
1 - Eventos.
item_value_type integer Suma de los tipos de valor de item que se enviarán.

Valores posibles:
1 - Numérico (float);
2 - Carácter;
4 - Log;
8 - Numérico (sin signo);
16 - Texto;
32 - Binario (compatible desde Zabbix 7.0.5).

Predeterminado: 31 - Todos los tipos de item (excepto binario).

Property behavior:
- compatible si data_type está establecido en "Valores de item".
max_records integer Número máximo de eventos o items que se pueden enviar en un solo mensaje.

Valores posibles: 0-2147483647 (valor máximo de un entero con signo de 32 bits).

Predeterminado: 0 - Ilimitado.
max_senders integer Número de procesos de envío que se ejecutarán para este connector.

Valores posibles: 1-100.

Predeterminado: 1.
max_attempts integer Número de intentos.

Valores posibles: 1-5.

Predeterminado: 1.
attempt_interval string Intervalo entre reintentos.
Acepta segundos.

Valores posibles: 0s-10s.

Predeterminado: 5s.

Property behavior:
- compatible 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.

Predeterminado: 5s.
http_proxy string Cadena de conexión del proxy HTTP(S) dada como
[protocol]://[username[:password]@]proxy.example.com[:port].

Se admiten macros de usuario.
authtype integer Método de autenticación HTTP.

Valores posibles:
0 - (predeterminado) Ninguno;
1 - Básica;
2 - NTLM;
3 - Kerberos;
4 - Digest;
5 - Bearer.
username string Nombre de usuario.
Se admiten macros de usuario.

Property behavior:
- compatible si authtype está establecido en "Basic", "NTLM", "Kerberos" o "Digest"
password string Contraseña.
Se admiten macros de usuario.

Property behavior:
- compatible si authtype está establecido en "Basic", "NTLM", "Kerberos" o "Digest"
token string Token Bearer.
Se admiten macros de usuario.

Property behavior:
- obligatorio si authtype está establecido en "Bearer"
verify_peer integer Si se debe validar que el certificado del host es auténtico.

Valores posibles:
0 - No validar;
1 - (predeterminado) Validar.
verify_host integer Si se debe validar que el nombre del host para la conexión coincide con el del certificado del host.

Valores posibles:
0 - No validar;
1 - (predeterminado) Validar.
ssl_cert_file string Ruta del archivo de clave SSL pública.
Se admiten macros de usuario.
ssl_key_file string Ruta del archivo de clave SSL privada.
Se admiten macros de usuario.
ssl_key_password string Contraseña del archivo de clave SSL.
Se admiten macros de usuario.
description text Descripción del connector.
status integer Si el connector está habilitado.

Valores posibles:
0 - Deshabilitado;
1 - (predeterminado) Habilitado.
tags_evaltype integer Método de evaluación de etiquetas.

Valores posibles:
0 - (predeterminado) Y/O;
2 - O.

Filtro de etiquetas

El filtro de etiquetas permite exportar solo los valores de item o eventos que coincidan. Si no se establece, se exportará todo. El objeto filtro de etiquetas tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag string Nombre de la etiqueta.

Comportamiento de la propiedad:
- obligatorio
operator integer Operador de la condición.

Valores posibles:
0 - (por defecto) Igual;
1 - No es igual;
2 - Contiene;
3 - No contiene;
12 - Existe;
13 - No existe.
value string Valor de la etiqueta.