Supported OS

Versión de la integración1.1.1

Información general

Conéctate a Zabbix para:

  • Monitorizar Zabbix a través de Datadog Agent.
  • Enviar alertas de Zabbix a Datadog para ver las alertas como eventos en tu flujo (stream) de eventos Datadog.

Configuración

El check de Zabbix no está incluido en el paquete del Datadog Agent, por lo que es necesario instalarlo.

Instalación

Para el Agent v7.21/v6.21 o posteriores, sigue las instrucciones a continuación para instalar el check de Zabbix en tu host. Para instalarlo con el Agent Docker o versiones anteriores del Agent, consulta Uso de integraciones de la comunidad.

  1. Ejecuta el siguiente comando para instalar la integración del Agent:

    datadog-agent integration install -t datadog-zabbix==<INTEGRATION_VERSION>
    
  2. Configura tu integración como si fuese una integración de base.

Configuración

  1. Asegúrate de que la zona horaria de tu servidor Zabbix esté configurada en UTC. Puedes encontrar más información sobre las zonas horarias de Zabbix en la documentación de Zabbix.

  2. Edita el archivo zabbix.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent, para empezar a recopilar los datos de rendimiento de Zabbix. Consulta el zabbix.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

  3. Reinicia el Agent.

Recopilación de eventos

Crear un tipo de soporte Datadog
  1. Ve a Administration > Media Types > Create Media Type (Administración > Tipos de soporte > Crear un tipo de soporte).
  2. Añade parámetros al webhook utilizando variables de plantilla Zabbix. Añade tu api_key Datadog y las siguientes variables de plantilla Zabbix como parámetros:
ParámetroValor
api_keyYour Datadog API key
event_date{EVENT.DATE}
event_name{EVENT.NAME}
event_nseverity{EVENT.NSEVERITY}
event_tags{EVENT.TAGSJSON}
event_time{EVENT.TIME}
event_value{EVENT.VALUE}
item_name{ITEM.NAME}
alert_message{ALERT.MESSAGE}
alert_subject{ALERT.SUBJECT}
  1. Define el Nombre como Datadog, el Tipo como Webhook e introduce el siguiente código como Script:
try {
    Zabbix.Log(4, '[datadog webhook] received value=' + value);

    var params = JSON.parse(value);
    var req = new HttpRequest();
    req.addHeader('Content-Type: application/json');
    var webhook_url = 'https://app.datadoghq.com/intake/webhook/zabbix?api_key=' + params.api_key;
    var webhook_data = value;
    var resp = req.post(webhook_url, webhook_data);
    if (req.getStatus() != 202) {
        throw 'Response code: '+req.getStatus();
    }
    Zabbix.Log(4, '[datadog webhook] received response with status code ' + req.getStatus() + '\n' + resp);
} catch (error) {
    Zabbix.Log(4, '[datadog webhook] event creation failed json : ' + webhook_data)
    Zabbix.Log(4, '[datadog webhook] event creation failed : ' + error);
}
return JSON.stringify({});
  1. Confirma que el webhook está configurado correctamente utilizando el botón “Test”.
Asignar soportes webhook a un usuario existente
  1. Después de configurar el tipo de soporte webhook, ve a Administration > Users (Administración > Usuarios) y crea un usuario Zabbix exclusivo para representar el webhook. Por ejemplo, utiliza el alias Datadog para el webhook Datadog. Todos los parámetros, excepto los soportes, se pueden dejar en sus valores predeterminados, ya que este usuario no inicia sesión en Zabbix.
  2. En el perfil de usuario, ve a la pestaña Soporte y añade un webhook con la información de contacto requerida. Si el webhook no utiliza un campo de destino de envíos, introduce cualquier combinación de caracteres admitidos para omitir los requisitos de validación.
  3. Conceda a este usuario al menos permisos de lectura en todos los hosts a los que deba enviar alertas.
Configurar una acción de alerta para el webhook
  1. Ve a Configuration > Actions (Configuración > Acciones).
  2. En el menú desplegable del título de la página, selecciona el tipo de acción preferida.
  3. Haz clic en Create Action (Crear acción).
  4. Pon un nombre a la acción.
  5. Elige las condiciones en las que se realizan las operaciones.
  6. Elige las operaciones que se van a realizar.

Validación

Ejecuta el subcomando de estado del Agent y busca zabbix en la sección Checks.

Datos recopilados

Métricas

Eventos

Las alertas de Zabbix se recopilan como eventos en el flujo de eventos Datadog.

Checks de servicios

Solucionar problemas

¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.

PREVIEWING: may/embedded-workflows