Vorschau · Entwicklungsstand 1.6.1

LogEvent

Wofür ist das gedacht?

Ein einzelnes strukturiertes Ereignis des Schema-2-Verlaufs. Nutze Code, Context und Sequence für maschinelle Auswertungen; Message und Details sind bereinigte Anzeigen. Einzelereignisse und aggregierte StepSummaries ergänzen sich.

LogEvent verstehen
  1. 1
    Area

    Textuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.

  2. 2
    BranchDecision

    Strukturierte Entscheidung eines Bedingungsblocks mit Aktivität, Grund und Operatoren ohne rohe Vergleichswerte.

  3. 3
    BranchActive

    Ob der betreffende Zweig bei dieser Entscheidung gewählt wurde.

  4. 4
    Conditions

    Ausgewertete Bedingungen mit Position, Zustand und Operator; bewusst ohne sensible Rohvergleichswerte.

  5. 5
    Operator

    Operator der ausgewerteten Bedingung, ohne deren rohen Vergleichsinhalt.

  6. 6
    Position

    Position des Steps beziehungsweise der Bedingung im gespeicherten Snapshot.

  7. 7
    State

    Zustand einer Bedingung/Beobachtung. Fehlende Belege nicht als false oder erfolgreich umdeuten.

  8. 8
    MatchMode

    Verknüpfung der Bedingungsliste, soweit diese Entscheidung einen Vergleich besitzt.

  9. 9
    ParentActive

    Ob der übergeordnete Block bei dieser Entscheidung aktiv war.

  10. 10
    Reason

    Stabiler Grund für Skip, Entscheidung oder Abschluss. Im Zusammenhang mit Code und Phase interpretieren.

  11. 11
    Category

    Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script. Daraus wird keine Ausführung anhand des Nachrichtentexts abgeleitet.

  12. 12
    Code

    Stabiler Ereignistoken wie step.completed. Für Auswertungen diesen Token verwenden statt übersetzte Nachrichtentexte zu parsen.

  13. 13
    Context

    Korrelationsobjekt mit Lauf-, Step-, Trigger- und gegebenenfalls Elternlauf-Identitäten.

  14. 14
    AutomationId

    ID der auslösenden Automation, falls der Lauf aus einer Automation stammt.

  15. 15
    InstanceId

    Dispatcher-Instanz-ID der Ausführung. Mehrere Ausführungen desselben Jobs besitzen unterschiedliche Instanzen.

  16. 16
    ParentRunId

    Übergeordneter Lauf eines Unterjobs. Ermöglicht die Navigation von besitzender Arbeit zu Kindläufen.

  17. 17
    RunId

    ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.

  18. 18
    StepExecutionId

    Identität einer tatsächlichen Step-Ausführung. Start und terminales Ereignis teilen sie; eine Wiederholung erhält eine neue Identität.

  19. 19
    StepId

    Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.

  20. 20
    TriggerId

    Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.

  21. 21
    Details

    Optionale bereinigte Zusatzdiagnose. Eingabewerte, Skriptargumente und Secrets werden nicht vollständig hineinkopiert.

  22. 22
    DiagnosticCode

    Stabiler Diagnosecode für bekannte Fehler-/Speicherfälle, soweit vorhanden.

  23. 23
    DurationMs

    Gemessene Dauer in Millisekunden. Ein fehlender Wert ist keine Dauer von null.

  24. 24
    FlowEffect

    Strukturierter Einfluss auf den Ablauf, etwa beendete Hauptphase oder nächster Durchlauf.

  25. 25
    Kind

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  26. 26
    Id

    Eindeutige Identität des Ereignisses beziehungsweise Laufs. Ereignis-ID und RunId haben unterschiedliche Aufgaben.

  27. 27
    Iteration

    Nummer des Hauptdurchlaufs, soweit das Ereignis einem Durchlauf zugeordnet ist.

  28. 28
    Level

    Schweregrad Debug, Information, Warning oder Error. Eine Warning ist nicht automatisch ein abgebrochener Lauf.

  29. 29
    Message

    Lesbare, bereinigte Nachricht. Sie ist eine Anzeige und keine stabile Programmierschnittstelle.

  30. 30
    Parameters

    Explizit erlaubte, bereinigte Diagnosewerte. Keine vollständige Kopie der Step-settings oder frei verfügbarer Eingabeinhalte.

  31. 31
    Paths

    Explizit erlaubte strukturierte Aktionspfade. Werden getrennt von beliebigen Eingabetexten erfasst und bei Export erneut bereinigt.

  32. 32
    Kind

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  33. 33
    Value

    Wert eines strukturierten erlaubten Pfad-/Diagnoseeintrags, entsprechend seinem umgebenden Typ.

  34. 34
    Phase

    Bereich der Ausführung: Startphase, Hauptphase oder Endphase. Er beeinflusst die Bedeutung fehlender und übersprungener Steps.

  35. 35
    ProblemId

    Gemeinsame Problemidentität für mehrere Diagnosen desselben Vorfalls; dadurch werden Probleme nicht anhand ihrer Textzeilen doppelt gezählt.

  36. 36
    RelatedInstanceIds

    Instanzen, die an einer Automationsentscheidung beteiligt waren, zum Beispiel bereits laufende Ziele bei Restart/Ignore.

  37. 37
    SchemaVersion

    Version des strukturierten Logformats; der aktuelle Repository-Vertrag ist Schema 2.

  38. 38
    Sequence

    Repositoryweit aufsteigende Ereignissequenz für Reihenfolge und Seitencursor, unabhängig von gleichzeitigen Zeitstempeln.

  39. 39
    Source

    Ursprungsart Job, Automation, Application oder Makro.

  40. 40
    SourceId

    Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.

  41. 41
    SourceName

    Zum Ereigniszeitpunkt gespeicherter Anzeigename der Quelle.

  42. 42
    Timestamp

    Zeitpunkt des Ereignisses mit Zeitzonenoffset. Für Vergleiche UTC verwenden.

  43. 43
    Trigger

    Snapshot der auslösenden Ereignisart und Zielzuordnung, soweit vorhanden.

  44. 44
    EventKind

    Konkrete Ereignisart des Trigger-Snapshots.

  45. 45
    Kind

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  46. 46
    TargetId

    Stabile ID des von der Automation angesprochenen Jobs/Makros.

  47. 47
    TargetKind

    Art des Automationsziels: Job oder Makro.

  48. 48
    TargetName

    Gespeicherter Anzeigename des Ziels zum Zeitpunkt der Beobachtung.

  49. 49
    WatchedDirectory

    Explizit erlaubter beobachteter Ordnerpfad für eine Datei-Automation.

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.

EinstellungBedeutung und BedienungBeispielwert
AreaTextuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.Beispieltext
BranchDecisionStrukturierte Entscheidung eines Bedingungsblocks mit Aktivität, Grund und Operatoren ohne rohe Vergleichswerte.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
BranchActiveOb der betreffende Zweig bei dieser Entscheidung gewählt wurde.Aus (Häkchen entfernt)
ConditionsAusgewertete Bedingungen mit Position, Zustand und Operator; bewusst ohne sensible Rohvergleichswerte.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
OperatorOperator der ausgewerteten Bedingung, ohne deren rohen Vergleichsinhalt.Beispieltext
PositionPosition des Steps beziehungsweise der Bedingung im gespeicherten Snapshot.100
StateZustand einer Bedingung/Beobachtung. Fehlende Belege nicht als false oder erfolgreich umdeuten.Beispieltext
MatchModeVerknüpfung der Bedingungsliste, soweit diese Entscheidung einen Vergleich besitzt.Beispieltext
ParentActiveOb der übergeordnete Block bei dieser Entscheidung aktiv war.Aus (Häkchen entfernt)
ReasonStabiler Grund für Skip, Entscheidung oder Abschluss. Im Zusammenhang mit Code und Phase interpretieren.Beispieltext
CategoryTypisierter 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
CodeStabiler Ereignistoken wie step.completed. Für Auswertungen diesen Token verwenden statt übersetzte Nachrichtentexte zu parsen.Beispieltext
ContextKorrelationsobjekt mit Lauf-, Step-, Trigger- und gegebenenfalls Elternlauf-Identitäten.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
AutomationIdID der auslösenden Automation, falls der Lauf aus einer Automation stammt.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
InstanceIdDispatcher-Instanz-ID der Ausführung. Mehrere Ausführungen desselben Jobs besitzen unterschiedliche Instanzen.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
ParentRunIdÜbergeordneter Lauf eines Unterjobs. Ermöglicht die Navigation von besitzender Arbeit zu Kindläufen.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
RunIdID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
StepExecutionIdIdentität einer tatsächlichen Step-Ausführung. Start und terminales Ereignis teilen sie; eine Wiederholung erhält eine neue Identität.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
StepIdStabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.Beispieltext
TriggerIdIdentität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
DetailsOptionale bereinigte Zusatzdiagnose. Eingabewerte, Skriptargumente und Secrets werden nicht vollständig hineinkopiert.Beispieltext
DiagnosticCodeStabiler Diagnosecode für bekannte Fehler-/Speicherfälle, soweit vorhanden.Beispieltext
DurationMsGemessene Dauer in Millisekunden. Ein fehlender Wert ist keine Dauer von null.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
FlowEffectStrukturierter Einfluss auf den Ablauf, etwa beendete Hauptphase oder nächster Durchlauf.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
KindArt des Triggers beziehungsweise der strukturierten Beobachtung.Beispieltext
IdEindeutige Identität des Ereignisses beziehungsweise Laufs. Ereignis-ID und RunId haben unterschiedliche Aufgaben.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
IterationNummer des Hauptdurchlaufs, soweit das Ereignis einem Durchlauf zugeordnet ist.100
LevelSchweregrad Debug, Information, Warning oder Error. Eine Warning ist nicht automatisch ein abgebrochener Lauf.
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
MessageLesbare, bereinigte Nachricht. Sie ist eine Anzeige und keine stabile Programmierschnittstelle.Beispieltext
ParametersExplizit erlaubte, bereinigte Diagnosewerte. Keine vollständige Kopie der Step-settings oder frei verfügbarer Eingabeinhalte.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
PathsExplizit erlaubte strukturierte Aktionspfade. Werden getrennt von beliebigen Eingabetexten erfasst und bei Export erneut bereinigt.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
KindArt des Triggers beziehungsweise der strukturierten Beobachtung.Beispieltext
ValueWert eines strukturierten erlaubten Pfad-/Diagnoseeintrags, entsprechend seinem umgebenden Typ.Beispieltext
PhaseBereich der Ausführung: Startphase, Hauptphase oder Endphase. Er beeinflusst die Bedeutung fehlender und übersprungener Steps.Beispieltext
ProblemIdGemeinsame Problemidentität für mehrere Diagnosen desselben Vorfalls; dadurch werden Probleme nicht anhand ihrer Textzeilen doppelt gezählt.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
RelatedInstanceIdsInstanzen, die an einer Automationsentscheidung beteiligt waren, zum Beispiel bereits laufende Ziele bei Restart/Ignore.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
SchemaVersionVersion des strukturierten Logformats; der aktuelle Repository-Vertrag ist Schema 2.100
SequenceRepositoryweit aufsteigende Ereignissequenz für Reihenfolge und Seitencursor, unabhängig von gleichzeitigen Zeitstempeln.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
SourceUrsprungsart 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
SourceIdStabile 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.
SourceNameZum Ereigniszeitpunkt gespeicherter Anzeigename der Quelle.Beispieltext
TimestampZeitpunkt des Ereignisses mit Zeitzonenoffset. Für Vergleiche UTC verwenden.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
TriggerSnapshot der auslösenden Ereignisart und Zielzuordnung, soweit vorhanden.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
EventKindKonkrete Ereignisart des Trigger-Snapshots.Beispieltext
KindArt des Triggers beziehungsweise der strukturierten Beobachtung.Beispieltext
TargetIdStabile ID des von der Automation angesprochenen Jobs/Makros.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
TargetKindArt des Automationsziels: Job oder Makro.Beispieltext
TargetNameGespeicherter Anzeigename des Ziels zum Zeitpunkt der Beobachtung.Beispieltext
WatchedDirectoryExplizit erlaubter beobachteter Ordnerpfad für eine Datei-Automation.Beispieltext

Beispiel

Öffne Logs, filtere die Quelle und den Zeitraum, öffne einen Lauf und verknüpfe die Ereignisse über Context.RunId. Für eine technische Untersuchung den Bericht exportieren und runs.json zusammen mit den JSONL-Ereignissen lesen. Einzelereignisse und StepSummaries gemeinsam berücksichtigen.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Eine Datenlücke, nicht verfügbare Datei oder IsComplete=false begrenzt die Aussagekraft. Ein Start-/Dispatch-Ereignis beweist keinen Abschluss. Nicht ausgeführte, deaktivierte und übersprungene Steps getrennt behandeln; übersetzte Message-Texte nicht als stabile Statuscodes parsen.

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: LogEvent

Felder und Zusammenhänge auf einen Blick
  1. 1
    AreaArea · String · Nicht angegeben

    Textuelle Kontext-/Bereichsangabe

  2. 2
    BranchDecisionBranchDecision · LogBranchDecision · Nicht angegeben

    Strukturierte Entscheidung eines Bedingungsblocks mit Aktivität, Grund und Operatoren ohne rohe Vergleichswerte.

  3. 3
    BranchActiveBranchDecision.BranchActive · Boolean · Nicht angegeben

    Ob der betreffende Zweig bei dieser Entscheidung gewählt wurde.

  4. 4
    ConditionsBranchDecision.Conditions · IReadOnlyList`1 · Nicht angegeben

    Ausgewertete Bedingungen mit Position, Zustand und Operator; bewusst ohne sensible Rohvergleichswerte.

  5. 5
    OperatorBranchDecision.Conditions.Operator · String · Nicht angegeben

    Operator der ausgewerteten Bedingung, ohne deren rohen Vergleichsinhalt.

  6. 6
    PositionBranchDecision.Conditions.Position · Int32 · Nicht angegeben

    Position des Steps beziehungsweise der Bedingung im gespeicherten Snapshot.

  7. 7
    StateBranchDecision.Conditions.State · String · Nicht angegeben

    Zustand einer Bedingung/Beobachtung

  8. 8
    MatchModeBranchDecision.MatchMode · String · Nicht angegeben

    Verknüpfung der Bedingungsliste, soweit diese Entscheidung einen Vergleich besitzt.

  9. 9
    ParentActiveBranchDecision.ParentActive · Boolean · Nicht angegeben

    Ob der übergeordnete Block bei dieser Entscheidung aktiv war.

  10. 10
    ReasonBranchDecision.Reason · String · Nicht angegeben

    Stabiler Grund für Skip, Entscheidung oder Abschluss

  11. 11
    CategoryCategory · LogArea · General, Execution, Automation, FileAccess, Capture, Detection, Process, Script, Video, Windows

    Typisierter Fachbereich, zum Beispiel FileAccess, Capture oder Script

  12. 12
    CodeCode · String · Nicht angegeben

    Stabiler Ereignistoken wie step.completed

  13. 13
    ContextContext · LogContext · Nicht angegeben

    Korrelationsobjekt mit Lauf-, Step-, Trigger- und gegebenenfalls Elternlauf-Identitäten.

  14. 14
    AutomationIdContext.AutomationId · Guid · Nicht angegeben

    ID der auslösenden Automation, falls der Lauf aus einer Automation stammt.

  15. 15
    InstanceIdContext.InstanceId · Guid · Nicht angegeben

    Dispatcher-Instanz-ID der Ausführung

  16. 16
    ParentRunIdContext.ParentRunId · Guid · Nicht angegeben

    Übergeordneter Lauf eines Unterjobs

  17. 17
    RunIdContext.RunId · Guid · Nicht angegeben

    ID genau dieses Laufs

  18. 18
    StepExecutionIdContext.StepExecutionId · Guid · Nicht angegeben

    Identität einer tatsächlichen Step-Ausführung

  19. 19
    StepIdContext.StepId · String · Nicht angegeben

    Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.

  20. 20
    TriggerIdContext.TriggerId · Guid · Nicht angegeben

    Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.

  21. 21
    DetailsDetails · String · Nicht angegeben

    Optionale bereinigte Zusatzdiagnose

  22. 22
    DiagnosticCodeDiagnosticCode · String · Nicht angegeben

    Stabiler Diagnosecode für bekannte Fehler-/Speicherfälle, soweit vorhanden.

  23. 23
    DurationMsDurationMs · Int64 · Nicht angegeben

    Gemessene Dauer in Millisekunden

  24. 24
    FlowEffectFlowEffect · LogFlowEffect · Nicht angegeben

    Strukturierter Einfluss auf den Ablauf, etwa beendete Hauptphase oder nächster Durchlauf.

  25. 25
    KindFlowEffect.Kind · String · Nicht angegeben

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  26. 26
    IdId · Guid · Nicht angegeben

    Eindeutige Identität des Ereignisses beziehungsweise Laufs

  27. 27
    IterationIteration · Int32 · Nicht angegeben

    Nummer des Hauptdurchlaufs, soweit das Ereignis einem Durchlauf zugeordnet ist.

  28. 28
    LevelLevel · ExecutionLogLevel · Debug, Information, Warning, Error

    Schweregrad Debug, Information, Warning oder Error

  29. 29
    MessageMessage · String · Nicht angegeben

    Lesbare, bereinigte Nachricht

  30. 30
    ParametersParameters · Dictionary`2 · Nicht angegeben

    Explizit erlaubte, bereinigte Diagnosewerte

  31. 31
    PathsPaths · IReadOnlyList`1 · Nicht angegeben

    Explizit erlaubte strukturierte Aktionspfade

  32. 32
    KindPaths.Kind · String · Nicht angegeben

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  33. 33
    ValuePaths.Value · String · Nicht angegeben

    Wert eines strukturierten erlaubten Pfad-/Diagnoseeintrags, entsprechend seinem umgebenden Typ.

  34. 34
    PhasePhase · String · Nicht angegeben

    Bereich der Ausführung: Startphase, Hauptphase oder Endphase

  35. 35
    ProblemIdProblemId · Guid · Nicht angegeben

    Gemeinsame Problemidentität für mehrere Diagnosen desselben Vorfalls; dadurch werden Probleme nicht anhand ihrer Textzeilen doppelt gezählt.

  36. 36
    RelatedInstanceIdsRelatedInstanceIds · IReadOnlyList`1 · Nicht angegeben

    Instanzen, die an einer Automationsentscheidung beteiligt waren, zum Beispiel bereits laufende Ziele bei Restart/Ignore.

  37. 37
    SchemaVersionSchemaVersion · Int32 · Nicht angegeben

    Version des strukturierten Logformats; der aktuelle Repository-Vertrag ist Schema 2.

  38. 38
    SequenceSequence · Int64 · Nicht angegeben

    Repositoryweit aufsteigende Ereignissequenz für Reihenfolge und Seitencursor, unabhängig von gleichzeitigen Zeitstempeln.

  39. 39
    SourceSource · LogSource · Job, Automation, Application, Makro

    Ursprungsart Job, Automation, Application oder Makro.

  40. 40
    SourceIdSourceId · Guid · Nicht angegeben

    Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.

  41. 41
    SourceNameSourceName · String · Nicht angegeben

    Zum Ereigniszeitpunkt gespeicherter Anzeigename der Quelle.

  42. 42
    TimestampTimestamp · DateTimeOffset · Nicht angegeben

    Zeitpunkt des Ereignisses mit Zeitzonenoffset

  43. 43
    TriggerTrigger · LogTriggerSnapshot · Nicht angegeben

    Snapshot der auslösenden Ereignisart und Zielzuordnung, soweit vorhanden.

  44. 44
    EventKindTrigger.EventKind · String · Nicht angegeben

    Konkrete Ereignisart des Trigger-Snapshots.

  45. 45
    KindTrigger.Kind · String · Nicht angegeben

    Art des Triggers beziehungsweise der strukturierten Beobachtung.

  46. 46
    TargetIdTrigger.TargetId · Guid · Nicht angegeben

    Stabile ID des von der Automation angesprochenen Jobs/Makros.

  47. 47
    TargetKindTrigger.TargetKind · String · Nicht angegeben

    Art des Automationsziels: Job oder Makro.

  48. 48
    TargetNameTrigger.TargetName · String · Nicht angegeben

    Gespeicherter Anzeigename des Ziels zum Zeitpunkt der Beobachtung.

  49. 49
    WatchedDirectoryTrigger.WatchedDirectory · String · Nicht angegeben

    Explizit erlaubter beobachteter Ordnerpfad für eine Datei-Automation.

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

Feldtypen, Standards und Regeln

WertTypStandard laut VertragOptionen und RegelnErklärung
Area
Area
StringNicht angegebenRegeln siehe Erklärung
Textuelle Kontext-/Bereichsangabe. Für fachliche Filter zusätzlich die typisierte Category verwenden.
BranchDecision
BranchDecision
LogBranchDecisionNicht angegebenRegeln siehe Erklärung
Strukturierte Entscheidung eines Bedingungsblocks mit Aktivität, Grund und Operatoren ohne rohe Vergleichswerte.
BranchActive
BranchDecision.BranchActive
BooleanNicht angegebenRegeln siehe Erklärung
Ob der betreffende Zweig bei dieser Entscheidung gewählt wurde.
Conditions
BranchDecision.Conditions
IReadOnlyList`1Nicht angegebenRegeln siehe Erklärung
Ausgewertete Bedingungen mit Position, Zustand und Operator; bewusst ohne sensible Rohvergleichswerte.
Operator
BranchDecision.Conditions.Operator
StringNicht angegebenRegeln siehe Erklärung
Operator der ausgewerteten Bedingung, ohne deren rohen Vergleichsinhalt.
Position
BranchDecision.Conditions.Position
Int32Nicht angegebenRegeln siehe Erklärung
Position des Steps beziehungsweise der Bedingung im gespeicherten Snapshot.
State
BranchDecision.Conditions.State
StringNicht angegebenRegeln siehe Erklärung
Zustand einer Bedingung/Beobachtung. Fehlende Belege nicht als false oder erfolgreich umdeuten.
MatchMode
BranchDecision.MatchMode
StringNicht angegebenRegeln siehe Erklärung
Verknüpfung der Bedingungsliste, soweit diese Entscheidung einen Vergleich besitzt.
ParentActive
BranchDecision.ParentActive
BooleanNicht angegebenRegeln siehe Erklärung
Ob der übergeordnete Block bei dieser Entscheidung aktiv war.
Reason
BranchDecision.Reason
StringNicht angegebenRegeln siehe Erklärung
Stabiler Grund für Skip, Entscheidung oder Abschluss. Im Zusammenhang mit Code und Phase interpretieren.
Category
Category
LogAreaNicht angegebenRegeln 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.
Code
Code
StringNicht angegebenRegeln siehe Erklärung
Stabiler Ereignistoken wie step.completed. Für Auswertungen diesen Token verwenden statt übersetzte Nachrichtentexte zu parsen.
Context
Context
LogContextNicht angegebenRegeln siehe Erklärung
Korrelationsobjekt mit Lauf-, Step-, Trigger- und gegebenenfalls Elternlauf-Identitäten.
AutomationId
Context.AutomationId
GuidNicht angegebenRegeln siehe Erklärung
ID der auslösenden Automation, falls der Lauf aus einer Automation stammt.
InstanceId
Context.InstanceId
GuidNicht angegebenRegeln siehe Erklärung
Dispatcher-Instanz-ID der Ausführung. Mehrere Ausführungen desselben Jobs besitzen unterschiedliche Instanzen.
ParentRunId
Context.ParentRunId
GuidNicht angegebenRegeln siehe Erklärung
Übergeordneter Lauf eines Unterjobs. Ermöglicht die Navigation von besitzender Arbeit zu Kindläufen.
RunId
Context.RunId
GuidNicht angegebenRegeln siehe Erklärung
ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.
StepExecutionId
Context.StepExecutionId
GuidNicht angegebenRegeln siehe Erklärung
Identität einer tatsächlichen Step-Ausführung. Start und terminales Ereignis teilen sie; eine Wiederholung erhält eine neue Identität.
StepId
Context.StepId
StringNicht angegebenRegeln siehe Erklärung
Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.
TriggerId
Context.TriggerId
GuidNicht angegebenRegeln siehe Erklärung
Identität der konkreten Ereignisbeobachtung, nicht nur der gespeicherten Triggerkonfiguration.
Details
Details
StringNicht angegebenRegeln siehe Erklärung
Optionale bereinigte Zusatzdiagnose. Eingabewerte, Skriptargumente und Secrets werden nicht vollständig hineinkopiert.
DiagnosticCode
DiagnosticCode
StringNicht angegebenRegeln siehe Erklärung
Stabiler Diagnosecode für bekannte Fehler-/Speicherfälle, soweit vorhanden.
DurationMs
DurationMs
Int64Nicht angegebenRegeln siehe Erklärung
Gemessene Dauer in Millisekunden. Ein fehlender Wert ist keine Dauer von null.
FlowEffect
FlowEffect
LogFlowEffectNicht angegebenRegeln siehe Erklärung
Strukturierter Einfluss auf den Ablauf, etwa beendete Hauptphase oder nächster Durchlauf.
Kind
FlowEffect.Kind
StringNicht angegebenRegeln siehe Erklärung
Art des Triggers beziehungsweise der strukturierten Beobachtung.
Id
Id
GuidNicht angegebenRegeln siehe Erklärung
Eindeutige Identität des Ereignisses beziehungsweise Laufs. Ereignis-ID und RunId haben unterschiedliche Aufgaben.
Iteration
Iteration
Int32Nicht angegebenRegeln siehe Erklärung
Nummer des Hauptdurchlaufs, soweit das Ereignis einem Durchlauf zugeordnet ist.
Level
Level
ExecutionLogLevelNicht angegebenRegeln siehe Erklärung
["Debug", "Information", "Warning", "Error"]
Schweregrad Debug, Information, Warning oder Error. Eine Warning ist nicht automatisch ein abgebrochener Lauf.
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.
Message
Message
StringNicht angegebenRegeln siehe Erklärung
Lesbare, bereinigte Nachricht. Sie ist eine Anzeige und keine stabile Programmierschnittstelle.
Parameters
Parameters
Dictionary`2Nicht angegebenRegeln siehe Erklärung
Explizit erlaubte, bereinigte Diagnosewerte. Keine vollständige Kopie der Step-settings oder frei verfügbarer Eingabeinhalte.
Paths
Paths
IReadOnlyList`1Nicht angegebenRegeln siehe Erklärung
Explizit erlaubte strukturierte Aktionspfade. Werden getrennt von beliebigen Eingabetexten erfasst und bei Export erneut bereinigt.
Kind
Paths.Kind
StringNicht angegebenRegeln siehe Erklärung
Art des Triggers beziehungsweise der strukturierten Beobachtung.
Value
Paths.Value
StringNicht angegebenRegeln siehe Erklärung
Wert eines strukturierten erlaubten Pfad-/Diagnoseeintrags, entsprechend seinem umgebenden Typ.
Phase
Phase
StringNicht angegebenRegeln siehe Erklärung
Bereich der Ausführung: Startphase, Hauptphase oder Endphase. Er beeinflusst die Bedeutung fehlender und übersprungener Steps.
ProblemId
ProblemId
GuidNicht angegebenRegeln siehe Erklärung
Gemeinsame Problemidentität für mehrere Diagnosen desselben Vorfalls; dadurch werden Probleme nicht anhand ihrer Textzeilen doppelt gezählt.
RelatedInstanceIds
RelatedInstanceIds
IReadOnlyList`1Nicht angegebenRegeln siehe Erklärung
Instanzen, die an einer Automationsentscheidung beteiligt waren, zum Beispiel bereits laufende Ziele bei Restart/Ignore.
SchemaVersion
SchemaVersion
Int32Nicht angegebenRegeln siehe Erklärung
Version des strukturierten Logformats; der aktuelle Repository-Vertrag ist Schema 2.
Sequence
Sequence
Int64Nicht angegebenRegeln siehe Erklärung
Repositoryweit aufsteigende Ereignissequenz für Reihenfolge und Seitencursor, unabhängig von gleichzeitigen Zeitstempeln.
Source
Source
LogSourceNicht angegebenRegeln 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
GuidNicht angegebenRegeln siehe Erklärung
Stabile ID des ursprünglichen Jobs/Makros/der Automation; sie ist nicht die Identität eines einzelnen Laufs.
SourceName
SourceName
StringNicht angegebenRegeln siehe Erklärung
Zum Ereigniszeitpunkt gespeicherter Anzeigename der Quelle.
Timestamp
Timestamp
DateTimeOffsetNicht angegebenRegeln siehe Erklärung
Zeitpunkt des Ereignisses mit Zeitzonenoffset. Für Vergleiche UTC verwenden.
Trigger
Trigger
LogTriggerSnapshotNicht angegebenRegeln siehe Erklärung
Snapshot der auslösenden Ereignisart und Zielzuordnung, soweit vorhanden.
EventKind
Trigger.EventKind
StringNicht angegebenRegeln siehe Erklärung
Konkrete Ereignisart des Trigger-Snapshots.
Kind
Trigger.Kind
StringNicht angegebenRegeln siehe Erklärung
Art des Triggers beziehungsweise der strukturierten Beobachtung.
TargetId
Trigger.TargetId
GuidNicht angegebenRegeln siehe Erklärung
Stabile ID des von der Automation angesprochenen Jobs/Makros.
TargetKind
Trigger.TargetKind
StringNicht angegebenRegeln siehe Erklärung
Art des Automationsziels: Job oder Makro.
TargetName
Trigger.TargetName
StringNicht angegebenRegeln siehe Erklärung
Gespeicherter Anzeigename des Ziels zum Zeitpunkt der Beobachtung.
WatchedDirectory
Trigger.WatchedDirectory
StringNicht angegebenRegeln siehe Erklärung
Explizit erlaubter beobachteter Ordnerpfad für eine Datei-Automation.

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