Trace Structure

▼klira.user.messageCore↓

▼klira.guardrails.inputGuardrails

klira.compliance.allowedCompliance

klira.compliance.blockedCompliance

klira.compliance.augmentedCompliance

klira.compliance.llm_fallbackCompliance

▶klira.workflow.{name}Core

▶klira.guardrails.outputGuardrails

klira.evals.test_caseEvals

Click any span to view details. Only one branch expands at a time.

klira.user.messageCore

Root span — one per user interaction. Always a root (no parent).

Created by:UserMessageTraceContext / @workflow auto-trace

Span names:klira.user.message

● 4 required○ 4 optional

Attribute	Type	Req	Description
klira.entity_type	string	●	"user_message"
klira.user_id	string	●	User identifier
klira.conversation_id	string	●	Conversation identifier
klira.message_id	string	●	Unique message ID (UUID)
klira.input	string	○	User input text (truncated 10 000 chars)
klira.entity_name	string	○	Entity name
klira.evals.run_id	string	○	Eval run ID (eval mode only)
klira.duration_ms	float	○	Span duration in ms (processor)

Span Catalog

Core

klira.user.messageCore

Root span — one per user interaction. Always a root (no parent).

klira.workflow.{name}Core

Created by @workflow decorator. Child of klira.user.message or root.

klira.agent.{name}Core

Created by @agent decorator. Child of any klira span.

klira.task.{name}Core

Created by @task decorator. Child of any klira span.

klira.tool.{name}Core

Created by @tool decorator. Child of any klira span.

klira.agent.handoffCore

Agent handoff logging span. Child of workflow/agent/task/tool.

klira.rag.retrievalCore

RAG retrieval logging span. Child of any klira span.

LLM

klira.llm.{provider}.{operation}LLM

LLM call span created by auto-patched adapters. Child of any klira span.

Guardrails

klira.guardrails.inputGuardrails

Inbound guardrails check. Child of any klira or LLM span.

klira.guardrails.outputGuardrails

Outbound guardrails check. Child of guardrails, klira, or LLM span.

Compliance

klira.compliance.allowedCompliance

No policies matched — content passed through. Child of guardrails span.

klira.compliance.blockedCompliance

A blocking policy matched. Child of guardrails span.

klira.compliance.augmentedCompliance

Allow-with-guidelines policy matched. Child of guardrails span.

klira.compliance.llm_fallbackCompliance

LLM fallback evaluation used when fast rules were inconclusive.

klira.audit.regulatoryCompliance

Regulatory audit logging span. Child of any klira span.

Clinical

klira.clinical.decisionClinical

Clinical decision logging. Child of any klira span.

klira.clinical.escalationClinical

Human escalation event. Child of any klira span.

klira.clinical.handoffClinical

Agent-to-agent handoff event. Child of any klira span.

klira.clinical.safety_checkClinical

Safety check event. Child of any klira span.

klira.clinical.rag_retrievalClinical

RAG retrieval event. Child of any klira span.

Evals

klira.evals.test_caseEvals

Eval test case execution. Root or child of klira.user.message.

Resource

Resource AttributesResource

Set on every exported span via TracerProvider resource

Context Attrs

Healthcare Context

Healthcare ContextHealthcare Context

Set on the current active span via context setters — not tied to a specific span type.

Attribute	Type	Setter	Description
klira.healthcare.patient_id	string	set_patient_context()	Patient identifier
klira.healthcare.encounter_id	string	set_patient_context()	Encounter identifier
klira.healthcare.department	string	set_clinical_context()	Hospital department
klira.healthcare.specialty	string	set_clinical_context()	Medical specialty
klira.healthcare.clinical_domain	string	set_clinical_context()	Clinical domain
klira.healthcare.interaction_modality	string	set_interaction_modality()	chat, voice, portal

PHI Attributes

PHI AttributesPHI

Appended at export-time by KliraOTLPSpanExporter when anonymization=True. Scans: gen_ai.prompt, gen_ai.prompt.original, klira.output, klira.input.

Attribute	Type	Setter	Description
klira.phi.detected	bool	Exporter (always)	Whether PHI was detected
klira.phi.entity_count	int	Exporter (if detected)	Number of PHI entities found
klira.phi.entity_types	string	Exporter (if detected)	"PERSON,PHONE_NUMBER", etc.

Processor-Added

Processor-AddedAuto (Processor)

Auto-set by NoneAttributeFilterProcessor on span end.

Attribute	Type	Setter	Description
klira.duration_ms	float	Processor	Span duration in ms (all klira.* spans)
klira.guardrails.latency_ms	float	Processor	Guardrails-specific duration alias