Opzioni di configurazione avanzate per Management Agent

È possibile utilizzare la console per impostare le proprietà dell'agente per la raccolta dei log di Log Analytics a vari livelli di gerarchia, poiché il livello tenant è il più alto.

È possibile specificare manualmente le proprietà per i file di log modificando le proprietà di configurazione nella cartella di installazione dell'agente.

È possibile eseguire questa attività per tutti i log ad eccezione degli eventi Windows.

1. Se si desidera applicare le proprietà su pattern specifici e/o origini log, prendere nota dell'ID pattern e dell'ID origine. Aprire il file xml di configurazione nella cartella di installazione dell'agente agent_inst/state/laStorage/os_file/os_file.xml.

   • Esempio di ID pattern: <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Esempio di ID di origine: <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

   La posizione della cartella di installazione dell'agente varia a seconda del tipo di origine. Ad esempio, la posizione è agent_inst/state/laStorage/database_sql/database_sql.xml per il database SQL.

2. Modificare il file delle proprietà emd.properties nella posizione agent_inst/config/emd.properties e aggiungere la proprietà seguente per sostituire la configurazione predefinita di Oracle Log Analytics:

   loganalytics.src.override_config=true
       

3. Specificare il fuso orario tz e le proprietà enc con codifica caratteri nel file emd.properties selezionando uno degli esempi riportati di seguito.

   • Applicare le proprietà per tutte le origini e i pattern:

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

   • Applicare le proprietà solo per origini log specifiche:

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

     In questo esempio, per l'origine -2574377491167724513 vengono applicate le proprietà UTC e EUC-JP con codifica caratteri e la proprietà UTF-8 con codifica caratteri viene applicata per l'origine -2574377491167724512.

   • Applicare le proprietà solo per pattern specifici:

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

     In questo esempio, per il pattern 495071102827757094 vengono applicate le proprietà UTC e EUC-JP con codifica caratteri e la proprietà UTF-8 con codifica caratteri viene applicata per il pattern 495071102827757095.

   • Applicare le proprietà solo per una combinazione di pattern e origini specifiche:

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

     In questo esempio, le proprietà UTC e EUC-JP con codifica caratteri vengono applicate ai log con il pattern 495071102827757094 e -2574377491167724513 di origine e la proprietà UTF-8 con codifica caratteri per i log con il pattern 495071102827757095 e l'origine -2574377491167724513.

È possibile personalizzare la pianificazione della collection SQL per ciascuna origine di log del database specificando la periodicità in un file CSV nel formato specificato di seguito.

1. Passare alla directory di installazione di Management Agent o Oracle Cloud Agent sull'host del database, ad esempio agent_inst. Creare una directory laconfig nella directory di installazione dell'agente.

2. Nella directory laconfig creare un file CSV logan_schedule_database_sql_*.csv. File di configurazione della pianificazione.

3. Nel file di configurazione della pianificazione, fornire i dettagli della pianificazione di origine nel seguente formato:

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

   La riga di intestazione deve avere il contenuto prescritto: NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR

   Nelle righe successive, specificare la pianificazione per ogni origine, una per riga.

   I parametri della riga di intestazione e i relativi valori:

   Parametro riga intestazione	Descrizione	Valori consentiti
   NAME	Nome dell'origine log del database definita in Oracle Log Analytics.	Qualsiasi
   RECURRENCE_PATTERN_UNIT	Si tratta dell'unità di cadenza della collection SQL, ad esempio minuti o giorni. SETTIMANA e MESE possono avere più valori separati da :	MIN: minuti ORA: ore DAY: giorni SETTIMANA: settimane MESE: mesi
   RECURRENCE_PATTERN_VALUE	Il valore dell'unità di pattern selezionata.	MIN: intervallo 5 MIN, 15 MIN HOUR: intervallo di 1 ora DAY: esecuzione giornaliera all'indirizzo 1 o 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MESE: data 1-31, ULTIMO giorno del mese
   START_HOUR	Ora di inizio per la raccolta SQL, ad esempio 0100 ore o 1200 ore. Se questo valore non viene specificato, la collection SQL inizia subito dopo l'associazione source-entity. Si noti che, anche se il valore non viene specificato, la virgola precedente deve essere presente nella riga affinché la schedulazione sia valida.	1 or 12.

4. Dopo aver salvato il file CSV, riavviare l'agente.

Alcuni valori di esempio per la configurazione della pianificazione:

Le cartelle contenenti più di 10.000 file possono causare l'uso elevato di risorse (memoria/archiviazione/CPU) da parte del Management Agent, il che può rallentare la raccolta dei log, influire su altre funzionalità del Management Agent e rallentare anche il computer host.

Quando il plugin Log Analytics di Management Agent rileva cartelle di grandi dimensioni, al file mgmt_agent_logan.log di Management Agent viene aggiunto un messaggio simile al seguente esempio:

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.

Tuttavia, se si desidera continuare a monitorare i log in cartelle di grandi dimensioni, è possibile abilitare il supporto apportando le modifiche riportate di seguito.

È possibile modificare manualmente la proprietà di configurazione loganalytics.enable_large_dir in true nella cartella di installazione dell'agente per abilitare la raccolta di log da cartelle con più di 10000 file. Per impostazione predefinita, il valore della proprietà è false.

Modificare il file delle proprietà emd.properties nella posizione agent_inst/config/emd.properties e aggiungere il valore della proprietà sopra riportato per sostituire la configurazione predefinita di Oracle Log Analytics:

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

Sostituire INSTALL_DIRECTORY con il percorso della cartella agent_inst. Riavviare il Management Agent dopo aver modificato il file emd.properties.

Potrebbe essere necessario apportare alcune modifiche alla configurazione sull'agente host per abilitare questo supporto. Provare le nuove impostazioni in un ambiente di sviluppo o di test prima di renderle in produzione. Determinare l'aumento per i seguenti fattori utilizzando un ambiente rappresentativo per testarli. L'aumento richiesto effettivo dipenderà da fattori quali il numero di file, il tasso di creazione dei file e gli altri tipi di raccolta che il Management Agent sta eseguendo.

• Aumentare le dimensioni dell'heap del Management Agent. Per le directory con un numero elevato di file, la dimensione dell'heap richiesta aumenta con il numero di file. Vedere Documentazione di Management Agent.
• Assicurarsi che siano disponibili spazio su disco e inodi sufficienti per gestire un numero elevato di file di stato che il Management Agent potrebbe dover conservare. Dipende dal tipo di origine log e parser utilizzati. Se il parser utilizza la funzione Intestazione-Dettaglio, l'agente crea e memorizza l'intestazione in un file cache purché esista il file di log originale.
• Assicurarsi che l'impostazione del sistema operativo per il numero di file aperti possa supportare il Management Agent che legge la cartella di grandi dimensioni e un numero potenzialmente elevato di file di stato.

Utilizzare la macro ignore-case (?i) nel pattern di percorso del file di log per interpretarla in formato senza distinzione tra maiuscole e minuscole. Applicabile per il pattern del percorso dei file di log fornito nelle origini log di tipo File .

La macro (?i) verrà applicata solo quando si trova all'inizio dell'elemento del percorso.

Si consideri l'esempio seguente:

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

Nell'esempio precedente, l'elemento del percorso che segue la macro è FOO. Questo viene interpretato in forma senza distinzione tra maiuscole e minuscole.