Häufig enthalten die Logs nicht alle erforderlichen Informationen zur Konsolidierung der Analyse. In solchen Fällen können Sie eine Lookup-Tabelle erstellen, um die bereits gesammelten Informationen zu erfassen und die Daten in den Logs besser zu verstehen. Beispiel: Das Feld Fehler-ID in Logereignissen enthält keine Beschreibung der Fehler. Sie können einen Lookup erstellen, der Fehler-ID Beschreibungen zuordnet, und dann die Optionen zur Feldanreicherung verwenden, um die Beschreibungen für die Suche in den Logdatensätzen zur Verfügung zu stellen. Beispiele für Szenarios, in denen Sie Lookups erstellen können:

• Produktbestand: Produkt-ID, technische Daten, Preis, verfügbarer Bestand, Regalnummer
• Mitarbeiterdaten: Mitarbeiter-ID, personenbezogene Daten, Organisation, Rolle, Skala, Gehalt, Manager
• Bibliotheksreferenz: Kachel, Autor, Zusammenfassung, Ausgabe, vorherige Ausgabe, Preis

Mit der Funktion Quell-Lookup können Sie primär die einfachen Lookups zur Aufnahmezeit verwenden. Siehe Aufnahmezeit-Lookups in der Quelle verwenden.

Sie können auch einfache Lookups zur Abfragezeit verwenden, wie unten dargestellt:

In der folgenden lookup-Abfrage wird die Fehlermeldung aus der Lookup-Tabelle ORA Error Messages durch Zuordnung des Fehler-ID-Feldes abgerufen. Die Meldung wird dann zusammen mit anderen Feldern wie Logquelle und Entity in einer Summentabelle angezeigt:

'Error ID' like 'ORA%' | lookup table = 'ORA Error Messages' select errmsg using 'Error ID' = errid | fields -*, 'Log Source', Entity, errmg

• Informationen aus den Logs:
  • Error ID: Fehler-ID wie in den Logs im Format ORA% angegeben
  • Log Source: Die Logquelle der Logs
  • Entity: Die Entity der Logs
• Informationen aus der von Oracle definierten Lookup-Tabelle ORA Error Messages:
  • errid: Die Fehler-ID im Format ORA%
  • errmsg: Die Fehlermeldung für die Fehler-ID

  Die anderen in der Lookup-Tabelle ORA Error Messages verfügbaren Details sind errcause (Fehlerursache) und erraction (Fehleraktion) für jede Fehler-ID. Um den Inhalt der Lookup-Tabelle anzuzeigen, verwenden Sie den Befehl searchlookup wie folgt:

  * | searchlookup table = 'ORA Error Messages'

1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Logging Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.

2. Die Administrationsressourcen werden im linken Navigationsbereich unter Ressourcen aufgeführt. Klicken Sie auf Lookups.

3. Klicken Sie unter Lookups auf den Lookup, dessen Details Sie anzeigen möchten.

   Auf der Seite "Lookup-Details" werden die Details angezeigt, die Sie beim Erstellen angegeben haben, sowie der Inhalt der Lookup-Tabelle. Sie können auch die Aktionen wie Ressource verschieben, Tags hinzufügen und Löschen ausführen. Einzelheiten zu diesen Aktionen finden Sie im folgenden Abschnitt.

Um andere Aktionen für den Lookup auszuführen, wählen Sie auf der Listenseite Lookups das Compartment, den Typ und den Erstellungstyp des Lookups aus, und grenzen Sie die Suche nach dem Lookup im Abschnitt Filter ein. Sie können auch Tagfilter einschließen, um Lookups nach Tags zu filtern. Nachdem Sie den Lookup identifiziert haben, klicken Sie in der Zeile des Lookups auf das Symbol Actions:

• Datei erneut hochladen: Wenn benutzerdefinierte Lookups vorhanden sind, eine neue Version der Lookup-Tabelle vorhanden ist oder ein vorheriger Upload nicht erfolgreich war, können Sie sie erneut hochladen.

• Löschen: Möglicherweise müssen Sie einige Ihrer alten oder nicht verwendeten Lookups löschen. Um den Lookup zu löschen, bestätigen Sie dies im Dialogfeld Lookup löschen. Sie können einen Lookup nur löschen, wenn er vom Benutzer erstellt wurde.

• OCID kopieren: Die OCID der Lookup-Ressource wird kopiert. Sie können diese Ressource damit überall in Oracle Cloud Infrastructure referenzieren.
• Ressource verschieben: Das Dialogfeld Ressource zu einem anderen Compartment verschieben wird angezeigt. Wählen Sie unter den Optionen das Compartment aus, in welches Sie das Lookup verschieben möchten, und klicken Sie auf Ressource verschieben.
• Tags hinzufügen: Siehe Tags zu Logging Analytics-Ressourcen hinzufügen.

1. Aktualisieren Sie die CSV-Datei mit den Feld/Wert-Kombinationen.

2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Logging Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.

3. Die Administrationsressourcen werden im linken Navigationsbereich unter Ressourcen aufgeführt. Klicken Sie auf Lookups.

4. Klicken Sie unter Suchvorgänge in der Zeile, die dem zu aktualisierenden Lookup entspricht, auf das Symbol Aktionen , und klicken Sie auf Datei erneut hochladen.

   Das Dialogfeld Datei erneut hochladen wird geöffnet.

5. Wählen Sie die aktualisierte CSV-Lookup-Datei aus, die Sie zuvor erstellt haben, und klicken Sie auf Hochladen.

Führen Sie nach dem Erstellen des einfachen Lookups eine Abfrage mit dem Befehl searchlookup aus, um die Werte im Lookup aufzulisten. Verwenden Sie den Befehl lookup in einer Abfrage, um die Ausgabefelder diesen Werten zuzuordnen.

1. Erstellen Sie eine CSV-Lookup-Datei mit den Feld/Wert-Kombinationen. Beispiel: So erstellen Sie einen Lookup, der die Fehler-ID Beschreibungen zuordnet:

   errid,description
   02323,Network Not Reachable
   09912,User Activity
   12322,Out of Memory

   Beachten Sie, dass die erste Zeile der Header mit den Titeln errid und description für die Werte in den nachfolgenden Zeilen ist.

2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Logging Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.

3. Die Administrationsressourcen werden im linken Navigationsbereich unter Ressourcen aufgeführt. Klicken Sie auf Lookups.

   Die Listenseite für Lookups wird angezeigt. Wählen Sie im linken Navigationsbereich das Compartment aus, in dem der Lookup erstellt werden muss.

4. Klicken Sie unter Lookups auf Lookup erstellen.

5. Geben Sie in der Seite Lookup erstellen den Namen des Lookups ein, z.B. server error code lookups, und eine optionale Beschreibung.

6. Wählen Sie unter Typ die Option Einfach aus.

7. Wählen Sie die zuvor erstellte Lookup-CSV-Datei aus.

8. Blenden Sie optional den Abschnitt Erweiterte Optionen anzeigen ein, und fügen Sie dem Lookup Tags hinzu. Klicken Sie auf Erstellen.

Nachdem Sie den Dictionary Lookup erstellt haben, verwenden Sie den Befehl searchlookup, um die Lookups aufzulisten. Verwenden Sie den lookup-Befehl, um den Feldern erst nach Verwendung der link- oder cluster-Befehle in der Abfrage eine Abfrage zuzuordnen.

Operator,Condition,Network Name
CIDRMATCH,192.0.2.10/24,Database Network

Operator,Condition,Label,Module
# ----------------------------------
# Startup/Shutdown and Terminations
# ----------------------------------
CONTAINS,Server started in RUNNING mode,Server Started,WebLogic Server
CONTAINS,A critical service failed. The server will shut itself down,Server Shutdown,WebLogic Server
CONTAINS,state changed to FAILED,Server Failed,
CONTAINS,Removing .* from cluster view due to PeerGone,Cluster Removed,WebLogic Server
# ----------------------
# Connection Error / Timeouts and Slowness
# ----------------------
CONTAINS,Unable to connect to WSM policy manager,WSM Policy Manager Connection Error,
CONTAINS REGEX,java.sql.SQLTimeoutException: \S+: user requested cancel of current operation,SQL Timeout,Database
CONTAINS,This member is running extremely slowly and may endanger the rest of the cluster,WebLogic Cluster Slowness,WebLogic Server

Sie können dasselbe Dictionary in mehreren Abfragen verwenden. Beispiel: Die folgende Abfrage wendet dasselbe Dictionary auf das Feld Message an und zeigt die zusammengefassten Ergebnisse mit der Tortendiagrammvisualisierung an:

'Log Source' = 'Linux Syslog Logs'
| lookup table = 'Linux Error Categories' select Issue, Area using Message
| stats count by Area

Einzelner Ressourcentyp: loganalytics-lookup

Teil des aggregierten Ressourcentyps: loganalytics-features-family

Ressourcen-Policy-Anweisung, wenn Familien-Policy nicht definiert ist:

Beachten Sie, dass für die obige Policy-Anweisung die Berechtigung auf die Lookup-Ressource mit dem erforderlichen Geltungsbereich (Mandant oder Compartment) eingeschränkt werden kann. Es dürfen keine anderen Policy-Anweisungen vorhanden sein, die die Ressourcentypfamilie und einen größeren Geltungsbereich abdecken.

Die folgenden Vorgänge können mit jedem Verb ausgeführt werden, wenn Sie eine IAM-Policy für loganalytics-lookup erstellen:

In der Regel verfügen nur Administratoren über die Berechtigungen USE und MANAGE zum Erstellen oder Löschen von Lookups. Wenn Sie Berechtigungen zum Ausführen von Lookup-Abfragen benötigen, benötigen Sie die READ-Berechtigung.

Aggregierte Familien-Policy-Anweisung, die die Berechtigung für die Lookup-Ressource abdeckt:

In der Regel verfügen nur Administratoren über die Berechtigungen USE und MANAGE zum Erstellen oder Löschen von Lookups. Wenn Sie Berechtigungen zum Ausführen von Lookup-Abfragen benötigen, benötigen Sie die READ-Berechtigung.

Wenn Sie Log Explorer, SDKs oder CLI bereits zum Ausführen der Abfragen verwenden, verfügen Sie bereits über die erforderlichen Berechtigungen zum Ausführen von searchlookup- oder lookup-Abfragebefehlen für die vorhandenen von Oracle definierten und benutzerdefinierten Lookups.

Wenn Sie den Instanz-Principal zum Ausführen der Abfragen verwenden, erteilen Sie die folgende Berechtigung, wenn Sie noch keinen loganalytics-features-family-Zugriff auf die dynamische Gruppe erteilt haben:

Allow dynamic-group <dynamic-group-name> to {LOG_ANALYTICS_LOOKUP_READ} in tenancy

Oder

Allow dynamic-group <dynamic-group-name> to {LOG_ANALYTICS_LOOKUP_READ} in compartment <compartment_name>