Zabbix¶

Catégorie : Monitoring | Version : 1.0.0 | Connexion : directe ou via Proxy

À quoi sert ce module ?¶

Le module Zabbix connecte votre instance Zabbix à Tevyra. Il synchronise vos hôtes, groupes, triggers et problèmes actifs. Vous pouvez acquitter des problèmes et gérer la maintenance directement depuis Tevyra.

Avant de commencer¶

Pour configurer ce module, vous aurez besoin de :

L'URL de votre instance Zabbix (>= version 5.0)
Un token API Zabbix (recommandé) ou des identifiants utilisateur (voir guide ci-dessous)

Configuration¶

Paramètres requis¶

Paramètre	Type	Description
`url`	url	URL de l'instance Zabbix
`api_token`	secret	Token API Zabbix (Administration > API tokens)

Paramètres optionnels¶

Paramètre	Type	Défaut	Description
`username`	string	-	Utilisateur Zabbix (auth legacy, si pas de token)
`password`	secret	-	Mot de passe Zabbix (auth legacy, si pas de token)
`verify_ssl`	boolean	True	Vérifie les certificats SSL
`timeout`	integer	30	Délai d'attente des requêtes API
`collect_metrics`	boolean	True	Collecte les métriques de performance
`sync_interval`	integer	60	Intervalle de collecte en secondes

Exemple de configuration¶

Token API (recommandé)Login/Password (legacy)

{
  "url": "https://zabbix.company.com",
  "api_token": "your-zabbix-api-token",
  "verify_ssl": true,
  "timeout": 30,
  "collect_metrics": true,
  "sync_interval": 60
}

{
  "url": "https://zabbix.company.com",
  "username": "tevyra-service",
  "password": "secure-password",
  "verify_ssl": true
}

Creer un token API Zabbix¶

Connectez-vous a Zabbix en tant qu'administrateur
Allez dans Administration > API tokens
Cliquez sur Create API token
Nommez le token : Tevyra
Selectionnez l'utilisateur associe
(Optionnel) Definissez une date d'expiration
Copiez le token genere

Permissions

Le compte associe au token doit avoir les droits de lecture sur les groupes d'hotes a superviser. Pour les actions (acquittement, maintenance), des droits d'ecriture sont necessaires.

Donnees collectees¶

Une fois active, le module synchronise automatiquement les donnees suivantes :

Type d'asset	Description
`zabbix_host`	Serveurs, équipements réseau, VMs
`zabbix_hostgroup`	Groupes d'hôtes
`zabbix_trigger`	Triggers de surveillance
`zabbix_problem`	Problèmes actifs

Intervalle de synchronisation par defaut : 60 secondes

Actions disponibles¶

Depuis l'interface Tevyra, vous pouvez executer les actions suivantes :

Action	Description
`zabbix.acknowledge_problem`	Acquitte un problème
`zabbix.enable_host`	Active la surveillance d'un hôte
`zabbix.disable_host`	Désactive la surveillance d'un hôte
`zabbix.create_maintenance`	Crée une fenêtre de maintenance
`zabbix.delete_maintenance`	Supprime une fenêtre de maintenance

Indicateurs¶

Le tableau de bord affiche les indicateurs suivants :

Indicateur	Description
`zabbix_hosts_total`	Nombre total d'hotes
`zabbix_hosts_monitored`	Hotes supervises actifs
`zabbix_hosts_disabled`	Hotes desactives
`zabbix_host_groups_total`	Nombre de groupes d'hotes
`zabbix_triggers_total`	Nombre total de triggers
`zabbix_triggers_active`	Triggers actifs
`zabbix_triggers_problem`	Triggers en etat probleme
`zabbix_problems_total`	Nombre total de problemes actifs
`zabbix_problems_acknowledged`	Problemes acquittes
`zabbix_problems_unacknowledged`	Problemes non acquittes
`zabbix_problems_by_severity`	Repartition par severite

Niveaux de severite Zabbix¶

Niveau	Signification
Not classified	Non classifie
Information	Informatif
Warning	Avertissement
Average	Moyen
High	Eleve
Disaster	Critique