Monitoring Process Plugin Activity

Flow Studio Observer Panel

All workflow executions triggered by agents appear in the Flow Studio Observer Panel with initiatedBy: "OctopusAgent:{agentId}". The Observer Panel shows:

• The workflow execution timeline with all node states
• Input data passed from the agent to the workflow
• AI Agent Node turns — the prompt sent and agent response received
• HIL task decisions made by the agent actor, with the reason
• Final workflow output returned to the agent

Structured Log Events

// ProcessPlugin emits structured log events at key integration points:

// Agent triggers a workflow
{
  "timestamp":    "2024-06-15T10:00:00Z",
  "level":        "Information",
  "event":        "WorkflowTriggered",
  "agent_id":     "hr-assistant",
  "session_id":   "sess-abc123",
  "tenant_id":    "tenant-xyz",
  "workflow_id":  "leave-approval-workflow",
  "execution_id": "exec-abc456",
  "mode":         "sync"
}

// Sync workflow completed
{
  "timestamp":    "2024-06-15T10:00:04Z",
  "level":        "Information",
  "event":        "WorkflowCompleted",
  "execution_id": "exec-abc456",
  "elapsed_ms":   4250,
  "status":       "Completed"
}

// HIL task received
{
  "timestamp":    "2024-06-15T10:05:00Z",
  "level":        "Information",
  "event":        "HILTaskReceived",
  "task_id":      "hil-xyz789",
  "task_type":    "ApprovalRequest",
  "agent_id":     "approval-agent"
}

// HIL decision submitted
{
  "timestamp":    "2024-06-15T10:05:03Z",
  "level":        "Information",
  "event":        "HILDecisionSubmitted",
  "task_id":      "hil-xyz789",
  "decision":     "Approve",
  "elapsed_ms":   2870
}

Prometheus Metrics

# Metrics emitted by ProcessPlugin (scrape at /metrics)

# Counter — total workflow triggers by agent
octopus_workflow_triggers_total{agent_id="hr-assistant", workflow_id="leave-approval-workflow"} 42

# Histogram — sync workflow wait time distribution
octopus_workflow_sync_duration_seconds_bucket{le="1"} 5
octopus_workflow_sync_duration_seconds_bucket{le="5"} 38
octopus_workflow_sync_duration_seconds_bucket{le="30"} 42

# Counter — HIL tasks processed
octopus_hil_tasks_total{agent_id="approval-agent", decision="Approve"} 17
octopus_hil_tasks_total{agent_id="approval-agent", decision="Reject"} 3

# Gauge — HIL tasks currently pending
octopus_hil_tasks_pending{agent_id="approval-agent"} 2

Alert Recommendations