Documentation sur Oracle Cloud Infrastructure

Affichage des journaux d'application des noeuds gérés et des noeuds autogérés

Découvrez comment afficher les journaux des applications exécutées sur des noeuds gérés et des noeuds autogérés dans une grappe Kubernetes que vous avez créée à l'aide de Kubernetes Engine (OKE).

Après avoir créé une grappe à l'aide de Kubernetes Engine, vous pouvez utiliser Oracle Cloud Infrastructure Logging pour consulter et rechercher les journaux des applications qui s'exécutent sur les instances de calcul hébergeant les noeuds gérés et les noeuds autogérés de la grappe.

Avant de pouvoir collecter et analyser les journaux d'applications à l'aide d'Oracle Cloud Infrastructure Logging :

  • Vous devez avoir effectué les opérations suivantes :
    • Surveillance activée pour les instances de calcul hébergeant des noeuds gérés et des noeuds autogérés (voir Activation de la surveillance pour les instances de calcul).
    • Installez le logiciel Oracle Cloud Agent sur les instances de calcul hébergeant des noeuds gérés et des noeuds autogérés. L'agent vous permet de spécifier les journaux à collecter et comment les analyser. L'agent est installé par défaut dans les instances de calcul des noeuds gérés. Pour confirmer que l'agent est déjà installé, voir Vérifier l'installation de l'agent.
  • Vous devez avoir effectué les opérations suivantes :
    • Créé un groupe dynamique avec une règle qui inclut les instances de calcul hébergeant des noeuds gérés et des noeuds autogérés en tant qu'hôtes cibles (voir À propos des groupes dynamiques et Sélection d'hôtes cibles avec des groupes dynamiques). Par exemple :
      instance.compartment.id = 'ocid1.tenancy.oc1..<unique-id>'
    • Créé une politique pour le groupe dynamique avec un énoncé de politique permettant aux hôtes cibles du groupe dynamique de transmettre les journaux à Oracle Cloud Infrastructure Logging (voir Sélection d'hôtes cibles avec des groupes dynamiques). Par exemple :
      allow dynamic-group <dynamic-group-name> to use log-content in tenancy

      Notez que si un groupe dynamique ne se trouve pas dans le domaine d'identité par défaut, ajoutez le préfixe dynamic-group '<identity-domain-name>'/'<dynamic-group-name>' au nom du groupe dynamique avec le nom du domaine d'identité. Vous pouvez également spécifier le groupe dynamique à l'aide de son OCID, dans le format dynamic-group id <dynamic-group-ocid>.

Une fois les conditions requises ci-dessus satisfaites, vous pouvez définir des journaux personnalisés et des configurations d'agent associées pour consulter les journaux des applications des instances de calcul hébergeant des noeuds gérés et des noeuds autogérés. Notez que les journaux d'application doivent être générés dans le chemin d'accès au fichier que vous spécifiez lors de la création d'une configuration d'agent (généralement, mais pas nécessairement, /var/logs/containers). Pour plus d'informations sur les journaux personnalisés et les configurations d'agent, voir Journaux personnalisés.

Notez qu'en plus de consulter les journaux d'application des instances de calcul hébergeant des noeuds gérés et des noeuds autogérés, vous pouvez également :

Utilisation de la console

Pour définir un nouvel objet de journal personnalisé et une configuration d'agent associée afin de vous permettre de voir et de rechercher les journaux des applications exécutées sur des instances de calcul hébergeant des noeuds gérés et des noeuds autogérés dans une grappe :

  1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Journaux.
  2. Sélectionnez un compartiment que vous êtes autorisé à utiliser.
  3. Sélectionnez Créer un journal personnalisé pour créer un nouveau journal personnalisé.

  4. Dans la page Créer un journal personnalisé, spécifiez :

    • Nom du journal personnalisé : Nom de votre choix pour le nouveau journal personnalisé. Évitez d'entrer des informations confidentielles.
    • Compartiment: Compartiment dans lequel créer le nouveau journal.
    • Groupe de journaux : Groupe de journaux dans lequel placer le journal personnalisé. Vous pouvez sélectionner Créer un nouveau groupe pour créer un nouveau groupe de journaux (voir Journaux et groupes de journaux).
  5. Facultativement, sélectionnez Afficher les options supplémentaires et spécifiez :
    • Conservation des journaux : Durée (en mois) de conservation du journal personnalisé. Sélectionnez l'une des options prédéfinies, ou sélectionnez Heure personnalisée et spécifiez un nombre de mois de votre choix (jusqu'à 60).
    • Options de marquage : Si vous êtes autorisé à créer une ressource, vous disposez également des autorisations nécessaires pour appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.

  6. Sélectionnez Créer un journal personnalisé.

    Un nouveau journal personnalisé est créé et la page Créer une configuration d'agent s'affiche.

    Pour plus de commodité, les instructions ci-dessous décrivent comment créer une nouvelle configuration d'agent associée au nouveau journal personnalisé (bien que vous puissiez créer une nouvelle configuration d'agent plus tard si vous préférez).

  7. Dans la page Créer une configuration d'agent, sélectionnez Créer une nouvelle configuration et spécifiez :

    • Nom de la configuration : Nom de votre choix pour la nouvelle configuration d'agent. Évitez d'entrer des informations confidentielles.
    • Description : Description de la nouvelle configuration d'agent.
    • Compartiment : Compartiment dans lequel créer la nouvelle configuration d'agent.
  8. Dans le panneau Groupes d'hôtes de la page Créer une configuration d'agent, spécifiez :
    • Type de groupe : Sélectionnez Groupe dynamique.
    • Groupe : Groupe dynamique existant qui inclut les noeuds gérés des groupes de noeuds gérés de la grappe en tant qu'hôtes cibles. Le groupe dynamique que vous sélectionnez doit avoir l'autorisation d'accéder au compartiment que vous avez spécifié pour la configuration d'agent, et doit également permettre aux hôtes cibles de transmettre des journaux à Oracle Cloud Infrastructure Logging.

  9. Dans le panneau de Configuration d'agent de la page Créer une configuration d'agent, spécifiez :

    • Configurer les entrées de journal : Un ou plusieurs emplacements où se trouvent les journaux des applications utilisés en tant qu'entrées du journal personnalisé, comme suit :
      • Type d'entrée : Sélectionnez Chemin du fichier journal.
      • Nom d'entrée : Nom de votre choix pour la nouvelle entrée de journal.
      • Chemin d'accès aux fichiers : Chemin d'accès aux journaux d'application sur les instances de calcul hébergeant des noeuds gérés et des noeuds autogérés. Par exemple, généralement (mais pas nécessairement) /var/logs/containers/*
    • Sélectionner la destination de journal : Les options sont préalimentées avec les détails de journal personnalisé que vous avez spécifiés précédemment.
  10. Facultativement, sélectionnez Afficher les options supplémentaires et spécifiez :
    • Options de marquage : Si vous êtes autorisé à créer une ressource, vous disposez également des autorisations nécessaires pour appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
  11. Sélectionnez Créer une configuration d'agent pour créer la configuration d'agent associée au journal personnalisé.

Pour voir et rechercher le contenu d'un journal personnalisé créé pour une application s'exécutant sur des instances de calcul hébergeant des noeuds gérés et des noeuds autogérés dans une grappe :

  1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Journaux.
  2. Sélectionnez le nom du journal personnalisé que vous souhaitez consulter. Vous pouvez trier les entrées de journal par âge et les filtrer par heure.
  3. (Facultatif) Sélectionnez Actions et sélectionnez Explorer avec la recherche dans les journaux pour ouvrir la page de recherche centralisée dans les journaux. Vous pouvez appliquer des filtres et explorer et visualiser les données des journaux de différentes manières (voir Consultation des journaux personnalisés dans une instance de calcul).