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. Sélectionnez un compartiment dans lequel vous êtes autorisé à travailler.
    3. Sélectionnez Créer un journal personnalisée.
    4. Sur la page Créer un journal personnalisé, saisissez le nom du journal personnalisé. Evitez de saisir des informations confidentielles.
    5. Sélectionnez le compartiment de création de la connexion.
    6. Sous Groupes de journaux, sélectionnez le groupe de journaux existant dans lequel placer le journal personnalisé ou créez-en un.
    7. (Facultatif) Dans la section Balises, ajoutez des balises au journal.

      Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous disposez également de droits d'accès permettant d'appliquer des balises à format libre à cette ressource. Pour appliquer une balise définie, vous devez disposer des droits d'accès nécessaires pour utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.

    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 :
      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.

    9. Sélectionnez Suivant.
    10. Sur la page Créer une configuration d'agent, créez 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 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 ultérieurement, passez à la dernière étape de cette tâche.
    11. Entrez un nom et une description pour la configuration. Evitez de saisir 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 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.
    14. Pour ajouter des groupes, sélectionnez Ajouter un 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.
    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 :
      • 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>* }}

      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ées, puis sélectionnez un analyseur pour indiquer comment analyser le journal. Certains analyseurs nécessitent d'autres entrées et ont plus d'options, selon le type choisi.

      Par exemple, pour JSON, vous devez sélectionner une valeur type d'heure 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 à la rubrique Analyseurs et entrées du journal.

      Important

      Le type d'analyseur NONE est requis, même si vous ne souhaitez pas spécifier un type d'analyseur particulier.
    17. Choisissez Créer.

      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.