Parametri URL Explorer log

Log Explorer supporta diversi parametri URL che consentono il passaggio del contesto all'applicazione. In Log Explorer fare clic su Azioni e selezionare Copia URL query per ottenere un collegamento che ricarichi la pagina esattamente come è attualmente visualizzata.

Parametri visualizzazione e query

I parametri di visualizzazione e query consentono agli integratori di comunicare a Log Explorer quali filtri di visualizzazione e query predefiniti devono essere utilizzati quando la pagina viene caricata.

Parametro Descrizione Valori supportati Esempio
viz Imposta la visualizzazione
  • pie
  • bar - barra verticale
  • hbar - barra orizzontale
  • line
  • sunburst
  • treemap
  • cloud
  • map
  • records
  • table
  • records_histogram
  • table_histogram
  • distinct
  • cluster
  • link
  • tile
  • summary_table

URL: loganalytics/explorer?viz=records_histogram

Risultato: Log Analytics viene caricato con il grafico Record con istogramma e la query predefinita appropriata per questa visualizzazione.

cerca Aggiorna la clausola di ricerca della query -
  • Test per un gruppo di parole:

    URL: loganalytics/explorer?search='Failed to start'

    Query di risultato: 'Failed to start' | stats count as logrecords by 'Log Source' | sort -logrecords

  • Test per ogni parola:

    URL: loganalytics/explorer?search=Failed start

    Query risultante: Failed and start | stats count as logrecords by 'Log Source' | sort -logrecords

  • Test per una parola o un'altra:

    URL: loganalytics/explorer?search=Failed or start

    Query di risultato: Failed or start | stats count as logrecords by 'Log Source' | sort -logrecords

filtri Aggiorna la query con i controlli di campo/valore specificati. I filtri vengono specificati con il nome del campo, il valore e un comparatore facoltativo. Per impostazione predefinita, viene utilizzato il comparatore EQUALS.

I delimitatori per i filtri sono __:__ __,__ __;__

Comparatori supportati:

  • EQUALS (valore predefinito)
  • NOT_EQUALS
  • STARTS_WITH
  • DOES_NOT_START_WITH
  • ENDS_WITH
  • DOES_NOT_END_WITH
  • CONTIENE
  • DOES_NOT_CONTAIN
  • IS_LESS_THAN
  • IS_LESS_THAN_OR_EQUAL_TO
  • IS_GREATER_THAN
  • IS_GREATER_THAN_OR_EQUAL_TO
  • IS_BETWEEN
  • IS_NOT_BETWEEN
  • Solo un campo verificherà se il campo è impostato su null:

    URL: loganalytics/explorer?filters=ospid

    Url alternativi:

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

    Query di risultato: 'OS Process ID' = null | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un campo e un valore verranno testati se il campo è uguale al valore:

    URL: loganalytics/explorer?filters=ospid__:__889

    Query di risultato: 'OS Process ID' = 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un campo, un valore e un comparatore eseguiranno il test per il valore del comparatore di campi:

    URL: loganalytics/explorer?filters=ospid__:__889__:__NOT_EQUALS

    Query di risultato: 'OS Process ID' != 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Filtri multipli (per confronti complessi):

    URL: loganalytics/explorer?filters=ospid__:__889__:__NOT_EQUALS__;__ospid__:__3000__:__IS_LESS_THAN

    Query di risultato: 'OS Process ID' != 889 and 'OS Process ID' < 3000 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Valori multipli:

    Url (problemi superiori e medi degli ultimi 14 giorni): loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

    Query di risultato: 'Problem Priority' in (High, Medium) | stats count as logrecords by 'Log Source' | sort -logrecords

    Impostazioni GC risultanti: poiché anche i parametri orari vengono impostati in questo caso, l'opzione Ora viene impostata su Last 14 Days.

  • Casi di errore:

    Se le combinazioni campo/valore non corrispondono, viene visualizzato un errore. Ad esempio, filters=ospid:abc restituisce un errore perché ospid è un valore Long e abc è una stringa.

encodedQuery

Decodifica la query codificata base64 dall'URL e aggiorna la query in Log Explorer.

In javascript è possibile creare il file encodedQuery utilizzando window.btoa(query). Decodificare utilizzando window.atob(encodedQuery).

Ciò impedisce al firewall di contrassegnare determinati caratteri nella query. Ad esempio, questa query verrà contrassegnata dal firewall utilizzando i parametri di query non codificati: 'Previous State' != 'Current State' | eval z = substr(a, 0, 1).

-

URL con query codificata:

URL: loganalytics/explorer?viz=pie&viz=pie&encodedQuery=KiB8IHN0YXRzIGNvdW50IGFzIGxvZ3JlY29yZHMgYnkgJ0xvZyBTb3VyY2Un

Esempio: loganalytics/explorer?viz=summary_table&filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days&encodedQuery=KiB8IHN0YXRzIGNvdW50IGFzIGxvZ3MgYnkgJ0xvZyBTb3VyY2Un

La query decodificata è * | stats count as logs by 'Log Source'

Al parametro Priorità problema viene quindi aggiunto il risultato della ricerca: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Parametri contesto globale

Quando Log Analytics esegue una query, viene considerato solo un subset di record di log. L'insieme di record di log viene determinato tenendo conto del contesto globale. Ciò include impostazioni quali il compartimento e l'ora.

Parametro Descrizione Valori supportati Esempio
startTime L'ora di inizio, UTC in millisecondi, viene utilizzata insieme a endTime. Se entrambi vengono forniti nell'URL, nella console viene impostato un intervallo di tempo personalizzato. Data in millisecondi UTC

Ad esempio, se si esegue quanto segue nella console, si otterranno due numeri: ora di inizio e ora di fine. È possibile collegarli all'URL e visualizzare i dati degli ultimi 30 minuti:

var now = new Date();

var startTime = now.getTime() - (1000*60) *30;

var endTime = now.getTime();

URL di esempio con ora di inizio e fine: /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

Il risultato è un'ora personalizzata in Log Explorer con questi valori impostati come ora di inizio e di fine.

L'ora è supportata anche nel seguente formato:

/loganalytics/explorer?startTime=Mon Oct 26 2019 16:38:12 GMT-0400&endTime=Mon Oct 26 2020 16:38:12 GMT-0400

endTime L'ora di fine, UTC in millisecondi, viene utilizzata insieme a startTime. Se entrambi vengono forniti nell'URL, nella console viene impostato un intervallo di tempo personalizzato. Data in millisecondi UTC Vedere startTime.
timeNum Log Explorer supporta i tempi relativi, ad esempio Last 7 days. Per specificare un orario relativo, impostare timeNum su un numero e timeUnit sull'intervallo di tempo richiesto. Un numero maggiore di 0 /loganalytics/explorer?timeNum=42&timeUnit=minutesor/loganalytics/explorer?timeNum=1&timeUnit=day
timeUnit Log Explorer supporta i tempi relativi, ad esempio Last 7 days. Per specificare un'ora relativa, impostare timeNum su un numero e timeUnit sull'intervallo di tempo richiesto.
  • SECONDI
  • MINUTI
  • ORE
  • GIORNI
  • SETTIMANE
  • MESI
  • ANNI
Vedere timeNum.
scopeFilters Questo parametro consente di passare filtri di ambito quali il compartimento, l'entità e il set di log del gruppo di log.

scopeFilters=lg:<logGroupFilter>;en:<entityFilter>;lgste:<logSetFilter>;rg:<regionFilter>;lfe:<logFieldFilter>;mc:<metricCompartmentFilter>;rs:<resourceCompartmentFilter>

dove:

  • logGroupFilter = <logCompartmentOcid>,<includeSubComponents(true/false)>

  • entityFilter = <entityCompartmentOcid>,<includeDependents(true/false)>,<entityOcid>,<entityOcid>,...

  • logSetFilter (encoded)= <logSetNameEncoded>,<logSetNameEncoded>....

  • regionFilter = <region> (For example, us-phoenix-1)

  • logFieldFilter (encoded) = <fieldName>:<fieldValueEncoded>

  • resourceCompartmentFilter = <resourceCompartmentOcid>,<includeSubComponents(true/false)>

  • metricCompartmentFilter = <metricCompartmentOcid>,<includeSubComponents(true/false)>

/loganalytics/explorer?&scopeFilters=lg:root,true;en:root,true,ocid1...;rs:root,true;lfe:Severity,ZXJyb3I=;rg:us-phoenix-1