Notes de version Canopsis 23.10.0¶

Canopsis 23.10.0 a été publié le 31 octobre 2023.

Procédure d'installation¶

Suivre la procédure d'installation de Canopsis.

Procédure de mise à jour¶

Canopsis 23.10.0 apporte des changements importants tant au niveau technique que fonctionnel.
À ce titre, le Guide de migration vers Canopsis 23.10.0 doit obligatoirement être suivi pour les installations déjà en place.

Changements entre Canopsis 23.04 et 23.10¶

Environnement SNMP¶

Le moteur SNMP a été migré de Python 2 vers Python 3. Certains changements de configurations sont nécessaires pour que l'ensemble de la pile SNMP reste fonctionnel.
Le guide de migration vous indique les changements à effectuer.

Voici les différents liens de documentations associées :

Tags¶

La version 23.04 a introduit une première version de gestion des tags à partir des événements.
Canopsis 23.10 introduit une gestion interne des tags.
La documentation associée fournit toutes les explications nécessaires à leur mise en oeuvre.

Vues privées¶

Un système de vues privées a été ajouté à Canopsis.
Il permet aux utilisateurs ayant le droit requis de créer leurs propres vues qui ne seront visibles et accessibles que par eux.

vueprivée1

vueprivée2

Bookmarks / Signets¶

Il existe à présent une fonctionnalité permettant de bookmarker une alarme.
Elle se matérialise par une action du bac à alarmes.

Bookmark1

Bookmark2

Fonctionnalité Thèmes¶

Canopsis 23.04 introduit la notion de thème graphique.
Les thèmes sont liés aux utilisateurs, qui choisissent celui qu'ils souhaitent appliquer.

theme

La version Canopsis 23.10 permet à présent de créer ses propres thèmes.
Elle propose à l'utilisateur d'agir sur les paramètres qui concernent :

Principaux éléments du produit

theme1

Paramètres de taille de police

theme2

Paramètres du bac à alarmes

theme3

Couleurs de criticités

theme4

Consultez la documentation pour plus d'informations.

Mode Maintenance¶

Lorsque vous opérez une mise à jour de Canopsis ou une maintenance sur des composants de Canopsis, vous disposez à présent d'un "mode maintenance".
Celui-ci permet de déconnecter tous les utilisateurs présents sur la plate-forme pour garantir qu'il n'y ait pas de perturbation pendant l'intervention.

maintenance1

maintenance2

La documentation vous donne tous les détails.

Rafraîchissement des alarmes¶

Une nouvelle option du bac à alarmes permet de rafraîchir les alarmes qui sont actuellement présentées sur un bac sans intervention.
Seules les alarmes qui sont affichées sur le bac sont raffraîchies

Information importante

Si la mise à jour d'une alarme l'exclut du filtre en cours, l'alarme sera tout de même mise à jour mais ne disparaitra du filtre qu'après le rafraîchissement périodique paramétré ou manuel.

Largeur et position des colonnes¶

Jusque Canopsis 23.04, la largeur des colonnes était gérée de manière automatique par le widget Bac à alarmes.
La version 23.10 permet à l'utilisateur de gérer lui-même ce paramètre.
Dans les paramètres avancés du widget, vous trouvez les Paramètres des colonnes :

Glisser/Déposer les colonnes : l'ordre des colonnes est paramétrable en drag'n drop par l'utilisateur
Redimensionner les colonnes : la largeur des colonnes est paramétrable en drag'n drop par l'utilisateur

Plusieurs rôles pour un même utilisateur¶

Le système d'affectation des droits évolue et permet à présent d'affecter plusieurs rôles à un utilisateur.
Les droits sont alors fusionnés.

roles

Enrichissement : gestion des erreurs¶

Lorsque le moteur d'enrichissement n'arrive pas à appliquer une règle, l'interface graphique de gestion de ces règles peut vous présenter les erreurs.

enrichissement

Les différents types d'erreurs suivants sont gérées :

Pattern invalide
Template invalide
MongoDB
API externe
Autre

Binaire ready¶

Le binaire ready (qui permet de vérifier que les backends de Canopsis sont prêts) vérifie maintenant que l'initialisation de Canopsis est terminée.

Ceci correspond à la fin du travail de la commande reconfigure pour la version de Canopsis en cours. Ce programme ready pourra servir notamment pour des systèmes d'orchestration de conteneurs (Kubernetes et assimilés).
Avec cette technique, il sera possible de lancer les moteurs Canopsis seulement lorsque les conditions sont réunies, diminuant ou supprimant les phénomènes de crashs au démarrage.

Smart feeder¶

Un générateur d'événements "intelligent" a été développé. Il permet de simuler le trafic d'un environnement de production, de manière réaliste.

Retrouvez la documentation associée ici

Réception de métriques¶

Canopsis 23.10 est capable de recevoir des métriques dans ls événements.
La documentation n'est pas encore prête. Elle le sera d'ici peu. En attendant, les métriques peuvent être transmises de la manière suivante :

"perf_data" : "cpu=20%;80;90;0;100"

Le format retenu est celui de Nagios :trademark:

Suppression de la fonctionnalité "Tour"¶

La fonctionnalité Tour, qui permettait d'afficher une aide lors de votre première connexion a été supprimée.

Montées de version¶

Les outils suivants bénéficient de mises à jour :

Outil	Version d'origine	Version après 23.10
NodeJS	16	20

Les instructions pour leur mise à jour sont précisées dans le guide de migration.

Liste des modifications¶

UI :
- Amélioration de la fonction de vérification des patterns (#4641)
- Correction d'un bug qui empêchait de positionner une image sur la mire de connexion (#4948)
- Désactivation de la possibilité de changer le type d'une consigne (#5048)
- La "forme" de l'auteur d'une action dans l'interface graphique peut utiliser un template (#4800)
- Le helper handlebars copy supporte certains caractères spéciaux (#5049)
- Ajout d'un helper handlebars json permettant de renvoyer des chaines au format json (#5049)
- Le helper handlebars timestamp supporte les formats moment (#4765)
- Les variables d'environnement peuvent être utilisées sur la page de connexion (#4944)
- Ajout d'un mode maintenance permettant de déconnecter les utilisateurs durant une intervention technique (#4114)
- Un utilisateur peut hériter de plusieurs rôles dont les droits seront fusionnés (#4701)
- Ajout d'un système de vues privées permettant aux utilisateurs ayant le droit de créer et gérer des vues qui leur sont propres (#4734)
- Bac à alarmes
  - La sélection des colonnes se fait à présent de manière plus ergonomique et autorise le drag'n drop (#4872)
  - Correction d'un bug qui empêchait la déclaration de tickets en masse (#5069)
  - Lorsqu'un lien est présent dans les colonnes output, longOutput, initialOutput, ou initialLongOutput, il est directement interprété comme tel (#5036)
  - Ajout de la possibilité d'annuler l'annulation d'une alarme (#4971)
  - Ajout d'une option permettant de rafraîchir les alarmes présentes dans le bac sans intervention (#4473)
  - Ajout de la possibilité d'exporter une alarme au format PDF (#4899)
  - La recherche naturelle peut à présent porter sur des informations d'entités (#4881)
  - Le helper handlebars tags permet de filtrer les alarmes portant le tag (#5023)
  - En plus du nombre de conséquences, une méta alarme porte à présent les compteurs d'alarmes conséquences ouvertes et fermées (#4885)
  - Meilleure présentation des liens lorsque le nombre maximum de liens est spécifié (#4991)
  - Correction d'un bug qui empêchait l'export CSV dans certaines conditions (#4520)
  - Dans l'export CSV, il est désormais possible de définir un modèle d'export des informations dynamiques d'une alarme (#5136)
  - Ajout d'une option permettant d'exécuter des actions sur des alarmes en criticité "OK" (#4749)
  - La largeur des colonnes est maintenant paramétrable (#4694)
  - Un historique des recherches est à présent disponible. Les motifs de recherche peuvent également être épinglés (#4850)
  - Lors d'une déclaration de ticket, si une seule règle est appliquable, elle est automatiquement sélectionnée (#5075)
  - Le badge de déclaration de tickets associé à une alarme présente le dernier statut uniquement (#5106)
  - Le commentaire associé à une dissociation de méta alarme n'est plus obligatoire (#4924)
  - Dans la liste des variables, les boutons d'export ont été revus (#5045)
  - Ajout de la possibilité de bookmarker les alarmes (#4736)
  - Lorsqu'une remédiation en cours en minimisée, la fenêtre réduite est visible sans scroll (#5135)
- Météo des services
  - Il est à présent possible de personnaliser le comportement des tuiles lorsqu'une action est requise (#4674)
- Règles SNMP
  - Le formulaire de création de règles permet à présent d'effectuer des recherches dans la liste des OID (#5096)
- Règles de génération de liens
  - Une nouvelle option permet de "masquer" les liens du menu action dans un bac à alarmes (#4962)
  - Nouvelles variables utilisables dans une URL : .User.Email, .User.Username, .User.Firstname, .User.Lastname, .User.ExternalID, .User.Source, .User.Role (#4797)
- Règles de déclaration de tickets
  - Les variables d'environnement sont utilisables dans les URL (#5066)
  - Il est à présent possible de forger l'URL du ticket en utilisant des variables fournies dans le retour d'API (#4984)
  - Le formulaire de déclaration de tickets montre à présent l'existence de ticket sur les alarmes (#5079)
- Explorateur de contexte
  - Le filtre "Observateur" a été renommé en "Service" (#3890)
- Comportements périodiques
  - Le formulaire de saisie des règles de récurrence a été revu (#4538)
  - Il est désormais possible d'ajouter des dates d'exception en utilisant des fichiers au format ics(#4709)
- Editeur de pattern
  - Amélioration de la présentation des tags lorsque leur nombre est important (#5081)
  - Dans les patterns de scénarios, mise à disposition des variables suivantes : v.last_comment.initiator, v.ticket.initiator, et v.canceled.initiator (#5085)
- Filtres d'événements
  - Les erreurs d'enrichissement sont présentées dans les gestionnaire de règles (#4565)
API :
- Seconde partie de correction d'un bug qui entrainait un calcul de durée d'alarme négatif (#5001)
- Ajout d'un trigger capable de se déclencher après la réception de x événements sur une alarme (#5024)
- Les variables d'environnement peuvent maintenant être exploitées dans Canopsis (#4946)
- Correction d'un bug qui empechait l'export de statistiques de remédiation en cas d'absence de métrique (#5072)
- Correction d'un bu qui présentait ce message de log "expect string for key=\"engine-run-info$$engine-correlation$$3140090f-309a-4605-b533-64d0b0a0ad89\" but got type=" (#4985)
Moteurs :
- AXE
  - Seconde partie de correction d'un bug qui entrainait un calcul de durée d'alarme négatif (#5001)
  - Correction d'un bug de calcul de compteurs de services lorsque le débit d'événements est très élevé (#5050)
- Remediation
  - Correction d'un bug qui générait une erreur 500 avec le message "runtime error: invalid memory address or nil pointer dereference" (#5046)
  - Correction d'un bug qui générait une erreur 500 avec le message "(Location4568) Total size of documents in job_history matching pipeline's $lookup stage exceeds 104857600 bytes" (#5057)
  - Les remédiations désactivées sont à présent réellement désactivées (#5065)
Général :
- Le service migrate-metrics-meta ne fait plus partie des configurations de référence de Canopsis (#5067)
- L'option LastEventDate (canopsis.toml) n'existe plus. La mise à jour de cette date est calculée naturellement, y compris sur les méta alarmes (#5027)
- Ajout d'un générateur d'événement smart-feeder capable de simuler le comportement d'un environnement de production (#4876)
Documentation :

Dernière mise à jour: 2024-02-19