Oracle Cloud Infrastructure-Dokumentation

Parameter für Log Explorer-URL

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 zu erhalten, der die Seite genau so lädt, wie sie derzeit angezeigt wird.

Visualisierungs- und Abfrageparameter

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

Parameter Beschreibung Unterstützte Wert Beispiel
Viz Legt die Visualisierung fest
  • pie
  • bar - Senkrechter Strich
  • 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: Log 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'

    Ergebnisabfrage: '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

    Ergebnisabfrage: 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 Komparator EQUALS 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'

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

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

    URL: loganalytics/explorer?filters=ospid__:__889

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

  • Ein Feld, ein Wert und ein Komparator werden auf einen Feldkomparatorwert getestet:

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

    Ergebnisabfrage: '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

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

  • Mehrere Werte:

    URL (High- und Med-Probleme der letzten 14 Tage): loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

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

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

  • Fehlerfälle:

    Wenn die Feld-/Wertkombinationen nicht übereinstimmen, wird ein Fehler angezeigt. Beispiel: filters=ospid:abc würde einen Fehler ergeben, da ospid ein Long-Wert und abc ein String ist.

encodedQuery

Entschlüsselt 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. Decodieren 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 Parameter Problempriorität zur Suche hinzugefügt, was zu Folgendem führt: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Globale Kontextparameter

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

Parameter Beschreibung Unterstützte Wert 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 Folgendes in der Konsole ausführen, erhalten Sie zwei Zahlen: Start- und Endzeit. Sie können sie an die URL anschließen und Daten für die 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.

Die Uhrzeit wird auch in folgendem 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 ein relatives Zeitset timeNum auf eine Zahl und timeUnit auf den erforderlichen Zeitrahmen anzugeben. 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
  • WOCHEN
  • 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