Oracle Logging Analytics consente di selezionare ed eseguire una ricerca utilizzata di recente. Quando si fa clic sul campo Cerca o si immette testo nel campo Cerca, Oracle Logging Analytics visualizza una lista di ricerche utilizzate di recente. Ciò consente di accedere rapidamente ai comandi di ricerca utilizzati di recente. È possibile selezionare uno qualsiasi dei comandi elencati e fare clic su Esegui per eseguire il comando di ricerca selezionato.

L'interfaccia utente di Oracle Logging Analytics consente di formulare la query di ricerca.

È possibile utilizzare i seguenti elementi dell'interfaccia utente per formulare la query di ricerca:

• Barra di ricerca: la query di ricerca viene visualizzata qui. È possibile modificare direttamente il testo in questo campo per perfezionare ulteriormente i risultati della ricerca.

  La barra di ricerca cresce o si riduce in base al numero di righe aggiunte alla query. Può avere un massimo di 21 righe e un minimo di 1 riga. Di seguito sono riportati alcuni dei collegamenti personalizzati disponibili.

  • Ctrl + i: consente di rientrare ogni riga di testo presente nell'editor. Tenere presente che la lettera maiuscola I apre il debugger.
  • Ctrl + Enter: esegue la query visualizzata nell'editor
  • Ctrl + Space: visualizza la lista di opzioni completata automaticamente in base alla posizione del cursore
  • Ctrl + Z: annulla l'ultima modifica
  • Ctrl + Y: Ripete l'ultima modifica
  • Ctrl + D: elimina la riga corrente

  Nota: non utilizzare il tasto SHIFT se non specificato.

  Posizionare il cursore tra parentesi aperte o di chiusura per visualizzare l'elemento corrispondente evidenziato. Gli elementi che possono essere evidenziati sono ( ) e [ ].

  La barra di ricerca supporta due temi diversi, il colore e la scala di grigi. È possibile modificare i temi in modo dinamico modificando l'opzione nel popup della Guida.

• Campo: il pannello Campo è diviso nelle seguenti sezioni:

  • Gli attributi Pinnati consentono di filtrare i dati di log in base ai seguenti elementi:

    • Origini di log, ad esempio log del database, log di Oracle WebLogic Server e così via.

    • Entità di log, ovvero i nomi effettivi dei file di log.

    • Etichette, che sono tag aggiunte alle voci di log quando le voci di log corrispondono a condizioni definite specifiche.

    • Carica i nomi dei dati di log caricati su richiesta.

    Per impostazione predefinita, le entità e i dettagli della raccolta sono disponibili nel bucket con pin del pannello Campi per l'applicazione dei filtri. È possibile fissare campi aggiuntivi al bucket appuntato in base all'utilizzo. Una volta appuntati, i campi vengono spostati nel bucket appuntato. È possibile sbloccare qualsiasi campo e rimuoverlo dal bucket bloccato e spostarlo di nuovo nel bucket Interessante o Altro.

  • In base alla ricerca e alle query, Oracle Log Analytics aggiunge automaticamente campi al bucket Interesse per riferimento rapido. È possibile fissare un campo disponibile nel bucket Interessante. Il campo appuntato viene quindi spostato nel bucket appuntato.

  • È possibile fissare in memoria qualsiasi campo nel bucket Altro e spostarlo nel bucket appuntato. Se si utilizza un campo dell'altro bucket nella ricerca o nella query, il bucket viene spostato nel bucket Interessante.

    Le opzioni selezionate vengono aggiunte automaticamente alla query nella barra Cerca.

• Visualizza: in questo riquadro è possibile selezionare la modalità di visualizzazione dei risultati della ricerca. Nel campo Raggruppa per è possibile decidere le metriche in base alle quali raggruppare i risultati.

• Salva: utilizzare questo pulsante per salvare la query di ricerca attualmente presente nel campo Cerca, da eseguire in un secondo momento.

• Apri: utilizzare questo pulsante per visualizzare le query di ricerca salvate in precedenza. È possibile eseguire queste query e ottenere i risultati correnti oppure utilizzare queste query per creare dashboard.

• Nuovo: utilizzare questo pulsante per avviare una nuova query di ricerca.

• Esporta: utilizzare questo pulsante per esportare il risultato della query di ricerca corrente in un file in formato Comma-seperated Values(CSV) o JavaScript Object Notation(JSON).

• Esegui: utilizzare questo pulsante per eseguire la query attualmente presente nel campo Cerca.

• Selettore tempo: utilizzare il selettore ora per specificare il periodo di tempo.

• Riquadro di visualizzazione: in questo riquadro vengono visualizzati i risultati della query di ricerca. Le informazioni filtrate in questo riquadro vengono caricate quando viene eseguita la query nel campo Cerca. Facendo clic su un'area qualsiasi del grafico nel riquadro di visualizzazione, è possibile eseguire il drill-down della query di ricerca e aggiornarla.

Le query di stringa possono includere parole chiave e frasi. Una parola chiave è una singola parola (ad esempio, database), mentre una frase si riferisce a più parole, racchiusa tra virgolette singole (‘ ‘) o doppie (“ “) (ad esempio, ‘database connection’). Se si specifica una parola chiave o una frase nella query, dopo l'esecuzione della query vengono restituite tutte le voci di log contenenti la parola chiave o la frase specificata.

Il linguaggio di ricerca di Oracle Logging Analytics supporta anche il mapping di pattern speciale. In altre parole, è possibile utilizzare caratteri jolly, ad esempio asterisco (*), punto interrogativo (?) e percentuale (%), per completare le parole chiave.

La tabella riportata di seguito elenca i caratteri jolly supportati e fornisce una breve descrizione di ciascuno di essi.

È possibile specificare più parole chiave. Ad esempio, database e connection. Vengono restituiti i log contenenti le parole database e connection (ma non necessariamente insieme). Tuttavia, queste parole non devono necessariamente avvenire consecutivamente. Tuttavia, racchiudendo le parole tra virgolette e includendole nella stringa di query come frase (‘database connection’, ad esempio), vengono restituiti solo i log contenenti la frase ‘database connection’. Per informazioni sull'utilizzo di più parole chiave, vedere Uso delle espressioni booleane.

Quando si specifica una parola chiave o una frase, tenere presente quanto riportato di seguito.

• Per le parole chiave e le stringhe di frase non viene fatta distinzione tra maiuscole e minuscole.

• Le parole chiave non racchiuse tra virgolette devono contenere solo caratteri alfanumerici, il carattere di sottolineatura (_) e i caratteri jolly (*, % e ?).

• Le ricerche con parole chiave in cui la sottostringa potrebbe essere interpretata come una direttiva separata devono essere specifiche tra virgolette. Ad esempio, per cercare la stringa and, sarà necessario immetterla tra apici (‘and’) per evitare che il sistema riprenda il significato booleano.

ORA-* AND message LIKE 'connection* error*'

ORA-* AND message LIKE IN ('tablesp*','connection* error*')

Gli operatori di confronto sono condizioni specificate per stabilire una relazione tra un campo e il relativo valore. I campi senza valori vengono considerati nulli.

La tabella seguente elenca gli operatori di confronto supportati e fornisce una breve descrizione di ciascuno di essi.

Utilizzare questi operatori per trovare i log con campi con valori specifici. Ad esempio, specificare Severity=’ERROR’ per eseguire la ricerca nei log disponibili in cui il valore del campo Severity è ERROR. Analogamente, Severity!=NULL restituisce tutti i log in cui il valore del campo Severity non è nullo, ovvero in cui è stata specificata la severità.

La funzione di ricerca di Oracle Logging Analytics dispone delle funzionalità LIKE e REGEX, in base alle convenzioni standard. Le espressioni booleane possono avere un valore true o false.

Nella tabella seguente sono elencate le espressioni booleane supportate, insieme a una breve descrizione di ciascuna.

Il linguaggio di ricerca di Oracle Logging Analytics supporta la nidificazione delle espressioni booleane in altre espressioni booleane. Considerare ad esempio la seguente query:

fatal ('order' OR host LIKE '*.oracle.com')

L'esecuzione di questa query restituisce tutti i log che contengono fatal e contengono la parola chiave order oppure provengono da un host il cui nome termina con .oracle.com.

È possibile utilizzare l'interfaccia utente di Oracle Logging Analytics per formulare la query di ricerca.

Per impostazione predefinita, la query * | stats count by ‘log source’ viene specificata nel campo Cerca.

In genere, l'intervallo di tempo selezionato in Log Explorer non è incluso nella stringa di query. È possibile specificare l'intervallo di tempo nella query utilizzando il modificatore tempo assoluto o tempo relativo nel comando search.

Alcuni esempi in cui è possibile specificare un intervallo di tempo nella query:

• Restituisce tutti i log degli errori ORA-600 trovati nelle ultime 24 ore:

  Message like 'ORA-600%' and time > dateRelative(24h)

• Restituisce il conteggio di log per la destinazione host myHost negli ultimi 90 giorni.

  'Host Name (Server)' = myHost and Time > dateRelative(90day) | stats count as 'Num Host Logs'

time between '2014-07-15T16:24:51.000Z' and '2014-07-17T18:14:16.000Z'

time between toDate('2014-07-12', 'yyyy-MM-dd') and toDate('2014-07-15', 'yyyy-MM-dd')

time between * AND dateRelative(12h)

time > dateRelative(12h)

time > dateRelative(30min, hour)

time < dateAdd(toDate('2014-07-22', 'yyyy-MM-dd'), day, -10)

time > dateSet(toDate('2015-08-10', 'yyyy-MM-dd'), year, 2010, month, 6)

Le subquery consentono alla query figlio di fornire un filtro dinamico alle relative query padre. Le subquery vengono valutate per prime e il risultato viene quindi utilizzato nella query padre.

• È possibile nidificare le subquery l'una all'altra e una particolare query con più subquery allo stesso livello.
• Per impostazione predefinita, le subquery ereditano l'intervallo di tempo globale, ma è possibile eseguirne l'override utilizzando la sintassi time between T1 and T2, se necessario.
• Le subquery sono limitate a restituire solo le prime 2000 corrispondenze come input al relativo padre. Altri risultati vengono troncati.
• Hanno un timeout massimo di 30 secondi da completare.
• Tutti i campi restituiti da una subquery devono corrispondere ai campi della query padre per nome. Altrimenti, si verificherà un errore.
• È possibile utilizzare le subquery solo all'interno di un comando di ricerca.
• È possibile utilizzare tutti i comandi all'interno di una subquery, ad eccezione di cluster, clustersplit, clustercompare, fieldsummary, delete, classify, highlight e highlightrows.

Esempi:

• Eseguire il grafico del traffico dalla lista di esclusione IP nel tempo:

  [searchlookup table=ip_blacklist | distinct ip | rename ip as 'host address'] | timestats count

• Elenca i prodotti più acquistati per i primi utenti di un sito di e-commerce:

  'Log Source'='WLS Access Logs' status=200 action=purchase ['Log Source'='WLS Access Logs' status=200 action=purchase | stats count by 'Host (Client Address)' | top limit=1 'Host(Client Address)' | fields -*, 'Host (Client Address)'] | lookup table=products select 'product name' using productid | stats count, distinctcount(productId), unique('product name') by 'Host (Client Address)'

• Trova i primi 4 ID processo del sistema operativo con la somma più alta:

  [ *|stats sum('OS Process ID') as OSprocessidSum by 'OS Process ID' | top 4 OSprocessidSum | fields -OSprocessidSum ] | stats count by 'OS Process ID', 'Log Source', 'Host Name(Server)'

• Visualizzare tutti i log della destinazione con i log di severità più irreversibili:

  * and [ Severity = fatal | stats count by Target | top limit = 1 Count | fields -Count]