Aller au contenu

L'enrichissement

Canopsis étant un hyperviseur, une des fonctions attendues concerne l'enrichissement de données.

Nous pouvons considérer que les informations transmises par les sources de données (et notamment les superviseurs) sont des informations pauvres.

Elles sont pauvres dans le sens où elles nous signifient dans la majeure partie des cas qu'il y a une alarme (ou une mise à jour d'alarme) concernant une entité.

Une entité ?

Une entité est un composant typé (composant, ressource, service).

Pour aider les pilotes des centres d'opérations, il est indispensable d'enrichir ces informations et ainsi de qualifier au plus juste les alarmes à traiter.

Le but est donc de classer les alarmes et d'apporter de l'information objective sur des météos de services, afin de faciliter la prise de décision.

Plusieurs possibilités sont offertes dans Canopsis :

  • Enrichissement systématique depuis les évènements
  • Enrichissement conditionné par des règles de gestion appliquées aux évènements (Pro)
  • Enrichissement par l'intermédiaire de référentiels externes (Pro)

Enrichissement depuis les évènements

Vous avez paramétré des connecteurs de données qui transmettent des évènements à Canopsis. Un évènement est constitué d'attributs, certains sont obligatoires, d'autres facultatifs.

Considérons l'évènement suivant :

{
    "resource": "check_http",
    "event_type": "check",
    "component": "nvl-par-web-05",
    "connector": "centreon",
    "source_type": "resource",
    "state": 2,
    "connector_name": "centreon-novalys",
    "output": "CRITICAL - temps de réponse 3,8 s",
    "site": "Paris 13e"
}

En publiant cet évènement, l'attribut site ne sera pas interprété, car il ne participe pas à la spécification d'un évènement. Il est conservé dans le dictionnaire ExtraInfos de l'évènement.

Vous souhaitez néanmoins que cette information soit disponible pour l'entité check_http/nvl-par-web-05. Une règle d'enrichissement de type « Définir une info d'entité à l'aide d'un modèle », avec la valeur {{ .Event.ExtraInfos.site }}, copie l'attribut dans l'information site de l'entité. La création d'une telle règle est détaillée dans la section suivante.

Pour rendre cette valeur visible sur l'interface de Canopsis, il faut ensuite l'ajouter manuellement. Pour cela, deux solutions :

  • Pour un widget de manière générale (Plus d'infos, Info popup, Template) : {{ entity.infos.site.value }}
  • Pour une colonne de Bac à alarmes : une colonne « Informations sur l'entité », avec le dictionnaire site et le champ « Valeur »

Nom des colonnes

Bac à alarmes

Enrichissement via des règles de gestion

Dans Canopsis, il existe la possibilité de définir des règles event-filter dont le but est :

  • de manipuler les attributs d'un évènement, d'une alarme, d'une entité ;
  • d'enrichir les entités ;
  • d'enrichir les entités à partir d'une collection de données externe (Pro).

La documentation complète se trouve sur cette page.

Prenons le cas d'usage suivant :

L'évènement contient un attribut groupe, qui indique le domaine métier de l'entité, par exemple "groupe": "logistique".

Considérons l'évènement suivant :

{
    "resource": "check_sap_idoc",
    "event_type": "check",
    "component": "nvl-lyo-erp-01",
    "connector": "centreon",
    "source_type": "resource",
    "state": 2,
    "connector_name": "centreon-novalys-enrich",
    "output": "CRITICAL - file d'attente IDoc saturée",
    "groupe": "logistique"
}

Chose importante, les attributs pris en charge sont décrits dans la partie sur les champs des évènements de la documentation de l'event-filter du moteur engine-che.

Dans notre cas, l'attribut groupe est personnalisé et sera donc automatiquement inséré dans le dictionnaire ExtraInfos de l'évènement.

On commence en ajoutant une règle de type « Enrichissement » via le menu « Exploitation » > « Filtres d'événements » :

Menu Event-filter

Ajout d'une règle

Ensuite, dans l'onglet « Modèles », on définit sur quels évènements sera exécutée cette règle. Dans notre cas, nous utilisons le nom du connecteur (connector_name).

Définition du pattern

Dernière étape, dans les options d'enrichissement de l'onglet « Général », nous ajoutons une action « Définir une info d'entité à l'aide d'un modèle » qui récupère le contenu de l'attribut groupe ({{ .Event.ExtraInfos.groupe }}) et le place dans une nouvelle information d'entité domainemetier.

Ajout d'une action

Le résultat pourra être observé sur un Bac à alarmes, par exemple :

Nom des colonnes

Bac à alarmes

Enrichissement via référentiels externes

L'enrichissement par référentiel externe passe par le développement d'un driver dont le métier est de synchroniser un référentiel tiers avec le contexte Canopsis.

Dans l'édition Pro de Canopsis, il est notamment possible d'interconnecter les outils Service Now et iTop.

Pour plus d'informations, n'hésitez pas à nous consulter.

Annexes

Consulter le contexte

De manière générale, vous pouvez consulter le contenu de la base de données qui porte les entités, le Contexte.

Pour cela, vous devez instancier un widget « Explorateur de contexte », y rechercher l'entité voulue, puis ouvrir l'onglet « Infos » de son panneau dépliable.

Voici un exemple avec check_http/nvl-par-web-05 :

Contexte

Puis avec check_sap_idoc/nvl-lyo-erp-01 :

Contexte