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. Sous Portée de la liste, 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. Dans Compartiment, sélectionnez le compartiment que vous voulez créer.
    6. À partir du groupe de journaux, sélectionnez un groupe dans lequel placer le journal personnalisé.
    7. Facultativement, sélectionnez Afficher les options supplémentaires et indiquez les valeurs suivantes :
      • Dans Conservation des journaux, 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.

      • Sous Ajouter des marqueurs, ajoutez un ou plusieurs marqueurs au journal en entrant un espace de noms de marqueur (pour un marqueur défini), une clé et une valeur.
    8. Sélectionnez Créer un journal personnalisé.
      Dans la page Créer une configuration d'agent, vous pouvez créer une nouvelle configuration pour définir les paramètres des données de journal associées (valeur par défaut) ou les ajouter ultérieurement. La configuration d'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 Créer une nouvelle configuration, passez à l'étape suivante.
      • Si vous sélectionnez Ajouter une configuration plus tard, passez à l'étape 16.
    9. Entrez un nom et une description pour la configuration. Évitez d'entrer des informations confidentielles.
    10. Sélectionnez le compartiment dans lequel créer la configuration.
    11. 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.
    12. Pour ajouter d'autres groupes, sélectionnez + Un autre 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.
    13. Sous Configuration de l'agent, définissez le format des journaux (ce que vous voulez surveiller) dans Configurer les entrées de journal. Sélectionnez l'une des options de la liste Type d'entrée :
      • 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 + Une autre entrée de journal pour ajouter des entrées de journal personnalisées.

    14. Sélectionnez Options d'analyseur avancé et, dans le panneau Options d'analyseur avancé, 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.
    15. Après avoir configuré les entrées de journal et l'analyseur, vous pouvez éventuellement spécifier des paramètres de marqueur.
    16. Sélectionnez Créer une configuration d'agent.

      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.