Erweiterte Konfigurationsoptionen für Management Agent

Mit der Konsole können Sie die Agent-Eigenschaften für die Log Analytics-Logerfassung auf verschiedenen Hierarchieebenen festlegen, wobei die Mandantenebene die höchste ist.

Sie können die Eigenschaften für die Logdateien manuell angeben, indem Sie die Konfigurationseigenschaften im Agent-Installationsordner bearbeiten.

Sie können diese Aufgabe für alle Logs mit Ausnahme der Windows-Ereignisse ausführen.

1. Wenn Sie die Eigenschaften auf bestimmte Muster und/oder Logquellen anwenden möchten, notieren Sie sich die Muster-ID und die Quellen-ID. Öffnen Sie die xml-Konfigurationsdatei unter dem Agent-Installationsordner agent_inst/state/laStorage/os_file/os_file.xml.

   • Beispiel für Muster-ID: <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Beispiel für Quellen-ID: <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

   Der Speicherort des Agent-Installationsordners hängt vom Quelltyp ab. Beispiel: Der Speicherort für SQL Database lautet agent_inst/state/laStorage/database_sql/database_sql.xml.

2. Bearbeiten sie die Eigenschaftendatei emd.properties im Verzeichnis agent_inst/config/emd.properties, und fügen Sie die folgende Eigenschaft ein, um die Standardkonfiguration von Oracle Log Analytics außer Kraft zu setzen:

   loganalytics.src.override_config=true
       

3. Geben Sie die Eigenschaften für die Zeitzone tz und die Zeichencodierung enc in der Datei emd.properties an, indem Sie eines der folgenden Beispiele auswählen:

   • Wenden Sie die Eigenschaften für alle Quellen und Muster an:

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

   • Wenden Sie die Eigenschaften nur für bestimmte Logquellen an:

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

     In diesem Beispiel werden die Eigenschaften der Zeitzone UTC und der Zeichencodierung EUC-JP für die Quelle -2574377491167724513 angewendet und Die Zeichencodierungseigenschaft UTF-8 für die Quelle -2574377491167724512.

   • Wenden Sie die Eigenschaften nur für bestimmte Muster an:

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

     In diesem Beispiel werden die Eigenschaften der Zeitzone UTC und der Zeichencodierung EUC-JP für das Muster 495071102827757094 angewendet und Die Zeichencodierungseigenschaft UTF-8 für das Muster 495071102827757095.

   • Wenden Sie die Eigenschaften nur für eine Kombination bestimmter Muster und Quellen an:

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

     In diesem Beispiel werden die Eigenschaften der Zeitzone UTC und der Zeichencodierung EUC-JP für Logs mit dem Muster 495071102827757094 und der Quelle -2574377491167724513 angewendet. die Zeichencodierungseigenschaft UTF-8 wird für Logs mit dem Muster 495071102827757095 und der Quelle -2574377491167724513 angewendet.

Sie können den SQL-Erfassungsplan für jede Datenbanklogquelle anpassen, indem Sie das Intervall in einer CSV-Datei in dem unten angegebenen Format angeben.

1. Navigieren Sie zum Management Agent- oder Oracle Cloud Agent-Installationsverzeichnis auf Ihrem Datenbankhost. Beispiel: agent_inst. Erstellen Sie im Agent-Installationsverzeichnis ein Verzeichnis laconfig.

2. Erstellen Sie im Verzeichnis laconfig eine CSV-Datei logan_schedule_database_sql_*.csv. Dies ist die Plankonfigurationsdatei.

3. Geben Sie in der Zeitplankonfigurationsdatei die Details des Quellplans im folgenden Format an:

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

   Die Headerzeile muss den vorgeschriebenen Inhalt aufweisen: NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR

   Geben Sie in den folgenden Zeilen den Zeitplan für jede Quelle an, einen pro Zeile.

   Die Headerzeilenparameter und ihre Werte:

   Headerzeilenparameter	Beschreibung	Zulässige Werte
   NAME	Der Name der in Oracle Log Analytics definierten Datenbanklogquelle.	Beliebig
   RECURRENCE_PATTERN_UNIT	Dies ist die Trittfrequenzeinheit der SQL-Collection, z.B. Minuten oder Tage. WEEK und MONTH können mehrere durch : getrennte Werte aufweisen	MIN: Minuten STUNDEN: Stunden TAG: Tage WEEK: Wochen MONAT: Monate
   RECURRENCE_PATTERN_VALUE	Der Wert der ausgewählten Mustereinheit.	MIN: Intervall 5 Min., 15 MIN. Stunden: Intervall 1 Stunde TAG: Tägliche Ausführung um 1 oder 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MONAT: Datum 1-31, LAST Tag des Monats
   START_HOUR	Die Startstunde für die SQL-Collection, z.B. 0100 Stunden oder 1200 Stunden. Wenn dieser Wert nicht angegeben ist, beginnt die SQL-Collection unmittelbar nach der Verknüpfung der Quell-Entity. Beachten Sie, dass auch wenn der Wert nicht angegeben ist, das vorherige Komma in der Zeile vorhanden sein muss, damit der Zeitplan gültig ist.	1 oder 12.

4. Starten Sie den Agent nach dem Speichern der CSV-Datei neu.

Einige der Beispielwerte für die Zeitplankonfiguration:

Ordner, die mehr als 10.000 Dateien enthalten, können eine hohe Ressourcennutzung (Speicher/Speicher/CPU) durch den Management Agent verursachen, was zu einer langsamen Logerfassung führen kann, sich auf andere Funktionen des Management Agent auswirkt und auch den Hostrechner verlangsamen kann.

Wenn vom Management Agent-Plug-in des Log Analytics-Plug-ins große Ordner gefunden werden, wird der Management Agent-Datei mgmt_agent_logan.log eine Meldung wie folgende Beispielmeldung hinzugefügt:

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.

Wenn Sie jedoch weiterhin Logs in großen Ordnern überwachen möchten, können Sie die Unterstützung aktivieren, indem Sie die folgenden Änderungen vornehmen.

Sie können die Konfigurationseigenschaft loganalytics.enable_large_dir im Agent-Installationsordner manuell in true bearbeiten, um die Erfassung von Logs aus Ordnern mit mehr als 10000 Dateien zu aktivieren. Der Eigenschaftswert lautet standardmäßig false.

Ändern Sie die Eigenschaftendatei emd.properties im Verzeichnis agent_inst/config/emd.properties, und fügen Sie den obigen Eigenschaftswert hinzu, um die Standardkonfiguration von Oracle Log Analytics außer Kraft zu setzen:

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

Ersetzen Sie INSTALL_DIRECTORY durch den Pfad zum Ordner agent_inst. Starten Sie den Management Agent neu, nachdem Sie die Datei emd.properties bearbeitet haben.

Möglicherweise müssen Sie einige Konfigurationsänderungen an Ihrem Host-Agent vornehmen, um diesen Support zu aktivieren. Testen Sie die neuen Einstellungen in einer Entwicklungs- oder Testumgebung, bevor Sie sie in Produktion nehmen. Bestimmen Sie die Erhöhung für die folgenden Faktoren, indem Sie sie in einer repräsentativen Umgebung testen. Die tatsächlich erforderliche Erhöhung hängt von Faktoren wie der Anzahl der Dateien, der Rate der Dateierstellung und den anderen Collection-Typen ab, die der Management Agent ausführt.

• Erhöhen Sie die Heap-Größe des Management Agent. Bei Verzeichnissen mit einer großen Anzahl von Dateien erhöht sich die erforderliche Heap-Größe mit der Anzahl der Dateien. Siehe Management Agent-Dokumentation.
• Stellen Sie sicher, dass genügend Plattenspeicherplatz und Inodes für die Verarbeitung der großen Anzahl von Statusdateien verfügbar sind, die der Management Agent möglicherweise behalten muss. Dies hängt vom Typ der verwendeten Logquelle und des verwendeten Parsers ab. Wenn Ihr Parser die Funktion "Header-Detail" verwendet, erstellt und speichert der Agent den Header in einer Cachedatei, solange die ursprüngliche Logdatei vorhanden ist.
• Stellen Sie sicher, dass die Betriebssystemeinstellung für die Anzahl der geöffneten Dateien den Management Agent beim Lesen des großen Ordners und möglicherweise einer großen Anzahl von Statusdateien unterstützen kann.

Verwenden Sie das Makro (?i) (Groß-/Kleinschreibung ignorieren) im Pfadmuster der Logdatei, um es in der Form zu interpretieren, in der die Groß-/Kleinschreibung nicht beachtet wird. Dies gilt für das Logdateipfadmuster, das in Logquellen des Typs Datei bereitgestellt wird.

Das Makro (?i) wird nur angewendet, wenn es sich am Anfang des Pfadelements befindet.

Betrachten Sie das Beispiel:

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

Im obigen Beispiel ist das Element des Pfads, das dem Makro folgt, FOO. Dies wird in der Form interpretiert, in der die Groß-/Kleinschreibung nicht beachtet wird.