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 client étant le plus élevé.

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

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

1. Si vous souhaitez appliquer les propriétés sur des modèles et/ou des sources de journaux spécifiques, notez l'ID modèle et l'ID 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 modèle : <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Exemple d'ID 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. Spécifiez le fuseau horaire tz et les propriétés d'encodage de caractères enc dans le fichier emd.properties en sélectionnant l'un des exemples suivants :

   • Appliquer les propriétés pour toutes les sources et tous les modèles :

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

   • Appliquer les propriétés uniquement pour des sources de journaux 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'enregistrement de caractères EUC-JP sont appliquées pour la source -2574377491167724513 et la propriété d'enregistrement de caractères UTF-8 est appliquée pour la source -2574377491167724512.

   • Appliquer les propriétés uniquement pour 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'enregistrement de caractères EUC-JP sont appliquées pour le modèle 495071102827757094 et la propriété d'enregistrement de caractères UTF-8 est appliquée pour le modèle 495071102827757095.

   • Appliquer les propriétés uniquement pour 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 pour les journaux avec le modèle 495071102827757094 et la propriété d'encodage de source -2574377491167724513 et de caractères UTF-8 est appliquée pour les journaux avec le modèle 495071102827757095 et la source -2574377491167724513.

Vous pouvez personnaliser la programmation de la collecte SQL pour chacune de vos sources de journaux de base de données en spécifiant la périodicité dans un fichier CSV dans le format spécifié ci-dessous.

1. Naviguez jusqu'au répertoire d'installation de l'agent de gestion ou d'Oracle Cloud Agent sur l'hôte de votre 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. Il s'agit du fichier de configuration de programmation.

3. Dans le fichier de configuration du programme, fournissez les détails du programme source dans le format suivant :

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

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

   Dans les enregistrements suivants, indiquez l'échéancier pour chaque source, un par enregistrement.

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

   Paramètre de rangée d'en-tête	Description	Valeurs autorisées
   NAME	Nom de la source de journaux de base de données définie dans Oracle Logging Analytics.	N'importe quelle
   RECURRENCE_PATTERN_UNIT	Il s'agit de l'unité de fréquence de la collection 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 MOIS : 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 1 heure JOUR : Exécution quotidienne à 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 collection SQL, par exemple 0100 heures ou 1200 heures. Si cette valeur n'est pas spécifiée, la collection 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 rangée pour que la programmation 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 programme :

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 ralentir également la machine hôte.

Lorsque de grands dossiers sont détectés par le plugiciel Management Agent Logging Analytics, un message similaire à 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 voulez continuer à surveiller les journaux dans des 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 à true dans le dossier d'installation de l'agent pour activer la collecte des journaux des dossiers contenant plus de 10000 fichiers. Par défaut, la valeur 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 de configuration à 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épendra de facteurs tels que le nombre de fichiers, le taux de création des fichiers et les autres types de collecte que l'agent OMA effectue.

• Augmentez la taille du tas de l'agent OMA. Pour les répertoires comportant un grand nombre de fichiers, la taille du tas requis augmente avec le nombre de fichiers. Voir la documentation sur l'agent de gestion.
• Assurez-vous que l'espace disque et les inodes sont suffisants pour gérer le grand nombre de fichiers d'état que l'agent OMA doit conserver. Cela dépend du type de source de journaux et d'analyseur utilisé. Si votre 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 initial existe.
• Assurez-vous que le paramètre du système d'exploitation pour le nombre de fichiers ouverts peut prendre en charge la lecture par l'agent OMA du dossier volumineux et du nombre potentiellement important de fichiers d'état.

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

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

Prenons 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 une forme non sensible à la casse.