Oracle Cloud Infrastructure-Dokumentation

link

Mit dem Befehl link können Sie Logdatensätze in allgemeinen Geschäftstransaktionen gruppieren. Dieser Befehl gibt die "Verknüpfen durch"-Felder mit den folgenden Details zurück:

Topics:

Hinweis

Im Folgenden sind einige der Limits aufgeführt, die mit dem Befehl link verknüpft sind:

  • Die maximale Anzahl von Gruppen, die von der Abfragesuche oder dem Abfrageexport mit Konsole, CLI oder SDK zurückgegeben werden, beträgt 500, wenn die Abfrage einen link-Befehl enthält.

    Es können jedoch bis zu 1 Million Gruppen in einer Link-Abfrageausführung verarbeitet und die Daten mit dem Befehl classify geclustert und visualisiert werden

  • Die maximale Anzahl von Feldern, die in den Befehl link aufgenommen werden können, beträgt 4. Wenn die Zeit eines der Felder ist, ist das maximale Limit 5.

Syntax

link [<link_options>] <fieldName> [, <fieldName>), ...]

Dabei kann link_options als [includenulls = [true|false]] [includetrends = [true|false]] [span = <span>] erweitert werden.

Parameter

In der folgenden Tabelle sind die in diesem Befehl verwendeten Parameter sowie deren Beschreibungen aufgeführt.

Parameter Beschreibung

includenulls

Gibt an, ob die Ergebnisse Logdatensätze enthalten sollen, bei denen die "Verknüpfen durch"-Felder Null sind. Der Standardwert ist false.

includetrends

Gibt an, ob die Ergebnisse Trenddaten enthalten sollen. Der Standardwert ist true.

span

Legt die Zeitspanne fest, die für das Ergebnishistogramm verwendet werden soll.

Syntax: <int><timescale>.

timescale-Syntax: <sec> | <min> | <hour> | <day> | <week> | <mon>

  • sec-Werte: s | sec | secs | second | seconds
  • min-Werte: m | min | mins | minute | minutes
  • min-Werte: h | hr | hrs | hour | hours
  • min-Werte: w | week | weeks
  • min-Werte: mon | month | months

Von link für jede Gruppe generierte Felder

Der Befehl link erzeugt eine Zeile pro Gruppe. Eine Gruppe ist die eindeutige Kombination der Eingabeschlüssel. Beispiel:

  • link 'Host Name (Server)' erzeugt eine Zeile für jeden Hostnamen. In diesem Fall ist eine Gruppe ein eindeutiger Hostname.
  • link 'Host Name (Server)', 'User Name' erzeugt eine Zeile für jede eindeutige Kombination aus Hostname und Benutzername. In diesem Fall ist eine Gruppe eine eindeutige Kombination aus Hostname und Benutzername.

Die folgenden Felder werden automatisch für jede Gruppe erstellt:

Feld Beschreibung
Collection Der Name der Collection, in der Daten persistiert werden. Wird mit dem Befehl linkdetails verwendet
ID Gruppen-ID, die innerhalb der Collection eindeutig ist
Anzahl Anzahl der Logdatensätze in einer Gruppe. In dieser Benutzeroberfläche können Sie auf dieses Feld klicken, um die Logdatensätze anzuzeigen. Mit Umschalttaste können Sie auch eine oder mehrere Zeilen in der UI auswählen, um alle diese Logdatensätze anzuzeigen oder die Logdatensätze zu clustern. Verwenden Sie dazu die folgenden Optionen:
  • Klicken Sie auf Anzeigen, und wählen Sie Logdatensätze aus.
  • Klicken Sie auf Anzeigen, und wählen Sie Cluster aus.
Startzeit Frühester Zeitstempel von Logdatensätzen in einer Gruppe
Endzeit Letzter Zeitstempel von Logdatensätzen in einer Gruppe
Gruppendauer Dauer der Logdatensätze in einer Gruppe. Dieses Feld ist standardmäßig in der Benutzeroberfläche ausgeblendet. Sie können dieses Feld anzeigen, indem Sie auf Optionen klicken und die Option Spalten ausblenden/anzeigen auswählen.

Außerdem werden die folgenden Felder für alle Gruppen erstellt. Sie sind auch standardmäßig in der UI ausgeblendet und können angezeigt werden, indem Sie auf Optionen klicken und Spalten ausblenden/anzeigen auswählen:

Feld Beschreibung
Abfragestartzeit Startzeit der Abfrage, wie mit dem Zeitselektor ausgewählt. Wenn Sie die Zeit überschreiben, indem Sie einen expliziten Zeitraum in der Abfrage angeben, wird dieser verwendet.
Abfrageendzeit Endzeit der Abfrage, wie mit dem Zeitselektor ausgewählt. Wenn Sie die Zeit überschreiben, indem Sie einen expliziten Zeitraum in der Abfrage angeben, wird dieser verwendet.
Trendintervall Das im Parameter span angegebene Intervall für den Befehl link. Dies ist das Intervall, das für timestats und andere Diagramme verwendet wird. Wenn kein span angegeben wurde, wird ein Standardwert verwendet.
Trendintervalleinheit Die Einheit für das Intervall, das im Parameter span für den Befehl link angegeben wird.

Beispiele zur Verwendung dieses Befehls in typischen Szenarios finden Sie unter:

Mit dem folgenden Befehl werden alle Logs mit schwerwiegenden Fehlern nach Transaktion gruppiert:

severity = fatal | link 'Transaction ID'

Der folgende Befehl gruppiert alle Logs mit schwerwiegenden Fehlern nach Transaktion und ruft die durchschnittliche verstrichene Zeit von Logdatensätzen in jeder Gruppe ab:

severity = fatal | link 'Transaction ID' | stats avg('Elapsed Time (System)') as 'Average Elapsed Time'