Ingérer les journaux ODL (Oracle Diagnostic Logging)

Oracle Diagnostic Logging (ODL) est un format accepté à l'échelle de l'industrie pour l'écriture de messages de diagnostic dans des fichiers journaux. Le fichier journal peut être au format ODL text ou ODL XML. La plupart des composants Oracle Fusion Middleware, des produits Oracle Enterprise Performance Management System et d'autres applications Oracle écrivent des fichiers journaux de diagnostic au format ODL.

Oracle Logging Analytics fournit des sources de journaux définies par Oracle correspondant au format ODL pour prendre en charge plusieurs applications Oracle :

Source définie par Oracle Type d'entité

Journaux de diagnostic OHS FMW (V11)

Serveur HTTP Oracle

Journaux de diagnostic OHS FMW (V12)

Serveur HTTP Oracle

Journaux de contrôle du répertoire OID FMW

Oracle Internet Directory

Journaux du serveur du répartiteur de répertoire OID FMW

Oracle Internet Directory

Journaux du serveur de réplication de répertoire OID FMW

Oracle Internet Directory

Journaux du serveur de répertoire OID FMW

Oracle Internet Directory

Journaux de surveillance OID FMW

Oracle Internet Directory

Journaux de diagnostic Fusion Apps

Serveur WebLogic

Journaux FMW BI Publisher

Serveur WebLogic

Journaux FMW BI JBIPS

Serveur WebLogic

Journaux de diagnostic FMW WLS Server

Serveur WebLogic

Journaux de diagnostic d'Oracle VM Manager

Oracle VM Manager

Flux global pour la collecte des journaux ODL

Voici les tâches générales de collecte des informations de journal à partir de votre hôte :

Créer une source pour les journaux de diagnostic au format ODL

Les sources définissent l'emplacement des journaux de votre entité et la façon d'enrichir les entrées de journal. Pour démarrer la collecte continue des journaux au moyen des agents de gestion OCI, une source doit être associée à une ou plusieurs entités.

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Logging Analytics, cliquez sur Administration. La page Aperçu de l'administration s'ouvre.

    Les ressources d'administration sont répertoriées dans le volet de navigation de gauche sous Ressources. Cliquez sur Sources.

    La page Sources s'ouvre. Cliquez sur Créer une source.

  2. Dans le champ Nom, entrez le nom de la source.

    Au besoin, ajoutez une description.

  3. Dans la liste Type de source, sélectionnez le type Journalisation des diagnostics Oracle (ODL).

    Utilisez ce type pour les journaux qui suivent le format des journaux Oracle Diagnostics. Ils sont généralement utilisés pour les journaux de diagnostic d'Oracle Fusion Middleware et d'Oracle Applications.

  4. Cliquez sur le champ Type d'entité et sélectionnez le type d'entité pour cette source de journaux. Sélectionnez le type d'entité de votre source de journaux qui correspond le mieux à ce que vous allez surveiller. Évitez de sélectionner des types d'entité composite, par exemple Database Cluster. Sélectionnez plutôt le type d'entité Instance de base de données, car les journaux sont générés au niveau de l'instance.
  5. Cliquez sur le champ Analyseur et sélectionnez le nom de l'analyseur pertinent. For ODL source type, the only parser available is Oracle Diagnostic Logging Format.
  6. Dans les onglets Inclure et Exclure, entrez les informations suivantes :
    • Dans l'onglet Modèles inclus, cliquez sur Ajouter pour spécifier les modèles de nom de fichier pour cette source.

      Entrez le modèle de nom de fichier et sa description.

      Vous pouvez entrer des paramètres entre accolades {}, par exemple {AdrHome}, en tant que partie du modèle de nom de fichier. Oracle Logging Analytics remplace ces paramètres dans le modèle d'inclusion par les propriétés d'entité lorsque la source est associée à une entité. La liste des paramètres possibles est définie par le type d'entité. Si vous créez vos propres types d'entité, vous pouvez définir vos propres propriétés. Lorsque vous créez une entité, vous êtes invité à indiquer une valeur pour chaque propriété de cette entité. Vous pouvez également ajouter vos propres propriétés personnalisées par entité, si nécessaire. Toutes ces propriétés peuvent être utilisées en tant que paramètres ici dans les modèles inclus.

      Par exemple, pour une entité indiquée où la propriété {AdrHome} a la valeur /u01/oracle/database/, le modèle d'inclusion {AdrHome}/admin/logs/*.log sera remplacé par /u01/oracle/database/admin/logs/*.log pour cette entité spécifique. Chaque autre entité d'un même hôte peut avoir une valeur différente pour {AdrHome}, ce qui entraînerait la collecte d'un jeu de fichiers journaux complètement différent pour chaque entité.

      Vous ne pouvez associer une source à une entité que si les paramètres requis par la source dans les modèles ont une valeur pour l'entité indiquée.

      Vous pouvez configurer des avertissements dans la collecte de journaux pour vos modèles. Dans la liste déroulante Envoyer un avertissement, sélectionnez le cas dans lequel l'avertissement doit être émis :

      • Pour chaque modèle présentant un problème : Lorsque vous avez défini plusieurs modèles d'inclusion, un avertissement de collecte de journaux est envoyé pour chaque modèle de nom de fichier qui ne correspond pas.

      • Seulement si tous les modèles ont des problèmes : Lorsque vous avez défini plusieurs modèles d'inclusion, un avertissement de collecte de journaux ne sera envoyé que si tous les modèles de nom de fichier ne correspondent pas.

    • Vous pouvez utiliser un modèle exclu lorsqu'il existe des fichiers au même emplacement que celui que vous ne souhaitez pas inclure dans la définition de la source. Dans l'onglet Modèles exclus, cliquez sur Ajouter pour définir des modèles de noms de fichier journal qui doivent être exclus de cette source de journaux.

      Par exemple, il existe un fichier portant le nom audit.aud dans le répertoire que vous avez configuré en tant que source d'inclusion (/u01/app/oracle/admin/rdbms/diag/trace/). Dans le même emplacement, il existe un autre fichier portant le nom audit-1.aud. Vous pouvez exclure tous les fichiers ayant le modèle audit-*.aud.

  7. Cliquez sur Créer une source.