DokumentationExperience PlatformHandbuch zum Abfragedienst

Abfrageprotokolle

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Entwickler
IMPORTANT
Bestimmte Funktionen für Abfrageprotokolle befinden sich derzeit in einer eingeschränkten Version und stehen nicht allen Kundinnen und Kunden zur Verfügung. Ohne Bearbeitungssymbol wird Ihre Benutzeroberfläche möglicherweise etwas anders angezeigt. Außerdem kann der Prozess der Auswahl eines Abfragenamens dazu führen, dass zum Abfrage-Editor anstelle der Ansicht Details zum Abfrageprotokoll navigiert wird.

Adobe Experience Platform führt ein Protokoll aller Abfrageereignisse, die sowohl über die API als auch über die Benutzeroberfläche auftreten. Diese Informationen sind in der Benutzeroberfläche des Abfrage-Service auf der Registerkarte Protokolle verfügbar.

Die Protokolldateien werden automatisch von jedem Abfrageereignis generiert und enthalten Informationen wie die verwendete SQL, 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 als Teil der Administratorprotokoll-Funktion gespeichert und finden Sie in der Administratorprotokoll-Dokumentation.

Abfrageprotokolle überprüfen check-query-logs

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

NOTE
Systemabfragen und Dashboard-Abfragen sind standardmäßig ausgeschlossen. Im Abschnitt Filter finden Sie Informationen dazu, wie Sie die angezeigten Protokolle basierend auf Ihren Einstellungen verfeinern können.

Die Platform-Benutzeroberfläche mit hervorgehobenen Abfragen und hervorgehobenem Protokoll.

Abfrage-Service-Protokolle werden in einem anpassbaren Tabellenformat angezeigt. Um die Tabellenspalten anzupassen, klicken Sie auf das Einstellungssymbol ( A Einstellungssymbol). ) auf der rechten Seite des Bildschirms. Es ​ ein Dialogfeld „Tabelle anpassen angezeigt, in dem jede Spalte deaktiviert 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 „Abfrageprotokoll“ mit hervorgehobener Dropdown-Liste „Suchleiste“ und „Spaltentabelle verwalten“.

Eine Beschreibung für jede der Protokolltabellenspalten finden Sie im Abschnitt „Protokoll“ der Übersicht über den Abfrage-Service.

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 „Abfrageprotokoll“ mit einer ausgewählten Zeile und den hervorgehobenen Protokolldaten in der rechten Seitenleiste.

Im Bedienfeld Protokolldetails können Sie eine Vielzahl von Aktionen ausführen. Sie können die Abfrage als CTAS ausführen, wodurch ein neuer Ausgabedatensatz erstellt wird. Sie können die vollständige SQL-Abfrage, die bei 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 „Abfrageprotokoll“ mit einer ausgewählten Zeile, „Als CTAS ausführen“, „Abfrage löschen“ und dem hervorgehobenen Symbol „SQL kopieren“.

IMPORTANT
Bestimmte Funktionen für Abfrageprotokolle befinden sich derzeit in einer eingeschränkten Version und stehen nicht allen Kundinnen und Kunden zur Verfügung.

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

NOTE
Wenn die Abfrage mit der API erstellt wurde und bei der Initialisierung kein Vorlagenname angegeben wurde, werden stattdessen die ersten paar Dutzend Zeichen der SQL-Abfrage angezeigt.

Die Detailansicht des Abfrageprotokolls.

Protokolle bearbeiten edit-logs

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

Der Arbeitsbereich „Abfrageprotokoll“ mit einem hervorgehobenen Stiftsymbol.

Protokolle filtern filter-logs

Sie können die Liste der Abfrageprotokolle nach verschiedenen Einstellungen filtern. Wählen Sie das Filtersymbol ( Das Filtersymbol. ) oben links im Arbeitsbereich, um einen Satz von Filteroptionen in der linken Leiste zu öffnen.

Der Arbeitsbereich „Abfrageprotokoll“ mit hervorgehobenem Filtersymbol.

Die Liste der verfügbaren Filter wird angezeigt.

Der Arbeitsbereich „Abfrageprotokoll“ mit den angezeigten und hervorgehobenen Filteroptionen.

Die folgende Tabelle enthält eine Beschreibung jedes Filters.

Filter
Beschreibung
Dashboard-Abfragen ausschließen
Dieses Kontrollkästchen ist standardmäßig aktiviert und schließt Protokolle aus, die von den Abfragen zum Generieren von Insights generiert wurden. Diese Abfragen werden vom System generiert und verdecken die Aufzeichnungen benutzergenerierter Protokolle, die für die Überwachung, Verwaltung und Fehlerbehebung erforderlich sind. Deaktivieren Sie das Kontrollkästchen, um die systemgenerierten Protokolle anzuzeigen.
Systemabfragen ausschließen
Dieses Kontrollkästchen ist standardmäßig aktiviert und schließt vom System generierte Protokolle aus. Systemgenerierte Abfragen umfassen häufig Hintergrundaufgaben oder Wartungsvorgänge, 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 während eines bestimmten Zeitraums erstellt wurden, legen Sie die Start und Ende im Abschnitt Startdatum fest.
Abschlussdatum
Um die Protokolle nach Abfragen zu filtern, die während eines bestimmten Zeitraums abgeschlossen wurden, legen Sie die Start und Ende im Abschnitt Abschlussdatum fest.
Status
Um Protokolle nach dem Status der Abfrage zu filtern, wählen Sie das entsprechende Optionsfeld aus. Zu den verfügbaren Optionen gehören Gesendet, In ​, Erfolg und Fehlgeschlagen. Sie können Protokolle nur jeweils nach einer Statusbedingung filtern.
Client
Um Protokolle nach dem verwendeten Abfrage-Client zu filtern, geben Sie einen der folgenden akzeptierten Werte in das freie Textfeld ein: API, Adobe Query Service UI oder QsAccel.
Meine Abfragen
Verwenden Sie den Umschalter Meine Abfragen, um die Protokolle nach von Ihnen ausgeführten Abfragen zu filtern.
ID des Abfrageprotokolls
Um nach der eindeutigen Protokoll-ID einer Abfrage zu filtern, geben Sie die Protokoll-ID in das freie Textfeld ein. Diese Informationen finden Sie im Abschnitt Protokolldetails.

Alle angewendeten Filter werden über den gefilterten Protokollergebnissen angezeigt.

Die Registerkarte „Protokoll“ des Arbeitsbereichs „Abfragen“ mit hervorgehobener Liste der angewendeten Filter.

Nächste Schritte

Durch das Lesen dieses Dokuments können Sie jetzt besser verstehen, wie in der Benutzeroberfläche von Query Service auf Abfrageprotokolle zugegriffen wird und wie sie 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 Überwachen von Abfragen erfahren Sie, wie der Abfrage-Service die Sichtbarkeit geplanter Abfrageausführungen verbessert.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb