Documentation sur Oracle Cloud Infrastructure

Gérer les journaux de service de diagnostic dans Oracle Access Governance

Les services Oracle Cloud Infrastructure (OCI) génèrent des journaux de service que vous pouvez activer pour qu'une ressource puisse gérer de manière centralisée toutes les informations de diagnostic critiques à l'aide de la console OCI.

Pour utiliser les journaux de service, vous devez d'abord les activer.

Vous devez noter que les journaux de service sont affichés pour les opérations qui entraînent un échec et pour celles qui contiennent des informations de débogage. Il s'agit notamment des éléments suivants :
  • Échecs de lancement de campagne (lorsqu'une campagne passe à l'état "Fin du système")
  • Échecs de suppression d'ensemble d'accès
  • Échecs de chargement de données
  • Échecs de données clés
  • Échecs d'avis par courriel
  • Échecs de mesure corrective
  • Échecs d'ingestion
  • Journaux de diagnostic entrants et sortants

Activer le journal de service pour une ressource dans Oracle Access Governance

Vous pouvez activer les journaux de service pour une ressource, qui fait référence à une instance de service Oracle Access Governance.

Vous devez noter que la journalisation est configurée de manière distincte pour chaque instance de service. Cela implique que chaque instance de service d'un compartiment comporte sa propre entrée de journal de service distincte.

  1. Connectez-vous à la console Oracle Cloud Infrastructure avec un utilisateur affecté avec le rôle d'application Administrateur du contrôle d'accès.
  2. Ouvrez le menu de navigation Icône de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Journaux .
    La page Journaux s'affiche.
  3. Sous le panneau Portée de la liste, dans la liste Compartiment, sélectionnez un compartiment que vous êtes autorisé à utiliser.
  4. Sous le panneau Filtres, dans la liste Groupe de journaux, sélectionnez un groupe de journaux auquel placer le journal du service.
    Note

    Si aucun groupe de journaux n'existe, vous verrez une option pour en créer un à l'aide de la fonction Afficher les options avancées du panneau Activer le journal des ressources à l'étape 9.
  5. Cliquez sur Activer le journal de service. Le panneau Activer le journal des ressources s'ouvre.
    Activer le panneau du journal de la ressource
  6. Sous Sélectionner une ressource, configurez une ressource :
    1. La zone de liste Compartiment de la ressource est préalimentée avec le nom du compartiment sélectionné à l'étape 3.
    2. Dans la zone de liste Service, sélectionnez un service spécifique pour lequel vous voulez activer la journalisation du service. Par exemple, vous sélectionnez Access Governance.
    3. Dans la zone de liste Ressource, sélectionnez une ressource. Par exemple, AG1, qui est une instance du service Oracle Access Governance.
      Note

      La zone de liste Ressource affiche toutes les instances de service créées dans un compartiment. Par exemple, si un compartiment contient trois instances de service, les trois seront listées distinctement dans la zone de liste Ressource.
  7. Sous Configurer le journal, configurez le journal du service :
    1. Dans la zone de liste Catégorie de journal, sélectionnez Diagnostic.
    2. Dans le champ Nom du journal, spécifiez un nom pour le journal de service.
  8. Cliquez sur Afficher les options avancées pour configurer d'autres options pour le journal du service.
  9. Sous le panneau Emplacement du journal, configurez l'emplacement du journal :
    1. La zone de liste Compartiment est préalimentée avec le nom du compartiment sélectionné à l'étape 3.
    2. Dans Groupe de journaux, créez un nouveau groupe de journaux s'il n'existe pas en cliquant sur Créer un groupe. Dans le panneau Créer un groupe de journaux, entrez les valeurs suivantes :
      • Compartiment : Spécifie le compartiment dans lequel créer le groupe de journaux. Ce champ est préalimenté en fonction de votre choix de compartiment à l'étape 3.
      • Nom : Entrez un nom pour ce groupe de journaux.
      • Description : Entrez une description pour ce nouveau groupe de journaux.
      • Entrez les informations de marquage. Ce champ est facultatif.
      • Cliquez sur Créer.
  10. Dans la zone de liste Conservation des journaux, sélectionnez une valeur pour configurer la période de conservation des journaux.
  11. Appliquez toutes les informations relatives au marquage dans les champs Espace de noms de marqueur, Clé de marqueur et Valeur de marqueur pour organiser et lister les ressources en fonction des besoins de votre entreprise.
  12. Cliquez sur Activer le journal.

    La page Informations sur le journal s'affiche et affiche un message "Création du journal" pour indiquer que le journal est en cours de configuration. Attendez quelques minutes que le statut du journal soit mis à jour à Actif dans l'onglet Informations sur le journal.


    Page Informations sur le journal

Une fois que le journal de service a été activé et que son statut est Actif, la zone Explorer le journal devient visible, ce qui vous permet d'analyser efficacement les données du journal de service.

Vous disposez également de plusieurs options pour gérer les journaux de service une fois activés :
  • Désactiver le journal : Règle le statut du journal à INACTIF.
  • Modifier : Permet de modifier le nom du journal de service ou les paramètres de conservation des journaux.
  • Modifier le groupe de journaux : Déplace le journal de service vers un autre groupe de journaux.
  • Ajouter des marqueurs : Permet d'ajouter des marqueurs pour l'organisation de ressources.
  • Supprimer : Supprime le journal du service.

Voir les détails des journaux de service

Une fois la journalisation activée, cliquez sur le lien sous Nom du journal pour voir les détails du journal.

  1. Connectez-vous à la console Oracle Cloud Infrastructure avec un utilisateur affecté avec le rôle d'application Administrateur du contrôle d'accès.
  2. Ouvrez le menu de navigation Icône de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Journaux .
    La page Journaux s'affiche.
  3. Sous le panneau Portée de la liste, dans la zone de liste Compartiment, sélectionnez le compartiment contenant le journal souhaité que vous voulez voir.
  4. Cliquez sur le lien sous Nom du journal pour voir les détails du journal de service spécifique.

    La page des détails du journal s'ouvre et l'onglet Informations sur le journal est sélectionné.


    Onglet Informations sur le journal

  5. Dans la zone Explorer le journal, appliquez des filtres simples, tels que le tri par Newest ou Oldest dans le champ Trier ou le filtrage par période dans le champ Filtrer par période.

    Dans la zone Explorer le journal, un graphique à barres Nombre d'événements de journal par minute affiche le nombre d'événements de journal, selon les paramètres de filtre.

    En fonction des paramètres de filtre, les résultats de recherche des journaux sont générés. Chaque entrée de journal comporte trois colonnes d'en-tête interactives, qui correspondent à : l'horodatage du journal (datetime), le plugiciel où le journal a eu lieu (type) et le message de journal (data.message).


    Explorer la zone de journalisation

  6. Dans la zone Explorer le journal, sélectionnez l'une des options suivantes pour voir des informations détaillées sur le journal du service.
    1. Pour voir des informations détaillées sur une seule entrée de journal, cliquez sur la flèche vers le bas (icône flèche vers le bas) pour développer l'entrée de journal pour laquelle vous voulez voir les détails.

      La vue JSON s'affiche avec l'onglet JSON sélectionné.


      Vue JSON

      Dans la vue JSON, vous pouvez voir les champs et les valeurs des données de journal, réduire et développer des noeuds, ou cliquer sur l'icône de copie pour copier l'entrée de journal dans le presse-papiers.

    2. Pour voir ce journal dans la page Rechercher directement, cliquez sur le menu Actions et sélectionnez Explorer avec la recherche de journaux.

      La page Rechercher s'affiche avec le champ Sélectionner les journaux à rechercher préalimenté avec le filtre de journal courant. Vous pouvez maintenant effectuer une analyse détaillée de ce journal directement dans la page Rechercher.

Rechercher des journaux de service

Utilisez la page Rechercher du service de journalisation pour effectuer une analyse détaillée et effectuer une enquête sur les journaux de service, appliquer des filtres, visualiser les données des journaux, explorer les journaux dans la vue JSON et exporter les résultats de recherche.

Exemple : Considérons un scénario dans lequel une opération, telle que la création d'une campagne échoue, est indiquée par un message de statut "Fin du système" dans la console d'instance du service Oracle Access Governance. Pour voir les détails du journal correspondant à cette campagne dans la console OCI à l'aide du mode de base, procédez comme suit.

Pour rechercher des journaux, vous devez d'abord les activer.

Par défaut, les journaux sont indexés, ce qui vous permet de les rechercher au moyen de la console Oracle Cloud Infrastructure (OCI) à l'aide du mode de base avec des contrôles de filtre personnalisés ou du mode avancé avec une option d'interrogation personnalisée. Voir Recherche de journalisation pour en savoir plus sur les résultats de recherche et Visualisation des résultats de recherche pour plus d'informations sur la visualisation des recherches.

  1. Connectez-vous à la console Oracle Cloud Infrastructure avec un utilisateur affecté avec le rôle d'application Administrateur du contrôle d'accès.
  2. Ouvrez le menu de navigation Icône de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Rechercher .
    La page Rechercher s'affiche.
  3. Dans le panneau Rechercher, effectuez les tâches suivantes pour filtrer les détails du journal.
    1. Dans Sélectionner les journaux à explorer, le compartiment racine est déjà sélectionné par défaut pour le filtrage. Cliquez sur ce champ pour ouvrir le panneau Sélectionner les journaux à rechercher, où vous pouvez filtrer par compartiment, Groupes de journaux et Journaux.
    2. Dans la liste Filtrer par heure, sélectionnez un intervalle de temps prédéterminé pour limiter les résultats de la recherche. Vous pouvez également sélectionner Personnalisé pour spécifier un intervalle de dates dans les champs Date de début et Date de fin du calendrier.
    3. Dans la liste Filtrer par heure, sélectionnez un intervalle de temps prédéterminé pour limiter les résultats de la recherche. Vous pouvez également sélectionner Personnalisé pour spécifier un intervalle de dates dans les champs Date de début et Date de fin du calendrier.
    4. Dans le champ Filtres personnalisés, commencez à taper pour afficher les paramètres de filtre afin de créer une interrogation personnalisée. La saisie de 'd' affiche les filtres commençant par cette lettre. Sélectionnez un filtre prédéfini dans la liste ou entrez un critère de filtre spécifique.
      Note

      Les résultats de recherche sont chargés automatiquement lorsque vous appliquez des filtres. Par conséquent, vous n'avez pas à cliquer sur le bouton Rechercher chaque fois que vous mettez à jour les filtres. Toutefois, si un certain temps s'écoule et que de nouveaux journaux sont générés, vous devez cliquer de nouveau sur Rechercher pour extraire les dernières entrées.

      Exemple : Vous pouvez voir les détails du journal de service pour une campagne qui a été abandonnée avec un statut Fin du système dans la console d'instance du service Oracle Access Governance en définissant le filtre personnalisé suivant : data.logGroup='idm-agcs-caas-campaign' et data.state='SYSTEM_ABORTED' .

      Les données de journal sont chargées dans les onglets Explorer et Visualiser en fonction des paramètres de filtre.


      Page de recherche

  4. Dans l'onglet Explorer, sélectionnez l'une des options suivantes pour voir des informations détaillées sur le journal.
    1. Pour voir des informations détaillées sur une seule entrée de journal, cliquez sur la flèche vers le bas (icône flèche vers le bas) pour développer l'entrée de journal pour laquelle vous voulez voir les détails.

      La vue JSON s'affiche avec l'onglet JSON sélectionné.

    2. Pour examiner toutes les données de journal, dans l'onglet Explorer, cliquez sur le menu Actions, puis sélectionnez Développer les données de journal.

      Toutes les entrées de journal de votre recherche sont entièrement développées.

    Pour explorer les fonctions de consultation et de gestion des résultats de recherche dans la page Rechercher, voir Consultation et utilisation des résultats de recherche.