Documentation sur Oracle Cloud Infrastructure

Création d'un journal

Créez un journal contenant des informations de diagnostic critiques qui vous indiquent le rendement et l'accès de vos services Oracle Cloud Infrastructure (OCI).

Les groupes de journaux sont des conteneurs logiques permettant d'organiser les journaux. Les journaux doivent toujours être dans des groupes de journaux. Vous devez créer un groupe de journaux avant de créer un journal.

Pour plus d'informations sur les journaux et les autorisations requises pour les utiliser, voir Gestion des groupes de journaux.

    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é.
    4. Dans la page Créer un journal personnalisé, entrez le nom du journal personnalisé. Évitez d'entrer des informations confidentielles.
    5. Sélectionnez le compartiment dans lequel créer la connexion.
    6. Sous Groupe de journaux, sélectionnez un groupe de journaux existant dans lequel placer le journal personnalisé ou créez-en un.
    7. (Facultatif) Dans la section Marqueurs, ajoutez un ou plusieurs marqueurs au journal.

      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.

    8. Sélectionnez Afficher les options supplémentaires, puis sélectionnez la durée de conservation du journal, par incréments de 30 jours, jusqu'à un maximum de 180 jours :
      Note

      Si vous remplacez la période de conservation de six mois par un mois, tous les journaux datant de plus d'un mois ne seront plus accessibles. Par exemple, si vous passez d'un mois à six mois, les journaux ne seront pas disponibles après un mois et les anciens journaux de six mois ne seront pas disponibles.

      De plus, l'heure et la date futures auxquelles un journal n'est plus disponible dépendent de l'heure et de la date exactes de création du journal. Par exemple, si vous avez créé un journal le 21 juillet à 15:05 UTC avec une période de conservation de trois mois, le 19 octobre à 15:05 le journal ne sera plus interrogeable.

    9. Sélectionnez Suivant.
    10. Dans la page Créer une configuration d'agent, créez une configuration pour définir les paramètres des données de journal associées (valeur par défaut) ou ajoutez-les plus tard. La configuration de l'agent définit les instances auxquelles la configuration s'applique (groupes d'hôtes), les fichiers journaux obtenus et l'analyseur (le cas échéant) utilisé (Configurer les entrées de journal).
      • Si vous sélectionnez Ajouter une nouvelle configuration, passez à l'étape suivante.
      • Si vous sélectionnez Ajouter une configuration plus tard, passez à la dernière étape de cette tâche.
    11. Entrez un nom et une description pour la configuration. Évitez d'entrer des informations confidentielles.
    12. Sélectionnez le compartiment dans lequel créer la configuration.
    13. Sous Groupes d'hôtes, où vous définissez les machines virtuelles qui s'appliquent à cette configuration, sélectionnez l'une des options suivantes dans la liste Type de groupe :
      • Groupe dynamique : Le groupe dynamique fait référence à un groupe d'instances que vous pouvez créer dans la fonction IAM de la console. Pour plus d'informations, voir À propos des groupes dynamiques. Sélectionnez un groupe dynamique dans la liste Groupe.
      • Groupe d'utilisateurs : Le groupe d'utilisateurs fait référence à la fonction Groupes IAM de la console. Pour plus d'informations, voir Gestion des groupes. Sélectionnez un groupe d'utilisateurs dans la liste Groupe.
    14. Pour ajouter d'autres groupes, sélectionnez Ajouter un groupe d'hôtes.

      Vous pouvez ajouter une combinaison de types de groupe pour la configuration d'agent.

      Note

      Cinq groupes au maximum par configuration sont autorisés et un hôte peut être dans cinq groupes au maximum.
    15. Sous Configuration de l'agent, définissez le format des journaux (les journaux à surveiller) dans Configurer les entrées de journal. Sélectionnez l'une des options de la liste Type d'entrée, puis entrez les valeurs appropriées :
      • Pour journal d'événements Windows, entrez un nom d'entrée et sélectionnez un ou plusieurs canaux d'événement.
      • Pour Chemin d'accès au journal, entrez un nom d'entrée et un ou plusieurs chemins d'accès au fichier. Par exemple, /<log_path>/<log_name>.

      Vous pouvez spécifier plusieurs chemins d'accès au fichier journal, séparés par une virgule (,). Pour plus de renseignements, consultez la page https://docs.fluentd.org/input/tail#path.

      <source>
@type tail
tag 757261.oc_oslogs_linux
path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
 var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
path_key tailed_path
</source>
      Exemple de configuration :
      {{path C:\Program Files (x86)\<application>\<directory>*, 
 C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

      Sélectionnez Ajouter une entrée de journal pour ajouter d'autres entrées de journal personnalisées.

    16. Sélectionnez Afficher les options d'analyseur avancé, puis sélectionnez un analyseur pour spécifier comment analyser le journal. Certains analyseurs nécessitent des entrées supplémentaires et offrent plus d'options, selon le type choisi.

      Par exemple, pour JSON, vous devez sélectionner une valeur de Type de temps dans la liste, tandis que vous pouvez éventuellement spécifier des paramètres d'heure d'événement et de champ vide. Pour REGEXP, vous pouvez spécifier l'expression rationnelle pour la mise en correspondance des journaux, ainsi que le format d'heure. Pour plus d'informations, voir Entrées de journal et analyseurs.

      Important

      Le type d'analyseur Aucun est requis, même si vous ne voulez pas spécifier un type d'analyseur particulier.
    17. Sélectionnez Créer.

      L'objet de journal personnalisé est créé, ainsi que la configuration d'agent associée (s'il est spécifié), qui extrait les données des instances et les pousse dans l'objet de journal personnalisé.

  • Utilisez la commande oci logging log create et les paramètres requis pour créer un journal dans un groupe de journaux :

    oci logging log create --display-name display_name --log-group-id log_group_ocid --log-type log_type [OPTIONS]

    Pour obtenir la liste complète des paramètres et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Exécutez l'opération CreateLog pour créer un journal dans un groupe de journaux.