UiPath Documentation
test-cloud
latest
false
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Test Cloud-Administratorhandbuch

Datenmodell exportieren

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:

FeldBeschreibung
EreignistypZeichenfolge, die den Ereignistyp identifiziert (z. B. job.created, queueitem.added).
SchemaVersionBezeichner der Schemaversion.
ZeitstempelUTC-Zeitstempel des Ereignisses.
TenantKeyMandantenbezeichner.
MandantennameAnzeigename des Mandanten.
FolderKeyOrdnerbezeichner.
OrdnernameAnzeigename des Ordners.
FullFolderPathVollständiger Ordnerpfad.
Job events

Ausgesetzt am: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating

FeldTypBeschreibung
SchlüsselGUIDEindeutiger Auftragsbezeichner.
ErstellungszeitZeitstempelErstellungszeit des Auftrags.
StartTimeZeitstempelStartzeit der Ausführung.
EndTimeZeitstempelEndzeit der Ausführung.
Status (State)StringAuftragsstatus: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed.
ProcessNameStringName des Quellpakets.
DisplayNameStringAnzeigename im Orchestrator.
RoboterName (RobotName)StringBezeichner des ausgeführten Roboters.
Name der HostmaschineStringName 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

FeldTypBeschreibung
SchlüsselGUIDWarteschlangenelementbezeichner.
ID Warteschlangendefinition (QueueDefinitionId)NummerNumerische Warteschlangen-ID.
StatusStringElementstatus: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown.
Status überprüfen (Review Status)StringKlassifizierung überprüfen: None, InReview, Verified, Retried, Unknown.
PrioritätStringElementpriorität: High, Normal, Low, Unknown.
Fälligkeitsdatum (DueDate)DateTimeVerarbeitungsfrist.
ErstellungszeitDateTimeErstellungszeitstempel.
Verarbeitung starten (StartProcessing)DateTimeDie Startzeit der Verarbeitung.
Verarbeitung beenden (EndProcessing)DateTimeAbschlusszeit der Verarbeitung.
Verschiebungsdatum (DeferDate)DateTimeFrüheste verfügbare Verarbeitungszeit.
SecondsInPreviousAttemptNummerDauer des vorherigen Versuchs in Sekunden.
Wiederholungsanzahl (RetryNumber)NummerAnzahl der Verarbeitungsversuche.
FortschrittStringFortschritt des Geschäftsflows.
AnalysedatenStringSchlüssel-Wert-Paare der Analytics-Eigenschaft.
AusgabeStringAusgabedaten aus der Aktivität „Set Transaction Status“.
Spezielle Daten (SpecificData)StringBenutzerdefinierte Daten aus der Eigenschaft Spezifischer Inhalt oder der Aktivität „Warteschlangenelement hinzufügen“.
CreatorJobIdNummerBezeichner des erstellen Auftrags.
ExecutorJobIdNummerBezeichner des ausgeführten Auftrags.
ProcessExceptionReasonStringFehlerzusammenfassung.
ProcessExceptionDetailsStringFehlerdetails.
ProcessExceptionTypeStringFehlertyp: ApplicationException, BusinessException, None.

Das in jedes Ereignis eingebettete Queue -Objekt enthält: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.

Hinweis:

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

FeldTypBeschreibung
Maschinen-IDNummerNumerische ID der Maschine.
MachineKeyGUIDMaschinenbezeichner.
MaschinennameStringBenutzerdefinierter Name der Maschine.
AutomationCloudSlotsNummerReservierte Runtime-Slots.
HeadlessSlotsNummerHeadless-Modus-Slots.
NonProductionSlotsNummerNon-Production-Umgebungsslots.
UnattendedSlotsNummerUnbeaufsichtigte Ausführungsslots.

Zu den Ereignissen der Maschinensitzung (machineSession.status) gehören:

FeldTypBeschreibung
MachineKeyGUIDMaschinenbezeichner.
MaschinennameStringBenutzerdefinierter Name der Maschine.
Name der HostmaschineStringHostsystemname.
DienstbenutzernameStringUiPath Robot-Dienstkonto.
MaschinenstatusStringStatus: Available, Busy, Disconnected, Unknown.
ZeitstempelDateTimeEreigniszeitstempel.
IsUnresponsiveBoolescherOb die Verbindung nicht reagiert.
Roboterprotokollereignisse

Ausgestellt am: robotlog

FeldTypBeschreibung
MeldungStringProtokollinhalt.
EbeneStringSchweregrad: Trace, Info, Warn, Error, Fatal.
ProtokolltypStringKategorie: User, Default, Error, Business, ExecutionStep, Info, Security, Technical.
ZeitstempelDateTimeGenerierungszeitstempel.
JobIdGUIDAuftragsschlüssel.
ProcessNameStringName des ausgeführten Prozesses.
ProzessversionStringProzessversion.
RoboterName (RobotName)StringRoboterbezeichner.
Maschinen-IDNummerNumerische ID der Maschine.
MachineKeyGUIDMaschinenbezeichner.
MaschinennameStringMaschinenname.
Name der HostmaschineStringName der Hostmaschine (nur Sitzungsprotokolle).
Windows-IdentitätStringHandelndes Benutzerkonto.
initiatedByStringAusführungsquelle: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI.
FileNameString.xaml Dateiname ausgeführt.
AktivitätsinfoJSONAktivitätsmetadaten: DisplayName, State, Activity, Arguments.
Benutzerdefinierte FelderJSONBenutzerdefinierte Felder, die über die Aktivität AddLogFields hinzugefügt wurden.
Warteschlangenname (QueueName)StringName der Quellwarteschlange (nur Warteschlangenverarbeitung).
Transaktions-IDGUIDTransaktionsschlüssel (nur Warteschlangenverarbeitung).
transactionStateStringStarted, Ended, Postponed (nur Warteschlangenverarbeitung).
transactionStatusStringStart, Success, Failed, BusinessException, ApplicationException (nur Warteschlangenverarbeitung).
TransaktionsausführungszeitNummerAusführungsdauer in Sekunden (nur Warteschlangenverarbeitung).
GesamtausführungszeitInSekundenNummerGesamtausführungsdauer (nur Warteschlangenverarbeitung).
queueItemPriorityStringHigh, Normal, Low (nur Endprotokolle für Warteschlangentransaktionen).
ÜberprüfungsstatusDes WarteschlangenelementsStringInReview, Verified, Reported, Retried (nur Endprotokolle für Warteschlangentransaktionen).
ProcessingExceptionReasonStringGrund der Ausnahme (nur Protokolle zum Ende von Warteschlangentransaktionen).
Typ der VerarbeitungsausnahmeStringApplicationException 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:

FeldBeschreibung
OrganizationIdBezeichner der Organisation, die das Ereignis ausgibt.
TenantIdBezeichner des Mandanten, der das Ereignis ausgibt.
FolderKeyOrdner- oder Arbeitsbereichsbezeichner.
ProzessschlüsselBezeichner der Prozessdefinition.
InstanzIDBezeichner der Prozessinstanz.
RunIdBezeichner der Prozessausführung.
SpannentypMaestro-Ereignistyp: Incident, ProcessRun, ElementRun, InstanceOperation.
StatusAktueller Lebenszyklusstatus des Ereignisses.
EventUniqueIdGlobal eindeutiger Bezeichner des ausgegebenen Ereignisses.
EventTimeUtcZeitstempel, wann das Ereignis ausgegeben wurde.
AblaufverfolgungsattributeOptionale Metadaten auf Ablaufverfolgungsebene (null-fähig).
SpannenattributeStringifizierte JSON von zusätzlichen spannenspezifischen Attributen.
Vorfallsfelder
FeldBeschreibung
ElementIdElement, in dem der Vorfall aufgetreten ist.
Element-AusführungsIDElementausführung, die dem Vorfall zugeordnet ist.
IncidentUpdateTimeUtcZeitstempel der letzten Aktualisierung des Vorfalls.
Kommentar (Comment)Optionaler Kommentar, der dem Vorfall zugeordnet ist.
FehlercodeFehlercode für den Vorfall.
FehlermeldungKurze Fehlermeldung.
FehlerdetailsDetaillierte Fehlerinformationen.
DebugModeDebugmodusstatus, als der Vorfall auftrat.
Prozessausführungsfelder
FeldBeschreibung
Startzeit UTCStartzeit der Prozessausführung in UTC.
SpannennameFür den Menschen lesbarer Name der Spanne oder des Ereignisses.
Ablaufverfolgungs-IDBezeichner der verteilten Ablaufverfolgung für die Korrelation.
Spannen-IDSpannenbezeichner für diese Prozessausführung.
ÜbergeordneteSpan-IDBezeichner der übergeordneten Spanne (NULL-fähig für Stammspannen).
PackageIdDer Paketbezeichner.
PackageKeyPaketschlüssel, enthält in der Regel Version.
PackageVersionPaketversion
ReleasenameFür Menschen lesbarer Release-Name.
Externe IDBezeichner der externen Korrelation.
QuelleTriggerquelle der Ausführung (z. B. Manual).
TypDesDebugmodusKonfiguration des Debugmodus.
Ersteller BenutzerschlüsselBenutzer, der die Ausführung initiiert hat (nullable).
CaseInstanceIdBezeichner der Fallinstanz (nullable).
FallverwaltungsmetadatenMetadaten für die Fallverwaltung (null-fähig).
Elementausführungsfelder
FeldBeschreibung
Startzeit UTCStartzeit der Elementausführung in UTC.
EndTimeUtcEndzeit der Elementausführung in UTC.
SpannennameFür den Menschen lesbarer Name der Spanne oder des Ereignisses.
Ablaufverfolgungs-IDBezeichner der verteilten Ablaufverfolgung für die Korrelation.
Spannen-IDSpannenbezeichner für diese Elementausführung.
ÜbergeordneteSpan-IDBezeichner der übergeordneten Spanne (nullable).
VariablenStrukturierte Variablen, die bei der Elementausführung erfasst werden.
VariablesJsonAls JSON serialisierte Variablen.
ElementAusführung.ElementIDBezeichner des Elements.
ElementAusführung.ElementNameAnzeigename des Elements.
ElementAusführung.ElementtypElementtyp.
ElementAusführung.ElementErweiterungstypErweiterungstyp (nullable).
ElementAusführung.ElementAusführungIdBezeichner der Elementausführung.
ElementRun.IncomingFlowIdBezeichner des eingehenden Flows.
ElementRun.IncomingFlowIdsArray mit eingehenden Flow-Bezeichnern (nullable).
ElementAusführung.CaseStageElementIdElementbezeichner der Fallphase (nullable).
ElementRun.CaseManagementMetadataFallmetadaten 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
FeldBeschreibung
IDGlobal eindeutiger Bezeichner des Prüfungsereignisses.
LokaleIDInterner sequenzieller Bezeichner für die Bestellung.
Erstellt amZeitstempel, wann das Ereignis erstellt wurde.
Zuletzt geändertZeitstempel der letzten Änderung (nullable).
VersionVersion des Prüfungsereignisdatensatzes.
Status (State)Interner Lebenszyklusstatus des Ereignisses.
StatusErgebnis des Termins (numerische Aufzählung).
EreignistypBezeichner der ausgeführten Aktion.
EventSourceBezeichner des Produkts oder Systems, das das Ereignis auslöst.
EventTargetBezeichner der Ereigniskategorie.
EventDetailsEingebettete JSON mit ereignisspezifischen Details (siehe unten).
ServiceNameFür den Menschen lesbarer Name des sendenden Dienstes.
ClientInfo).Eingebettete JSON mit IpAddress und IpCountry.
Akteurs-IDEindeutiger Bezeichner des Akteurs.
ActorNameAnzeigename des Akteurs.
AkteurEMailE-Mail des Akteurs (nullable).
AkteurdetailsEingebettete JSON mit Metadaten, die den Akteur beschreiben.
OrganizationIdBezeichner der Organisation.
OrganisationsnameName der Organisation.
TenantIdMandantenbezeichner (NULL-fähig für Ereignisse auf Organisationsebene).
MandantennameMandantenname (NULL-fähig für Ereignisse auf Organisationsebene).
UrsprungInfrastruktur 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:

FeldBeschreibung
Benutzer.IDBezeichner des Benutzers.
Benutzer.AnzeigenameAnzeigename des Benutzers.
Benutzer.EmailBenutzer-E-Mail.
Benutzer.TypBenutzertyp (Aufzählung).
AnmeldemethodeAuthentifizierungsmethode.
Client-IDBezeichner des OAuth-Clients.
ScopesGewährt oder angeforderte Scopes.

Apps-Ereignisse:

FeldBeschreibung
App-IDEindeutiger App-Bezeichner.
appNameAnwendungsname
App-TypTyp der Anwendung.
VersionAnwendungsversion
BeschreibungApp-Beschreibung.
OrdnernameOrdner, der die App enthält.
istActionAppOb die App eine Aktions-App ist.
istÖffentlicheAppOb die App öffentlich sichtbar ist.

Integration Service-Ereignisse:

FeldBeschreibung
ConnectionIdBezeichner der Integrationsverbindung.
ConnectionNameName der Verbindung.
ConnectorConnector-Anzeigename.
ConnectorKeyEindeutiger Connectorschlüssel.

Administrator-/Richtlinienereignisse:

FeldBeschreibung
PolicyIdRichtlinienbezeichner.
PolicyNameRichtlinienname.
Richtlinie erstelltMetadaten zur Richtlinienerstellung.
Richtlinie gelöschtMetadaten zum Löschen von Richtlinien.
ModifiedFieldsFelder haben sich während der Aktualisierung geändert.

License Resource Manager-Ereignisse:

FeldBeschreibung
ProduktnameName des lizenzierten Produkts.
OldQuantityVorherige Lizenzmenge.
NewQuantityAktualisierte Lizenzmenge.
TenantIdBetroffener Mandant.
MandantennameName des betroffenen Mandanten.
AdminNameAdministrator, der die Änderung durchgeführt hat.

Data Service-Ereignisse (DataFabric):

FeldBeschreibung
EntityIdBezeichner der DataFabric-Entität.
EntitätsnameName der Entität.
Datensatz-IDBezeichner des betroffenen Datensatzes.
GeänderteEigenschaftenDurch den Vorgang geänderte Eigenschaften.
ZeitstempelDataFabric-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-FeldBeschreibung
Ablaufverfolgungs-IDAblaufverfolgungsbezeichner. Gruppiert alle Spannen, die zu einer Ausführung gehören.
SpannenIDEindeutiger Bezeichner für diesen Bereich.
parentSpanIdBezeichner der übergeordneten Spanne. Leere Zeichenfolge für Stammspannen.
nameFür Menschen lesbarer Spannenname (z. B. Agent run - googlesearch, LLM call).
kindSpannenart: SPAN_KIND_INTERNAL oder SPAN_KIND_CLIENT.
startTimeUnixNoneSpannenstartzeit in Unix-Nanosekunden.
endTimeUnixNanoSpannenendzeit in Unix-Nanosekunden.
status.codeAusführungsstatus: STATUS_CODE_OK oder STATUS_CODE_ERROR.
status.meldungStatusmeldung (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-FeldOTEL-AttributHinweise
IDSpannen_IDEindeutiger Spannenbezeichner.
Ablaufverfolgungs-IDTrace_IDAblaufverfolgungsbezeichner.
ParentIdübergeordnete_span_idNULL für Stammspannen.
NamenameSpannenname.
StartTimestart_time_unix_nanoIn Unix-Nanosekunden konvertiert.
EndTimeend_time_unix_nanoIn Unix-Nanosekunden konvertiert.
Statusstatus.code1 = OK, 2 = FEHLER.
AttributeAttributeJSON-Zeichenfolge, die mithilfe der Punktnotation in Schlüssel-Wert-Paare analysiert wurde.
Spannentyp, Organisations-ID, Mandanten-ID, Ordnerschlüssel, Auftragsschlüssel, Prozessschlüssel, Quelle, VerbosityLevelAttribute.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"):

AttributBeschreibung
type, agentId, agentName, agentVersionFelder zur Agentenidentität.
systemPrompt, userPromptAgent-Prompts.
inputSchema, OutputSchemaEingabe- und Ausgabeschemas.
Eingabe, Ausgabe, QuelleAusführungseingaben, -ausgaben und Triggerquelle.
FehlerFehlerdetails, falls vorhanden.

Vervollständigungsattribute (attributes.type = "completion"):

AttributBeschreibung
Typ, ModellSpannentyp und LLM-Modellbezeichner.
Einstellungen.maxTokens, Einstellungen.temperatureLLM-Einstellungen.
toolCallsArray von Toolaufrufen, die während des Abschlusses ausgeführt wurden.
Nutzung.completionTokens, Nutzung.promptTokens, utility.totalTokensTokennutzung.
Nutzung.isBioExecution, Nutzung.executionDeploymentType, utility.isPiiMaskedAusführungsmetadaten.
FehlerFehlerdetails, falls vorhanden.

ToolCall-Attribute (attributes.type = "toolCall"):

AttributBeschreibung
Typ, Anruf-ID, ToolnameIdentität des Toolaufrufs.
Argumente, ToolTypeAufrufargumente und Tooltyp.
ErgebnisErgebnis des Toolaufrufs.
FehlerFehlerdetails, falls vorhanden.

ToolGuardrailEvaluation-Attribute (attributes.type = "toolGuardrailEvaluation"):

AttributBeschreibung
type, Guardrail-Name, Guardrail-BeschreibungLeitplankenidentität.
GuardrailAktion, Details, AktionLeitplankenaktion und Ergebnis.
Argumente, ErgebnisAuswertungseingaben und Ergebnis.
SchweregradKlassifizierung nach Schweregrad.
FehlerFehlerdetails, falls vorhanden.

Exportbeschränkungen

GrenzwertWert
Max. einzelner Attributwert32 KB
Maximale Gesamtzahl von Attributen pro Spanne256 KB
Max. OTLP-Batchgröße~1 MB (Protobuff)
DateianhängeNur 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": ""
  }
]

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben