Notes de version Canopsis 3.39.0¶
Canopsis 3.39.0 a été publié le 10 avril 2020.
Procédure d'installation¶
Suivre la procédure d'installation de Canopsis.
Procédure de mise à jour¶
Suivre la procédure standard de mise à jour de Canopsis.
Puis, en fonction de votre méthode d'installation, effectuez les manipulations suivantes.
Manipulations supplémentaires en environnement Docker¶
Redis doit être mis à jour vers sa version 5. La variable de référence (habituellement définie dans un fichier .env) utilisée est la suivante :
REDIS_TAG=5.0.8-buster
Si vous utilisez les moteurs Go, vous devez obligatoirement ajouter le nouveau moteur engine-fifo suivant à votre docker-compose.yml :
fifo:
image: canopsis/engine-fifo:${CANOPSIS_IMAGE_TAG}
env_file:
- compose.env
restart: unless-stopped
command: /engine-fifo
Si vous utilisiez le moteur engine-che avec l'option -alwaysFlushEntities, celle-ci n'a plus d'utilité et doit obligatoirement être supprimée.
En édition Pro, si vous utilisez les moteurs engine-webhook et engine-dynamic-infos, vous pouvez simplifier les points d'entrée en supprimant les paramètres -publishQueue, si vous les aviez exactement configurés aux valeurs suivantes :
dynamic-infos:
image: canopsis/engine-dynamic-infos:${CANOPSIS_IMAGE_TAG}
env_file:
- compose.env
depends_on:
- "mongodb"
restart: unless-stopped
# command: /cmd/engine-dynamic-infos -publishQueue Engine_webhook
command: /cmd/engine-dynamic-infos
webhook:
image: canopsis/engine-webhook:${CANOPSIS_IMAGE_TAG}
env_file:
- compose.env
depends_on:
- "mongodb"
restart: unless-stopped
# command: /cmd/engine-webhook -publishQueue Engine_action
command: /cmd/engine-webhook
Relancez l'ensemble de votre environnement avec docker-compose up -d. Assurez-vous avec docker-compose ps que le conteneur de provisionnement RabbitMQ init ait bien à nouveau été exécuté.
Manipulations supplémentaires en installation par paquets¶
Redis doit être mis à jour vers sa version 5. Cette manipulation n'est facilement réalisable que dans le cadre d'une nouvelle installation de Canopsis avec canoctl, ou à l'aide de votre contrat de support Capensis si vous en bénéficiez.
Pour Redis, notez qu'il est fort probable que vous ayez besoin d'ajuster sa variable maxmemory. Voyez pour cela la documentation sur le service Redis.
Si vous utilisez les moteurs Go, vous devez activer le nouveau moteur engine-fifo, et forcer la création de sa file RabbitMQ associée :
systemctl enable canopsis-engine-go@engine-fifo
cp /opt/canopsis/etc/initialisation-cat.toml.example /opt/canopsis/etc/initialisation.toml
set -o allexport ; source /opt/canopsis/etc/go-engines-vars.conf
/opt/canopsis/bin/init -conf /opt/canopsis/etc/initialisation.toml
Supprimez toute référence à l'option -alwaysFlushEntities du moteur engine-che, si vous l'utilisiez :
vi $(grep -lr alwaysFlushEntities /etc/systemd/system/canopsis*)
systemctl daemon-reload
Vous devez ensuite resynchroniser votre fichier amqp2engines.conf avec les fichiers de référence suivants présents dans /opt/canopsis/etc :
amqp2engines-go-cat.conf.exampleamqp2engines-go-core.conf.exampleamqp2engines-python-cat.conf.exampleamqp2engines-python-core.conf.example
Vous devez ensuite vous connecter à l'interface de RabbitMQ pour y apporter quelques changements.
Allez dans Exchanges > canopsis.events > Bindings, et cliquez sur le bouton « Unbind » de la file Engine_che :
Puis, redémarrez l'ensemble de vos moteurs :
canoctl restart
Changements entre Canopsis 3.38.0 et 3.39.0¶
Nouveau rythme de publication des nouvelles versions¶
Afin d'apporter de meilleures garanties sur les livrables, le rythme de publication de nouvelles versions de Canopsis passe maintenant de 2 à 3 semaines.
Les sprints de développement interne se poursuivent néanmoins sur leur rythme habituel de 15 jours.
Nouveaux helpers Handlebars¶
De nouveaux helpers Handlebars propres à Canopsis ont été ajoutés :
{{sum}},{{minus}},{{mul}},{{divide}}: afin d'appliquer les opérations mathématiques basiques sur des nombres.{{concat}}: afin de concaténer des chaines de caractères.
Consultez la documentation des helpers Handlebars propres à Canopsis, afin d'en savoir plus.
Nouveau mécanisme d'importation et d'exportation de vues¶
Les vues créées dans Canopsis peuvent maintenant être importées et exportées entre différents environnements, en quelques clics sur l'interface.
Nouveau widget Compteur¶
Ce widget permet d'afficher des compteurs sous formes de tuiles.
Les compteurs concernés sont des nombres d'alarmes, d'alarmes acquittées, alarmes associées à un ticket d'incident, alarmes en veille.
Plus d'informations dans la documentation du widget Compteur.
Améliorations diverses du vocabulaire du Bac à alarmes¶
Certaines parties du vocabulaire présent dans l'interface de Canopsis ont été revues dans les traductions françaises et anglaises.
Par exemple, l'état d'une alarme, qui pouvait être confondu avec son statut, s'intitule dorénavant criticité. Des termes internes tels que rrule ont maintenant été traduits en des termes plus clairs, tels que récurrence.
Seule l'interface web est concernée par ces changements ; la base de données, les API et les connecteurs utilisent toujours les noms de champs historiques, par compatibilité avec l'existant.
Déploiement facilité des moteurs Pro avec canoctl deploy¶
Si vous disposez d'une souscription à l'édition Pro de Canopsis, la commande de déploiement canoctl deploy est maintenant capable de déployer les moteurs Pro, sans nécessiter une quelconque manipulation supplémentaire.
(Ceci n'est valable que pour une nouvelle installation de Canopsis et de ses paquets.)
Mise à jour du serveur de cache Redis¶
En environnement Docker, ou en installation par paquets, Redis a été mis à jour d'une version 3 à une version 5, avec une configuration revue. Cette mise à jour est nécessaire au bon fonctionnement du nouveau moteur Go engine-fifo.
Voyez la procédure plus haut, pour les détails de cette mise à jour.
Améliorations diverses du Guide d'administration¶
Certaines parties du Guide d'administration ont été revues ou améliorées. Ce travail de fond se poursuivra lors des prochaines mises à jour de la plateforme de documentation.
Liste des modifications¶
- Images Docker / paquets :
- Documentation :
- Documentation de la fonctionnalité d'importation et d'exportation de vues Canopsis (#2311)
- Améliorations de la documentation du connecteur
email2canopsis - Documentation du droit « Lister les variables disponibles » (#2235)
- Ajout d'une documentation sur Redis et son paramètre
maxmemory(#2301) - Documentation du droit "Lister les variables disponibles" (#2235)
- Documentation du nouveau widget « Compteur » (#2247)
- API :
- Correction d'un bug dans l'API
Pbehaviorqui ne permettait pas de gérer le renommage correctement (#2314)
- Correction d'un bug dans l'API
- Connecteurs :
- email2canopsis :
- Ajout de 2 sélectionneurs
before_incetafter_incpermettant d'inclure les bornes en elles-mêmes (#2244) - Le sélectionneur
lineprend maintenant en charge le multi-lignes (#2242) - Ajout du mot clé
andpermettant de concaténer des valeurs (#2241) - Ajout de la fonction
printpermettant d'affecter une valeur statique à un attribut (#2240) - Possibilité dans le fichier
inide spécifier l'expéditeur à l'aide d'une expression régulière (#2239) - Le connecteur envoie à présent un événement complémentaire en cas d'erreur de connexion à la boite aux lettres (#2245)
- Ajout de 2 sélectionneurs
- email2canopsis :
- Moteurs :
- Moteurs nouvelle génération (Go) :
- Ajout d'engine-fifo, garantissant la cohérence du traitement des évènements internes à Canopsis, et posant les fondations pour des améliorations futures de performance
- Correction d'un bug entrainant un plantage et redémarrage du moteur
watcher(#2254) - Prise en charge des types
pbhenteretpbhleavedans les steps des alarmes (#2228) - Le moteur
actionpeut désormais exécuter les actionsack/ackremove,assocticket/declareticket,cancel(#2178) - Le moteur
actionpeut désormais ajouter un délai dans l'exécution des actions (#2179)
- Moteurs nouvelle génération (Go) :
- UI :
- Ajout de nouveaux helpers Handlerbars
{{sum}},{{mul}},{{minus}},{{divide}},{{concat}}(#2277, #2247) - Bac à alarmes :
- Prise en charge des types
pbehaviorsdans la chronologie de l'alarme (#2290) - La compilation des templates
infopopupa lieu au moment du clic et non pas au chargement du bac à alarmes (#2279) - L'accès à la liste des variables brutes est désormais lié à un droit (et non plus lié à l'édition du widget) (#2235)
- Une alarme est désormais accessible par le biais d'une URL directe (#2211)
- Un filtre portant sur des
dynamic-infospeut comporter un caractère joker (#2193)
- Prise en charge des types
- Calendrier :
- Correction d'un bug de positionnement de date (#2304)
- CRUD Webhook :
- Les webhooks peuvent être activés ou désactivés (#2209)
- CRUD Dynamic Infos :
- CRUD Actions :
- Correction de l'affichage des patterns d'alarmes et d'entités (#2089)
- Linklist :
- Les liens sont maintenant triés par ordre alphabétique (#2282)
- Widgets :
- Ajout d'un nouveau widget « Compteur » (#2247)
- Paramètres :
- Ajout d'un mécanisme d'import/export des vues de Canopsis (#2243)
- Ajout de nouveaux helpers Handlerbars
- Expérience utilisateur :