Documentation sur Oracle Cloud Infrastructure

Options de configuration avancée pour l'agent de gestion

Modifier les propriétés de l'agent

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

Vous pouvez définir les propriétés de l'agent à l'un des niveaux suivants répertoriés dans l'ordre hiérarchique. Pour les instructions de navigation permettant de modifier les propriétés de l'agent, suivez le lien à côté du niveau.
Note

La valeur de propriété appliquée à un niveau supérieur s'applique à tous les niveaux inférieurs. La propriété d'agent définie au niveau inférieur est prioritaire si la même propriété est définie à plusieurs niveaux.

À tous les niveaux ci-dessus, naviguez jusqu'à la boîte de dialogue dans laquelle les propriétés d'agent pour ce type de source sont répertoriées en suivant les étapes de la section correspondante pour chaque type de niveau. Le tableau de la boîte de dialogue affiche la valeur courante de chaque propriété. Pointez le curseur de la souris sur l'icône d'informations icône d'informations pour savoir quelle est la valeur par défaut.

  • Dans le champ Nouvelle valeur, entrez la nouvelle valeur de la propriété à modifier. Assurez-vous que le type de données de la valeur est tel que spécifié. Pour la liste des propriétés que vous pouvez modifier pour chaque type de source et les types de données correspondants, voir Propriétés d'agent que vous pouvez modifier.

  • Pour remplacer la propriété par la valeur par défaut, cliquez sur l'icône de menu Actions Icône d'actions et sélectionnez Réinitialiser à la valeur par défaut.

  • Pour effacer la valeur courante de la propriété, cliquez sur l'icône de menu Actions Icône d'actions et sélectionnez Effacer la valeur courante. Si vous effacez la valeur courante, la nouvelle valeur est héritée. La nouvelle valeur s'affiche dans le tableau après avoir enregistré les modifications en cours et rouvert cette boîte de dialogue.

  • Enregistrez les modifications.

Modifier les propriétés de l'agent au niveau de la location

Les modifications que vous apportez à ce niveau seront répercutées sur les agents de la location.

  1. Naviguez jusqu'à la page Détails du service. Voir Voir les détails du service Log Analytics.

  2. À côté de Propriétés de collecte d'agent global, cliquez sur Modifier. La boîte de dialogue Modifier les propriétés de collecte d'agent global s'ouvre.

  3. Sélectionnez votre type de source. Selon le type de source sélectionné, les propriétés que vous pouvez modifier sont répertoriées dans le tableau.

Modifier les propriétés de l'agent au niveau de l'agent

Les modifications que vous apportez à ce niveau seront répercutées sur les entités et les sources gérées par l'agent spécifique.

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

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

    La page Entités s'ouvre. Filtrez les entités en spécifiant le type Agent de gestion.

    Les entités d'agent sont listées.

  3. Cliquez sur le nom de l'entité d'agent. La page Entity Details s'ouvre.

  4. À côté de Propriétés de collecte d'agent global, cliquez sur Modifier. Sélectionnez votre type de source. Les propriétés d'agent pouvant être modifiées pour ce type de source sont répertoriées dans le tableau.

Modifier les propriétés d'agent pour une source spécifique

Les modifications que vous apportez à ce niveau seront répercutées sur toutes les entités associées à cette source et les modèles de source.

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

  2. 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 l'icône de menu Actions Icône du menu Actions à côté de la source, puis sélectionnez Modifier.

    La page Modifier la source s'ouvre.

  3. Cliquez sur Afficher les propriétés de collecte de l'agent. Les propriétés d'agent pouvant être modifiées pour ce type de source sont répertoriées dans un tableau.

Modifier les propriétés de l'agent pour un modèle source créé par l'utilisateur

Les modifications apportées à ce niveau seront répercutées sur toutes les entités associées à cette source qui utilisent le modèle de source spécifique créé par l'utilisateur.

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

  2. 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 l'icône de menu Actions Icône du menu Actions à côté de la source, puis sélectionnez Modifier.

    La page Modifier la source s'ouvre.

  3. À côté du modèle créé par l'utilisateur de votre source, cliquez sur l'icône de menu Actions Icône d'actions et cliquez sur Modifier les propriétés de collecte. Les propriétés d'agent pouvant être modifiées pour ce type de source sont répertoriées dans un tableau.

Modifier les propriétés d'agent pour une entité

Les modifications que vous apportez à ce niveau vont refléter l'entité d'agent spécifique et les associations de l'entité d'agent avec les sources.

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

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

    La page Entités s'ouvre. Filtrez les entités en spécifiant le type Agent de gestion.

    Les entités d'agent sont listées.

  3. Cliquez sur l'icône de menu Actions Icône d'actions à côté du nom de l'entité d'agent et cliquez sur Modifier. La boîte de dialogue Edit Entity s'ouvre.

  4. Cliquez sur Afficher les propriétés de collecte de l'agent. Sélectionnez votre type de source. Les propriétés d'agent pouvant être modifiées pour ce type de source sont répertoriées dans le tableau.

Modifier les propriétés de l'agent au niveau de l'association source-entité

Les modifications que vous apportez à ce niveau seront répercutées sur l'entité d'agent spécifique associée à la source.

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

  2. 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 le nom de la source pour ouvrir la page des détails de la source.

    Les entités d'agent associées à la source sont répertoriées dans le tableau.

  3. Cliquez sur l'icône de menu Actions Icône d'actions à côté du nom de l'entité d'agent et cliquez sur Modifier l'association. La boîte de dialogue Modifier l'association s'ouvre.

  4. Cliquez sur Afficher les propriétés de collecte de l'agent. Les propriétés d'agent pouvant être modifiées pour ce type de source sont répertoriées dans le tableau.

Propriétés d'agent que vous pouvez modifier

Propriété Type de source pris en charge Type de données Niveaux applicables Description Intervalle de valeurs
Fuseau horaire Fichier, base de données, journal de diagnostic Oracle (ODL), API REST Chaîne Tous les niveaux Valeur de fuseau horaire dans les formats pris en charge par java.util.TimeZone; Exemple : GMT. Si cette propriété n'est pas fournie, l'agent tente de la déterminer à partir du contenu du fichier journal. Sinon, il récupère le fuseau horaire de l'agent (qui est GMT par défaut). Valeur de fuseau horaire dans les formats pris en charge par java.util.TimeZone
Métadonnées Fichier, base de données, journal de diagnostic Oracle (ODL), API REST, module d'écoute Syslog JSON Tous les niveaux Métadonnées à attacher à chaque entrée de journal; Exemple : {"accounts":["hr", "finance"], "status":["enabled"]} Maximum 1024 caractères
Activer la surveillance des grands répertoires Fichier, journal de diagnostic Oracle (ODL) Boolean Locataire, agent Activer le traitement des répertoires volumineux; Exemple : false -
Encodage du jeu de caractères Fichier, journal de diagnostic Oracle (ODL) Chaîne Tous les niveaux Jeu de caractères pour le contenu du journal; Exemple : UTF-8. Si cette propriété n'est pas fournie, l'agent tente de la déterminer à partir du contenu du fichier journal. Nom canonique de l'API java.nio par Java 8. Voir Encodages pris en charge.
SQLNET.ALLOWED_LOGON_VERSION Base de données Chaîne Locataire, agent, entité Exemple : 12 Valeurs valides : 8, 12
Anciens jours maximum Base de données Entier Tous les niveaux Nombre maximal d'anciennes rangées à extraire dans un cycle de collecte de journaux; Exemple : 1000000 Nombre positif incluant zéro
Fenêtre de temps de nettoyage du statut API REST Entier Locataire, agent Fenêtre de temps indiquant la quantité d'anciens fichiers d'état à nettoyer; Format : ISO 8601; Exemple : P7D. Supérieur à zéro
Données historiques API REST Chaîne Locataire, agent, entité

Heure représentant le nombre d'enregistrements plus anciens à extraire; Format : ISO 8601; Exemple : P30D.

Si seul un nombre est indiqué, l'agent prend par défaut la valeur Jours. Exemple : 30 prend par défaut la valeur 30d.

Les données historiques peuvent être fournies en tant qu'entité au niveau de la règle de journal

Pour spécifier le nombre de jours de collecte des données au cours des 30 jours précédents : 30d. Vous pouvez également spécifier les heures (h) et les minutes (m). Exemple : 12h, 30m. Vous pouvez également indiquer l'horodatage exact dans le format "yyyy-MM-dd'T'HH:mm:ss.SSSZ". Exemple : 2001-07-04T12:08:56.100-0700
Activer le filtre des enregistrements en double API REST Boolean Tous les niveaux Activer le filtrage des doubles; Exemple : true. -
Longueur maximale d'enregistrement de journal Module d'écoute Syslog Entier Tous les niveaux Longueur maximale du journal des messages syslog en kilo-octets; Exemple : 64. 1-640

Spécifier manuellement le fuseau horaire et l'encodage des caractères pour les fichiers

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 Log 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'écriture de caractères EUC-JP sont appliquées pour la source -2574377491167724513 et de génération de caractères UTF-8 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'écriture de caractères EUC-JP sont appliquées pour le modèle 495071102827757094 et la propriété d'écriture de caractères UTF-8 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'écriture de caractères EUC-JP sont appliquées pour les journaux avec le modèle 495071102827757094 et la propriété d'écriture de source -2574377491167724513 et de caractères UTF-8 est appliquée pour les journaux avec le modèle 495071102827757095 et la source -2574377491167724513.

Configurer le programme de collecte SQL pour la base de données

Vous pouvez personnaliser le programme de 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 la 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 du programme.

  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'horaire 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 Log Analytics.

    N'importe quelle

    RECURRENCE_PATTERN_UNIT

    Il s'agit de l'unité de cadence de la collecte SQL, par exemple minutes ou jours.

    SEMAINE et MONTH peuvent avoir plusieurs valeurs séparées par :

    • MIN : minutes
    • Heure : heures
    • JOUR : jours
    • SEMAINE : semaines
    • MOIS : mois

    RECURRENCE_PATTERN_VALUE

    Valeur de l'unité de modèle 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
    • MONTH : date 1-31, LAST 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 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 :

Contenu de la rangée source Description

<Source-Name>,MIN,5,

Programmez l'interrogation SQL toutes les 5 minutes à partir du temps d'association source-entité.

<Source-Name>,HOUR,1,

Programmez l'interrogation SQL toutes les heures à partir de l'heure d'association source-entité.

<Source-Name>,DAY,1,1

Programmez l'interrogation SQL tous les jours à une heure système de 0100 heures.

<Source-Name>,DAY,1,12

Programmez l'interrogation SQL tous les jours à une heure système de 1200 heures.

<Source-Name>,WEEK,FRI,1

Programmez l'interrogation SQL chaque semaine le vendredi à 0100 heures, heure système.

<Source-Name>,WEEK,WED:THU,1

Programmez l'interrogation SQL chaque semaine, le mercredi et le jeudi, à une heure système de 0100 heures.

<Source-Name>,MONTH,7,1

Programmez l'interrogation SQL tous les mois à la date 7 à 0100 heures, heure système.

<Source1-Name>,MIN,5,

<Source2-Name>,DAY,1,1

Associez d'abord Source1 à l'entité et attendez que la collecte de journaux commence, puis mettez à jour la configuration en ajoutant l'association de Source2 à la même entité

Activer la collecte de journaux à partir de dossiers volumineux

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

Lorsque de grands dossiers sont détectés par le plugiciel Log Analytics de l'agent de gestion, 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.
Note

Nous vous recommandons d'éviter d'utiliser de grands dossiers. Utilisez un mécanisme de nettoyage pour supprimer les fichiers peu de temps après leur collecte afin que l'agent de gestion dispose de suffisamment de temps pour les collecter à nouveau.

Toutefois, si vous voulez continuer à surveiller les journaux dans des dossiers volumineux, vous pouvez activer le soutien 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 de journaux à partir de 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 la propriété ci-dessus pour remplacer la configuration par défaut d'Oracle Log 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 de fichiers et les autres types de collecte que l'agent de gestion effectue.

  • 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 la portion de mémoire requise 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és. 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 d'origine 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 de gestion du dossier volumineux et éventuellement d'un grand nombre de fichiers d'état.

Utiliser la macro pour une correspondance non sensible à la casse du chemin d'accès au fichier journal

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

La macro (?i) ne sera appliquée que lorsqu'elle est 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.

Note

Si la valeur d'une propriété contient le caractère de barre oblique /, veillez à utiliser correctement la macro ignore-case. Par exemple, si la propriété d'entité est logdir=/tmp/logs/, que le modèle de chemin d'accès au fichier de source de journaux est (?i){logdir}/foo.log et que la macro ignore-case y est appliquée, le modèle de chemin d'accès au fichier de source de journaux est interprété comme (?i)/tmp/logs/foo.log, ce qui n'est pas le résultat souhaité.

Dans ce cas, ajoutez plusieurs propriétés qui ne sont pas sensibles à la casse et créez le chemin du modèle de journal à partir de celles-ci à l'aide de la macro ignore-case.