Oracle Cloud Infrastructure-Dokumentation

Log Explorer-URL-Parameter

Log Explorer unterstützt mehrere URL-Parameter, mit denen Kontext an die Anwendung übergeben werden kann. Klicken Sie im Log Explorer auf Aktionen, und wählen Sie Abfrage-URL kopieren aus, um einen Link abzurufen, mit dem die Seite genau so neu geladen wird, wie sie derzeit angezeigt wird.

Visualisierungs- und Abfrageparameter

Mit Visualisierungs- und Abfrageparametern können Integratoren mit dem Log Explorer kommunizieren, welche Standardvisualisierungs- und Abfragefilter beim Laden der Seite verwendet werden müssen.

Parameter Beschreibung Unterstützte Werte Beispiel
Anzeigen Legt die Visualisierung fest
  • pie
  • bar - vertikaler Balken
  • hbar - Horizontaler Balken
  • line
  • sunburst
  • treemap
  • cloud
  • map
  • records
  • table
  • records_histogram
  • table_histogram
  • distinct
  • cluster
  • link
  • tile

  • summary_table

URL: loganalytics/explorer?viz=records_histogram

Ergebnis: Logging Analytics wird mit dem Diagramm Datensätze mit Histogramm und der Standardabfrage geladen, die für diese Visualisierung geeignet ist.

suchen Aktualisiert die Suchklausel der Abfrage -

  • Test für eine Gruppe von Wörtern:

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

    Abfrageergebnisse: 'Failed to start' | stats count as logrecords by 'Log Source' | sort -logrecords

  • Testen Sie für jedes Wort:

    URL: loganalytics/explorer?search=Failed start

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

  • Testen Sie das eine oder andere Wort:

    URL: loganalytics/explorer?search=Failed or start

    Abfrageergebnisse: Failed or start | stats count as logrecords by 'Log Source' | sort -logrecords
Filter Aktualisiert die Abfrage mit den angegebenen Feld-/Wertprüfungen. Filter werden mit Feldname, Wert und einem optionalen Komparator angegeben. Standardmäßig wird der EQUALS-Vergleich verwendet.

Die Begrenzungszeichen für Filter sind __:__ __,__ __;__

Unterstützte Komparatoren:

  • EQUALS (Standardwert)
  • NOT_EQUALS
  • STARTS_WITH
  • DOES_NOT_START_WITH
  • ENDS_WITH
  • DOES_NOT_END_WITH
  • ENTHÄLT
  • 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

  • Nur ein Feld testet, ob das Feld auf Null gesetzt ist:

    URL: loganalytics/explorer?filters=ospid

    Alternative URLs:

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

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

  • Ein Feld und ein Wert testen, ob das Feld dem Wert entspricht:

    URL: loganalytics/explorer?filters=ospid__:__889

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

  • Ein Feld, ein Wert und ein Komparator testen den Feldkomparatorwert:

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

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

  • Mehrere Filter (für komplexe Vergleiche):

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

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

  • Mehrere Werte:

    Url (hohe und mittlere Probleme der letzten 14 Tage): loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

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

    Ergebnisse von GC-Einstellungen: Da in diesem Fall auch die Zeitparameter festgelegt sind, wird die Zeit auf Last 14 Days gesetzt.

  • Fehlerfälle:

    Wenn die Feld/Wert-Kombinationen nicht übereinstimmen, wird ein Fehler angezeigt. Beispiel: filters=ospid:abc würde einen Fehler ergeben, weil ospid lang und abc eine Zeichenfolge ist.

encodedQuery

Decodiert die base64-codierte Abfrage aus der URL und aktualisiert die Abfrage im Log Explorer.

In javascript können Sie die encodedQuery mit window.btoa(query) erstellen. Dekodieren Sie mit window.atob(encodedQuery).

Dadurch wird verhindert, dass die Firewall bestimmte Zeichen in der Abfrage kennzeichnet. Beispiel: Diese Abfrage wird von der Firewall mit den nicht codierten Abfrageparametern gekennzeichnet: 'Previous State' != 'Current State' | eval z = substr(a, 0, 1).

-

URL mit codierter Abfrage:

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

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

Decodierte Abfrage ist * | stats count as logs by 'Log Source'

Dann wird der Suche der Parameter Problempriorität hinzugefügt, der Folgendes ergibt: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Globale Kontextparameter

Wenn Logging Analytics eine Abfrage ausführt, wird nur eine Teilmenge von Logdatensätzen berücksichtigt. Die Gruppe der Logdatensätze wird unter Berücksichtigung des globalen Kontexts bestimmt. Dazu gehören Einstellungen wie Compartment und Zeit.

Parameter Beschreibung Unterstützte Werte Beispiel
startTime Die Startzeit (UTC in Millisekunden) wird in Verbindung mit endTime verwendet. Wenn beide in der URL angegeben sind, wird ein benutzerdefinierter Zeitrahmen in der Konsole festgelegt. Datum in UTC Millisekunden

Beispiel: Wenn Sie in der Konsole Folgendes ausführen, erhalten Sie zwei Zahlen: Startzeit und Endzeit. Sie können sie an die URL anschließen und die Daten der letzten 30 Minuten anzeigen:

var now = new Date();

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

var endTime = now.getTime();

Beispiel-URL mit Start- und Endzeit: /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

Das Ergebnis ist eine benutzerdefinierte Zeit im Log Explorer, wobei diese Werte als Start- und Endzeit festgelegt sind.

Zeit wird auch im folgenden Format unterstützt:

/loganalytics/explorer?startTime=Mon Oct 26 2019 16:38:12 GMT-0400&endTime=Mon Oct 26 2020 16:38:12 GMT-0400
endTime Die Endzeit (UTC in Millisekunden) wird in Verbindung mit startTime verwendet. Wenn beide in der URL angegeben sind, wird ein benutzerdefinierter Zeitrahmen in der Konsole festgelegt. Datum in UTC Millisekunden Siehe startTime.
timeNum Log Explorer unterstützt relative Zeiten, wie Last 7 days. Um eine relative Zeit anzugeben, setzen Sie timeNum auf eine Zahl und timeUnit auf den erforderlichen Zeitrahmen. Eine Zahl größer als 0 /loganalytics/explorer?timeNum=42&timeUnit=minutesor/loganalytics/explorer?timeNum=1&timeUnit=day
timeUnit Log Explorer unterstützt relative Zeiten, wie Last 7 days. Um eine relative Zeit anzugeben, setzen Sie timeNum auf eine Zahl und timeUnit auf den erforderlichen Zeitrahmen.
  • SEKUNDEN
  • MINUTEN
  • STUNDEN
  • TAGE
  • WEEEN
  • MONATE
  • JAHREN
 Siehe timeNum.
scopeFilters Mit diesem Parameter können Geltungsbereichsfilter wie Loggruppen-Compartment, Entity und Logset übergeben werden.

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

Dabei gilt:

  • 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