Vorschau · Entwicklungsstand 1.6.1

LogQuery

Wofür ist das gedacht?

Filter- und Seitengrenzen einer strukturierten Logabfrage. Source, SourceId, RunId, TriggerId, Category, Zeitraum und MinimumLevel grenzen den Bestand ein. Sequenz-/Snapshotgrenzen halten die Seitenauswertung stabil.

LogQuery verstehen

1
AfterSequence
Untere exklusive Sequenzgrenze: nur spätere Ereignisse lesen. Zusammen mit SnapshotSequence eine stabile Abfrage begrenzen.
2
Area
Textuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.
3
BeforeSequence
Obere exklusive Sequenzgrenze für rückwärtige Seiten. Den NextBeforeSequence-Wert der vorherigen Seite übernehmen, statt Ereignisnummern selbst zu schaetzen.
4
Category
Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script. Daraus wird keine Ausführung anhand des Nachrichtentexts abgeleitet.
5
From
Optionaler Anfang des Ereignis-Zeitbereichs als DateTimeOffset. Zeitpunkte mit Offset vergleichen.
6
MinimumLevel
Mindestschweregrad für die Abfrage: Debug, Information, Warning oder Error. Höhere Grenzen koennen wichtige Diagnoseereignisse ausblenden.
7
OnlyProblems
Beschraenkt die Abfrage auf Problemereignisse. Fuer vollständige Ablaufanalyse auch normale Start-, Status- und Abschlussereignisse lesen.
8
PageSize
Gewuenschte Anzahl Ereignisse je Seite. Fuer Folgeseiten dieselben Filter und SnapshotSequence verwenden.
9
RunId
ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.
10
Search
Optionaler Suchtext für die vorhandene Logsuche. Suche ersetzt keine stabile Auswertung von Code, Context und Status.
11
SnapshotSequence
Obere Snapshot-Sequenz der Abfrage. Bei Folgeseiten denselben Wert verwenden, damit neu angehängte Ereignisse den abgefragten Bestand nicht verschieben.
12
Source
Ursprungsart Job, Automation, Application oder Makro.
13
SourceId
Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.
14
TriggerId
Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.
15
Until
Optionales Ende des Ereignis-Zeitbereichs als DateTimeOffset. Kein Lauf-Endzeitpunkt und kein Beleg eines erfolgreichen Abschlusses.

Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

Einstellung	Bedeutung und Bedienung	Beispielwert
AfterSequence	Untere exklusive Sequenzgrenze: nur spätere Ereignisse lesen. Zusammen mit SnapshotSequence eine stabile Abfrage begrenzen.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
Area	Textuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.	Beispieltext
BeforeSequence	Obere exklusive Sequenzgrenze für rückwärtige Seiten. Den NextBeforeSequence-Wert der vorherigen Seite übernehmen, statt Ereignisnummern selbst zu schaetzen.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
Category	Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script. Daraus wird keine Ausführung anhand des Nachrichtentexts abgeleitet. General Allgemeiner Log-Fachbereich ohne spezielleren Ausführungsbereich. Execution Ausführung und Ablaufsteuerung. Automation Triggerbeobachtung und Automationsentscheidungen. FileAccess Datei-/Ordnerzugriffe und ihre Diagnose. Capture Bildschirm-/Kameraaufnahme. Detection Bild-/Text-/Punkterkennung und Auswertung. Process Programmstart, Suche, Fokus und Beenden. Script Skriptausführung und zugehörige Hintergrundarbeit. Video Videoaufnahme und Finalisierung. Windows Windows-Taste als Modifikator (Bitmaske 8) beziehungsweise Windows-Fachbereich, wenn diese Option zu einem Log-Bereich gehört.	General
From	Optionaler Anfang des Ereignis-Zeitbereichs als DateTimeOffset. Zeitpunkte mit Offset vergleichen.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
MinimumLevel	Mindestschweregrad für die Abfrage: Debug, Information, Warning oder Error. Höhere Grenzen koennen wichtige Diagnoseereignisse ausblenden. Debug Technische Detailbeobachtung. Information Normale Lebenszyklus-/Aktionsinformation. Warnung Problemhinweis, der nicht zwingend den Lauf beendet. Fehler Fehlerbeobachtung; den tatsächlichen Laufabschluss zusätzlich über Outcome prüfen.	Debug
OnlyProblems	Beschraenkt die Abfrage auf Problemereignisse. Fuer vollständige Ablaufanalyse auch normale Start-, Status- und Abschlussereignisse lesen.	Aus (Häkchen entfernt)
PageSize	Gewuenschte Anzahl Ereignisse je Seite. Fuer Folgeseiten dieselben Filter und SnapshotSequence verwenden.	100
RunId	ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
Search	Optionaler Suchtext für die vorhandene Logsuche. Suche ersetzt keine stabile Auswertung von Code, Context und Status.	Beispieltext
SnapshotSequence	Obere Snapshot-Sequenz der Abfrage. Bei Folgeseiten denselben Wert verwenden, damit neu angehängte Ereignisse den abgefragten Bestand nicht verschieben.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
Source	Ursprungsart Job, Automation, Application oder Makro. Job Quelle beziehungsweise Ziel ist ein Job. Automation Triggerbeobachtung und Automationsentscheidungen. Application Ereignis stammt aus der Anwendung selbst. Makro Quelle beziehungsweise Ziel ist ein Makro.	Job
SourceId	Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
TriggerId	Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
Until	Optionales Ende des Ereignis-Zeitbereichs als DateTimeOffset. Kein Lauf-Endzeitpunkt und kein Beleg eines erfolgreichen Abschlusses.	Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.

Beispiel

Filtere einen konkreten RunId und lese LogPage mit unveraenderter SnapshotSequence bis NextBeforeSequence=null. Ordne danach StepExecutionId, StepSummaries und Laufstatus gemeinsam zu. Der Log-Leitfaden zeigt ein synthetisches Ereignis im echten Serializerformat.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

State, Issues und IsComplete begrenzen die Aussagekraft. Ein leerer beziehungsweise nicht verfuegbarer Bestand ist kein Erfolgsbeleg. Fehlende ExecutionId oder Endzeitpunkte nicht erfinden.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: LogQuery

Felder und Zusammenhänge auf einen Blick

1
AfterSequenceAfterSequence · Int64 · Nicht angegeben
Untere exklusive Sequenzgrenze: nur spätere Ereignisse lesen
2
AreaArea · String · Nicht angegeben
Textuelle Kontext-/Bereichsangabe
3
BeforeSequenceBeforeSequence · Int64 · Nicht angegeben
Obere exklusive Sequenzgrenze für rückwärtige Seiten
4
CategoryCategory · LogArea · General, Execution, Automation, FileAccess, Capture, Detection, Process, Script, Video, Windows
Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script
5
FromFrom · DateTimeOffset · Nicht angegeben
Optionaler Anfang des Ereignis-Zeitbereichs als DateTimeOffset
6
MinimumLevelMinimumLevel · ExecutionLogLevel · Debug, Information, Warning, Error
Mindestschweregrad für die Abfrage: Debug, Information, Warning oder Error
7
OnlyProblemsOnlyProblems · Boolean · Nicht angegeben
Beschraenkt die Abfrage auf Problemereignisse
8
PageSizePageSize · Int32 · Nicht angegeben
Gewuenschte Anzahl Ereignisse je Seite
9
RunIdRunId · Guid · Nicht angegeben
ID genau dieses Laufs
10
SearchSearch · String · Nicht angegeben
Optionaler Suchtext für die vorhandene Logsuche
11
SnapshotSequenceSnapshotSequence · Int64 · Nicht angegeben
Obere Snapshot-Sequenz der Abfrage
12
SourceSource · LogSource · Job, Automation, Application, Makro
Ursprungsart Job, Automation, Application oder Makro.
13
SourceIdSourceId · Guid · Nicht angegeben
Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.
14
TriggerIdTriggerId · Guid · Nicht angegeben
Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.
15
UntilUntil · DateTimeOffset · Nicht angegeben
Optionales Ende des Ereignis-Zeitbereichs als DateTimeOffset

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
AfterSequence `AfterSequence`	`Int64`	`Nicht angegeben`	Regeln siehe Erklärung	Untere exklusive Sequenzgrenze: nur spätere Ereignisse lesen. Zusammen mit SnapshotSequence eine stabile Abfrage begrenzen.
Area `Area`	`String`	`Nicht angegeben`	Regeln siehe Erklärung	Textuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.
BeforeSequence `BeforeSequence`	`Int64`	`Nicht angegeben`	Regeln siehe Erklärung	Obere exklusive Sequenzgrenze für rückwärtige Seiten. Den NextBeforeSequence-Wert der vorherigen Seite übernehmen, statt Ereignisnummern selbst zu schaetzen.
Category `Category`	`LogArea`	`Nicht angegeben`	Regeln siehe Erklärung `["General", "Execution", "Automation", "FileAccess", "Capture", "Detection", "Process", "Script", "Video", "Windows"]`	Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script. Daraus wird keine Ausführung anhand des Nachrichtentexts abgeleitet. `General` Allgemeiner Log-Fachbereich ohne spezielleren Ausführungsbereich. `Execution` Ausführung und Ablaufsteuerung. `Automation` Triggerbeobachtung und Automationsentscheidungen. `FileAccess` Datei-/Ordnerzugriffe und ihre Diagnose. `Capture` Bildschirm-/Kameraaufnahme. `Detection` Bild-/Text-/Punkterkennung und Auswertung. `Process` Programmstart, Suche, Fokus und Beenden. `Script` Skriptausführung und zugehörige Hintergrundarbeit. `Video` Videoaufnahme und Finalisierung. `Windows` Windows-Taste als Modifikator (Bitmaske 8) beziehungsweise Windows-Fachbereich, wenn diese Option zu einem Log-Bereich gehört.
From `From`	`DateTimeOffset`	`Nicht angegeben`	Regeln siehe Erklärung	Optionaler Anfang des Ereignis-Zeitbereichs als DateTimeOffset. Zeitpunkte mit Offset vergleichen.
MinimumLevel `MinimumLevel`	`ExecutionLogLevel`	`Nicht angegeben`	Regeln siehe Erklärung `["Debug", "Information", "Warning", "Error"]`	Mindestschweregrad für die Abfrage: Debug, Information, Warning oder Error. Höhere Grenzen koennen wichtige Diagnoseereignisse ausblenden. `Debug` Technische Detailbeobachtung. `Information` Normale Lebenszyklus-/Aktionsinformation. `Warning` Problemhinweis, der nicht zwingend den Lauf beendet. `Error` Fehlerbeobachtung; den tatsächlichen Laufabschluss zusätzlich über Outcome prüfen.
OnlyProblems `OnlyProblems`	`Boolean`	`Nicht angegeben`	Regeln siehe Erklärung	Beschraenkt die Abfrage auf Problemereignisse. Fuer vollständige Ablaufanalyse auch normale Start-, Status- und Abschlussereignisse lesen.
PageSize `PageSize`	`Int32`	`Nicht angegeben`	Regeln siehe Erklärung	Gewuenschte Anzahl Ereignisse je Seite. Fuer Folgeseiten dieselben Filter und SnapshotSequence verwenden.
RunId `RunId`	`Guid`	`Nicht angegeben`	Regeln siehe Erklärung	ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.
Search `Search`	`String`	`Nicht angegeben`	Regeln siehe Erklärung	Optionaler Suchtext für die vorhandene Logsuche. Suche ersetzt keine stabile Auswertung von Code, Context und Status.
SnapshotSequence `SnapshotSequence`	`Int64`	`Nicht angegeben`	Regeln siehe Erklärung	Obere Snapshot-Sequenz der Abfrage. Bei Folgeseiten denselben Wert verwenden, damit neu angehängte Ereignisse den abgefragten Bestand nicht verschieben.
Source `Source`	`LogSource`	`Nicht angegeben`	Regeln siehe Erklärung `["Job", "Automation", "Application", "Makro"]`	Ursprungsart Job, Automation, Application oder Makro. `Job` Quelle beziehungsweise Ziel ist ein Job. `Automation` Triggerbeobachtung und Automationsentscheidungen. `Application` Ereignis stammt aus der Anwendung selbst. `Makro` Quelle beziehungsweise Ziel ist ein Makro.
SourceId `SourceId`	`Guid`	`Nicht angegeben`	Regeln siehe Erklärung	Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.
TriggerId `TriggerId`	`Guid`	`Nicht angegeben`	Regeln siehe Erklärung	Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.
Until `Until`	`DateTimeOffset`	`Nicht angegeben`	Regeln siehe Erklärung	Optionales Ende des Ereignis-Zeitbereichs als DateTimeOffset. Kein Lauf-Endzeitpunkt und kein Beleg eines erfolgreichen Abschlusses.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag