Journalisation de la configuration
La journalisation de la configuration enregistre les modifications de configuration du Site et les activités administratives dans la base de données. Vous pouvez utiliser le contenu journalisé pour :
- Diagnostiquer et résoudre les problèmes après que des modifications de configuration ont été effectuées ; le journal fournit une piste d’audit
- Faciliter la gestion des changements et suivre les configurations
- Établir des rapports sur l’activité d’administration
Vous définissez les préférences de journalisation de la configuration, affichez les journaux de configuration et générez des rapports HTML et CSV à partir de Citrix Studio. Vous pouvez filtrer les affichages des journaux de configuration par plages de dates et par résultats de recherche en texte intégral. La journalisation obligatoire, lorsqu’elle est activée, empêche que des modifications de configuration soient effectuées à moins qu’elles ne puissent être journalisées. Avec l’autorisation appropriée, vous pouvez supprimer des entrées du journal de configuration. Vous ne pouvez pas utiliser la fonctionnalité de journalisation de la configuration pour modifier le contenu du journal.
La journalisation de la configuration utilise un SDK PowerShell et le service de journalisation de la configuration. Le service de journalisation de la configuration s’exécute sur chaque contrôleur du Site ; si un contrôleur tombe en panne, le service sur un autre contrôleur gère automatiquement les requêtes de journalisation.
Par défaut, la fonctionnalité de journalisation de la configuration est activée et utilise la base de données qui est créée lorsque vous créez le Site (la base de données de configuration du Site). Vous pouvez spécifier un emplacement différent pour la base de données. La base de données de journalisation de la configuration prend en charge les mêmes fonctionnalités de haute disponibilité que la base de données de configuration du Site.
L’accès à la journalisation de la configuration est contrôlé via l’administration déléguée, avec les autorisations Modifier les préférences de journalisation et Afficher les journaux de configuration.
Les journaux de configuration sont localisés lorsqu’ils sont créés. Par exemple, un journal créé en anglais sera lu en anglais, quelle que soit la locale du lecteur.
Contenu journalisé
Les modifications de configuration et les activités administratives initiées depuis Studio, Director et les scripts PowerShell sont journalisées. Des exemples de modifications de configuration journalisées incluent le travail avec (création, modification, suppression, attribution) :
- Catalogues de machines
- Groupes de mise à disposition (y compris la modification des paramètres de gestion de l’alimentation)
- Rôles et étendues d’administrateur
- Ressources et connexions d’hôte
- Stratégies Citrix via Studio
Voici des exemples de modifications administratives journalisées :
- Gestion de l’alimentation d’une machine virtuelle ou d’un bureau utilisateur
- Studio ou Director envoyant un message à un utilisateur
Les opérations suivantes ne sont pas journalisées :
- Opérations autonomes telles que la mise sous tension des machines virtuelles par la gestion de pool.
- Actions de stratégie implémentées via la console de gestion des stratégies de groupe (GPMC) ; utilisez les outils Microsoft pour afficher les journaux de ces actions.
- Modifications apportées via le registre, l’accès direct à la base de données ou à partir de sources autres que Studio, Director ou PowerShell.
- Lorsque le déploiement est initialisé, la journalisation de la configuration devient disponible lorsque la première instance du service de journalisation de la configuration s’enregistre auprès du service de configuration. Par conséquent, les toutes premières étapes de la configuration ne sont pas journalisées (par exemple, lorsque le schéma de base de données est obtenu et appliqué, lorsqu’un hyperviseur est initialisé).
Gérer la journalisation de la configuration
Par défaut, la journalisation de la configuration utilise la base de données créée lors de la création d’un site (également appelée base de données de configuration de site). Citrix recommande d’utiliser un emplacement distinct pour la base de données de journalisation de la configuration (et la base de données de surveillance) pour les raisons suivantes :
- La stratégie de sauvegarde de la base de données de journalisation de la configuration est susceptible de différer de la stratégie de sauvegarde de la base de données de configuration de site.
- Le volume de données collectées pour la journalisation de la configuration (et le service de surveillance) pourrait affecter négativement l’espace disponible pour la base de données de configuration de site.
- Cela divise le point de défaillance unique pour les trois bases de données.
Remarque : Les éditions du produit qui ne prennent pas en charge la journalisation de la configuration n’ont pas de nœud Journalisation dans Studio.
Activer et désactiver la journalisation de la configuration et la journalisation obligatoire
Par défaut, la journalisation de la configuration est activée et la journalisation obligatoire est désactivée.
- Sélectionnez Journalisation dans le volet de navigation de Studio.
- Sélectionnez Préférences dans le volet Actions. La boîte de dialogue Journalisation de la configuration contient des informations sur la base de données et indique si la journalisation de la configuration et la journalisation obligatoire sont activées ou désactivées.
- Sélectionnez l’action souhaitée :
Pour activer la journalisation de la configuration, sélectionnez le bouton radio Activer. Il s’agit du paramètre par défaut. Si l’écriture dans la base de données est impossible, les informations de journalisation sont ignorées, mais l’opération se poursuit.
Pour désactiver la journalisation de la configuration, sélectionnez le bouton radio Désactiver. Si la journalisation était précédemment activée, les journaux existants restent lisibles avec le SDK PowerShell.
Pour activer la journalisation obligatoire, sélectionnez le bouton radio Empêcher les modifications de la configuration du site lorsque la base de données n’est pas disponible. Aucune modification de configuration ou activité administrative qui serait normalement journalisée ne sera autorisée, sauf si elle peut être écrite dans la base de données de journalisation de la configuration. Vous ne pouvez activer la journalisation obligatoire que lorsque la journalisation de la configuration est activée, c’est-à-dire lorsque le bouton radio Activer est sélectionné. Si le service de journalisation de la configuration échoue et que la haute disponibilité n’est pas utilisée, la journalisation obligatoire est supposée. Dans de tels cas, les opérations qui seraient normalement journalisées ne sont pas effectuées.
Pour désactiver la journalisation obligatoire, sélectionnez le bouton radio Autoriser les modifications de la configuration du site lorsque la base de données n’est pas disponible. Les modifications de configuration et les activités administratives sont autorisées, même si la base de données utilisée pour la journalisation de la configuration est inaccessible. Il s’agit du paramètre par défaut.
Modifier l’emplacement de la base de données de journalisation de la configuration
Remarque : Vous ne pouvez pas modifier l’emplacement de la base de données lorsque la journalisation obligatoire est activée, car le changement d’emplacement inclut un bref intervalle de déconnexion qui ne peut pas être journalisé.
- Créez un serveur de base de données, en utilisant une version prise en charge de SQL Server.
- Sélectionnez Journalisation dans le volet de navigation de Studio.
- Sélectionnez Préférences dans le volet Actions.
- Dans la boîte de dialogue Préférences de journalisation, sélectionnez Modifier la base de données de journalisation.
- Dans la boîte de dialogue Modifier la base de données de journalisation, spécifiez l’emplacement du serveur contenant le nouveau serveur de base de données. Les formats valides sont répertoriés dans l’article Bases de données.
- Pour permettre à Studio de créer la base de données, cliquez sur OK. Lorsque vous y êtes invité, cliquez sur OK, et celle-ci sera créée automatiquement. Studio tente d’accéder à la base de données en utilisant les informations d’identification de l’utilisateur Studio actuel ; si cela échoue, vous êtes invité à saisir les informations d’identification de l’utilisateur de la base de données. Studio télécharge ensuite le schéma de la base de données dans celle-ci. (Les informations d’identification ne sont conservées que pendant la création de la base de données.)
- Pour créer la base de données manuellement, cliquez sur Générer un script de base de données. Le script généré contient des instructions pour la création manuelle de la base de données. Assurez-vous que la base de données est vide et qu’au moins un utilisateur dispose des autorisations d’accès et de modification de la base de données avant de télécharger le schéma.
Les données de journalisation de la configuration de la base de données précédente ne sont pas importées dans la nouvelle base de données. Les journaux ne peuvent pas être agrégés à partir des deux bases de données lors de la récupération des journaux. La première entrée de journal dans la nouvelle base de données de journalisation de la configuration indiquera qu’un changement de base de données s’est produit, mais elle n’identifie pas la base de données précédente.
Afficher le contenu du journal de configuration
Lors de l’initiation de modifications de configuration et d’activités administratives, les opérations de haut niveau créées par Studio et Director sont affichées dans le volet central supérieur de Studio. Une opération de haut niveau entraîne un ou plusieurs appels de service et SDK, qui sont des opérations de bas niveau. Lorsque vous sélectionnez une opération de haut niveau dans le volet central supérieur, le volet central inférieur affiche les opérations de bas niveau.
Si une opération échoue avant d’être terminée, l’opération de journalisation peut ne pas être terminée dans la base de données ; par exemple, un enregistrement de début n’aura pas d’enregistrement de fin correspondant. Dans de tels cas, le journal indique qu’il manque des informations. Lorsque vous affichez des journaux basés sur des plages horaires, les journaux incomplets sont affichés si les données des journaux correspondent aux critères. Par exemple, si tous les journaux des cinq derniers jours sont demandés et qu’un journal existe avec une heure de début dans les cinq derniers jours mais n’a pas d’heure de fin, il est inclus.
Lorsque vous utilisez un script qui appelle des cmdlets PowerShell, si vous créez une opération de bas niveau sans spécifier d’opération de haut niveau parente, la journalisation de la configuration créera une opération de haut niveau de substitution.
Pour afficher le contenu du journal de configuration, sélectionnez Journalisation dans le volet de navigation de Studio. Par défaut, l’affichage dans le volet central répertorie le contenu du journal chronologiquement (les entrées les plus récentes en premier), séparé par date.
| Pour filtrer l’affichage par | Effectuez cette action |
|---|---|
| Résultats de la recherche | Saisissez du texte dans la zone de recherche en haut du volet central. L’affichage filtré inclut le nombre de résultats de recherche. Pour revenir à l’affichage de journalisation standard, effacez le texte dans la zone de recherche. |
| En-tête de colonne | Cliquez sur un en-tête de colonne pour trier l’affichage par ce champ. |
| Une plage de dates | Sélectionnez un intervalle dans la liste déroulante située à côté de la zone de recherche en haut du volet central. |
Générer des rapports
Vous pouvez générer des rapports CSV et HTML contenant les données du journal de configuration.
- Le rapport CSV contient toutes les données de journalisation d’un intervalle de temps spécifié. Les données hiérarchiques de la base de données sont aplaties en une seule table CSV. Aucun aspect des données n’a de priorité dans le fichier. Aucun formatage n’est utilisé et aucune lisibilité humaine n’est supposée. Le fichier (nommé MyReport) contient simplement les données dans un format universellement consommable. Les fichiers CSV sont souvent utilisés pour archiver des données ou comme source de données pour un outil de création de rapports ou de manipulation de données tel que Microsoft Excel.
- Le rapport HTML fournit une forme lisible par l’homme des données de journalisation pour un intervalle de temps spécifié. Il offre une vue structurée et navigable pour l’examen des modifications. Un rapport HTML comprend deux fichiers, nommés Résumé et Détails. Le Résumé liste les opérations de haut niveau : quand chaque opération a eu lieu, par qui, et le résultat. Cliquer sur un lien Détails à côté de chaque opération vous mène aux opérations de bas niveau dans le fichier Détails, qui fournit des informations supplémentaires.
Pour générer un rapport de journal de configuration, sélectionnez Journalisation dans le volet de navigation de Studio, puis sélectionnez Créer un rapport personnalisé dans le volet Actions.
- Sélectionnez la plage de dates pour le rapport.
- Sélectionnez le format du rapport : CSV, HTML ou les deux.
- Accédez à l’emplacement où le rapport doit être enregistré.
Supprimer le contenu du journal de configuration
Pour supprimer le journal de configuration, vous devez disposer de certaines autorisations d’administration déléguée et de base de données SQL Server.
-
Administration déléguée — Vous devez disposer d’un rôle d’administration déléguée qui permet la lecture de la configuration du déploiement. Le rôle d’administrateur complet intégré dispose de cette autorisation. Un rôle personnalisé doit avoir Lecture seule ou Gérer sélectionné dans la catégorie Autres autorisations.
Pour créer une sauvegarde des données de journalisation de configuration avant de les supprimer, le rôle personnalisé doit également avoir Lecture seule ou Gérer sélectionné dans la catégorie Autorisations de journalisation.
-
Base de données SQL Server — Vous devez disposer d’un identifiant de connexion SQL Server avec l’autorisation de supprimer des enregistrements de la base de données. Il existe deux façons de procéder :
-
Utilisez un identifiant de connexion de base de données SQL Server avec un rôle de serveur sysadmin, ce qui vous permet d’effectuer n’importe quelle activité sur le serveur de base de données. Alternativement, les rôles de serveur serveradmin ou setupadmin vous permettent d’effectuer des opérations de suppression.
-
Si votre déploiement nécessite une sécurité supplémentaire, utilisez un identifiant de connexion de base de données non-sysadmin mappé à un utilisateur de base de données qui a l’autorisation de supprimer des enregistrements de la base de données.
- Dans SQL Server Management Studio, créez un identifiant de connexion SQL Server avec un rôle de serveur autre que ‘sysadmin’.
- Mappez l’identifiant de connexion à un utilisateur dans la base de données ; SQL Server crée automatiquement un utilisateur dans la base de données avec le même nom que l’identifiant de connexion.
- Dans l’appartenance au rôle de base de données, spécifiez au moins un des membres de rôle pour l’utilisateur de base de données : ConfigurationLoggingSchema_ROLE ou dbowner.
Pour plus d’informations, consultez la documentation de SQL Server Management Studio.
-
Pour supprimer les journaux de configuration :
- Sélectionnez Journalisation dans le volet de navigation de Studio.
- Sélectionnez Supprimer les journaux dans le volet Actions.
- Il vous est demandé si vous souhaitez créer une sauvegarde des journaux avant leur suppression. Si vous choisissez de créer une sauvegarde, accédez à l’emplacement où l’archive de sauvegarde doit être enregistrée. La sauvegarde est créée sous forme de fichier CSV.
Une fois les journaux de configuration effacés, la suppression du journal est la première activité enregistrée dans le journal vide. Cette entrée fournit des détails sur la personne qui a supprimé les journaux et la date de cette suppression.
Dans cet article
- Contenu journalisé
- Gérer la journalisation de la configuration
- Activer et désactiver la journalisation de la configuration et la journalisation obligatoire
- Modifier l’emplacement de la base de données de journalisation de la configuration
- Afficher le contenu du journal de configuration
- Générer des rapports
- Supprimer le contenu du journal de configuration