- Erste Schritte
- Datensicherheit und Compliance
- Organisationen
- Authentifizierung und Sicherheit
- Lizenzierung
- Über die Lizenzierung
- Einheitliche Preise: Lizenzierungsplan-Framework
- Aktivieren Ihrer Enterprise-Lizenz
- Migrieren von Test Suite zu Test Cloud
- Lizenzmigration
- Zuweisen von Lizenzen zu Mandanten
- Zuweisen von Benutzerlizenzen
- Freigegeben von Benutzerlizenzen
- Überwachung der Lizenzzuweisung
- Lizenzüberzuweisung
- Lizenzierungsbenachrichtigungen
- Benutzerlizenzverwaltung
- Mandanten und Dienste
- Konten und Rollen
- AI Trust Layer
- Externe Anwendungen
- Benachrichtigungen
- Protokollierung
- Datenexport
- Tests in Ihrer Organisation
- Fehlersuche und ‑behebung
- Migration zur Test Cloud
Test Cloud-Administratorhandbuch
Datenexport sendet Daten je nach ausgewählter Datenquelle in zwei Formaten:
- Ereignisbasiert (JSON) – Diskrete Ereignisse, die ausgegeben werden, wenn etwas in UiPath passiert (ein Auftrag ändert den Status, ein Warteschlangenelement wird verarbeitet, eine Prüfungsaktion wird aufgezeichnet). Bereitgestellt an Azure Event Hub oder AWS SQS.
- OTEL-Trace – hierarchische Spannen, die Agent- und Maestro-Ausführungsspuren im OpenTelemetry-Format darstellen. Wird an Arize, Databricks oder einen beliebigen OTLP-kompatiblen Endpunkt (OpenTelemetry Protocol) bereitgestellt.
Ereignisbasierte (JSON)-Exporte
Orchestrator-Ereignisse
Der Orchestrator gibt Ereignisse für Aufträge, Warteschlangenelemente, Maschinen und Roboterprotokolle aus. Jedes Ereignis enthält einen gemeinsamen Umschlag sowie einen entitätsspezifischen Textkörper.
Allgemeine Felder
Alle Orchestrator-Ereignisse enthalten die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Ereignistyp | Zeichenfolge, die den Ereignistyp identifiziert (z. B. job.created, queueitem.added). |
| SchemaVersion | Bezeichner der Schemaversion. |
| Zeitstempel | UTC-Zeitstempel des Ereignisses. |
| TenantKey | Mandantenbezeichner. |
| Mandantenname | Anzeigename des Mandanten. |
| FolderKey | Ordnerbezeichner. |
| Ordnername | Anzeigename des Ordners. |
| FullFolderPath | Vollständiger Ordnerpfad. |
Job events
Ausgesetzt am: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating
| Feld | Typ | Beschreibung |
|---|---|---|
| Schlüssel | GUID | Eindeutiger Auftragsbezeichner. |
| Erstellungszeit | Zeitstempel | Erstellungszeit des Auftrags. |
| StartTime | Zeitstempel | Startzeit der Ausführung. |
| EndTime | Zeitstempel | Endzeit der Ausführung. |
| Status (State) | String | Auftragsstatus: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed. |
| ProcessName | String | Name des Quellpakets. |
| DisplayName | String | Anzeigename im Orchestrator. |
| RoboterName (RobotName) | String | Bezeichner des ausgeführten Roboters. |
| Name der Hostmaschine | String | Name der Ausführungsmaschine. |
Queue item events
Ausgesetzt am: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted
| Feld | Typ | Beschreibung |
|---|---|---|
| Schlüssel | GUID | Warteschlangenelementbezeichner. |
| ID Warteschlangendefinition (QueueDefinitionId) | Nummer | Numerische Warteschlangen-ID. |
| Status | String | Elementstatus: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown. |
| Status überprüfen (Review Status) | String | Klassifizierung überprüfen: None, InReview, Verified, Retried, Unknown. |
| Priorität | String | Elementpriorität: High, Normal, Low, Unknown. |
| Fälligkeitsdatum (DueDate) | DateTime | Verarbeitungsfrist. |
| Erstellungszeit | DateTime | Erstellungszeitstempel. |
| Verarbeitung starten (StartProcessing) | DateTime | Die Startzeit der Verarbeitung. |
| Verarbeitung beenden (EndProcessing) | DateTime | Abschlusszeit der Verarbeitung. |
| Verschiebungsdatum (DeferDate) | DateTime | Früheste verfügbare Verarbeitungszeit. |
| SecondsInPreviousAttempt | Nummer | Dauer des vorherigen Versuchs in Sekunden. |
| Wiederholungsanzahl (RetryNumber) | Nummer | Anzahl der Verarbeitungsversuche. |
| Fortschritt | String | Fortschritt des Geschäftsflows. |
| Analysedaten | String | Schlüssel-Wert-Paare der Analytics-Eigenschaft. |
| Ausgabe | String | Ausgabedaten aus der Aktivität „Set Transaction Status“. |
| Spezielle Daten (SpecificData) | String | Benutzerdefinierte Daten aus der Eigenschaft Spezifischer Inhalt oder der Aktivität „Warteschlangenelement hinzufügen“. |
| CreatorJobId | Nummer | Bezeichner des erstellen Auftrags. |
| ExecutorJobId | Nummer | Bezeichner des ausgeführten Auftrags. |
| ProcessExceptionReason | String | Fehlerzusammenfassung. |
| ProcessExceptionDetails | String | Fehlerdetails. |
| ProcessExceptionType | String | Fehlertyp: ApplicationException, BusinessException, None. |
Das in jedes Ereignis eingebettete Queue -Objekt enthält: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.
SpecificData, SpecificContent und Output sind nicht in queueItem.deferred und queueItem.reviewStatusChanged -Ereignissen enthalten.
Machine events
Ausgesetzt am: machine.created, machine.updated, machine.deleted, machine.assign, machine.unassign
| Feld | Typ | Beschreibung |
|---|---|---|
| Maschinen-ID | Nummer | Numerische ID der Maschine. |
| MachineKey | GUID | Maschinenbezeichner. |
| Maschinenname | String | Benutzerdefinierter Name der Maschine. |
| AutomationCloudSlots | Nummer | Reservierte Runtime-Slots. |
| HeadlessSlots | Nummer | Headless-Modus-Slots. |
| NonProductionSlots | Nummer | Non-Production-Umgebungsslots. |
| UnattendedSlots | Nummer | Unbeaufsichtigte Ausführungsslots. |
Zu den Ereignissen der Maschinensitzung (machineSession.status) gehören:
| Feld | Typ | Beschreibung |
|---|---|---|
| MachineKey | GUID | Maschinenbezeichner. |
| Maschinenname | String | Benutzerdefinierter Name der Maschine. |
| Name der Hostmaschine | String | Hostsystemname. |
| Dienstbenutzername | String | UiPath Robot-Dienstkonto. |
| Maschinenstatus | String | Status: Available, Busy, Disconnected, Unknown. |
| Zeitstempel | DateTime | Ereigniszeitstempel. |
| IsUnresponsive | Boolescher | Ob die Verbindung nicht reagiert. |
Roboterprotokollereignisse
Ausgestellt am: robotlog
| Feld | Typ | Beschreibung |
|---|---|---|
| Meldung | String | Protokollinhalt. |
| Ebene | String | Schweregrad: Trace, Info, Warn, Error, Fatal. |
| Protokolltyp | String | Kategorie: User, Default, Error, Business, ExecutionStep, Info, Security, Technical. |
| Zeitstempel | DateTime | Generierungszeitstempel. |
| JobId | GUID | Auftragsschlüssel. |
| ProcessName | String | Name des ausgeführten Prozesses. |
| Prozessversion | String | Prozessversion. |
| RoboterName (RobotName) | String | Roboterbezeichner. |
| Maschinen-ID | Nummer | Numerische ID der Maschine. |
| MachineKey | GUID | Maschinenbezeichner. |
| Maschinenname | String | Maschinenname. |
| Name der Hostmaschine | String | Name der Hostmaschine (nur Sitzungsprotokolle). |
| Windows-Identität | String | Handelndes Benutzerkonto. |
| initiatedBy | String | Ausführungsquelle: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI. |
| FileName | String | .xaml Dateiname ausgeführt. |
| Aktivitätsinfo | JSON | Aktivitätsmetadaten: DisplayName, State, Activity, Arguments. |
| Benutzerdefinierte Felder | JSON | Benutzerdefinierte Felder, die über die Aktivität AddLogFields hinzugefügt wurden. |
| Warteschlangenname (QueueName) | String | Name der Quellwarteschlange (nur Warteschlangenverarbeitung). |
| Transaktions-ID | GUID | Transaktionsschlüssel (nur Warteschlangenverarbeitung). |
| transactionState | String | Started, Ended, Postponed (nur Warteschlangenverarbeitung). |
| transactionStatus | String | Start, Success, Failed, BusinessException, ApplicationException (nur Warteschlangenverarbeitung). |
| Transaktionsausführungszeit | Nummer | Ausführungsdauer in Sekunden (nur Warteschlangenverarbeitung). |
| GesamtausführungszeitInSekunden | Nummer | Gesamtausführungsdauer (nur Warteschlangenverarbeitung). |
| queueItemPriority | String | High, Normal, Low (nur Endprotokolle für Warteschlangentransaktionen). |
| ÜberprüfungsstatusDes Warteschlangenelements | String | InReview, Verified, Reported, Retried (nur Endprotokolle für Warteschlangentransaktionen). |
| ProcessingExceptionReason | String | Grund der Ausnahme (nur Protokolle zum Ende von Warteschlangentransaktionen). |
| Typ der Verarbeitungsausnahme | String | ApplicationException oder BusinessException (nur Endprotokolle von Warteschlangentransaktionen). |
Maestro-Ereignisse
Maestro gibt Ereignisse für Prozessausführungen, Elementausführungen und Vorfälle aus.
Standardfelder
Alle Maestro-Ereignisse enthalten die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| OrganizationId | Bezeichner der Organisation, die das Ereignis ausgibt. |
| TenantId | Bezeichner des Mandanten, der das Ereignis ausgibt. |
| FolderKey | Ordner- oder Arbeitsbereichsbezeichner. |
| Prozessschlüssel | Bezeichner der Prozessdefinition. |
| InstanzID | Bezeichner der Prozessinstanz. |
| RunId | Bezeichner der Prozessausführung. |
| Spannentyp | Maestro-Ereignistyp: Incident, ProcessRun, ElementRun, InstanceOperation. |
| Status | Aktueller Lebenszyklusstatus des Ereignisses. |
| EventUniqueId | Global eindeutiger Bezeichner des ausgegebenen Ereignisses. |
| EventTimeUtc | Zeitstempel, wann das Ereignis ausgegeben wurde. |
| Ablaufverfolgungsattribute | Optionale Metadaten auf Ablaufverfolgungsebene (null-fähig). |
| Spannenattribute | Stringifizierte JSON von zusätzlichen spannenspezifischen Attributen. |
Vorfallsfelder
| Feld | Beschreibung |
|---|---|
| ElementId | Element, in dem der Vorfall aufgetreten ist. |
| Element-AusführungsID | Elementausführung, die dem Vorfall zugeordnet ist. |
| IncidentUpdateTimeUtc | Zeitstempel der letzten Aktualisierung des Vorfalls. |
| Kommentar (Comment) | Optionaler Kommentar, der dem Vorfall zugeordnet ist. |
| Fehlercode | Fehlercode für den Vorfall. |
| Fehlermeldung | Kurze Fehlermeldung. |
| Fehlerdetails | Detaillierte Fehlerinformationen. |
| DebugMode | Debugmodusstatus, als der Vorfall auftrat. |
Prozessausführungsfelder
| Feld | Beschreibung |
|---|---|
| Startzeit UTC | Startzeit der Prozessausführung in UTC. |
| Spannenname | Für den Menschen lesbarer Name der Spanne oder des Ereignisses. |
| Ablaufverfolgungs-ID | Bezeichner der verteilten Ablaufverfolgung für die Korrelation. |
| Spannen-ID | Spannenbezeichner für diese Prozessausführung. |
| ÜbergeordneteSpan-ID | Bezeichner der übergeordneten Spanne (NULL-fähig für Stammspannen). |
| PackageId | Der Paketbezeichner. |
| PackageKey | Paketschlüssel, enthält in der Regel Version. |
| PackageVersion | Paketversion |
| Releasename | Für Menschen lesbarer Release-Name. |
| Externe ID | Bezeichner der externen Korrelation. |
| Quelle | Triggerquelle der Ausführung (z. B. Manual). |
| TypDesDebugmodus | Konfiguration des Debugmodus. |
| Ersteller Benutzerschlüssel | Benutzer, der die Ausführung initiiert hat (nullable). |
| CaseInstanceId | Bezeichner der Fallinstanz (nullable). |
| Fallverwaltungsmetadaten | Metadaten für die Fallverwaltung (null-fähig). |
Elementausführungsfelder
| Feld | Beschreibung |
|---|---|
| Startzeit UTC | Startzeit der Elementausführung in UTC. |
| EndTimeUtc | Endzeit der Elementausführung in UTC. |
| Spannenname | Für den Menschen lesbarer Name der Spanne oder des Ereignisses. |
| Ablaufverfolgungs-ID | Bezeichner der verteilten Ablaufverfolgung für die Korrelation. |
| Spannen-ID | Spannenbezeichner für diese Elementausführung. |
| ÜbergeordneteSpan-ID | Bezeichner der übergeordneten Spanne (nullable). |
| Variablen | Strukturierte Variablen, die bei der Elementausführung erfasst werden. |
| VariablesJson | Als JSON serialisierte Variablen. |
| ElementAusführung.ElementID | Bezeichner des Elements. |
| ElementAusführung.ElementName | Anzeigename des Elements. |
| ElementAusführung.Elementtyp | Elementtyp. |
| ElementAusführung.ElementErweiterungstyp | Erweiterungstyp (nullable). |
| ElementAusführung.ElementAusführungId | Bezeichner der Elementausführung. |
| ElementRun.IncomingFlowId | Bezeichner des eingehenden Flows. |
| ElementRun.IncomingFlowIds | Array mit eingehenden Flow-Bezeichnern (nullable). |
| ElementAusführung.CaseStageElementId | Elementbezeichner der Fallphase (nullable). |
| ElementRun.CaseManagementMetadata | Fallmetadaten auf Elementebene (nullable). |
Beispiel: Elementausführungsereignis
{
"ElementRun": {
"ProcessRun": {
"ProcessInstance": {
"OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
"TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
"FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
"PackageId": "Trace.Test.agentic.Agentic.Process",
"PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
"PackageVersion": "1.0.0",
"ReleaseName": "Agentic Process",
"ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
"InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"CaseInstanceId": null,
"ExternalId": "44777039",
"Source": "Manual",
"DebugModeType": "None",
"CreatorUserKey": null
},
"RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"CaseManagementMetadata": null
},
"ElementId": "__Action=Pending__",
"ElementName": "",
"ElementType": "__InstanceAction__",
"ElementExtensionType": null,
"ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
"IncomingFlowId": "",
"IncomingFlowIds": null,
"CaseStageElementId": null,
"CaseManagementMetadata": null
},
"StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
"EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
"Status": "Pending",
"Variables": {},
"VariablesJson": "{}",
"SpanName": "Instance Created",
"TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
"ParentSpanId": null,
"SpanType": "InstanceOperation",
"EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
"EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
"TraceAttributes": null,
"SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}
{
"ElementRun": {
"ProcessRun": {
"ProcessInstance": {
"OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
"TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
"FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
"PackageId": "Trace.Test.agentic.Agentic.Process",
"PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
"PackageVersion": "1.0.0",
"ReleaseName": "Agentic Process",
"ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
"InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"CaseInstanceId": null,
"ExternalId": "44777039",
"Source": "Manual",
"DebugModeType": "None",
"CreatorUserKey": null
},
"RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"CaseManagementMetadata": null
},
"ElementId": "__Action=Pending__",
"ElementName": "",
"ElementType": "__InstanceAction__",
"ElementExtensionType": null,
"ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
"IncomingFlowId": "",
"IncomingFlowIds": null,
"CaseStageElementId": null,
"CaseManagementMetadata": null
},
"StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
"EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
"Status": "Pending",
"Variables": {},
"VariablesJson": "{}",
"SpanName": "Instance Created",
"TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
"SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
"ParentSpanId": null,
"SpanType": "InstanceOperation",
"EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
"EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
"TraceAttributes": null,
"SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}
Prüfungsprotokollereignisse
Prüfungsprotokollexporte unterstützen sowohl Prüfungsereignisse auf Mandanten- als auch auf Organisationsebene.
Quellen auf Mandantenebene:
Identität und Zugriff: Identität, OMS, KMS, Lizenzierung, AuthZ, Routing
Produkte und Dienste: Integration Service, Data Service, Test Manager, Automation Ops, Apps, Document Understanding
Quellen auf Organisationsebene: Organisationsbezogene Richtlinien- und Benutzerverwaltungsereignisse.
Standardfelder
| Feld | Beschreibung |
|---|---|
| ID | Global eindeutiger Bezeichner des Prüfungsereignisses. |
| LokaleID | Interner sequenzieller Bezeichner für die Bestellung. |
| Erstellt am | Zeitstempel, wann das Ereignis erstellt wurde. |
| Zuletzt geändert | Zeitstempel der letzten Änderung (nullable). |
| Version | Version des Prüfungsereignisdatensatzes. |
| Status (State) | Interner Lebenszyklusstatus des Ereignisses. |
| Status | Ergebnis des Termins (numerische Aufzählung). |
| Ereignistyp | Bezeichner der ausgeführten Aktion. |
| EventSource | Bezeichner des Produkts oder Systems, das das Ereignis auslöst. |
| EventTarget | Bezeichner der Ereigniskategorie. |
| EventDetails | Eingebettete JSON mit ereignisspezifischen Details (siehe unten). |
| ServiceName | Für den Menschen lesbarer Name des sendenden Dienstes. |
| ClientInfo). | Eingebettete JSON mit IpAddress und IpCountry. |
| Akteurs-ID | Eindeutiger Bezeichner des Akteurs. |
| ActorName | Anzeigename des Akteurs. |
| AkteurEMail | E-Mail des Akteurs (nullable). |
| Akteurdetails | Eingebettete JSON mit Metadaten, die den Akteur beschreiben. |
| OrganizationId | Bezeichner der Organisation. |
| Organisationsname | Name der Organisation. |
| TenantId | Mandantenbezeichner (NULL-fähig für Ereignisse auf Organisationsebene). |
| Mandantenname | Mandantenname (NULL-fähig für Ereignisse auf Organisationsebene). |
| Ursprung | Infrastruktur oder regionaler Ursprung des Termins. |
EventDetails-Felder nach Dienst
Das Feld EventDetails ist eine JSON-Zeichenfolge, deren Struktur vom sendenden Dienst abhängt.
Identitäts-/Authentifizierungsereignisse:
| Feld | Beschreibung |
|---|---|
| Benutzer.ID | Bezeichner des Benutzers. |
| Benutzer.Anzeigename | Anzeigename des Benutzers. |
| Benutzer.Email | Benutzer-E-Mail. |
| Benutzer.Typ | Benutzertyp (Aufzählung). |
| Anmeldemethode | Authentifizierungsmethode. |
| Client-ID | Bezeichner des OAuth-Clients. |
| Scopes | Gewährt oder angeforderte Scopes. |
Apps-Ereignisse:
| Feld | Beschreibung |
|---|---|
| App-ID | Eindeutiger App-Bezeichner. |
| appName | Anwendungsname |
| App-Typ | Typ der Anwendung. |
| Version | Anwendungsversion |
| Beschreibung | App-Beschreibung. |
| Ordnername | Ordner, der die App enthält. |
| istActionApp | Ob die App eine Aktions-App ist. |
| istÖffentlicheApp | Ob die App öffentlich sichtbar ist. |
Integration Service-Ereignisse:
| Feld | Beschreibung |
|---|---|
| ConnectionId | Bezeichner der Integrationsverbindung. |
| ConnectionName | Name der Verbindung. |
| Connector | Connector-Anzeigename. |
| ConnectorKey | Eindeutiger Connectorschlüssel. |
Administrator-/Richtlinienereignisse:
| Feld | Beschreibung |
|---|---|
| PolicyId | Richtlinienbezeichner. |
| PolicyName | Richtlinienname. |
| Richtlinie erstellt | Metadaten zur Richtlinienerstellung. |
| Richtlinie gelöscht | Metadaten zum Löschen von Richtlinien. |
| ModifiedFields | Felder haben sich während der Aktualisierung geändert. |
License Resource Manager-Ereignisse:
| Feld | Beschreibung |
|---|---|
| Produktname | Name des lizenzierten Produkts. |
| OldQuantity | Vorherige Lizenzmenge. |
| NewQuantity | Aktualisierte Lizenzmenge. |
| TenantId | Betroffener Mandant. |
| Mandantenname | Name des betroffenen Mandanten. |
| AdminName | Administrator, der die Änderung durchgeführt hat. |
Data Service-Ereignisse (DataFabric):
| Feld | Beschreibung |
|---|---|
| EntityId | Bezeichner der DataFabric-Entität. |
| Entitätsname | Name der Entität. |
| Datensatz-ID | Bezeichner des betroffenen Datensatzes. |
| GeänderteEigenschaften | Durch den Vorgang geänderte Eigenschaften. |
| Zeitstempel | DataFabric-spezifischer Ereigniszeitstempel. |
Beispiel: Prüfungsprotokollereignis
{
"LocalId": 158693,
"State": 0,
"LastModified": null,
"Version": 1,
"Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
"CreatedOn": "2026-01-10T16:15:46.5597482",
"OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
"OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
"TenantId": null,
"TenantName": null,
"ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
"ActorName": "System Administrator",
"ActorEmail": null,
"ActorDetails": "{\"Type\":1}",
"EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
"EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
"EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
"EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"plt_basic_auth_multi_org@uipath-qa.com\",\"Type\":0}}",
"ServiceName": "Identity",
"Status": 0,
"ClientInfo": null,
"Origin": "alp-wus2-01-platform"
}
{
"LocalId": 158693,
"State": 0,
"LastModified": null,
"Version": 1,
"Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
"CreatedOn": "2026-01-10T16:15:46.5597482",
"OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
"OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
"TenantId": null,
"TenantName": null,
"ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
"ActorName": "System Administrator",
"ActorEmail": null,
"ActorDetails": "{\"Type\":1}",
"EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
"EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
"EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
"EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"plt_basic_auth_multi_org@uipath-qa.com\",\"Type\":0}}",
"ServiceName": "Identity",
"Status": 0,
"ClientInfo": null,
"Origin": "alp-wus2-01-platform"
}
OTEL-Trace-Exporte
Agent- und Maestro-Ablaufverfolgungen werden im OpenTelemetry-Format (OTEL) exportiert. Jede Ausführung generiert eine Baumstruktur von Spannen – eine Stammspanne pro Agent- oder Maestro-Ausführung mit untergeordneten Spannen für jeden LLM-Aufruf, jeden Toolaufruf und jede Leitplankenauswertung.
OTEL-Spanfelder
| OTEL-Feld | Beschreibung |
|---|---|
| Ablaufverfolgungs-ID | Ablaufverfolgungsbezeichner. Gruppiert alle Spannen, die zu einer Ausführung gehören. |
| SpannenID | Eindeutiger Bezeichner für diesen Bereich. |
| parentSpanId | Bezeichner der übergeordneten Spanne. Leere Zeichenfolge für Stammspannen. |
| name | Für Menschen lesbarer Spannenname (z. B. Agent run - googlesearch, LLM call). |
| kind | Spannenart: SPAN_KIND_INTERNAL oder SPAN_KIND_CLIENT. |
| startTimeUnixNone | Spannenstartzeit in Unix-Nanosekunden. |
| endTimeUnixNano | Spannenendzeit in Unix-Nanosekunden. |
| status.code | Ausführungsstatus: STATUS_CODE_OK oder STATUS_CODE_ERROR. |
| status.meldung | Statusmeldung (leere Zeichenfolge, wenn kein Fehler). |
| Attribute.* | Spannenattribute, vereinfacht mit Punktnotation (siehe unten). |
UiPath-Attributzuordnung
Die internen Ablaufverfolgungsfelder von UiPath werden wie folgt den OTEL-Attributen zugeordnet:
| UiPath-Feld | OTEL-Attribut | Hinweise |
|---|---|---|
| ID | Spannen_ID | Eindeutiger Spannenbezeichner. |
| Ablaufverfolgungs-ID | Trace_ID | Ablaufverfolgungsbezeichner. |
| ParentId | übergeordnete_span_id | NULL für Stammspannen. |
| Name | name | Spannenname. |
| StartTime | start_time_unix_nano | In Unix-Nanosekunden konvertiert. |
| EndTime | end_time_unix_nano | In Unix-Nanosekunden konvertiert. |
| Status | status.code | 1 = OK, 2 = FEHLER. |
| Attribute | Attribute | JSON-Zeichenfolge, die mithilfe der Punktnotation in Schlüssel-Wert-Paare analysiert wurde. |
| Spannentyp, Organisations-ID, Mandanten-ID, Ordnerschlüssel, Auftragsschlüssel, Prozessschlüssel, Quelle, VerbosityLevel | Attribute.uipath.* | Alle UiPath-Metadatenfelder. |
Spannenattributtypen
Das Feld Attributes im internen Schema von UiPath enthält einen JSON-String, der mithilfe der Punktnotation in OTEL-Spanattribute analysiert und vereinfacht wird. Die Struktur hängt vom Spannentyp ab.
agentRun-Attribute (attributes.type = "agentRun"):
| Attribut | Beschreibung |
|---|---|
| type, agentId, agentName, agentVersion | Felder zur Agentenidentität. |
| systemPrompt, userPrompt | Agent-Prompts. |
| inputSchema, OutputSchema | Eingabe- und Ausgabeschemas. |
| Eingabe, Ausgabe, Quelle | Ausführungseingaben, -ausgaben und Triggerquelle. |
| Fehler | Fehlerdetails, falls vorhanden. |
Vervollständigungsattribute (attributes.type = "completion"):
| Attribut | Beschreibung |
|---|---|
| Typ, Modell | Spannentyp und LLM-Modellbezeichner. |
| Einstellungen.maxTokens, Einstellungen.temperature | LLM-Einstellungen. |
| toolCalls | Array von Toolaufrufen, die während des Abschlusses ausgeführt wurden. |
| Nutzung.completionTokens, Nutzung.promptTokens, utility.totalTokens | Tokennutzung. |
| Nutzung.isBioExecution, Nutzung.executionDeploymentType, utility.isPiiMasked | Ausführungsmetadaten. |
| Fehler | Fehlerdetails, falls vorhanden. |
ToolCall-Attribute (attributes.type = "toolCall"):
| Attribut | Beschreibung |
|---|---|
| Typ, Anruf-ID, Toolname | Identität des Toolaufrufs. |
| Argumente, ToolType | Aufrufargumente und Tooltyp. |
| Ergebnis | Ergebnis des Toolaufrufs. |
| Fehler | Fehlerdetails, falls vorhanden. |
ToolGuardrailEvaluation-Attribute (attributes.type = "toolGuardrailEvaluation"):
| Attribut | Beschreibung |
|---|---|
| type, Guardrail-Name, Guardrail-Beschreibung | Leitplankenidentität. |
| GuardrailAktion, Details, Aktion | Leitplankenaktion und Ergebnis. |
| Argumente, Ergebnis | Auswertungseingaben und Ergebnis. |
| Schweregrad | Klassifizierung nach Schweregrad. |
| Fehler | Fehlerdetails, falls vorhanden. |
Exportbeschränkungen
| Grenzwert | Wert |
|---|---|
| Max. einzelner Attributwert | 32 KB |
| Maximale Gesamtzahl von Attributen pro Spanne | 256 KB |
| Max. OTLP-Batchgröße | ~1 MB (Protobuff) |
| Dateianhänge | Nur Metadaten (ID, Dateiname, MIME-Typ). Dateiinhalt wird nicht exportiert. |
Beispiel: OTEL-Ablaufverfolgung ( vier Spannen für einen Agentenlauf)
[
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "a4bd5687817248fc",
"parentSpanId": "",
"name": "Agent run - googlesearch",
"kind": "SPAN_KIND_INTERNAL",
"startTimeUnixNano": "1728000235632009500",
"endTimeUnixNano": "1728000248153231700",
"attributes.type": "agentRun",
"attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
"attributes.agentName": "googlesearch",
"attributes.agentVersion": "1.0.0",
"attributes.input.search_query": "google",
"attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
"attributes.source": "playground",
"attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
"attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
"attributes.uipath.span_type": "agentRun",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "4c10aa5169c44a17",
"parentSpanId": "a4bd5687817248fc",
"name": "LLM call",
"kind": "SPAN_KIND_CLIENT",
"startTimeUnixNano": "1728000238084433000",
"endTimeUnixNano": "1728000245772907200",
"attributes.type": "completion",
"attributes.model": "gpt-4o-2024-11-20",
"attributes.settings.maxTokens": 16384,
"attributes.settings.temperature": 0,
"attributes.usage.completionTokens": 491,
"attributes.usage.promptTokens": 1110,
"attributes.usage.totalTokens": 1601,
"attributes.uipath.span_type": "completion",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "0fde078a923d484e",
"parentSpanId": "4c10aa5169c44a17",
"name": "LLM",
"kind": "SPAN_KIND_CLIENT",
"startTimeUnixNano": "1728000238979846800",
"endTimeUnixNano": "1728000245095082400",
"attributes.type": "completion",
"attributes.model": "gpt-4o-2024-11-20",
"attributes.uipath.span_type": "completion",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "7fc828f5295d4788",
"parentSpanId": "a4bd5687817248fc",
"name": "Agent output",
"kind": "SPAN_KIND_INTERNAL",
"startTimeUnixNano": "1728000246820034400",
"endTimeUnixNano": "1728000246820034400",
"attributes.type": "agentOutput",
"attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
"attributes.uipath.span_type": "agentOutput",
"status.code": "STATUS_CODE_OK",
"status.message": ""
}
]
[
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "a4bd5687817248fc",
"parentSpanId": "",
"name": "Agent run - googlesearch",
"kind": "SPAN_KIND_INTERNAL",
"startTimeUnixNano": "1728000235632009500",
"endTimeUnixNano": "1728000248153231700",
"attributes.type": "agentRun",
"attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
"attributes.agentName": "googlesearch",
"attributes.agentVersion": "1.0.0",
"attributes.input.search_query": "google",
"attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
"attributes.source": "playground",
"attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
"attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
"attributes.uipath.span_type": "agentRun",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "4c10aa5169c44a17",
"parentSpanId": "a4bd5687817248fc",
"name": "LLM call",
"kind": "SPAN_KIND_CLIENT",
"startTimeUnixNano": "1728000238084433000",
"endTimeUnixNano": "1728000245772907200",
"attributes.type": "completion",
"attributes.model": "gpt-4o-2024-11-20",
"attributes.settings.maxTokens": 16384,
"attributes.settings.temperature": 0,
"attributes.usage.completionTokens": 491,
"attributes.usage.promptTokens": 1110,
"attributes.usage.totalTokens": 1601,
"attributes.uipath.span_type": "completion",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "0fde078a923d484e",
"parentSpanId": "4c10aa5169c44a17",
"name": "LLM",
"kind": "SPAN_KIND_CLIENT",
"startTimeUnixNano": "1728000238979846800",
"endTimeUnixNano": "1728000245095082400",
"attributes.type": "completion",
"attributes.model": "gpt-4o-2024-11-20",
"attributes.uipath.span_type": "completion",
"status.code": "STATUS_CODE_OK",
"status.message": ""
},
{
"traceId": "10f78499ce774eaba05699f234e1c75d",
"spanId": "7fc828f5295d4788",
"parentSpanId": "a4bd5687817248fc",
"name": "Agent output",
"kind": "SPAN_KIND_INTERNAL",
"startTimeUnixNano": "1728000246820034400",
"endTimeUnixNano": "1728000246820034400",
"attributes.type": "agentOutput",
"attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
"attributes.uipath.span_type": "agentOutput",
"status.code": "STATUS_CODE_OK",
"status.message": ""
}
]