Centreon documentation

Centreon documentation

  • Documentation

›Découverte

Getting Started

  • Installation & premier pas
  • Tutoriels

    • Introduction
    • Créer une vue personnalisée
    • Créer une vue graphique
    • Modéliser un service IT
    • Analyser la disponibilité des ressources

Installation

  • Introduction
  • Prérequis
  • Architectures possibles
  • Téléchargements
  • Installer un serveur central

    • A partir de l'ISO Centreon
    • A partir des paquets
    • A partir des VMs
    • A partir des sources
  • Installation Web
  • Installer un collecteur

    • A partir de l'ISO Centreon
    • A partir des paquets

    Installer un Remote Sever

    • A partir de l'ISO Centreon
    • A partir des paquets
  • Qu'est-ce que Centreon CEIP?

Sécurisez votre plate-forme

  • Sécurisez votre plateforme
  • Secure your MAP platform

Supervision

  • À propos de la surveillance
  • Actions génériques
  • Objets de Base

    • Les macros
    • Les commandes
    • Les périodes temporelles
    • Les contacts
    • Les hôtes
    • Les services
    • Les méta-services
  • Les modèles d'objets
  • Les Plugin Packs
  • Serveurs de Supervision

    • Ajouter un Poller à la configuration
    • Ajouter un Remote Server à la configuration
    • Communications
    • Déployer une configuration
    • Configuration avancée
  • Groupes et Catégories
  • Supervision Passive

    • Activer les Traps SNMP
    • Définition des Traps SNMP
    • Monitoring SNMP Traps
    • Déboguer la gestion des traps SNMP
    • Dynamic Service Management
  • Détection d'anomalies
  • Découverte

    • Introduction
    • Installation
    • Découverte des hôtes
    • Découverte des services
    • Administration
  • Auto Remediation
  • Import/Export

Alertes et Notifications

  • Concepts
  • Statut des ressources
  • Consoles d'évènements
  • Gestion des alertes
  • Notification

    • Concept
    • Configuration
    • Les dépendances
    • Les escalades de notifications
    • Flapping
    • Pour aller plus loin
  • Ticketing
  • Journal des événements

Graphiques de performance

  • Gestion des graphiques
  • Modèle de graphique
  • Courbes
  • Métriques virtuelles

Service Mapping

  • Introduction à Centreon BAM
  • Guide

    • Gestion
    • Supervision
    • Reporting
    • Paramètres
    • Widgets

    Administrer

    • Installer l'extension Centreon BAM
    • Mettre à jour l'extension
    • Monter de version l'extension
    • Migrer l'extension
    • Installer sur un Remote Server

Vues Graphiques

  • Introduction to Centreon MAP
  • Guide

    • Create a standard view
    • Create a geo view
    • Display views
    • Share a view

    Administrer

    • Install Centreon MAP extension
    • Update the extension
    • Upgrade the extension
    • Migrate the extension
    • Configure
    • Install on a Remote server
    • Advanced configuration
    • Known issues
    • Troubleshooter

Reporting

  • Introduction à Centreon MBI
  • Guide

    • Générer des rapports
    • Les rapports disponibles
    • Les widgets
    • Configurer
    • Concepts
    • Dév. de rapport

    Administrer

    • Installation de Centreon MBI
    • Mise à jour de l'extension
    • Monter de version de l'extension
    • Migrer l'extension
    • Sauvegarde et restauration

Administration

    Parameters

    • Centreon UI
    • Supervision
    • Gorgone
    • LDAP
    • RRDTool
    • Debogage
    • Gestion des données
    • Medias
  • Listes de Contrôles d'Accès (ACL)
  • Extensions
  • Partitionnement des bases de données
  • Centreon HA

    • Architectures
    • Installation d'un cluster à 2 nœuds
    • Installation d'un cluster à 4 nœuds
    • Supervision de Centreon-HA
    • Guide d'exploitation du cluster
    • Mise à jour d'une plateforme Centreon-HA
    • Upgrade from Centreon-Failover to Centreon-HA
    • Troubleshooting
  • Sauvegarde
  • Base de connaissance
  • Journalisation des modifications de configuration
  • Statistiques de la plateforme

Mettre à Jour, Monter de Version et Migrer

    Update

    • Mise à jour d'une plateforme Centreon 20.10

    Upgrade

    • Introduction à la montée de version
    • Montée de version depuis Centreon 20.04
    • Montée de version depuis Centreon 19.10
    • Montée de version depuis Centreon 19.04
    • Montée de version depuis Centreon 18.10
    • Montée de version depuis Centreon 3.4

    Migrate

    • Introduction
    • Migration depuis une plateforme Centreon 20.x
    • Migration depuis une plateforme Centreon 3.4
    • Nagios Reader vers Centreon CLAPI
    • Migration d'une plate-forme avec Poller Display

Plugin Packs

  • Introduction to Plugin Packs
  • Tutoriels

    • Collecter des OpenMetrics

    Applications

    • 3CX
    • Active Directory API
    • ActiveMQ JMX
    • Alyvix Server
    • Ansible
    • Ansible Tower
    • Antivirus ClamAV
    • Apache Server
    • Asterisk VoIP Server
    • Asterisk VoIP SNMP
    • Bind9 Web
    • BlueMind SSH
    • Cassandra
    • Cisco CMS
    • Cisco ISE
    • Cisco SSMS
    • Commvault CommServe Rest API
    • DRBD SSH
    • Dynatrace Rest API
    • EMC PPMA Rest API
    • Exchange 2010 API
    • Github
    • Github
    • Google GSuite
    • Haproxy SNMP
    • Hibernate
    • IBM Tivoli Storage M
    • Microsoft DHCP SNMP
    • Microsoft IIS Server Restapi
    • Microsoft IIS Server NSClient API (Deprecated)
    • JBoss Server
    • Jenkins
    • Kafka
    • Kaspersky
    • Keepalived SNMP
    • Lync 2013
    • IP-Label Newtest Rest API
    • Maltem Insight Rest API
    • McAfee Web Gateway
    • Microsoft Cluster Se
    • Microsoft IIS Server NRPE (Deprecated)
    • Microsoft SCCM
    • Microsoft WSUS
    • MS Active Directory
    • MS Biztalk
    • Graylog
    • MS Exchange 2K10
    • BlueMind
    • Mulesoft Anypoint
    • Netbackup Rest API
    • Netdata RestAPI
    • Nginx Server
    • Nginx Plus Restapi
    • OpenHeadend
    • OpenLDAP
    • OpenMetrics
    • OpenVPN OMI
    • OpenWeatherMap
    • Oracle GoldenGate SSH
    • Oracle VM Manager API
    • Pacemaker
    • Peoplesoft
    • Pfsense Fauxapi
    • PHP APC
    • PHP FPM
    • PVX
    • Quadstor
    • RabbitMQ RestAPI
    • Rapid Recovery SNMP
    • Redis Cli
    • Redis Restapi
    • Rubrik Rest API
    • Rudder
    • Salesforce
    • SAP HANA
    • SCOM Rest API
    • Gorgone Restapi
    • Selenium
    • Sendmail
    • Skype 2015
    • Smartermail Server
    • Solr
    • Squid SNMP
    • Symantec Netbackup
    • Tomcat JMX
    • Tomcat Webmanager
    • TrendMicro Iwsva
    • Varnish NRPE
    • Veeam
    • Veeam API
    • VerneMQ Restapi
    • VMware VCSA RestAPI
    • VTOM
    • Wazuh Rest API
    • Weblogic Server
    • ZIXI
    • Zookeeper

    Centreon

    • Centreon Central
    • Centreon Database
    • Centreon-HA
    • Centreon Map
    • Centreon Map4
    • Centreon MBI
    • Centreon Poller

    Cloud

    • Amazon API Gateway
    • Amazon CloudFront
    • Amazon CloudWatch
    • Amazon CloudWatch Logs
    • Amazon EBS
    • Amazon EC2
    • Amazon ElastiCache
    • Amazon EFS
    • Amazon Kinesis
    • Amazon RDS
    • Amazon S3
    • Amazon SNS
    • Amazon SQS
    • AWS Billing
    • AWS ELB
    • AWS Health
    • AWS Lambda
    • AWS Transit Gateway
    • AWS VPN
    • Amazon SES
    • Azure Automation
    • Azure Elastic Pool
    • Azure Event Grid
    • Azure ExpressRoute
    • Azure Firewall
    • Azure Key Vault
    • Azure Load Balancer
    • Azure Log Analytics
    • Azure Monitor
    • Azure Network Interface
    • Azure Public IP
    • Azure Recovery
    • Azure Resource
    • Azure ServiceBus
    • Azure SignalR
    • Azure SQL Database
    • Azure SQL Server
    • Azure Storage Account
    • Azure Virtual Machine
    • Azure Virtual Network
    • Azure VPN Gateway
    • Google CloudSQL MySQL
    • Google Compute Engine
    • Google Stackdriver
    • Google Storage
    • cAdvisor
    • Cloud Foundry
    • Docker
    • IBM Softlayer
    • Kubernetes API
    • Kubernetes w/ Prometheus
    • Office 365
    • Office365 Exchange
    • Office365 OneDrive
    • Office365 SharePoint
    • Office365 Skype
    • Office365 Teams
    • OVH
    • Prometheus Server
    • Node Exporter
    • VMware VeloCloud

    Database

    • CouchDB Rest API
    • Elasticsearch
    • Elasticsearch (Deprecated)
    • Firebird
    • InfluxDB
    • Informix DB
    • Informix DB SNMP
    • Microsoft SQL Server
    • MongoDB
    • MySQL/MariaDB
    • Oracle Database
    • PostgreSQL DB
    • RRDtool
    • Sybase
    • Warp10 Sensision

    Hardware Server

    • Adder AIM SNMP
    • AEG ACM
    • Avocent ACS 6000
    • Axis Video
    • Cisco Collaboration Endpoint Rest API
    • Cisco UCS
    • Dell CMC
    • Dell iDRAC
    • Dell OpenManage
    • Eltek eNexus
    • Fujitsu Server SNMP
    • Hanwha camera SNMP
    • Hikvision camera SNMP
    • HMS Ewon SNMP
    • Timelinkmicro Tms6001
    • HP Blade Chassis
    • HP Ilo Rest API
    • HP Ilo XMLAPI
    • HP OneView Rest API
    • HP Proliant
    • Huawei HMM
    • Huawei iBMC
    • IBM BladeCenter
    • IBM HMC SSH
    • IBM IMM
    • Lenovo XCC SNMP
    • Cisco Telepresence System SNMP
    • Masterclock NTP100GP
    • Pexip Infinity ManagementAPI
    • Polycom GroupSeries SNMP
    • Polycom Trio Rest API
    • Safenet Keysecure
    • Sun MgmtCard
    • Sun Mseries
    • Sun SFxxK
    • Supermicro

    Network

    • 3com Network
    • A10 AX
    • Acme Packet
    • Adva FSP 150 SNMP
    • Adva FSP 3000 SNMP
    • Aerohive
    • Alcatel Omniswitch
    • Allied Telesis SNMP
    • Alvarion BreezeACCESS SNMP
    • Arista Switch
    • Arkoon
    • Aruba Instant SNMP
    • Aruba Standard
    • Atrica Routeur
    • Athonet ePC SNMP
    • Atto Fibrebridge SNMP
    • Barracuda Cloudgen SNMP
    • Bee Ware
    • BGP Protocol SNMP
    • Bluecoat generic
    • Brocade Switch
    • CheckPoint firewall
    • Cisco Apic
    • Cisco ASA
    • Cisco Call Manager
    • Cisco Call Manager SXML
    • Cisco ESA XMLAPI
    • Cisco Firepower Management Console Rest API
    • Cisco Firepower SNMP
    • Cisco IronPort
    • Cisco Meraki Rest API
    • Cisco Meraki
    • Cisco Prime
    • Cisco Small Business
    • Cisco Standard
    • Cisco Standard SSH
    • Cisco VCS
    • Cisco Voice Gateway
    • Cisco Waas
    • Cisco WLC
    • Citrix Acceleration
    • Citrix Netscaler
    • Citrix SDX
    • Colubris SNMP
    • Cyberoam
    • D-Link DGS 3100
    • D-Link standard SNMP
    • Dell 6200
    • Dell 6200 SNMP
    • Dell N4000
    • Dell OS10 SNMP
    • Dell S-series
    • DenyAll SNMP
    • Dell Xseries
    • Digi Anywhere USB
    • Digi PortServers TS
    • Digi PortServers TS
    • Digi Sarian
    • Efficienti IP
    • Evertz FC7800
    • Extreme Network
    • Lenovo Flex System Switch
    • F5 BigIP
    • Fiberstore SNMP
    • Fortinet FortiAuthenticator SNMP
    • Fortinet Fortigate
    • Fortinet Fortimanage
    • Freebox
    • FritzBox
    • Gorgy NTP Server
    • H3C Network
    • Hirschmann switch
    • HP Procurve
    • HP Standard Network
    • HP Virtual Connect
    • Huawei
    • Infoblox SNMP
    • Juniper EX Series
    • Juniper GGSN
    • Juniper ISG
    • Juniper M-Series
    • Juniper Mag
    • Juniper SA
    • Juniper SRX
    • Juniper SSG
    • Juniper Trapeze
    • Kemp Loadbalancer
    • Meru SNMP
    • Mikrotik SNMP
    • Mitel 3300ICP
    • Moxa Switch
    • Mrv Optiswitch
    • NetASQ Network
    • Netgear MSeries
    • Netscaler MPX 8000
    • Nokia TiMos
    • Nortel Standard
    • Omniswitch 6850
    • OneAccess Network
    • Oracle Infiniband
    • Palo Alto firewall SNMP
    • Palo Alto firewall SSH
    • Peplink Balance
    • Peplink Pepwave SNMP
    • Perle IDS SNMP
    • pfSense
    • Rad Airmux SNMP
    • Radware Alteon
    • Raisecom
    • RedBack Router
    • Riverbed Interceptor
    • Riverbed SteelHead
    • Ruckus
    • Ruckus Zonedirector
    • Ruckus ICX
    • Ruckus SCG
    • Ruckus Smartzone
    • Ruggedcom Network
    • Silverpeak
    • Sonicwall
    • Sophos ES
    • Stonesoft
    • Stormshield SNMP
    • Stormshield SSH
    • Teltonika SNMP
    • Ubiquiti AirFiber SNMP
    • Traffic Director
    • Ucopia
    • Watchguard
    • Zyxel
    • Versa SNMP
    • Versa Director Restapi

    Operating System

    • AIX SNMP
    • Base Pack
    • FreeBSD SNMP
    • HP-UX
    • IBM AS400
    • Linux NRPE
    • Linux NRPE3
    • Linux SNMP
    • Linux SSH
    • Mac SNMP
    • Solaris SNMP
    • Windows NRPE
    • Windows NRPE 0.5
    • Windows NSClient API
    • Windows SNMP

    Printer

    • Printer standard

    Protocol

    • BGP Protocol
    • DHCP Server
    • DNS Service
    • FTP Server
    • Generic SNMP
    • HTTP Server
    • IMAP Server
    • JMX value
    • LDAP Server
    • Modbus
    • NTP Server
    • OSPF Protocol
    • POP Server
    • Protocol DHCP
    • Protocol SSH
    • Protocol TCP
    • Protocol UDP
    • Radius Service
    • SMTP Server
    • Telnet Scenario
    • TFTP Server
    • X509 Certificat

    Sensor

    • ABB CMS-700
    • AKCP Sensor
    • Geist p8000 sensor SNMP
    • Geist Sensor SNMP
    • HWg-STE Sensor
    • Jacarta Sensor
    • LM Sensors
    • Netbotz Sensor
    • Sensor IP
    • SensorGateway
    • Sensormetrix

    Storage

    • Adic Tape SNMP
    • Avid Isis
    • Buffalo TeraStation SNMP
    • Dell Compellent
    • Dell Compellent API
    • Dell Equallogic
    • Dell FluidFS
    • Dell MD3000
    • Dell Me4 Rest API
    • Dell ML6000
    • Dell TL2000
    • EMC Celerra
    • EMC Clariion
    • EMC Data Domain
    • EMC Isilon
    • EMC RecoveryPoint
    • EMC Symmetrix API
    • EMC Symmetrix NRPE
    • EMC Unisphere Rest API
    • EMC Vplex
    • EMC Xtremio
    • Exagrid
    • Fujitsu Eternus DX
    • Hitachi HCP SNMP
    • Hitachi NAS
    • Hitachi Standard
    • HP 3PAR 7000
    • HP 3PAR SSH
    • HP EVA
    • HP Lefthand
    • HP MSA2000
    • HP MSL
    • HP P2000
    • HP StoreOnce
    • HP StoreOnce SSH
    • IBM DS3000
    • IBM DS4000
    • IBM DS5000
    • IBM FlashSystem 900
    • IBM Storwize
    • IBM TS2900
    • IBM TS3100
    • IBM TS3200
    • IBM TS3500
    • Kaminario RestAPI
    • Lenovo S Series
    • Lenovo Iomega
    • NetApp Ontap Oncommand API
    • NetApp Ontap Rest API
    • NetApp Ontap SNMP
    • Netapp Santricity Restapi
    • Netgear Readynas SNMP
    • Nimble Storage
    • Nimble Storage Rest API
    • Oracle ZFS
    • Oracle ZS
    • Overland Neo
    • Panzura
    • Pure Storage
    • Pure Storage SNMP
    • Qnap
    • QSAN NAS
    • Quantum DXi Series
    • Quantum Scalar
    • Storagetek SL
    • Synology
    • Violin Memory 3000

    Toip Voip

    • Alcatel OXE
    • Asterisk VoIP Server
    • AudioCodes
    • Avaya AES SNMP
    • Avaya Media Gateway SNMP
    • Polycom DMA SNMP
    • Polycom HDX SNMP
    • Polycom RMX
    • Polycom RPRM SNMP
    • Sonus SBC
    • XiVO VoIP Server

    Ups Pdu

    • Alpha UPS SNMP
    • APC ATS
    • APC PDU
    • APC UPS
    • Clever PDU
    • CyberPower Systems PDU SNMP
    • Eaton ATS SNMP
    • Eaton PDU SNMP
    • Emerson PDU
    • HP UPS SNMP
    • MGE UPS System
    • Nitram UPS SNMP
    • Powerware UPS
    • Raritan PDU
    • Schleifenbauer Gateway SNMP
    • UPS Socomec Net Vision SNMP
    • UPS Standard

    Virtualization

    • Hyper-V 2012
    • Nutanix
    • Proxmox VE
    • VMware ESX
    • VMware ESX WS-MAN
    • VMware vCenter
    • VMware vCenter v4
    • VMware vCenter v5
    • VMware vCenter v6
    • VMware VM

Intégrations

    Externes

    • Accedian PVX Skylight
    • Maltem Insight Performances Rest API

    Notifications

    • Notify with Telegram bot

    Open Tickets

    • BMC Footprints
    • BMC Remedy
    • EasyVista
    • GLPI
    • GLPI RestAPI
    • iTop
    • IWS Isilog
    • Jira
    • Mail
    • OTRS RestAPI
    • Request Tracker RestAPI
    • Serena
    • ServiceNow

    Stream Connectors

    • BSM
    • Elasticsearch events
    • Elasticsearch metrics
    • NDO
    • HP OMI
    • PagerDuty Service integration
    • ServiceNow Event Manager
    • ServiceNow MID Server
    • Splunk Metrics
    • Splunk Events
    • Warp10

Mobile App.

  • Introduction

API

  • Introduction
  • Command Line API (v1)
  • Rest API (v1)
  • Rest API (v2)
  • Graphical views API (beta)

Ressources dévelopeur

  • À propos des ressources développeur
  • How to write a module
  • How to write a Stream Connector
  • How to translate Centreon
  • How to write a widget
  • Centreon Broker

    • Stream connectors
    • The BBDO protocol
    • Centreon Broker Event Mapping

Releases

  • Centreon Platform 20.10.0
  • Politique de cycle de vie des solutions
  • Release notes

    • Centreon Core
    • Extensions Commerciales
    • Open Source Extensions
Edit

Découverte des services

Lancer une découverte manuellement

Une fois les règles de découverte programmées, il est possible de les exécuter au travers de l’interface web Centreon.

Pour cela, se connecter et accéder au menu Configuration > Services > Manuelle.

Commencez à saisir le nom de l’hôte sur lequel réaliser la découverte et l’interface vous proposera de compléter automatiquement ce dernier :

image

Sélectionnez ensuite la commande de découverte à exécuter dans la liste déroulante qui vient d’apparaître :

image

Si cette liste est vide, cela signifie que cet hôte n’appartient pas à un modèle d’hôtes lié à une règle de découverte.

Cliquez sur le bouton Scan et patienter durant l’analyse des éléments disponibles :

image

Le résultat s’affiche. Sélectionnez les éléments à intégrer à la supervision et cliquez sur le bouton Save :

image

Les éléments ont été ajoutés et il n’est plus possible de les sélectionner :

image

Dans la liste de résultat de la découverte des éléments, il se peut que certains éléments ne puissent être sélectionnés. Cela indique qu’ils font déjà partie de la configuration.

Les services ont été ajoutés et sont visibles dans le menu Configuration > Services > Services par hôte:

image

Règles de découverte

General options

Options générales Une règle de découverte permet de créer dynamiquement des services et de les lier à un hôte, en se basant sur les éléments remontés par les sondes. Les services unitaires créés sont attachés à des modèles de services ce qui permet d’utiliser les fonctionnalités de Centreon (héritage, surcharge, etc.)

Pour créer une règle de découverte, rendez-vous dans le menu Configuration > Services > Règles et cliquez sur Ajouter :

image

Saisissez les premiers champs :

image

Voici une description des premiers champs à saisir :

  • Rule name : nom de la règle
  • Command Macro : la commande exécutée pour lister les attributs du flux XML
  • Command Discover : la commande de découverte exécutée pour lister les éléments
  • Service template: le modèle de service utilisé pour créer les nouveaux services

Rendez-vous dans le second onglet Inclusions / Exclusions & Macros tab. You should see available XML attributes:

image

Revenez au premier onglet et définir le nom des services qui seront créés ainsi que les autres champs disponibles :

image

Saisir le nom du service qui sera créé via le champ Service display name.

Le nom du service peut contenir une macro correspondant à un attribut du flux XML. Par exemple, pour une interface réseau, son nom peut être amené par l’attribut name. Trafic-$name$ sera remplacé par Trafic-eth0 si le nom de l’interface est eth0. Le nom de l’attribut XML doit être mis entre deux caractères $.

Puis compléter la règle :

  • Hosts templates : Les modèles qui seront utilisés pour définir la liste des hôtes pour lesquels les règles de découverte seront exécutées
  • Linked Instances : permet d’exécuter la règle que pour les hôtes liés aux collecteurs sélectionnées.

Laisser vide pour exécutr la règle depuis n’importe quel collecteur.

  • Contacts : Les contacts qui seront notifiés sur la création ou la désactivation de services à la suite de la découverte
  • Contact groups: Les groupes de contact qui seront notifiés sur la création ou la désactivation de services à la suite de la découverte
  • Disable elements not found : Permettre au module de désactiver les services associés aux éléments qui ne sont plus trouvés
  • Update existing services : Si actif, les services déjà découverts seront mis à jour si une propriété change (valeur de macros personnalisées, etc.).
  • Activate : Activer ou désactiver la règle (la règle sera ignorée par le processus de découverte si elle est désactivée).

Cliquer sur Save pour sauvegarder la règle de découverte.

Inclusions / Exclusions & Macros

Les Inclusions / Exclusions et Macro fonctionnent de la manière suivante :

image

Les Inclusions / Exclusions permettent d’inclure ou d’exclure des éléments durant la découverte. Cette inclusion/ exclusion concerne les attributs XML

Les règle d’inclusion/exclusion sont définies à partir de l’algorithme suivant :

  • Si seules des règles d’inclusion sont présentes, la valeur de l’attribut correspondant à au moins une inclusion est prise en compte
  • Si seulement des règles d’exclusion sont présentes, chaque élément sera pris en compte, sauf ceux correspondant à une exclusion
  • Si les deux types sont présents, le processus vérifiera l’élément correspondant à une inclusion puis s’assurera qu’il n’est pas listé dans une exclusion
  • Le seconde partie Macros permet de définir la relation entre l’attribut XML et la macro du modèle de service. Pour tous les services créés, les valeurs des macros seront remplacées par les valeurs des attributs.

image

Sur cette image toutes les macros seront créées sur le nouveau service car toutes les cases Empty sont sélectionnées. Pour ne pas créer ces macros, ne pas cocher les cases associées. La macro $_SERVICEINTERFACEID sera créée et contiendra la valeur associée à l’attribut XML $interfaceid de l’élément.

Options avancées

Le dernier onglet Advanced permet d’appliquer des regexp sur le champ Service display name ou tout attribut du flux XML. Cliquer sur Add a new entry pour ajouter une nouvelle entrée en définissant l’expression et le résultat attendu :

image

L’expression peut être appliquée sur :

  • @SERVICENAME@ : le nom du service qui sera créé
  • tous les attributs du flux XML via $attribute_name$

La seconde partie Customize code permet d’utiliser du code Perl.

Custom display scan permet de modifier l’affichage dans la découverte manuelle Par défaut, la découverte manuelle affiche le nom du service. Voici un exemple pour ajouter la taille des disques :

my ($value, $unit) = change_bytes(value => $total$);
$description = "<span style='color: red; font-weight: bold'>@SERVICENAME@</span> [size = <b>$value $unit</b>]";

Custom variables permet de créer des macros personnalisables. Voici un exemple pour définir des seuils dynamiques selon la taille des disques :

my $total_gb = $total$ / 1000 / 1000 / 1000;
if ($total_gb < 100) {
    $warning$ = 80;
    $critical$ = 90;
} elsif ($total_gb < 500) {
    $warning$ = 90;
    $critical$ = 95;
} else {
    $warning$ = 95;
    $critical$ = 98;
}

Il est possible d’utiliser les macros $warning$ et $critical$ dans la partie Macros.

Commandes de découverte

Une discovery commands est la définition d’une ligne de commande exécutant la sonde de découverte.

Chaque sonde de découverte doit disposer de deux commandes :

  • La première pour récupérer la liste des attributs du flux XML
  • La seconde pour récupérer la liste des éléments découverts sur l’équipement

image

Commande pour récupérer la liste des attributs XML

Rendez-vous dans le menu Configuration > Commandes > Découverte et cliquez sur Ajouter pour ajouter une nouvelle commande.

Saisissez les champs suivants :

  • Command Name : nom de la commande
  • Command type : sélectionnez l’option Discovery
  • Command Line : saisissez la ligne de commande pour exécuter la sonde et récupérer la liste des attributs XML

Toute commande utilisant les sondes du projet Centreon Plugin doit définir l’option hostname. Donc ajoutez l’option --hostname=127.0.0.1 dans votre commande.

image

Voici un exemple de ligne de commande exécutée dans un terminal :

/usr/lib/centreon/plugins/centreon_linux_snmp.pl --mode=list-interfaces --hostname=127.0.0.1 --disco-format

Et le résultat :

<?xml version="1.0" encoding="utf-8"?>
<data>
    <element>name</element>
    <element>total</element>
    <element>status</element>
    <element>interfaceid</element>
</data>

Sauvegardez votre commande.

Commande pour récupérer la liste des items d'un hôte

Rendez-vous dans le menu Configuration > Commandes > Découverte et cliquez sur Ajouter pour ajouter une nouvelle commande.

Saisissez les champs suivants :

  • Command Name : nom de la commande
  • Command type : sélectionnez l’option Discovery
  • Command Line: saisir la ligne de commande pour exécuter la sonde et récupérer la liste éléments disponibles

image

Voici un exemple de ligne de commande exécutée dans un terminal :

/usr/lib/centreon/plugins/centreon_linux_snmp.pl --mode=list-interfaces --hostname=192.168.220.129 --snmp-version=2 --snmp-community=public --disco-show

Et le résultat :

<?xml version="1.0" encoding="utf-8"?>
<data>
    <label status="1" name="lo" total="10" interfaceid="1"/>
    <label status="1" name="eth0" total="1000" interfaceid="2"/>
</data>

Sauvegardez votre commande.

Sondes de découverte

Une sonde de découverte (aussi appelée plugin) est un script qui liste un ensemble d’éléments similaires comme les systèmes de fichiers ou les interfaces réseaux d’un équipement donné.

Cette sonde doit être exécutable en ligne de commande (shell) par l’utilisateur centreon (ou l’utilisateur du moteur de supervision). Il peut être exécuté localement ou à distance en utilisant des protocoles comme SSH ou NRPE.

Les résultats doivent être présentés dans un flux XML valide où chaque élément doit être décrit comme un attribut d’un noeud XML. Pour obtenir ce flux XML les sondes de supervision Centreon Plugins utilisent l’option ‘–mode=xxx –disco-show’.

Par exemple :

/usr/lib/centreon/plugins/centreon_linux_snmp.pl --mode=list-interfaces --hostname=192.168.220.129 --snmp-version=2 --snmp-community=public --disco-show
<?xml version="1.0" encoding="utf-8"?>
<data>
    <label status="1" name="lo" total="10" interfaceid="1"/>
    <label status="1" name="eth0" total="1000" interfaceid="2"/>
</data>

Ici, l’attribut name correspond au nom de l’interface réseau. status représente l’état de l’interface (IFOPERSTATUS), total la bande passante (IFSPEED) et interfaceid l’identifiant de l’interface (IFINDEX).

La sonde de découverte doit également lister les attributs disponibles du flux XML via une option. Les sondes de supervision Centreon Plugins utilisent l’option ‘–mode=xxx –disco-format’.

Par exemple :

/usr/lib/centreon/plugins/centreon_linux_snmp.pl --mode=list-interfaces --hostname=127.0.0.1 --disco-format
<?xml version="1.0" encoding="utf-8"?>
<data>
    <element>name</element>
    <element>total</element>
    <element>status</element>
    <element>interfaceid</element>
</data>

Ici 4 attributs sont disponibles : name, total, status et interfaceid.

Tester manuellement une règle

Il est possible de tester le fonctionnement du module manuellement grâce aux options :

DirectiveTypeDescription
filter_rulestableauPermet d’exéxuter la ou les règles
filter_hoststableauPermet d’exécuter toutes les règles de découverte liées aux modèles d’hôte de ou des hôtes sélectionnés
filter_pollerstableauPermet d’exécuter les règles de découverte pour les ressources appartenant à ou aux Collecteurs
dry_runbooléenExécute la découverte sans changement dans la confugration (utiliser à des fin de test)

Exemples

Exécution de toutes les règles :

curl --request POST "http://localhost:8085/api/centreon/autodiscovery/services" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{}'

Test de toutes les règles :

curl --request POST "http://localhost:8085/api/centreon/autodiscovery/services" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "dry_run": 1
}'

Test d'une règle en particuliers :

curl --request POST "http://localhost:8085/api/centreon/autodiscovery/services" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "filters_rules": ["OS-Linux-SNMP-Network-Interfaces-Discovery"],
    "dry_run": 1
}'

Test de toutes les règles liées aux modèles d'hôte utilisés par l'hôte défini :

curl --request POST "http://localhost:8085/api/centreon/autodiscovery/services" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "filters_hosts": ["centreon-server"],
    "dry_run": 1
}'

Test d'une règle en particuliers pour l'hôte défini :

curl --request POST "http://localhost:8085/api/centreon/autodiscovery/services" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "filters_rules": ["OS-Linux-SNMP-Network-Interfaces-Discovery"],
    "filters_hosts": ["centreon-server"],
    "dry_run": 1
}'
← Découverte des hôtesAdministration →
  • Lancer une découverte manuellement
  • Règles de découverte
    • General options
    • Inclusions / Exclusions & Macros
    • Options avancées
  • Commandes de découverte
    • Commande pour récupérer la liste des attributs XML
    • Commande pour récupérer la liste des items d'un hôte
  • Sondes de découverte
  • Tester manuellement une règle
    • Exemples
Centreon documentation
Documentation
DémarrerAPIReleases
Ressources
Site CentreonBlogDownload
Suivez-nous
centreon
Follow @Centreon
Copyright © 2005 - 2021 Centreon