Journalisation de la configuration
Remarque :
Les enregistrements du journal de configuration apparaissent uniquement en anglais, quelle que soit la langue que vous sélectionnez pour votre compte Citrix Cloud. Les dates et heures associées à ces enregistrements sont au format MM/JJ/AA, exprimées en temps universel coordonné (UTC).
-
La journalisation de la configuration est une fonctionnalité qui capture les modifications de configuration de déploiement et les activités administratives de Citrix Virtual Apps and Desktops™ et Citrix DaaS (anciennement le service Citrix Virtual Apps and Desktops) dans une base de données de journalisation dans Citrix Cloud. Vous pouvez utiliser le contenu journalisé pour :
- Diagnostiquer et résoudre les problèmes après des modifications de configuration. Le journal fournit une piste d’audit.
- Faciliter la gestion des changements et le suivi des configurations.
- Rapporter les activités administratives.
Dans ce Citrix DaaS™, la journalisation de la configuration est toujours activée. Vous ne pouvez pas la désactiver.
Depuis Studio, vous pouvez afficher le contenu du journal de configuration, filtré par plages de dates ou par recherche en texte intégral. Vous pouvez également générer un rapport CSV à l’aide de PowerShell. Depuis cette console, vous ne pouvez pas modifier ou supprimer le contenu du journal. Vous pouvez utiliser le SDK PowerShell distant pour planifier la suppression périodique des données du journal.
Mettre à jour la rétention des journaux de configuration DaaS
Pour maintenir les performances des locataires DaaS, à compter du 9 septembre 2024, la rétention des journaux de configuration sera fixée à 180 jours.
- Les journaux de plus de 180 jours au 9 septembre 2024 seront supprimés. Alors que nous continuons d’augmenter nos Limites DaaS pour un seul locataire DaaS, cette implémentation garantit les meilleures performances et la meilleure résilience pour nos clients.
En tant que bonne pratique, nous conseillons aux clients de disposer d’un mécanisme d’exportation trimestriel. Cela peut être fait via PowerShell, consultez Générer des rapports. Nous recommandons également aux clients de planifier la suppression périodique des données, consultez Planifier la suppression périodique des données.
Autorisations requises (voir Administration déléguée) :
- Les administrateurs complets dans Citrix Cloud™, ainsi que les administrateurs cloud Citrix DaaS et les administrateurs en lecture seule peuvent afficher les journaux de configuration dans Studio.
- Les administrateurs complets et les administrateurs cloud peuvent également télécharger un rapport CSV de l’activité de journalisation, à l’aide de PowerShell.
Ce qui est journalisé
Les opérations suivantes sont journalisées :
- Modifications de configuration et activités administratives initiées depuis la section Gérer et le nœud Surveiller
- Scripts PowerShell
-
Requêtes d’API REST
-
Remarque :
Vous ne pouvez pas voir les entrées de journal pour les opérations internes de la plateforme Citrix Cloud, telles que la configuration et la gestion de la base de données.
Les 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
Les exemples de modifications administratives journalisées incluent :
- Gestion de l’alimentation d’une machine virtuelle ou d’un bureau utilisateur
- Fonctions de gestion ou de surveillance envoyant un message à un utilisateur
Les opérations suivantes ne sont pas journalisées. (Beaucoup d’entre elles ne sont pas disponibles pour les administrateurs clients.)
- Opérations automatiques 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 effectuées via le registre ou à partir de sources autres que Studio, Monitor ou PowerShell.
Afficher le contenu du journal de configuration
Pour afficher le contenu du journal de configuration, suivez ces étapes :
- Connectez-vous à Citrix Cloud.
- Dans la vignette DaaS, cliquez sur Gérer.
-
- Sélectionnez Journalisation dans le volet gauche et cliquez sur l’onglet Événements.
-
Par défaut, les journaux d’événements sont répertoriés par nom d’administrateur. Vous pouvez effectuer les tâches suivantes selon vos besoins :
- Trier l’affichage. Triez l’affichage en cliquant sur un en-tête de colonne.
- Filtrer les journaux. Affinez l’affichage en définissant des conditions de filtre telles que des intervalles de jours ou des périodes personnalisées, ou en saisissant des noms de tâches principales complets ou partiels dans la zone de recherche. Pour revenir à l’affichage standard après avoir utilisé la recherche, effacez le texte dans la zone de recherche.
- Exporter les journaux. Exportez les journaux sélectionnés ou tous les journaux vers un fichier CSV pour archivage ou analyse approfondie.
- Personnaliser les colonnes. Adaptez l’affichage à vos besoins en ajoutant des colonnes non par défaut telles que l’adresse IP du client et les étiquettes.
-
Gérer les étiquettes. Ajoutez, modifiez et supprimez des étiquettes pour les journaux d’événements afin d’améliorer l’organisation et le suivi des journaux.
-
Caractéristiques d’affichage :
- Les opérations de haut niveau créées pendant la gestion et la surveillance sont répertoriées dans le volet central supérieur. Une opération de haut niveau entraîne un ou plusieurs services et appels SDK PowerShell, 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 inférieur affiche les opérations de bas niveau.
- Si vous créez une opération de bas niveau dans PowerShell sans spécifier d’opération de haut niveau parente, la journalisation de la configuration crée une opération de haut niveau de substitution.
- 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’a pas d’enregistrement de fin correspondant. Dans de tels cas, le journal indique qu’il manque des informations. Lorsque vous affichez les journaux en fonction de plages horaires, les journaux incomplets sont affichés si les données des journaux correspondent aux critères. Par exemple, si vous demandez les journaux des cinq derniers jours et qu’un journal avec une heure de début au cours des cinq derniers jours n’a pas d’heure de fin, il est inclus.
- N’oubliez pas : vous ne pouvez pas voir les entrées de journal pour les opérations internes de la plateforme Citrix Cloud, telles que la configuration et la gestion de la base de données.
Afficher les tâches liées aux opérations de catalogue de machines
-
Pour afficher les tâches liées aux opérations de catalogue de machines, accédez à Journalisation > Tâches. L’onglet Tâches affiche uniquement les tâches liées aux catalogues créés via Machine Creation Services™ (MCS) ou Provisioning Services (PVS). Plus précisément, les tâches associées aux opérations de catalogue de machines suivantes apparaissent :
- Créer des catalogues
- Cloner des catalogues
- Ajouter des machines
- Supprimer des machines
- Mettre à jour un catalogue (mettre à jour des images ou des machines)
- Annuler les mises à jour de machines
Conseil :
L’onglet Tâches affiche uniquement les tâches liées aux modifications de schéma de provisionnement (création ou modification d’un schéma de provisionnement).
Une tâche peut être dans l’état suivant :
- Terminée
- Non démarrée
- En cours d’exécution
- Annulée
- Échouée
- Inconnue
Pour annuler une tâche en cours d’exécution, sélectionnez la tâche, puis cliquez sur Annuler. L’annulation prend un certain temps.
Les exemples de tâches journalisées incluent :
- Mise à jour d’image terminée pour un certain catalogue
- Erreur lors de la mise à jour de l’image pour un certain catalogue
- Mise à jour d’image annulée pour un certain catalogue
- Provisionnement de machines virtuelles pour un certain catalogue
- Suppression de machines virtuelles d’un certain catalogue
- Création d’un certain catalogue
Par défaut, l’affichage dans le volet central répertorie les tâches journalisées chronologiquement (les entrées les plus récentes en premier), séparées par date. Vous pouvez trier l’affichage par en-tête de colonne. Pour effacer les tâches terminées, cliquez sur Effacer les tâches terminées sous l’onglet Tâches. Pour choisir les colonnes à afficher, sélectionnez l’icône Colonnes à afficher dans le coin supérieur droit du tableau.
Afficher les journaux d’API
- Pour afficher les journaux d’API REST, accédez à Journalisation > API. L’onglet API affiche les requêtes d’API REST effectuées pendant une certaine période.
Tenez compte des considérations suivantes :
- Les journaux d’API REST sont effacés après votre déconnexion de la console. (Ils sont également effacés si vous actualisez la fenêtre de votre navigateur.)
- Toutes les opérations de la console qui entraînent des appels d’API ont leurs requêtes d’API correspondantes affichées dans l’onglet API.
- L’affichage liste les requêtes d’API par ordre chronologique (les entrées les plus récentes en premier), séparées par date. Le nombre maximal de requêtes d’API dans l’affichage est de 1 000.
Afficher les journaux PowerShell
- Pour afficher les commandes PowerShell correspondant aux actions d’interface utilisateur que vous avez effectuées au cours de la journée, accédez à l’onglet Journalisation > PowerShell.
Associer des métadonnées aux journaux de configuration
-
Vous pouvez joindre des métadonnées aux journaux de configuration en associant une paire
nom-valeurappeléeMetadataMapaux enregistrements de journal. -
Remarque :
-
-
- Vous ne pouvez joindre des métadonnées qu’aux objets d’opération de haut niveau.
- Les métadonnées sont associées aux enregistrements existants au moment de l’exécution.
Définir les métadonnées
Exécutez la commande PowerShell Set-LogHighLevelOperationMetadata pour associer un enregistrement de journal à la MetadataMap.
Set-LogHighLevelOperationMetadata accepte les paramètres suivants :
- Id : ID de l’opération de haut niveau.
-
InputObject : Les opérations de haut niveau auxquelles vous ajoutez les métadonnées. Il s’agit d’une alternative au paramètre
Idoù un objet d’opération de haut niveau ou une liste d’objets est passé(e) à la commande PowerShell. -
Name : Nom de la propriété des métadonnées à ajouter. La propriété doit être unique pour l’opération de haut niveau spécifiée. La propriété ne peut pas contenir les caractères suivants :
()\/;:#.*?=<>|[]"' - Value : Valeur de la propriété.
-
Map : Dictionnaire de paires (nom, valeur) pour les propriétés. Il s’agit d’une alternative à la définition des métadonnées à l’aide des paramètres
-Nameet-Value.
Par exemple, pour joindre les métadonnées à tous les enregistrements de journal de haut niveau avec l’ID 40, exécutez la commande PowerShell suivante :
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
Pour joindre les métadonnées à l’enregistrement de haut niveau avec l’utilisateur abc@example.com, exécutez la commande PowerShell suivante :
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
Récupérer à l’aide des métadonnées
Exécutez les commandes PowerShell suivantes pour utiliser les métadonnées associées afin de récupérer les enregistrements de journal :
-
Rechercher par clé et valeur :
Get-LogHighLevelOperation -Metadata "Key:Value" -
Rechercher par valeur et n’importe quelle clé :
Get-LogHighLevelOperation -Metadata "*:Value" -
Rechercher par clé et n’importe quelle valeur :
Get-LogHighLevelOperation -Metadata "Key:*"
Supprimer les métadonnées
Exécutez la commande PowerShell Remove-LogHighLevelOperationMetadata pour supprimer les métadonnées associées.
Remove-LogHighLevelOperationMetadata accepte les paramètres suivants :
- Id : ID de l’opération de haut niveau.
-
InputObject : Les opérations de haut niveau auxquelles vous ajoutez les métadonnées. Il s’agit d’une alternative au paramètre
Idoù un objet d’opération de haut niveau ou une liste d’objets est passé(e) à la commande PowerShell. - Name : Nom de la propriété des métadonnées à supprimer. Définissez sur $null pour supprimer toutes les métadonnées de l’objet spécifié.
- Map : Dictionnaire de paires (nom, valeur) pour les propriétés. Il peut s’agir d’une table de hachage (créée avec @{“name1” = “val1”; “name2” = “val2”}) ou d’un dictionnaire de chaînes (créé avec new-object “System.Collections.Generic.Dictionary[String, String]”). Les propriétés dont les noms correspondent aux clés de la carte sont supprimées.
Générer des rapports
Pour générer un rapport CSV ou HTML contenant des données de journal de configuration, utilisez les applets de commande PowerShell pour le service ConfigLogging dans le SDK PowerShell distant de Citrix Virtual Apps and Desktops. Pour plus de détails, consultez :
Planifier la suppression périodique des données
Utilisez le SDK PowerShell distant pour spécifier la durée de conservation des données dans la base de données de journalisation de la configuration. (Cette fonctionnalité n’est pas disponible dans Studio.) Dans Citrix DaaS, vous devez disposer d’un accès complet.
Dans l’applet de commande Set-LogSite, le paramètre -LoggingDBPurgeDurationDays spécifie le nombre de jours pendant lesquels les données sont conservées dans la base de données de journalisation de la configuration avant d’être supprimées automatiquement.
- Par défaut, la valeur de ce paramètre est 0. Une valeur nulle signifie que les données de la base de données de journalisation de la configuration ne sont jamais supprimées automatiquement.
- Lorsque vous définissez une valeur non nulle, la base de données est vérifiée toutes les 120 minutes. Les données plus anciennes que la période de rétention sont supprimées.
Utilisez Get-LogSite pour afficher la valeur actuelle du paramètre.
Différences par rapport à Citrix Virtual Apps and Desktops sur site
Si vous êtes familier avec la journalisation de la configuration dans le produit Virtual Apps and Desktops sur site, la version Citrix Cloud présente plusieurs différences. Dans Citrix Cloud :
- La journalisation de la configuration est toujours activée. Vous ne pouvez pas la désactiver. La journalisation obligatoire n’est pas disponible.
- Vous ne pouvez pas modifier l’emplacement de la base de données de journalisation de la configuration, car la base de données est gérée dans la plateforme Citrix Cloud.
- Les affichages des journaux de configuration n’incluent pas les opérations et activités effectuées au sein de la plateforme Citrix Cloud.
- PowerShell est votre seule option pour créer un rapport CSV ou HTML des opérations journalisées. Dans le produit sur site, les rapports peuvent être générés à partir de Citrix Studio ou de PowerShell.
- Vous ne pouvez pas supprimer le contenu du journal de configuration.
Dans cet article
- Mettre à jour la rétention des journaux de configuration DaaS
- Ce qui est journalisé
- Afficher le contenu du journal de configuration
- Afficher les tâches liées aux opérations de catalogue de machines
- Afficher les journaux d’API
- Afficher les journaux PowerShell
- Associer des métadonnées aux journaux de configuration
- Générer des rapports
- Planifier la suppression périodique des données
- Différences par rapport à Citrix Virtual Apps and Desktops sur site