Imposta raccolta comandi sistema operativo

Prerequisiti per l'impostazione della raccolta dell'output del comando del sistema operativo

Prima di impostare la raccolta dei log, completare i task prerequisiti riportati di seguito.

• Creare uno script personalizzato composto dal comando del sistema operativo, il cui output può essere raccolto in Oracle Log Analytics come log. L'output dello script STDOUT viene inviato come payload dall'agente al cloud. Il payload STDOUT può essere una singola voce di log o più voci di log. Assicurarsi che il parser utilizzato nell'origine Oracle Log Analytics possa analizzarlo. Inoltre, lo script deve essere in grado di gestire le condizioni di errore e controllare i prerequisiti.

  Memorizzare lo script personalizzato nella cartella agent_inst/state/laStorage/os_cmd/scripts nella cartella di installazione dell'agente. Di conseguenza, il percorso assoluto per la memorizzazione dello script è:

  • Per Oracle Management Agent: /opt/oracle/mgmt_agent/agent_inst/state/laStorage/os_cmd/scripts
  • Per il plugin Oracle Cloud Agent- Management Agent: /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/state/laStorage/os_cmd/scripts

• Potrebbero essere necessarie autorizzazioni speciali per i file per eseguire comandi particolari nello script. Configurare manualmente tali autorizzazioni sull'host agente. Lo script e tutti gli altri comandi/script eseguiti dallo script devono disporre dell'autorizzazione execute per l'utente di Management Agent.

Flusso complessivo per la raccolta dei log dei comandi del sistema operativo

Di seguito sono riportati i task di alto livello per la raccolta dell'output di uno script dei comandi del sistema operativo.

• Installare Management Agent nell'host in cui si desidera eseguire gli script dei comandi del sistema operativo e generare l'output che deve essere raccolto in Oracle Log Analytics. Vedere Impostazione della raccolta di log continua mediante Management Agent.

• Creare un'entità per identificare l'host dell'agente in Oracle Log Analytics. L'entità deve trovarsi sullo stesso host del Management Agent in cui verrà eseguito lo script. Esecuzione del comando del sistema operativo remoto non supportata. In genere, l'entità viene creata automaticamente quando si installa il Management Agent. Vedere Creare un'entità per rappresentare la risorsa che invia il log.

• Creare un parser in grado di analizzare l'output dello script. Questo parser deve essere utilizzato nell'origine che verrà identificata nel passo seguente. Vedere Creare un parser.
• Identificare un'origine esistente o creare un'origine log di tipo OS, comando. Vedere Create an OS Command Source.
• Verificare se si desidera configurare la proprietà di raccolta agenti customized_schedule per impostare l'intervallo di raccolta della raccolta dei comandi del sistema operativo. Il valore predefinito è 30 seconds. È possibile aggiornare la pianificazione a livello di agente, di origine, di entità o di associazione utilizzando le proprietà di raccolta agenti. Vedere Proprietà agente che è possibile modificare e Modifica proprietà agente.

• Associare le entità all'origine creata in precedenza. Vedere Configura nuova associazione origine-entità.

  Al termine dell'associazione, l'agente avvia l'esecuzione del comando del sistema operativo su base periodica, lo STDOUT del comando viene raccolto come dati di log e i dati di log iniziano a fluire in Oracle Log Analytics.

• Visualizzare i dati di log in Log Explorer selezionando l'origine del comando del sistema operativo creata in precedenza. Vedere Filtrare i log in base agli attributi di origine.

Se i dati di log non sono stati visualizzati in Log Explorer al termine dell'impostazione, è possibile verificare la presenza di avvertenze per la raccolta degli agenti per eventuali problemi. Le seguenti avvertenze sono correlate in modo specifico alla raccolta di output del comando del sistema operativo:

• Errore di esecuzione dell'applicazione esterna: si è verificato un errore durante l'esecuzione dello script o il comando del sistema operativo non è supportato.

• Applicazione esterna non trovata: script non trovato, nessuna autorizzazione di lettura/esecuzione sullo script.

Vedere Visualizza avvertenze della raccolta agenti.

Fattori importanti da considerare durante l'impostazione della raccolta dei comandi del sistema operativo

• Negli script è possibile usare il percorso completo dei comandi; ad esempio, usare /bin/sudo anziché sudo.

• Gli script vengono eseguiti come lo stesso utente con cui viene eseguito il Management Agent. Ciò è importante durante la lettura o la scrittura di file nello script.

• L'output generato dallo script in Standard Out (STDOUT) e Standard Error (STDERR) viene raccolto come testo per estrarre le voci di log.

• Le seguenti parole o prefissi non sono supportati nel comando del sistema operativo o nel nome dello script: sh, bash, csh, zsh, ksh, dash, cmd

• I seguenti caratteri non sono supportati nel comando del sistema operativo o nel nome dello script: |, &, ;, >, <

• Le seguenti sequenze di attraversamento della directory padre non sono supportate nel comando del sistema operativo o nel nome dello script: /../ o \..\. Inoltre, il comando del sistema operativo non può terminare con /.. o \...

• La seguente variabile d'ambiente viene passata agli script dall'agente. È possibile utilizzare la variabile negli script.

  • LA_SOURCE_COMMAND_ID: ID pattern generato internamente del comando nell'origine log. Può essere utilizzato per distinguere tra istanze di script se lo stesso script viene fornito in più comandi.