Dokumentation Experience Platform Handbuch zum Abfragedienst

Abfrageprotokolle

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Abfragen

Erstellt für:

Benutzende
Entwickler

IMPORTANT

Bestimmte Abfrageprotokollfunktionen sind derzeit in einer eingeschränkten Version verfügbar und stehen nicht allen Kunden zur Verfügung. Ihre Benutzeroberfläche wird möglicherweise ohne Bearbeitungssymbol etwas anders angezeigt. Außerdem können Sie beim Auswählen eines Abfragennamens anstelle der Ansicht Details des Abfragenprotokolls zum Abfrage-Editor navigieren.

Adobe Experience Platform verwaltet ein Protokoll aller Abfrageereignisse, die sowohl über die API als auch über die Benutzeroberfläche auftreten. Diese Informationen sind in der Benutzeroberfläche von Query Service auf der Registerkarte Protokolle verfügbar.

Die Protokolldateien werden automatisch von jedem Abfrageereignis generiert und enthalten Informationen wie die verwendete SQL-Datei, den Status der Abfrage, die Dauer und die letzte Laufzeit. Sie können Abfrageprotokolldaten als leistungsstarkes Tool zur Fehlerbehebung bei ineffizienten oder problematischen Abfragen verwenden. Umfassendere Protokollinformationen werden im Rahmen der Funktion "Auditprotokoll"aufbewahrt und finden Sie in der Dokumentation zum Auditprotokoll.

Abfrage-Logs überprüfen check-query-logs

Um die Abfrageprotokolle zu überprüfen, wählen Sie Abfragen , um zum Arbeitsbereich "Query Service"zu navigieren, und wählen Sie Protokoll aus den verfügbaren Optionen aus.

NOTE

Sowohl Systemabfragen als auch Dashboard-Abfragen sind standardmäßig ausgeschlossen. Informationen dazu, wie Sie die angezeigten Protokolle anhand Ihrer Einstellungen verfeinern, finden Sie im Abschnitt Filter .

Die Platform-Benutzeroberfläche mit hervorgehobenen Abfragen und Protokollen.

Anpassen und Suchen customize-and-search

Die Query Service-Logs werden in einem anpassbaren Tabellenformat dargestellt. Um die Tabellenspalten anzupassen, wählen Sie das Einstellungssymbol ( ) rechts neben dem Bildschirm. Ein Dialogfeld Tabelle anpassen wird angezeigt, in dem die Auswahl jeder Spalte aufgehoben werden kann.

Sie können auch nach Protokollen suchen, die sich auf bestimmte Abfragevorlagen beziehen, indem Sie den Vorlagennamen in das Suchfeld eingeben.

Der Arbeitsbereich Abfrageprotokollmit der Dropdown-Liste Suchleiste und Spaltentabelle verwaltenwurde hervorgehoben.

Eine Beschreibung für die einzelnen Protokolltabellenspalten finden Sie im Abschnitt Protokoll der Query Service-Übersicht.

Ermitteln von Protokolldaten

Jede Zeile stellt Protokolldaten für eine Abfrageausführung dar, die mit einer Abfragevorlage verknüpft ist. Wählen Sie eine beliebige Zeile aus der Tabelle aus, um die rechte Seitenleiste mit Protokolldaten für diese Ausführung zu füllen.

Der Arbeitsbereich Abfrage-Protokollmit einer ausgewählten Zeile und die Protokolldaten in der rechten Seitenleiste sind hervorgehoben.

Im Bereich "Protokolldetails"können Sie verschiedene Aktionen durchführen. Sie können die Abfrage als CTAS ausführen, das einen neuen Ausgabedatensatz erstellt, die vollständige SQL-Abfrage, die in der Ausführung verwendet wurde, anzeigen oder kopieren oder die Abfrage löschen.

NOTE

Die Option Als CTAS ausführen ist nur für eine SELECT-Abfrage verfügbar.

Der Arbeitsbereich Abfrage-Protokollmit einer ausgewählten Zeile, Als CTAS ausführen, Abfrage löschenund das Symbol SQL kopierenhervorgehoben.

IMPORTANT

Bestimmte Abfrageprotokollfunktionen sind derzeit in einer eingeschränkten Version verfügbar und stehen nicht allen Kunden zur Verfügung.

Sie können auch einen Namen für eine Abfragevorlage aus der Spalte Name auswählen, um direkt zur Ansicht Details des Abfrageprotokolls zu navigieren.

NOTE

Wenn die Abfrage mit der API erstellt wurde und während der Initialisierung kein Vorlagenname angegeben wurde, werden stattdessen die ersten Dutzend Zeichen der SQL-Abfrage angezeigt.

Die Detailansicht des Abfrageprotokolls.

Protokolle bearbeiten edit-logs

Neben dem Vorlagennamen jeder Zeile oder einem SQL-Snippet befindet sich ein Stiftsymbol ( ), mit denen Sie zum Abfrage-Editor navigieren können. Die Abfrage wird dann im Editor zur Bearbeitung vorausgefüllt.

Der Arbeitsbereich Abfrage-Protokollmit einem hervorgehobenen Stiftsymbol.

Filter-Logs filter-logs

Sie können die Liste der Abfrageprotokolle anhand verschiedener Einstellungen filtern. Wählen Sie das Filtersymbol ( ) oben links im Arbeitsbereich, um eine Reihe von Filteroptionen in der linken Leiste zu öffnen.

Der Arbeitsbereich Abfrage-Protokollmit hervorgehobenem Filtersymbol.

Die Liste der verfügbaren Filter wird angezeigt.

Der Arbeitsbereich Abfrage-Protokollmit den angezeigten und hervorgehobenen Filteroptionen.

Die folgende Tabelle enthält eine Beschreibung der einzelnen Filter.

Filter

Beschreibung

Dashboard-Abfragen ausschließen

Dieses Kontrollkästchen ist standardmäßig aktiviert und schließt Protokolle aus, die von den Abfragen generiert wurden, mit denen Einblicke generiert wurden. Diese Abfragen werden systemgeneriert und verschleiern die Datensätze von benutzergenerierten Protokollen, die zur Überwachung, Verwaltung und Fehlerbehebung erforderlich sind. Um vom System generierte Protokolle anzuzeigen, deaktivieren Sie das Kontrollkästchen.

Systemabfragen ausschließen

Dieses Kontrollkästchen ist standardmäßig aktiviert und schließt vom System erstellte Protokolle aus. Systemgenerierte Abfragen umfassen häufig Hintergrundaufgaben oder Wartungsaufgaben, die für die Benutzerüberwachung, Verwaltung oder Fehlerbehebung möglicherweise nicht relevant sind. Wenn Sie systemgenerierte Protokolle überprüfen müssen, deaktivieren Sie dieses Kontrollkästchen, um sie in Ihre Protokollansicht aufzunehmen.

Startdatum

Um die Protokolle nach Abfragen zu filtern, die in einem bestimmten Zeitraum erstellt wurden, legen Sie die Datumsangaben Start und Ende im Abschnitt Startdatum fest.

Abgeschlossenes Datum

Um die Protokolle nach Abfragen zu filtern, die in einem bestimmten Zeitraum abgeschlossen wurden, legen Sie die Datumsangaben Start und Ende im Abschnitt Abgeschlossen Datum fest.

Status

Um Protokolle anhand des Status der Abfrage zu filtern, wählen Sie das entsprechende Optionsfeld aus. Zu den verfügbaren Optionen gehören Gesendet, Gestartet, Erfolg und Fehlgeschlagen. Sie können Protokolle nur nach einer Statusbedingung filtern.

Client

Um die Protokolle nach dem verwendeten Abfrageclient zu filtern, geben Sie einen der folgenden zulässigen Werte in das Feld für den freien Text ein: API, Adobe Query Service UI oder QsAccel.

Meine Abfragen

Mit dem Umschalter Meine Abfragen können Sie die Protokolle nach von Ihnen ausgeführten Abfragen filtern.

Abfrageprotokoll-ID

Um nach der eindeutigen Logkennung einer Abfrage zu filtern, geben Sie die Logkennung in das Feld für den freien Text ein. Diese Informationen finden Sie in den Protokolldetails.

Alle angewendeten Filter werden oberhalb der gefilterten Protokollergebnisse angezeigt.

Die Registerkarte Protokoll des Arbeitsbereichs Abfragen, wobei die Liste der angewendeten Filter hervorgehoben ist.

Nächste Schritte

Durch Lesen dieses Dokuments können Sie jetzt besser verstehen, wie auf Abfrageprotokolle in der Benutzeroberfläche von Query Service zugegriffen und diese verwendet werden.

Weitere Informationen über die Funktionen des Abfrage-Services finden Sie in der Benutzeroberflächen-Übersicht oder im Handbuch zur Abfrage-Service-API.

Im Dokument Abfragen überwachen erfahren Sie, wie Query Service die Sichtbarkeit geplanter Abfrageausführungen verbessert.

recommendation-more-help

ccf2b369-4031-483f-af63-a93b5ae5e3fb