@agent-action-runner/opentelemetry

OpenTelemetry instrumentation for Agent Action Runner.

This package wraps a runner instead of deriving spans from audit events. That keeps span lifetime aligned with executeAction() and executeWorkflow().

import { createRunner } from '@agent-action-runner/core';
import { instrumentRunner } from '@agent-action-runner/opentelemetry';

const runner = instrumentRunner(createRunner(), {
  attributes: {
    service: 'admin-api',
  },
});

By default, the wrapper avoids high-cardinality or user-identifying attributes. It records action/workflow names and safe static attributes, but does not include userId, workflowId, or stepId unless you explicitly opt in.

const runner = instrumentRunner(createRunner(), {
  includeUserId: true,
  includeWorkflowId: true,
  includeStepId: true,
  attributeMapper: ({ attributes }) => ({
    ...attributes,
    deployment: 'local-dev',
  }),
});

The wrapper records:

• spans: agent_action.execute, agent_workflow.execute
• counters: agent_action_started_total, agent_action_succeeded_total, agent_action_failed_total, agent_workflow_started_total, agent_workflow_succeeded_total, agent_workflow_failed_total
• histogram: agent_action_duration_ms

Action input and output payloads are not written to telemetry attributes.

executeWorkflow() currently creates a workflow-level span only. It does not create child action spans for each workflow step because the core workflow runner owns step execution internally.