Vorschau · Entwicklungsstand 1.6.1
LogDiagnostic
Wofür ist das gedacht?
Stabiler Diagnosecode mit lokalisierten Ursachen-/Hilfeschlüsseln und angebotenen Hilfsaktionen. Übersetzte Texte nicht als maschinelle Identitaet verwenden.
- 1Actions
Angebotene Diagnoseaktionen mit Kind und optional RunId, StepId oder Path. Verweisen auf konkrete Hilfs-/Navigationsziele; sind keine ausgefuehrten Jobs.
- 2Kind
Art der jeweiligen Diagnose-Hilfsaktion; die optionalen Ziel-IDs und Pfade passend zu dieser Art interpretieren.
- 3Path
Optionaler strukturierter Pfad einer Diagnoseaktion. Nur im beschriebenen Aktionskontext verwenden; ein vorhandener Pfad beweist weder Existenz noch erfolgreiche Dateioperation.
- 4RunId
ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs.
- 5StepId
Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.
- 6CauseKey
Lokalisierungsschlüssel der Diagnoseursache. Fuer Anzeige aufloesen, für maschinelle Identitaet den stabilen Code verwenden.
- 7Code
Stabiler Diagnosecode, unabhaengig von lokalisierter Ursache und Hilfe. Mit CauseKey, HelpKey und Actions für die Anzeige kombinieren.
- 8HelpKey
Lokalisierungsschlüssel des konkreten Hilfetexts zur Diagnose. Kein freier Skriptbefehl.
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 |
|---|---|---|
| Actions | Angebotene Diagnoseaktionen mit Kind und optional RunId, StepId oder Path. Verweisen auf konkrete Hilfs-/Navigationsziele; sind keine ausgefuehrten Jobs. | Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten. |
| Kind | Art der jeweiligen Diagnose-Hilfsaktion; die optionalen Ziel-IDs und Pfade passend zu dieser Art interpretieren. | Beispieltext |
| Path | Optionaler strukturierter Pfad einer Diagnoseaktion. Nur im beschriebenen Aktionskontext verwenden; ein vorhandener Pfad beweist weder Existenz noch erfolgreiche Dateioperation. | Beispieltext |
| 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. |
| StepId | Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden. | Beispieltext |
| CauseKey | Lokalisierungsschlüssel der Diagnoseursache. Fuer Anzeige aufloesen, für maschinelle Identitaet den stabilen Code verwenden. | Beispieltext |
| Code | Stabiler Diagnosecode, unabhaengig von lokalisierter Ursache und Hilfe. Mit CauseKey, HelpKey und Actions für die Anzeige kombinieren. | Beispieltext |
| HelpKey | Lokalisierungsschlüssel des konkreten Hilfetexts zur Diagnose. Kein freier Skriptbefehl. | Beispieltext |
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 ansehenFehler 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: LogDiagnostic
- 1ActionsActions · IReadOnlyList`1 · Nicht angegeben
Angebotene Diagnoseaktionen mit Kind und optional RunId, StepId oder Path
- 2KindActions.Kind · String · Nicht angegeben
Art der jeweiligen Diagnose-Hilfsaktion; die optionalen Ziel-IDs und Pfade passend zu dieser Art interpretieren.
- 3PathActions.Path · String · Nicht angegeben
Optionaler strukturierter Pfad einer Diagnoseaktion
- 4RunIdActions.RunId · Guid · Nicht angegeben
ID genau dieses Laufs
- 5StepIdActions.StepId · String · Nicht angegeben
Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden.
- 6CauseKeyCauseKey · String · Nicht angegeben
Lokalisierungsschlüssel der Diagnoseursache
- 7CodeCode · String · Nicht angegeben
Stabiler Diagnosecode, unabhaengig von lokalisierter Ursache und Hilfe
- 8HelpKeyHelpKey · String · Nicht angegeben
Lokalisierungsschlüssel des konkreten Hilfetexts zur Diagnose
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 |
|---|---|---|---|---|
ActionsActions | IReadOnlyList`1 | Nicht angegeben | Regeln siehe Erklärung | Angebotene Diagnoseaktionen mit Kind und optional RunId, StepId oder Path. Verweisen auf konkrete Hilfs-/Navigationsziele; sind keine ausgefuehrten Jobs. |
KindActions.Kind | String | Nicht angegeben | Regeln siehe Erklärung | Art der jeweiligen Diagnose-Hilfsaktion; die optionalen Ziel-IDs und Pfade passend zu dieser Art interpretieren. |
PathActions.Path | String | Nicht angegeben | Regeln siehe Erklärung | Optionaler strukturierter Pfad einer Diagnoseaktion. Nur im beschriebenen Aktionskontext verwenden; ein vorhandener Pfad beweist weder Existenz noch erfolgreiche Dateioperation. |
RunIdActions.RunId | Guid | Nicht angegeben | Regeln siehe Erklärung | ID genau dieses Laufs. Verknüpft Starts, Steps, Probleme und Abschluss desselben Laufs. |
StepIdActions.StepId | String | Nicht angegeben | Regeln siehe Erklärung | Stabile ID des Job-Steps; derselbe Step kann in mehreren Durchläufen ausgeführt werden. |
CauseKeyCauseKey | String | Nicht angegeben | Regeln siehe Erklärung | Lokalisierungsschlüssel der Diagnoseursache. Fuer Anzeige aufloesen, für maschinelle Identitaet den stabilen Code verwenden. |
CodeCode | String | Nicht angegeben | Regeln siehe Erklärung | Stabiler Diagnosecode, unabhaengig von lokalisierter Ursache und Hilfe. Mit CauseKey, HelpKey und Actions für die Anzeige kombinieren. |
HelpKeyHelpKey | String | Nicht angegeben | Regeln siehe Erklärung | Lokalisierungsschlüssel des konkreten Hilfetexts zur Diagnose. Kein freier Skriptbefehl. |
Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag