È 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 questo task per tutti i log ad eccezione degli eventi di Windows.

1. Se si desidera applicare le proprietà a pattern e/o origini log specifici, 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 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 le proprietà tz del fuso orario e enc della codifica dei 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 del fuso orario e EUC-JP della codifica dei caratteri e la proprietà di codifica dei caratteri UTF-8 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 dei caratteri e la proprietà di codifica dei caratteri UTF-8 per il pattern 495071102827757095.

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

     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, per i log con il pattern 495071102827757094 e l'origine -2574377491167724513 vengono applicate le proprietà di codifica del fuso orario UTC e dei caratteri EUC-JP e la proprietà di codifica dei caratteri UTF-8 per i log con il pattern 495071102827757095 e l'origine -2574377491167724513.

È possibile personalizzare la pianificazione della raccolta SQL per ciascuna origine 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. Questo è il 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 ammessi
   NAME	Nome dell'origine log del database definita in Oracle Log Analytics.	Qualsiasi
   RECURRENCE_PATTERN_UNIT	Si tratta dell'unità di cadenza della raccolta 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. ORA: intervallo 1 ora DAY: esecuzione giornaliera alle ore 1 o 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MESE: data 1-31, ULTIMO giorno del mese
   START_HOUR	L'ora di inizio per la raccolta SQL, ad esempio 0100 ore o 1200 ore. Se questo valore non viene specificato, la raccolta SQL inizia immediatamente dopo l'associazione origine-entità. 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.

Se tuttavia 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 dei log dalle cartelle con più di 10000 file. Per impostazione predefinita, la 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.

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

• Aumentare la dimensione heap del Management Agent. Per le directory con un numero elevato di file, la dimensione heap richiesta aumenta con il numero di file. Vedere la documentazione di Management Agent.
• Accertarsi che lo spazio su disco e gli inodi siano sufficienti per gestire l'elevato numero di file di stato che il Management Agent potrebbe dover conservare. Dipende dal tipo di origine log e dal parser utilizzati. Se il parser utilizza la funzione Header-Detail, l'agente crea e memorizza l'intestazione in un file cache finché esiste 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 potenzialmente un numero 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. Si applica al pattern di percorso del 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.

Esempio:

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

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