CUCM change log : consigner les modifications directes sur le CUCM

À quoi cela sert

Toutes les modifications ne passent pas par EasyUC. Une personne qui modifie un téléphone directement dans CUCM Administration n'apparaît dans le journal d'audit EasyUC que si EasyUC interroge ensuite le CUCM. Le CUCM change log active cet enregistrement par connexion CUCM.

Il y a deux niveaux. Le change feed demande régulièrement au CUCM, via AXL, les objets modifiés. Il montre ce qui a changé et quand, mais pas par qui. Les entrées apparaissent avec la source CUCM direct environ une à deux minutes après la modification.

Le second niveau évalue en plus le journal d'audit du CUCM. Il ajoute l'utilisateur CUCM et l'IP du client. Pour cela, EasyUC lit toutes les 10 minutes les fichiers d'audit de chaque nœud CUCM actif via l'interface de collecte de journaux. L'utilisateur n'apparaît donc que 5 à 20 minutes après la modification. EasyUC ne modifie rien sur le CUCM lui-même.

Prérequis

Accès aux connexions CUCM dans l'administration.
Pour le change feed : une connexion AXL fonctionnelle. Il est activé par défaut pour chaque connexion.
Pour le journal d'audit CUCM, sur le CUCM : sous Cisco Unified Serviceability → Tools → Audit Log Configuration, Enable Audit Log et Detailed Audit Logging sont activés et enregistrés avec Apply to All Nodes.
Les services réseau Cisco Audit Event Service et Cisco Log Partitions Monitoring Tool sont en cours d'exécution sur tous les nœuds.
L'utilisateur AXL de la connexion peut lire les journaux de serviceability, par exemple via le rôle CUCM Standard CCM Server Monitoring.
EasyUC joint chaque nœud CUCM actif par son nom depuis le CUCM (HTTPS, port 8443). Les nœuds IM&P et Unity sont ignorés.
Dans les réglages du journal d'audit, les sources CUCM direct et CUCM audit log ne sont pas désactivées.

Pas à pas : activer l'enregistrement sur la connexion

Ouvrez Administration → CUCM & Provisioning → CUCM Connections.
Dans la ligne de la connexion, cliquez sur Actions → CUCM change log.
Laissez Fetch CUCM changes (change feed) activé, ou activez l'option.
Sous Monitored object types, choisissez quels objets CUCM sont surveillés. Au moins un type doit être sélectionné.
Saisissez l'intervalle entre les interrogations sous Polling interval (seconds).
Sur le CUCM, effectuez les étapes que la boîte de dialogue énumère sous Enable on the CUCM before using this option.
Activez ensuite Evaluate the CUCM audit log (who made the change) si vous souhaitez aussi voir l'utilisateur CUCM.
Sous Additional EasyUC AXL users, saisissez d'autres utilisateurs CUCM par lesquels EasyUC travaille lui-même. Tapez un nom d'utilisateur et appuyez sur Entrée.
Cliquez sur Save. Le message « CUCM change log saved » confirme l'opération.
Pour vérifier, modifiez la description d'un téléphone de test directement sur le CUCM et recherchez le téléphone sous Logs → EasyUC Logs après deux minutes.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Fetch CUCM changes (change feed)	Demande régulièrement au CUCM les objets modifiés. Par défaut : activé. Tant qu'il est désactivé, les modifications directes sur le CUCM n'apparaissent pas dans le journal d'audit. Après réactivation, l'interrogation repart à zéro, sans la période intermédiaire.
Monitored object types	Téléphone, profil de terminal, ligne, utilisateur, destination distante et profil de destination distante, hunt pilot, hunt list, line group, pickup group, translation pattern et route pattern. All sélectionne tous les types.
Polling interval (seconds)	De 60 à 300 secondes autorisé. Par défaut, une interrogation par minute.
Evaluate the CUCM audit log (who made the change)	Ajoute l'utilisateur et l'adresse IP issus du journal d'audit CUCM. Par défaut : désactivé.
Additional EasyUC AXL users	Les modifications de ces utilisateurs comptent comme des modifications EasyUC et ne sont pas affichées comme modifications CUCM directes. L'utilisateur AXL de la connexion est toujours inclus.

Comment lire les entrées

Comment lire les entrées
Champ / action	Signification et utilisation
Source CUCM direct	Modification détectée par le change feed. Indique l'objet, l'action et les champs modifiés. L'heure est précise à l'intervalle d'interrogation près. Performed by indique d'abord Unknown.
Performed by: CUCM administrator	Le journal d'audit CUCM a fourni l'utilisateur. Il est ajouté une seule fois à l'entrée « CUCM direct » et peut être recherché comme un utilisateur EasyUC.
Source CUCM audit log	Entrée distincte issue du journal d'audit lorsqu'aucune entrée « CUCM direct » ne correspondait ou qu'un autre événement a été consigné, par exemple un redémarrage de service.
Possible echo	Modification que EasyUC a probablement déclenchée lui-même. Masquée par défaut.
"Gap in the change feed"	Le CUCM a redémarré sa liste de modifications, par exemple après un redémarrage du service AXL. Les modifications intermédiaires sont ajoutées par une resynchronisation et portent la mention « Detected by resync, time inexact ».
Not stored	Les connexions et déconnexions sur le CUCM ne sont pas importées par défaut. Les valeurs des champs sensibles comme le PIN ou le mot de passe apparaissent uniquement comme modifiées.

Contrôler le résultat et circonscrire les erreurs

Vous reconnaissez le succès lorsque la modification de test apparaît avec la source CUCM direct après une à deux minutes et que, avec le journal d'audit activé, l'utilisateur CUCM est ajouté après 5 à 20 minutes.
Aucune entrée « CUCM direct » : vérifiez si le type d'objet est sélectionné sous Monitored object types et si la source est activée dans les réglages du journal d'audit.
L'utilisateur reste absent : sur le CUCM, contrôlez la configuration du journal d'audit sur tous les nœuds, les deux services réseau et les autorisations de serviceability de l'utilisateur AXL. Sans cette autorisation, seule la récupération du journal d'audit est touchée ; les autres fonctions continuent de s'exécuter.
« Allowed: 60 to 300 seconds » : corrigez l'intervalle d'interrogation.
« Please select at least one object type. » : sélectionnez un type d'objet ou désactivez le change feed.
« Nothing has been saved for this connection yet – the defaults are shown. » : simple avis. Save applique les valeurs par défaut.
L'utilisateur et la modification sont rapprochés par l'heure. Si deux administrateurs modifient le même objet à quelques minutes d'intervalle, l'utilisateur peut se retrouver sur la mauvaise entrée. Les lignes du journal d'audit sont conservées comme détails.
Si les fichiers d'audit sur le CUCM sont écrasés plus vite qu'ils ne sont récupérés, des lignes sont perdues. Après une pause, EasyUC relit au plus 7 jours.
Les modifications effectuées par la synchronisation LDAP apparaissent comme « CUCM direct » sans utilisateur si le journal d'audit n'en contient aucune trace.