Parametri URL Log Explorer

Log Explorer supporta diversi parametri URL che consentono di passare il 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 viene visualizzata.

Parametri di 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 al caricamento della pagina.

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: Logging 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 risultante: 'Failed to start' | stats count as logrecords by 'Log Source' | sort -logrecords

  • Prova per ogni parola:

    URL: loganalytics/explorer?search=Failed start

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

  • Prova per una parola o per un'altra:

    URL: loganalytics/explorer?search=Failed or start

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

filtri Aggiorna la query con i controlli campo/valore specificati. I filtri vengono specificati con un nome di campo, un 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 verifica 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 risultante: 'OS Process ID' = null | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un campo e un valore eseguiranno il test se il campo è uguale al valore:

    URL: loganalytics/explorer?filters=ospid__:__889

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

  • Un campo, un valore e un comparatore verranno testati per il valore del comparatore di campi:

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

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

  • Più filtri (per confronti complessi):

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

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

  • Valori multipli:

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

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

    Impostazioni GC risultanti: poiché in questo caso vengono impostati anche i parametri temporali, 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 restituirà un errore poiché ospid è un valore Long e abc è una stringa.

encodedQuery

Decodifica la query con codifica 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'

Il parametro Priorità problema viene quindi aggiunto alla ricerca risultante in: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Parametri contesto globale

Quando Logging Analytics esegue una query, viene considerato solo un subset di record di log. Il set di record di log viene determinato tenendo conto del contesto globale. Sono incluse impostazioni quali compartimento e ora.

Parametro descrizione; Valori supportati Esempio
startTime L'ora di inizio, UTC in millisecondi, viene utilizzata insieme a endTime. Se entrambi sono 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. Puoi collegarli all'URL e vedere 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 di fine: /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

Il risultato è l'ora personalizzata in Log Explorer con questi valori impostati come ora di inizio e 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 sono 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 intervallo di tempo 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 del gruppo di log, l'entità e il set 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