Skip to main content

Span attribute reference

Every attribute the plugin may set, grouped by span type. See Attribute conventions for the narrative version of the dual-convention mapping (OpenInference llm.* / input.value for Phoenix and OTel GenAI gen_ai.* for Langfuse, Weave and generic dashboards).

Attributes marked optional are only set when the underlying data is available. Content is governed by content_capture: full (the default) puts the complete prompt and response on api.* spans; previews elsewhere (input.value, output.value, gen_ai.*.messages, tool args/results) are clipped to preview_max_chars (or the per-category cap) and carry a hermes.preview.* marker when clipped; off records no content at all.

The tables are generated from the registry in hermes_otel/semconv.py by scripts/gen_semconv.py (make ci-semconv fails when they drift); the Convention column says whose vocabulary a name belongs to, both when one value is spelled for OpenInference and for the GenAI readers. A test (tests/unit/test_span_attributes_docs.py) fails if the code sets an attribute this page does not list, or this page lists one the code never sets.

Resource (on every span)​

AttributeConventionTypeMeaning
service.nameOTelstringhermes-agent; the named profile (coder) with service_name_from_profile: true. resource_attributes: overrides either
service.namespaceOTelstringhermes-agent, only with service_name_from_profile: true and a named profile active (see Profiles)
service.instance.idOTelstringUUID generated once per process — keeps two Hermes processes on different metric series
service.versionOTelstringPlugin version, read from the shipped plugin.yaml
process.pidOTelintProcess id
os.typeOTelstringOperating system in the OTel spelling (darwin, linux, windows), from platform.system(), so a fleet can be split by platform (#476)
host.archOTelstringCPU architecture in the OTel spelling (arm64, amd64, x86 …), from platform.machine() (#476)
openinference.project.nameOpenInferencestringproject_name / OTEL_PROJECT_NAME (the Phoenix project); optional
hermes.kanban.task_id, hermes.kanban.board, hermes.kanban.run_idhermesstringThe kanban card, its board and the attempt a dispatcher-spawned worker is running, from HERMES_KANBAN_TASK / _BOARD / _RUN_ID. Only when the task is set: Hermes pins the board into every chat's environment, so the board alone never marks a worker
host.nameOTelstringHostname, only when host_metrics: true
wandb.entity, wandb.projectWeavestringW&B Weave routing (when configured)
telemetry.sdk.name, telemetry.sdk.version, telemetry.sdk.languageOTelstringSet by the OTel SDK

Any resource_attributes.* / global_tags.* key from the config file is added too; resource_attributes wins on key conflict.

Every common_attributes.* key is set on every span as a plain span attribute (not on the Resource) by a SpanProcessor at span start, under keys the span does not already carry; see Which attributes reach which signal.

Every span​

AttributeConventionTypeMeaning
openinference.span.kindOpenInferencestringAGENT (root, subagent) · LLM (llm.*, api.*) · TOOL (tool.*) · GENERAL (skill, approval, human_input, kanban)
traceloop.span.kindTraceloopstringThe same span kinds in Traceloop's lowercase vocabulary: agent (root, subagent) · tool (tool.*) · task (everything else; Traceloop has no LLM kind, model spans are identified by gen_ai.*) · unknown. Filter on this from openllmetry-aware tools such as opentelemetry-mcp (since 1.26.0; earlier releases wrote the OpenInference spelling here, #382)
hermes.turn.numberhermesint1-based index of the user prompt within the session. A session resumed in a new process (hermes -r) continues from the user prompts in its conversation; after a context compaction the count can only stay or grow. On the root and on every llm.* / api.* / tool.* span of the turn
session.id, session_idOTel / hermesstringHermes session id, on the root and on llm.* / api.* / tool.* / subagent.*; session_id is the plugin's oldest spelling of the same value, kept for dashboards built on it
gen_ai.conversation.idgen_aistringSame id, gen_ai spelling, wherever gen_ai.operation.name is set
correlation.idhermesstringA correlation id the host passed on the hook (correlation_id / correlation.id / x-correlation-id …), reused on every span of that session. Hermes 0.21 passes none, so the attribute is absent; group by session.id instead
hermes.span.ended_by, hermes.span.sweep_reasonhermesstringOn a child span (tool.* / api.* / llm.* / approval.* / skill.*) the plugin ended on the operation's behalf because the operation's own end hook never came: ended_by is sweep and sweep_reason says why, turn_end (still open at on_session_end) · session_end (at finalize / reset) · turn_failed (every API attempt of the turn failed and the next turn closed it) · ttl (the orphan sweep, root_span_ttl_ms) · shutdown. Absent on a normally ended span (#477)
user.id, hermes.sender.idOTel / hermesstringGateway sender identity — only with capture_sender_id: true. user.id is platform:sender

agent / cron (turn root)​

The root span is named agent, or cron when the session kind is a cron job. Set at start:

AttributeConventionTypeMeaning
hermes.session.kindhermesstringsession · cron (from Hermes' session_type / origin / run_type when a host passes one; Hermes 0.21 passes none, so cron comes from a cron platform and everything else is session)
hermes.session_idhermesstringSession id (pre-existing spelling; session.id is the standard one)
llm.model_nameOpenInferencestringModel the turn started with
hermes.platformhermesstringThe Hermes surface the turn ran on: cli · telegram · discord · cron · … (never reported as a provider)
hermes.profilehermesstringThe Hermes profile that ran the turn: default, the profile id under ~/.hermes/profiles/, or custom. Also a resource attribute and the profile label on every metric (profiles)
hermes.llm.output.charshermesintSize of the turn's final response text, observed on transform_llm_output (hooks); absent when the finalizer did not run (optional)
llm.provider, gen_ai.provider.name, gen_ai.systembothstringThe LLM provider the turn's API calls reported, set at end; absent when no API call reported one. Hermes 0.21 passes no provider on on_session_start. Each carries its convention's well-known spelling when there is one for the Hermes id (gen_ai.*: x_ai, aws.bedrock, gcp.vertex_ai, gcp.gemini, azure.ai.inference, openai for openai-api / openai-codex; llm.provider: xai, aws, google, azure, moonshot, minimax), else the raw id (openrouter, nvidia, custom …) (#475)
hermes.providerhermesstringThe provider id exactly as Hermes names it (xai, bedrock, openai-api, openrouter …), beside the convention spellings in gen_ai.provider.name / llm.provider, wherever those are set (#475)
gen_ai.request.modelgen_aistringModel name
hermes.turn.stop_reasonhermesstringSet when agent_loop_stopped fires for the turn (/stop, the /new fast path): the reason Hermes gives; a stopped turn whose end never arrives is swept as interrupted, not timed_out
hermes.turn.verify_nudgeshermesintHow many times pre_verify fired this turn (the agent edited code and was about to finish); never the paths or the response
hermes.turn.triggerhermesstringWhat started the turn: user (CLI, TUI, desktop, a gateway platform, ACP), cron, kanban (a worker), subagent (a delegated child), a2a, api (the API server), oneshot (hermes -z, chat -q), curator, batch or system. /loop, /heartbeat and /goal re-entries and bot-to-bot DMs are not observable at turn start and classify as the turn they ride on (#444)
hermes.agent.model_overridehermesboolWhether the turn runs on a model other than the profile's model.default (a delegation.model child, a kanban --model worker, a cron job's own model, -m, /model); absent when either is unknown
gen_ai.operation.namegen_aistringinvoke_agent
gen_ai.agent.namegen_aistringThe host's agent_name when it passes one, else the active named profile (coder), else hermes-agent; Weave shows it as the agent
wandb.is_turn, wandb.thread_idWeavebool / stringMarks a Weave conversation turn and groups turns by session
weave.agent.versionWeavestringPlugin version (optional)
hermes.trace.remote_parenthermesbooltrue when the root was parented under the span an outer process named in HERMES_OTEL_TRACEPARENT (env vars, #474); absent otherwise
hermes.session.synthesizedhermesbooltrue on continuation turns: Hermes fires on_session_start only for a session's first turn, so later turns open their root lazily at the first hook of the turn (optional)
hermes.session.previous_idhermesstringThe session this one replaced (/new, /reset); the root also carries a span link (hermes.link=previous_session) to that session's last root (optional)
hermes.session.finalize_reason, hermes.session.reset_reasonhermesstringSet when a still-open root was closed by on_session_finalize / on_session_reset, with hermes.turn.final_status finalized / reset (optional)
hermes.linkhermesstringOn a span link: previous_session on the link from a replacing session's first root to the old session's last root; turn_root on the link from an auxiliary api.* span that started after its turn's root ended to that root
hermes.session_id, hermes.session.turn_count, hermes.session.duration_s, hermes.session.finalize_reason, hermes.session.reset_reasonhermesmixedOn the log record on_session_finalize / on_session_reset emit (exported with capture_logs), not on a span
hermes.cron.job_idhermesstringCron job id, cron roots only: from the hook payload, else parsed from the scheduler's cron_<job id>_<timestamp> session id (optional)
hermes.session.is_subagenthermesbooltrue on a delegated child's own root (optional)
hermes.subagent.role, hermes.subagent.parent_session_idhermesstringOn a delegated child's root (optional)

Set at end (turn summary; empty/zero aggregators are omitted):

AttributeConventionTypeMeaning
hermes.session.completed, hermes.session.interruptedhermesboolHook payload flags
hermes.turn.final_statushermesstringcompleted · interrupted · failed · incomplete · timed_out · finalized · reset — from Hermes' completed / interrupted / failed flags (timed_out from the orphan sweep; finalized / reset when a session boundary closed the root; failed also when the turn's last API attempt failed and Hermes never ended it, #467)
hermes.session.failedhermesboolHermes' failed flag on on_session_end
hermes.turn.exit_reasonhermesstringHermes' turn_exit_reason (interrupted_by_user, guardrail_halt, context_compression_timeout, max_iterations_reached(n/m) …), when reported
hermes.turn.tool_count, hermes.turn.toolshermesint / stringDistinct tool names (sorted CSV, ≤500 chars)
hermes.turn.tool_targets, hermes.turn.tool_commandshermesstring|-joined distinct paths/URLs and shell commands
hermes.turn.tool_outcomeshermesstringSorted CSV of distinct outcomes
hermes.turn.skill_count, hermes.turn.skillshermesint / stringSkills that loaded successfully this turn
hermes.turn.api_call_counthermesintpre_api_request hooks fired
hermes.turn.auxiliary.api_call_count, hermes.turn.auxiliary.error_counthermesintAuxiliary LLM attempts that ran under this turn (titling, compression, MoA, vision, …) and how many failed (optional)
hermes.turn.auxiliary.input_tokens, hermes.turn.auxiliary.output_tokenshermesintTheir token sum, reported beside gen_ai.usage.*, never inside it: the moa provider's main-loop api.* span already carries what the MoA facade returns (optional)
hermes.turn.auxiliary.cost.usage, hermes.turn.auxiliary.cost.statushermesfloat / stringTheir USD sum, with the same actual · estimated · partial · included · unknown rule as hermes.cost.status (optional)
hermes.cost.usagehermesfloatThe turn's USD cost: the sum of its API calls' hermes.cost.usage, set only when every call was priced (optional)
hermes.cost.statushermesstringactual (every call provider-reported) · estimated · partial (some calls priced, some not: no total) · included (subscription route) · unknown (no price for the model); absent when no call reported usage
gen_ai.response.modelgen_aistringModel at turn end
error.typeOTelstringMost recent provider error class this turn (optional)
input.value, output.valueOpenInferencestringFirst user message / final assistant response of the turn (previews; optional)

The root also carries the turn's token roll-up under the api.* spans' keys (gen_ai.usage.*, llm.token_count.*): the sum of its api.* spans (optional). It is withheld from a backend whose entry has root_usage: false, the preset for opik and langwatch, which sum usage over every span and would double the trace total (#327); the api.* spans and hermes.cost.* are never touched.

llm.*​

One per run_conversation call (span kind LLM).

AttributeConventionTypeMeaning
llm.model_nameOpenInferencestringModel
llm.provider, gen_ai.provider.name, gen_ai.systembothstringThe LLM provider reported by this turn's API calls, in each convention's spelling (see the turn root); absent on the first call before any API request reported one
gen_ai.request.modelgen_aistringModel name
gen_ai.operation.namegen_aistringchat
input.value, input.mime_typeOpenInferencestringUser message (text/plain) or, with capture_conversation_history, the conversation JSON (application/json)
gen_ai.input.messagesgen_aistring (JSON)Same content in the gen_ai message shape
output.value, output.mime_typeOpenInferencestringFinal assistant response
hermes.preview.input.truncated, hermes.preview.input.original_chars, hermes.preview.output.truncated, hermes.preview.output.original_charshermesbool, intSet only when the preview was clipped: true and the value's original length (optional)
gen_ai.output.messagesgen_aistring (JSON)Same in the gen_ai shape
gen_ai.response.modelgen_aistringThe response model a provider reported on this turn's API calls; absent when none was reported (never the request model)
hermes.conversation.message_counthermesintMessage count when conversation capture is on (optional)

api.*​

One per HTTP round-trip to the provider (span kind LLM). Set at start:

AttributeConventionTypeMeaning
llm.model_name, llm.providerOpenInferencestringModel / provider
gen_ai.request.model, gen_ai.system, gen_ai.provider.namegen_aistringModel / provider (gen_ai.system is the legacy spelling Langfuse reads); the provider in the GenAI well-known spelling when there is one, else the Hermes id, which hermes.provider always carries (#475)
gen_ai.operation.namegen_aistringchat
hermes.query_sourcehermesstringWhich loop the call belongs to: main (the agent loop), subagent (a delegated child's own loop), auxiliary (a call Hermes made on the agent's behalf: titling, compression, MoA reference models and aggregator, vision, approval, the kanban decomposer, the /goal judge, …; hooks)
hermes.auxiliary.taskhermesstringThe auxiliary task, as Hermes names it (title_generation, compression, moa_reference, moa_aggregator, vision, approval, kanban_decomposer, triage_specifier, goal_judge, …); unknown when it sent none. Auxiliary spans only
hermes.span.after_turnhermesbooltrue on an auxiliary span that started after its session's turn root had ended (title generation can fire after on_session_end): the span is its own root, with a span link (hermes.link=turn_root) to the root it followed rather than a parent that ended first (optional; auxiliary spans only)
llm.api_modehermesstringchat_completions · anthropic_messages · codex_responses · …
llm.request.message_count, llm.request.approx_input_tokens, llm.request.max_tokenshermesintRequest shape as Hermes reports it
llm.request.tool_counthermesintTools offered on an auxiliary call, when any (optional; auxiliary spans only)
gen_ai.request.max_tokens, gen_ai.request.temperature, gen_ai.request.top_p, gen_ai.request.top_k, gen_ai.request.frequency_penalty, gen_ai.request.presence_penalty, gen_ai.request.stream, gen_ai.request.reasoning.level, gen_ai.request.stop_sequences, gen_ai.request.choice.countgen_aimixedRequest parameters, each only when Hermes passes it (optional)
input.value, input.mime_type, gen_ai.input.messagesbothstring (JSON)Full request messages, one copy per convention — content_capture: full (the default)
gen_ai.system_instructionsgen_aistringFull system prompt: the leading system message, or the Responses API instructions — content_capture: full
hermes.content.input_charshermesintSize of the captured request JSON — content_capture: full

Set at end (success):

AttributeConventionTypeMeaning
llm.token_count.prompt, llm.token_count.completion, llm.token_count.totalOpenInferenceintWhole prompt (incl. cache reads/writes), completion, sum
llm.token_count.prompt_details.cache_read, llm.token_count.prompt_details.cache_writeOpenInferenceintCache buckets (optional)
llm.token_count.completion_details.reasoningOpenInferenceintReasoning tokens, a subset of completion (optional)
gen_ai.usage.input_tokens, gen_ai.usage.output_tokens, gen_ai.usage.total_tokensgen_aiintSame three totals
gen_ai.usage.cache_read.input_tokens, gen_ai.usage.cache_creation.input_tokensgen_aiintCache buckets, current spelling (optional)
gen_ai.usage.cache_read_input_tokens, gen_ai.usage.cache_creation_input_tokensgen_aiintSame values, pre-existing alias kept for older dashboards (optional)
gen_ai.usage.reasoning.output_tokensgen_aiintReasoning tokens (optional)
gen_ai.response.model, gen_ai.response.idgen_aistringResponse model / id, only when the provider reported them (optional)
gen_ai.response.finish_reasonsgen_aistring[]["stop"], ["tool_use"], …
llm.response.finish_reasonhermesstringSame, scalar
llm.response.duration_mshermesfloatWall-clock of the request
hermes.api.ttfc_mshermesfloatStreaming calls: milliseconds from the call's start (retries included) to the first response chunk, from Hermes's started_at / first_chunk_at; absent for a non-streamed call
llm.response.output_chars, llm.response.tool_callshermesintAssistant content length / tool-call count (optional)
output.value, output.mime_type, gen_ai.output.messagesbothstring (JSON)Full response: the text and, inside the one assistant message, its tool calls — content_capture: full (the default)
hermes.content.output_charshermesintSize of the captured response — content_capture: full
hermes.cost.statushermesstringHow Hermes priced this call (estimate_usage_cost, the function behind state.db and /usage): actual (provider-reported) · estimated (price table or models API) · included (subscription route: no charge to report) · unknown (no price for the model). Absent on Hermes builds without the pricing module
hermes.cost.sourcehermesstringWhere the price came from, as Hermes reports it (official_docs_snapshot, provider_models_api, none, …) (optional)
hermes.cost.usagehermesfloatUSD for this call, only for actual / estimated; never 0 for an unknown price or an included route (optional)

api.* on failure (api_request_error)​

When the request fails, the span ends with StatusCode.ERROR, an exception event, and:

AttributeConventionTypeMeaning
exception.type, exception.message, exception.escapedOTelstring / string / boolOn the exception span event the failed request records: the error class, its text and true (exception.type / exception.message also on a forwarded log record with exc_info)
error.typeOTelstringError class reported by Hermes (e.g. RateLimitError)
http.response.status_code, gen_ai.response.status_codeOTel / gen_aiintHTTP status (omitted for network errors)
hermes.retry.count, hermes.max_retries, hermes.retryablehermesint / int / boolRetry state for this request
llm.response.duration_mshermesfloatWall-clock of the failed attempt

The most recent error.type is also stamped on the turn's root span at on_session_end.

tool.*​

One per tool call (span kind TOOL), keyed by Hermes' tool_call_id so parallel calls never collide.

AttributeConventionTypeMeaning
tool.name, gen_ai.tool.namebothstringTool name
gen_ai.tool.call.idgen_aistringHermes tool_call_id (falls back to task_id on older Hermes)
gen_ai.operation.namegen_aistringexecute_tool
input.value, gen_ai.tool.call.argumentsbothstringTool args (JSON preview; full for mcp_* tools in content_capture: full)
output.value, gen_ai.tool.call.resultbothstringTool result preview
hermes.preview.input.truncated, hermes.preview.input.original_chars, hermes.preview.output.truncated, hermes.preview.output.original_charshermesbool, intSet only when the args or result preview was clipped: true and the original length (optional)
hermes.tool.result.charshermesintSize of the result string the model receives, every tool
hermes.terminal.output.chars, hermes.terminal.returncode, hermes.terminal.env_typehermesint, int, stringTerminal tool only: the output size as the terminal tool handed it to Hermes' transform stage (after the capture window, before the head+tail limit, whitespace strip and redaction), the exit code and the environment type, observed on transform_terminal_output (hooks)
hermes.terminal.output.truncated, hermes.terminal.output.dropped_charshermesbool, intTerminal tool only: whether Hermes' output limit cut the output before the model saw it, and by how many characters (dropped_chars only when true). Read from Hermes' own record of the cut (the output_total_chars field of a capture-window spill, or the [OUTPUT TRUNCATED - N chars omitted …] notice of the head+tail limit), never from a size comparison, so whitespace stripping, ANSI removal and redaction are not mistaken for truncation
hermes.tool.targethermesstringFirst non-empty path / file_path / target / url / uri arg (optional)
hermes.tool.commandhermesstringFirst non-empty command / cmd arg (optional)
hermes.tool.outcomehermesstringerror · timeout · blocked · cancelled from Hermes' hook status or the tool's own result status; completed means the tool returned and nothing reported a failure
hermes.tool.blocked_byhermesstringWhich governance floor blocked the call — deny_rule · hardline · stdin_password_guard (optional; only when positively classified, outcome=blocked)
hermes.tool.decided_byhermesstringhard_floor on the tool span when a floor (not a human) blocked the call; see also hermes.approval.decided_by on approval.* spans (optional)
hermes.tool.git_commithermesbooltrue when a terminal command was a git commit (matched as a word, so git commit-tree is not one) that exited 0: the call the commit counter (metrics) and the commit event came from (optional)
error.messageOTelstringResult error text when the outcome is error (optional)
hermes.skill.name, hermes.skill.sourcehermesstringBare skill name and skill_view / path_match when the call loaded a skill (optional)
hermes.tool.cpu.utilization.avg, hermes.tool.cpu.utilization.peakhermesfloatProcess-tree CPU (0..1) during the call — host_metrics only
hermes.tool.gpu.utilization.avg, hermes.tool.gpu.utilization.peakhermesfloatHost GPU busy ratio (0..1) during the call — host_metrics + GPU only

The utilization attributes are absent when host metrics are off or the tool finished between two samples. See Host & GPU metrics.

skill.*​

One per skill that loaded successfully this turn (skill_spans: true), nested under the root; opens when the loading tool call ends and closes at turn end.

AttributeConventionTypeMeaning
hermes.skill.name, gen_ai.skill.namehermes / gen_aistringBare skill name as Hermes names it
hermes.skill.sourcehermesstringskill_view · path_match
hermes.skill.pathhermesstringDirectory holding the skill's SKILL.md, as reported by skill_view (skill_dir) or resolved from the file the tool read; omitted when unknown, never derived from the name (optional)
hermes.span_kindhermesstringskill
gen_ai.operation.namegen_aistringexecute_skill
hermes.skill.result_statushermesstringTurn outcome at close (completed · interrupted · …)

approval.*​

One per human-in-the-loop (or smart-guardian) approval prompt, named approval.<pattern_key>.

AttributeConventionTypeMeaning
hermes.approval.pattern_key, hermes.approval.pattern_keyshermesstringHermes' approval pattern key, when reported (the span is then approval.<key>, else approval)
hermes.approval.surfacehermesstringcli · telegram · … (optional)
hermes.approval.command, hermes.approval.descriptionhermesstringGated command and Hermes' description (previews; optional)
gen_ai.tool.call.idgen_aistringCorrelates to the gated tool.* span (optional)
hermes.span_kindhermesstringapproval
hermes.approval.granted, hermes.approval.timed_outhermesboolOutcome flags
hermes.approval.choicehermesstringonce · session · always · deny · timeout · smart_approve · smart_deny · notify_failed
hermes.approval.decided_byhermesstringaux_llm for smart-guardian verdicts, empty for a human answer (optional)
hermes.approval.duration_mshermesfloatDecision wait time

human_input.*​

One per wait on the person (a clarify question, a password prompt), named human_input.<kind> and nested under the turn's in-flight span; an approval wait is only counted, since it has its own approval.* span. The prompt Hermes passes is already redacted.

AttributeConventionTypeMeaning
hermes.span_kindhermesstringhuman_input
hermes.human_input.kindhermesstringHermes's kind of wait: clarify, a password prompt, … (an approval wait has its own approval.* span and is only counted)
hermes.human_input.prompthermesstringWhat the person was asked, as Hermes redacted it; a preview under content_capture (optional)
hermes.human_input.outcomehermesstringHow the wait ended, as Hermes reports it (error when it reported nothing)
hermes.human_input.wait_shermesfloatSeconds the agent waited on the person (optional)

kanban.*​

One per kanban board transition (hooks): kanban.claim, kanban.spawn, kanban.worker_exit, kanban.stale_claim in the dispatcher process, kanban.complete and kanban.block in the worker; one run of a card is one trace rooted at kanban.claim (span hierarchy). Opened and closed at once.

AttributeConventionTypeMeaning
hermes.span_kindhermesstringkanban
hermes.kanban.eventhermesstringclaimed · spawned · worker_exited · stale_claim · completed · blocked
hermes.kanban.task_id, hermes.kanban.board, hermes.kanban.assignee, hermes.kanban.run_idhermesstringThe card, its board, the profile assigned to it and the attempt (run_id as a string); the join across the dispatcher's and the worker's traces
hermes.kanban.worker_pidhermesintThe worker process (kanban.spawn, kanban.worker_exit, kanban.stale_claim)
hermes.kanban.exit_kind, hermes.kanban.exit_code, hermes.kanban.retry_statushermesstring, int, stringHow the worker process ended (clean_exit · rate_limited · nonzero_exit · signaled · unknown), its exit code, and what the dispatcher does next (kanban.worker_exit; retry_status also on kanban.stale_claim)
hermes.kanban.heartbeat_stalehermesboolWhether the reclaimed claim had stopped heart-beating (kanban.stale_claim)
hermes.kanban.outcomehermesstringcompleted · blocked on the worker-side spans and on the worker's agent root; the dispatcher's own outcome word on kanban.worker_exit (crashed, timed_out, …)
hermes.kanban.summary, hermes.kanban.reasonhermesstringThe worker's hand-off summary (kanban.complete) or block reason (kanban.block), preview-clipped; absent when capture_previews=false

The worker's agent root additionally carries hermes.kanban.task_id, hermes.kanban.board, hermes.kanban.run_id and hermes.kanban.outcome once the card is completed or blocked.

subagent.*​

One per delegated child agent (span kind AGENT); the child's own root nests beneath it (or is linked, cross-process).

AttributeConventionTypeMeaning
gen_ai.operation.name, gen_ai.agent.namegen_aistringinvoke_agent / child role (gen_ai.agent.name absent when no role was reported)
hermes.subagent.role, hermes.subagent.goalhermesstringChild role (only when Hermes reports one; the span is then subagent.<role>, else subagent) and delegated goal (preview)
input.valueOpenInferencestringThe goal preview
hermes.subagent.child_session_id, hermes.subagent.child_idhermesstringChild session / sub-agent ids
hermes.subagent.parent_session_id, hermes.subagent.parent_turn_id, hermes.subagent.parent_idhermesstringParent identity
hermes.subagent.status, hermes.subagent.duration_ms, hermes.subagent.summary, output.valuehermes / OpenInferencemixedOn stop: reported child_status, wall-clock, result summary
hermes.subagent.model_inheritedhermesboolSet when the child's root starts, with gen_ai.request.model (the child's model): whether the child runs on its parent's model (false with delegation.model set)
hermes.subagent.usage.input_tokens, hermes.subagent.usage.output_tokens, hermes.subagent.usage.total_tokens, hermes.subagent.api_call_counthermesintOn stop: tokens and API calls of the child's whole subtree (its own turns plus every delegation it made); namespaced so the child root's gen_ai.usage.* is not counted twice by a reader that sums agent spans
hermes.subagent.cost.usage, hermes.subagent.cost.statushermesmixedOn stop: the subtree's USD and pricing status, by the turn root's rule (an amount only when every call was priced)
hermes.subagent.swepthermesbooltrue when the delegation was closed by its TTL (subagent_span_ttl_ms) because subagent_stop never arrived

Metrics​

Metrics are documented on their own page: Metrics reference.