Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt

Use this file to discover all available pages before exploring further.

The Idun standalone UI emits the events below through PostHog. The single off-switch is IDUN_TELEMETRY_ENABLED=false, which also kills Python engine telemetry.

Stability policy

Event names are a public contract. Renaming or removing an event goes through one release with both the old and new names emitted, so downstream PostHog dashboards and queries have time to migrate. The release notes call out the deprecation; the old name is removed in the following release. If you need to ship a breaking change faster than that, raise it explicitly in the PR description.

Events

EventWhere it firesProperties
$pageview / $autocapture / $pageleaveBuilt-in PostHog autocapturen/a
auth.login.startLogin form submit or OIDC redirect buttonmethod, provider?
auth.login.successOAuth callback or basic-auth responsemethod, provider?, duration_ms
auth.login.failureOAuth callback or basic-auth responsemethod, provider?, duration_ms, error_class
auth.logoutTopbar logout buttonmethod
agent.config.savedAdmin Save handlersagent_id, section, duration_ms, result
agent.config.reloadedAdmin Reload buttonagent_id, duration_ms, result
agent.run.startedChat sendagent_id, session_id, message_index
agent.run.completedStream RUN_FINISHEDagent_id, session_id, duration_ms
agent.run.errorStream erroragent_id, session_id, error_class, duration_ms
chat.message.sentChatInput submitsession_id, length_chars, length_words
chat.response.receivedFirst TEXT_MESSAGE_CONTENT deltasession_id, time_to_first_token_ms
chat.errorError toastsession_id, error_class, recoverable

Properties policy

  • Message content is never sent. Only counts, durations, and error class names.
  • Sensitive keys (api_key, token, password, secret, bearer, …) are redacted before send.
  • String values are truncated at 200 characters.
  • error_class is the exception constructor name, never the message.

Super-properties

Attached to every event:
  • deployment_typecloud / self-hosted / dev
  • idun_version
  • surfaceadmin / chat

Session replay

posthog-js records DOM + interactions. Masking is enforced via:
  • maskAllInputs: true (every <input>/<textarea> masked)
  • data-ph-mask on chat textarea + auth forms (defensive text mask)
  • data-ph-no-capture on chat bubbles + prompts editor (full DOM block)
Disable session replay independently with IDUN_TELEMETRY_SESSION_REPLAY=false.

Next steps

Local trace store

See how agent runs are captured and surfaced in the bundled admin UI.

Observability overview

Wire an external provider on top of the local store.

Production hardening

Lock down the standalone before shipping to production.
Last modified on May 20, 2026