Gestisci ricerche

Spesso, i log non contengono tutte le informazioni necessarie per consolidare l'analisi. In questi casi, è possibile creare una tabella di ricerca per raccogliere le informazioni già raccolte in modo da dare più senso ai dati nei log. Ad esempio, il campo ID errore negli eventi di log non fornisce una descrizione degli errori. È possibile creare una ricerca che mappa ID errore alle descrizioni, quindi utilizzare le opzioni Arricchimento campo per rendere disponibili le descrizioni per la ricerca nei record di log. Alcuni scenari di esempio in cui è possibile creare ricerche:

• Inventario dei prodotti: ID prodotto, specifiche tecniche, prezzo, scorte disponibili, numero di rack
• Informazioni sul dipendente: ID dipendente, informazioni personali, organizzazione, ruolo, scala, stipendio, manager
• Riferimento alla libreria: casella, autore, riepilogo, edizione, edizioni precedenti, prezzo

È possibile utilizzare principalmente le ricerche semplici in fase di inclusione utilizzando la funzione Ricerca origine. Vedere Uso delle ricerche in tempo di inclusione nell'origine.

È inoltre possibile utilizzare ricerche semplici al momento della query come mostrato di seguito:

Nella query lookup seguente, il messaggio di errore viene selezionato dalla tabella di ricerca ORA Error Messages mappando il campo ID errore e visualizzato in una tabella di riepilogo insieme ad altri campi quali l'origine log e l'entità:

'Error ID' like 'ORA%' | lookup table = 'ORA Error Messages' select errmsg using 'Error ID' = errid | fields -*, 'Log Source', Entity, errmg

• Informazioni dai log:
  • Error ID: ID errore come indicato nei log specificati nel formato ORA%
  • Log Source: l'origine log dei log
  • Entity: l'entità dei log
• Informazioni della tabella di ricerca definita da Oracle ORA Error Messages:
  • errid: ID dell'errore specificato nel formato ORA%
  • errmsg: il messaggio di errore per l'ID errore

  Gli altri dettagli disponibili nella tabella di ricerca ORA Error Messages sono errcause (causa errore) e erraction (azione errore) per ogni ID errore. Per visualizzare il contenuto della tabella di ricerca, utilizzare il comando searchlookup come indicato di seguito.

  * | searchlookup table = 'ORA Error Messages'

1. Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.

2. Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Ricerche.

3. In Ricerche, fare clic sul lookup di cui si desidera visualizzare i dettagli.

   Nella pagina Dettaglio ricerca vengono visualizzati i dettagli forniti durante la creazione e anche il contenuto della tabella di ricerca. È inoltre possibile eseguire azioni quali Sposta risorsa, Aggiungi tag e Elimina. Per informazioni dettagliate su queste azioni, vedere la sezione seguente.

Per eseguire altre azioni sulla ricerca, nella pagina elenco Ricerche selezionare il Compartimento, il Tipo e il Tipo di creazione della ricerca e limitare la ricerca della ricerca nella barra di ricerca. È inoltre possibile includere filtri tag per filtrare le ricerche in base alle tag. Dopo aver identificato la ricerca, fare clic sull'icona Azioni nella riga della ricerca:

• Ricarica file: in caso di ricerche create dall'utente, se si dispone di una nuova versione della tabella di ricerca o se un caricamento precedente non è riuscito, è possibile ricaricarlo.

• Elimina: potrebbe essere necessario eliminare alcune ricerche precedenti o non utilizzate. Per eliminare la ricerca, confermare nella finestra di dialogo Elimina ricerca. È possibile eliminare un lookup solo se creato dall'utente.

• Copia OCID: l'OCID della risorsa di ricerca viene copiato. Puoi usarlo per fare riferimento a questa risorsa ovunque in Oracle Cloud Infrastructure.
• Sposta risorsa: viene visualizzata la finestra di dialogo Sposta risorsa in un compartimento diverso. Dalle opzioni, selezionare il compartimento in cui si desidera spostare la ricerca, quindi fare clic su Sposta risorsa.
• Aggiungi tag: vedere Aggiungere tag alle risorse di Log Analytics.

1. Aggiornare il file CSV con le combinazioni campo-valore.

2. Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.

3. Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Ricerche.

4. In Ricerche, fare clic sull'icona Azioni nella riga corrispondente alla ricerca che si desidera aggiornare, fare clic su Ricarica file.

   Viene visualizzata la finestra di dialogo Ricarica file.

5. Selezionare il file CSV di ricerca aggiornato creato in precedenza e fare clic su Carica.

Dopo aver creato la ricerca semplice, eseguire una query con il comando searchlookup per elencare i valori nella ricerca e utilizzare il comando lookup in una query per mappare i campi di output a tali valori.

1. Creare un file CSV di ricerca con le combinazioni campo-valore. Ad esempio, per creare una ricerca che mappa l'ID errore alle descrizioni:

   errid,description
   02323,Network Not Reachable
   09912,User Activity
   12322,Out of Memory

   Si noti che la prima riga è l'intestazione con i titoli errid e description per i valori nelle righe successive.

2. Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.

3. Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Ricerche.

   Viene visualizzata la pagina di elenco delle ricerche. Dal riquadro di navigazione a sinistra selezionare il compartimento in cui deve essere creata la ricerca.

4. In Ricerche, fare clic su Crea ricerca.

5. Nella pagina Crea ricerca immettere il nome della ricerca, ad esempio server error code lookups, e una descrizione facoltativa.

6. In Tipo, selezionare Semplice.

7. Selezionare il file CSV di ricerca creato in precedenza.

8. Facoltativamente, espandere la sezione Mostra opzioni avanzate e aggiungere tag alla ricerca. Fare clic su Crea.

Dopo aver creato la ricerca del tipo di dizionario, utilizzare il comando searchlookup per elencare le ricerche. Utilizzare il comando lookup per eseguire il mapping ai campi con qualsiasi query solo dopo aver utilizzato i comandi link o cluster nella query.

Operator,Condition,Network Name
CIDRMATCH,192.0.2.10/24,Database Network

Operator,Condition,Label,Module
# ----------------------------------
# Startup/Shutdown and Terminations
# ----------------------------------
CONTAINS,Server started in RUNNING mode,Server Started,WebLogic Server
CONTAINS,A critical service failed. The server will shut itself down,Server Shutdown,WebLogic Server
CONTAINS,state changed to FAILED,Server Failed,
CONTAINS,Removing .* from cluster view due to PeerGone,Cluster Removed,WebLogic Server
# ----------------------
# Connection Error / Timeouts and Slowness
# ----------------------
CONTAINS,Unable to connect to WSM policy manager,WSM Policy Manager Connection Error,
CONTAINS REGEX,java.sql.SQLTimeoutException: \S+: user requested cancel of current operation,SQL Timeout,Database
CONTAINS,This member is running extremely slowly and may endanger the rest of the cluster,WebLogic Cluster Slowness,WebLogic Server

È possibile utilizzare lo stesso dizionario in più query. Ad esempio, la seguente query applica lo stesso dizionario al campo Message e mostra i risultati aggregati utilizzando la visualizzazione Grafico a torta:

'Log Source' = 'Linux Syslog Logs'
| lookup table = 'Linux Error Categories' select Issue, Area using Message
| stats count by Area

Tipo di risorsa individuale: loganalytics-lookup

Parte del tipo di risorsa aggregato: loganalytics-features-family

Dichiarazione dei criteri delle risorse se i criteri familiari non sono definiti:

Tenere presente che per limitare l'autorizzazione alla risorsa di lookup con l'ambito richiesto (tenancy o compartimento) al funzionamento dell'istruzione dei criteri precedente, non devono esistere altre istruzioni dei criteri che coprano la famiglia di tipi di risorsa e un ambito più ampio.

Quando si crea un criterio IAM per loganalytics-lookup, è possibile eseguire le operazioni riportate di seguito con ciascun verbo.

In genere, solo gli amministratori dispongono delle autorizzazioni USE e MANAGE per creare o eliminare la ricerca. Se si desidera che i privilegi eseguano query di ricerca, è necessario disporre dell'autorizzazione READ.

Rendiconto della polizza familiare aggregata che copre l'autorizzazione per la risorsa di ricerca:

In genere, solo gli amministratori dispongono delle autorizzazioni USE e MANAGE per creare o eliminare la ricerca. Se si desidera che i privilegi eseguano query di ricerca, è necessario disporre dell'autorizzazione READ.

Se si sta già utilizzando Log Explorer, SDK o CLI per eseguire le query, si dispone già delle autorizzazioni necessarie per eseguire i comandi di query searchlookup o lookup nelle ricerche esistenti definite da Oracle e create dall'utente.

Se si utilizza il principal dell'istanza per eseguire le query, fornire l'autorizzazione seguente se non è già stato fornito l'accesso loganalytics-features-family al gruppo dinamico:

Allow dynamic-group <dynamic-group-name> to {LOG_ANALYTICS_LOOKUP_READ} in tenancy

O

Allow dynamic-group <dynamic-group-name> to {LOG_ANALYTICS_LOOKUP_READ} in compartment <compartment_name>