Documentation Oracle Cloud Infrastructure

Création d'un journal

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

  • Les groupes de journaux sont des conteneurs logiques permettant d'organiser les journaux. Les journaux doivent toujours se trouver 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 droits d'accès requis pour les utiliser, reportez-vous à Gestion des groupes de journaux.

    1. Ouvrez le menu de navigation et sélectionnez Observation et gestion. Sous Journalisation, sélectionnez Journaux.
    2. Sous Portée de la liste, sélectionnez un compartiment dans lequel vous êtes autorisé à travailler.
    3. Cliquez sur Créer un journal personnalisé.
    4. Sur la page Créer un journal personnalisé, saisissez le nom du journal personnalisé. Evitez de saisir des informations confidentielles.
    5. Dans Compartiment, sélectionnez le compartiment dans lequel créer la connexion.
    6. Dans Groupe de journaux, sélectionnez un groupe de journaux dans lequel placer le journal personnalisé.
    7. Vous pouvez également cliquer sur Afficher les options supplémentaires et indiquer les valeurs suivantes :
      • Dans Conservation de journal, sélectionnez la durée de conservation du journal par incréments de 30 jours, jusqu'à un maximum de 180 jours.
        Remarque

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

        En outre, l'heure et la date futures auxquelles un journal ne sera plus disponible dépendent de l'heure et de la date exactes auxquelles vous avez créé le 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 pourra plus faire l'objet d'une recherche.

      • Sous Ajouter des balises, ajoutez des balises au journal en entrant un espace de noms de balise (pour une balise définie), une clé et une valeur.
    8. Cliquez sur Créer un journal personnalisé.
      Sur la page Créer une configuration d'agent, vous pouvez créer une configuration afin de définir les paramètres des données de journal associées (par défaut) ou l'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, le cas échéant, l'analyseur utilisé (Configurer les entrées de journal).
      • Si vous sélectionnez Créer une configuration, passez à l'étape suivante.
      • Si vous sélectionnez Ajouter une configuration ultérieurement, passez à l'étape 16.
    9. Entrez un nom et une description pour la configuration. Evitez de saisir 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 désigne un groupe d'instances que vous pouvez créer dans la fonctionnalité IAM de la console. Pour plus d'informations, reportez-vous à A propos des groupes dynamiques. Sélectionner un groupe dynamique dans la liste Groupe.
      • Groupe d'utilisateurs : le terme groupe d'utilisateurs fait référence à la fonctionnalité Groupes IAM de la console. Pour plus d'informations, reportez-vous à Gestion des groupes. Sélectionnez un groupe d'utilisateurs dans la liste Groupe.
    12. Pour ajouter d'autres groupes, cliquez sur + Un autre groupe d'hôtes.

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

      Remarque

      Au maximum, cinq groupes par configuration sont autorisés, et un hôte ne peut pas se trouver que dans cinq groupes différents.
    13. Sous Configuration d'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 :
      • Dans Journal d'événement Windows, saisissez un nom d'entrée et sélectionnez des canaux d'événement.
      • Pour Chemin de journal, entrez un nom d'entrée et un ou plusieurs chemins de fichier. Par exemple, /<chemin_journal>/<nom_journal>.

      Vous pouvez indiquer plusieurs chemins de fichier journal, séparés par une virgule (,). Pour plus d'informations, reportez-vous à 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>* }}

      Cliquez sur + Une autre entrée de journal pour ajouter d'autres entrées de journal personnalisées.

    14. Cliquez sur Options d'analyseur avancées. Dans le panneau Options d'analyseur avancées, sélectionnez un analyseur pour indiquer comment analyser le journal. Certains analyseurs nécessitent des entrées supplémentaires et ont plus d'options, selon le type choisi.

      Par exemple, pour JSON, vous devez sélectionner un type de temps dans la liste, tandis que vous pouvez éventuellement indiquer l'heure de l'événement et les paramètres de champ NULL. Pour REGEXP, vous pouvez indiquer l'expression régulière pour les journaux correspondants, ainsi que le format d'heure. Pour plus d'informations, reportez-vous à Analyseurs et entrées de journal.

      Important

      Le type d'analyseur NONE est requis, même si vous ne souhaitez pas spécifier de type d'analyseur particulier.
    15. Après avoir configuré les entrées de journal et l'analyseur, vous pouvez éventuellement indiquer des paramètres de balise.
    16. Cliquez sur Créer une configuration d'agent.

      L'objet de journal personnalisé est créé, avec la configuration d'agent associée (le cas échéant), qui extrait les données des instances et les propage 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 des commandes de la CLI, reportez-vous à Référence de ligne de commande.

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