Logging

All logs are sent to the debug console, which is accessible in the Client via developer options.

Telemetry

Logs are also uploaded to Loki via OpenTelemetry. All Info, Warning, and Error logs are uploaded. Debug is not uploaded by default but can be enabled via developer options.

The namespace (service.namespace) is set to default for builds and preview when running in Editor.

Log Attributes

Attribute Value Example

app_platform

Platform of the Unity build (will be web when the website is open on Windows and Android alike).

android, ios, web

detected_level

Human-readable severity label derived by Loki from severity_number

debug, info, warning, error

device_model_name

SystemInfo.deviceModel — device make and model reported by the OS

Google Pixel 10 Pro XL, iPad8,6

observed_timestamp

Unix epoch timestamp in nanoseconds, set at record creation

1781272335646100000

os_description

SystemInfo.operatingSystem — full OS version string reported by Unity

Android OS 16 / API-36 (CP1A.260505.005/15081906), iPadOS 26.5

os_type

OS family: android, ios, browser, darwin, windows, or linux

android, ios

promethist_agent_ref

Ref of the agent of the running interaction. Present only during one.

einstein, receptionist

promethist_project_ref

Ref of the open project.

default, acme

promethist_turn_id

UUID of the current conversation turn. Present only when a turn is active.

3fa85f64-5717-4562-b3fc-2c963f66afa6

scope_name

Log Category, maps to the OpenTelemetry instrumentation scope

UI, Graphics, Engine

service_instance_id

Stable per-device identifier, prefixed with unity-{platform}-

unity-android-a69a72ae-baf3-4b5a-9e35-b6d4994141ee

service_name

Always promethist-client-unity

promethist-client-unity

service_namespace

default in production builds; preview when running inside the Unity Editor

default, preview

service_version

Application.version as set in Unity Player Settings

0000.1.0

session_id

UUID of the current session. Present only when a session is active.

3fa85f64-5717-4562-b3fc-2c963f66afa6

severity_number

OpenTelemetry severity number: 5 = Debug, 9 = Info, 13 = Warning, 17 = Error

9

user_id

ID of the engine’s user for the open project, which the engine keys to the device. Present once the open project’s user has been read back.

3fa85f64-5717-4562-b3fc-2c963f66afa6

Categories

Categories are used to group logs from specific systems and assist in following their state. They map to scopes in OpenTelemetry.

Unity is the one nothing writes to deliberately: it carries what Unity itself reported - engine failures, plugin failures and uncaught exceptions, each with its stack trace and each uploaded once per run. See Logging for how those reach the upload.

The current list of categories is:

  • App

  • AudioStreaming

  • Authentication

  • Avanim

  • Bundles

  • Camera

  • Conversation

  • Emotions

  • Engine

  • General

  • Graphics

  • Multimodal

  • Native

  • UI

  • Unity

  • Visual