Vous pouvez utiliser la console pour définir les propriétés d'agent pour la collecte de journaux Logging Analytics à différents niveaux de hiérarchie, le niveau de locataire étant le plus élevé.

Vous pouvez spécifier manuellement les propriétés des fichiers journaux en modifiant les propriétés de configuration dans le dossier d'installation d'agent.

Vous pouvez effectuer cette tâche pour tous les journaux, à l'exception des événements Windows.

1. Si vous voulez appliquer les propriétés à des modèles et/ou à des sources de journal spécifiques, notez l'ID de modèle et l'ID de source. Ouvrez le fichier xml de configuration sous le dossier d'installation de l'agent agent_inst/state/laStorage/os_file/os_file.xml.

   • Exemple d'ID de modèle : <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Exemple d'ID de source : <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

   L'emplacement du dossier d'installation de l'agent varie en fonction du type de source. Par exemple, l'emplacement est agent_inst/state/laStorage/database_sql/database_sql.xml pour la base de données SQL.

2. Modifiez le fichier de propriétés emd.properties à l'emplacement agent_inst/config/emd.properties et ajoutez la propriété suivante pour remplacer la configuration par défaut d'Oracle Logging Analytics :

   loganalytics.src.override_config=true
       

3. Indiquez les propriétés de fuseau horaire tz et d'encodage de caractères enc dans le fichier emd.properties en sélectionnant l'un des exemples suivants :

   • Appliquez les propriétés à toutes les sources et à tous les modèles :

     loganalytics.src.addl_src_ptn_configs=tz=UTC,enc=EUC-JP

   • Appliquez les propriétés uniquement à des sources de journal spécifiques :

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,tz=UTC,enc=EUC-JP;srcid=-2574377491167724512,enc=UTF-8

     Dans cet exemple, les propriétés de fuseau horaire UTC et d'encodage de caractères EUC-JP sont appliquées à la source -2574377491167724513, et la propriété d'encodage de caractères UTF-8 est appliquée à la source -2574377491167724512.

   • Appliquez les propriétés uniquement à des modèles spécifiques :

     loganalytics.src.addl_src_ptn_configs=ptnid=495071102827757094,tz=UTC,enc=EUC-JP;ptnid=495071102827757095,enc=UTF-8

     Dans cet exemple, les propriétés de fuseau horaire UTC et d'encodage de caractères EUC-JP sont appliquées au modèle 495071102827757094, et la propriété d'encodage de caractères UTF-8 est appliquée au modèle 495071102827757095.

   • Appliquez les propriétés uniquement à une combinaison de modèles et de sources spécifiques :

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,ptnid=495071102827757094,tz=UTC,enc=EUC-JP;srcid=-2574377491167724513,ptnid=495071102827757095,enc=UTF-8

     Dans cet exemple, les propriétés de fuseau horaire UTC et d'encodage de caractères EUC-JP sont appliquées aux journaux avec le modèle 495071102827757094 et la source -2574377491167724513, et la propriété d'encodage de caractères UTF-8 est appliquée aux journaux avec le modèle 495071102827757095 et la source -2574377491167724513.

Vous pouvez personnaliser la programmation de collecte SQL pour chacune de vos sources de journal de base de données en indiquant la périodicité dans un fichier CSV au format indiqué ci-dessous.

1. Accédez au répertoire d'installation de l'agent de gestion ou de l'agent Oracle Cloud sur l'hôte de base de données, par exemple agent_inst. Créez un répertoire laconfig dans le répertoire d'installation de l'agent.

2. Dans le répertoire laconfig, créez un fichier CSV logan_schedule_database_sql_*.csv. Fichier de configuration du planning.

3. Dans le fichier de configuration du planning, indiquez les détails du planning source au format suivant :

   NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR
   <Source-Name>,DAY,1,1

   La ligne d'en-tête doit avoir le contenu prescrit : NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR

   Dans les lignes suivantes, indiquez la planification pour chaque source, une par ligne.

   Les paramètres de ligne d'en-tête et leurs valeurs :

   Paramètre de ligne d'en-tête	Description	Valeurs autorisées
   NAME	Nom de la source de journal de base de données définie dans Oracle Logging Analytics.	Tous
   RECURRENCE_PATTERN_UNIT	Unité de cadence de la collecte SQL, par exemple, minutes ou jours. SEMAINE et MOIS peuvent avoir plusieurs valeurs séparées par :	MIN : minutes HOUR : heures JOUR : jours SEMAINE : semaines MIS : mois
   RECURRENCE_PATTERN_VALUE	Valeur de l'unité de modèle que vous avez sélectionnée.	MIN : intervalle 5 MIN, 15 MIN HOUR : intervalle de 1 heure DAY : quotidien exécuté à 1 ou à 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MOIS : date 1-31, DERNIER jour du mois
   START_HOUR	Heure de début de la collecte SQL, par exemple, 0100 heures ou 1200 heures. Si cette valeur n'est pas indiquée, la collecte SQL commence immédiatement après l'association source-entité. Notez que, même si la valeur n'est pas spécifiée, la virgule précédente doit être présente dans la ligne pour que le planning soit valide.	1 ou 12.

4. Après avoir enregistré le fichier CSV, redémarrez l'agent.

Voici quelques exemples de valeurs pour la configuration du planning :

Les dossiers contenant plus de 10 000 fichiers peuvent entraîner une utilisation élevée des ressources (mémoire / stockage / CPU) par l'agent de gestion, ce qui peut ralentir la collecte des journaux, affecter d'autres fonctionnalités de l'agent de gestion et également ralentir la machine hôte.

Lorsque des dossiers volumineux sont détectés par le module d'extension de l'agent de gestion Logging Analytics, un message semblable à l'exemple suivant est ajouté au fichier mgmt_agent_logan.log de l'agent de gestion :

2020-07-30 14:46:51,653 [LOG.Executor.2388 (LA_TASK_os_file)-61850] INFO - ignore large dir /u01/service/database/logs. set property loganalytics.enable_large_dir to enable.

Toutefois, si vous souhaitez continuer à surveiller les journaux dans les dossiers volumineux, vous pouvez activer la prise en charge en apportant les modifications suivantes.

Vous pouvez modifier manuellement la propriété de configuration loganalytics.enable_large_dir en true dans le dossier d'installation de l'agent afin d'activer la collecte de journaux à partir de dossiers contenant plus de 10000 fichiers. La valeur par défaut de la propriété est false.

Modifiez le fichier de propriétés emd.properties à l'emplacement agent_inst/config/emd.properties et ajoutez la valeur de propriété ci-dessus pour remplacer la configuration par défaut d'Oracle Logging Analytics :

sudo -u mgmt_agent echo "loganalytics.enable_large_dir=true" >> INSTALL_DIRECTORY/agent_inst/config/emd.properties

Remplacez INSTALL_DIRECTORY par le chemin d'accès au dossier agent_inst. Redémarrez l'agent de gestion après avoir modifié le fichier emd.properties.

Vous devrez peut-être apporter des modifications à la configuration de votre agent hôte pour activer cette prise en charge. Essayez les nouveaux paramètres dans un environnement de développement ou de test avant de les mettre en production. Déterminez l'augmentation pour les facteurs suivants en utilisant un environnement représentatif pour les tester. L'augmentation réelle requise dépend de facteurs tels que le nombre de fichiers, le taux de création de fichiers et les autres types de collecte effectués par l'agent de gestion.

• Augmentez la taille de la portion de mémoire de l'agent de gestion. Pour les répertoires comportant un grand nombre de fichiers, la taille de portion de mémoire requise augmente avec le nombre de fichiers. Reportez-vous à la documentation de Management Agent.
• Assurez-vous que l'espace disque et les inodes sont suffisants pour gérer le grand nombre de fichiers d'état que l'agent de gestion peut avoir à conserver. Cela dépend du type de source de journal et d'analyseur utilisé. Si l'analyseur utilise la fonction Header-Detail, l'agent crée et stocke l'en-tête dans un fichier cache tant que le fichier journal d'origine existe.
• Assurez-vous que le paramètre du système d'exploitation pour le nombre de fichiers ouverts peut prendre en charge l'agent de gestion qui lit le grand dossier et potentiellement un grand nombre de fichiers d'état.

Utilisez la macro ignorant la casse (?i) dans le modèle de chemin du fichier journal pour l'interpréter sous la forme non sensible à la casse. Cela s'applique au modèle de chemin de fichier journal fourni dans les sources de journal de type Fichier.

La macro (?i) ne sera appliquée que lorsqu'elle est au début de l'élément du chemin.

Prenez l'exemple suivant :

/tmp/(?i)FOO/*.log

Dans l'exemple ci-dessus, l'élément du chemin qui suit la macro est FOO. Ceci est interprété sous la forme non sensible à la casse.