Skip to main content

Agent Monitoring

View agent status and logs.

Commands​


agent-status​

Show detailed runtime status for an agent.

sekuire agent-status <AGENT_ID> [OPTIONS]

Options​

OptionDescription
--registry <URL>Registry URL (default: https://api.sekuire.ai)

Example​

Terminal
$ sekuire agent-status 7f8a9b3c2d1e

Agent: my-agent v1.0.0
Sekuire ID: 7f8a9b3c2d1e...
Runtime: active
Verified: verified
Reputation: 85
Heartbeat: 2024-01-15T10:30:00Z

Output Fields​

FieldDescription
NameAgent name and version
Sekuire IDContent-addressable identity hash
RuntimeCurrent status: active, paused, terminated, or unknown
VerifiedVerification status: verified, unverified, or pending
ReputationTrust score (0-100)
HeartbeatLast heartbeat timestamp
PendingAny pending commands (if applicable)

Runtime States​

StateDescription
activeAgent is running and accepting tasks
pausedAgent is paused via sekuire stop
terminatedAgent was terminated via sekuire kill
unknownNo heartbeat received recently

logs​

View recent logs for an agent.

sekuire logs <AGENT_ID> [OPTIONS]

Options​

OptionDescription
--limit <N>Number of log entries (default: 20)
--registry <URL>Registry URL (default: https://api.sekuire.ai)

Example​

Terminal
$ sekuire logs 7f8a9b3c2d1e --limit 50

[2024-01-15T10:30:00Z] INF heartbeat {}
[2024-01-15T10:29:45Z] INF task_completed tool=get_weather
[2024-01-15T10:29:30Z] INF task_started tool=get_weather
[2024-01-15T10:28:00Z] WRN rate_limit_warning requests=95
[2024-01-15T10:27:00Z] INF heartbeat {}
[2024-01-15T10:26:30Z] ERR tool_execution_failed tool=send_email message=SMTP connection refused

Log Format​

[timestamp] SEVERITY event_type detail

Severity Levels​

LevelLabelDescription
InfoINFNormal operations
WarningWRNWarnings that may need attention
ErrorERRErrors that affected execution
DebugDBGDebug information

Common Event Types​

Event TypeDescription
heartbeatPeriodic health check
task_startedTask execution began
task_completedTask finished successfully
tool_execution_failedTool call failed
rate_limit_warningApproaching rate limits
policy_violationAction blocked by policy
bootstrap_completeAgent startup finished

Use Cases​

Debugging Issues​

# Check current status
sekuire agent-status 7f8a9b3c

# View recent errors
sekuire logs 7f8a9b3c --limit 100 | grep ERR

Monitoring Health​

# Check heartbeat timestamp
sekuire agent-status 7f8a9b3c

# View recent activity
sekuire logs 7f8a9b3c --limit 10

Audit Review​

# View extended history
sekuire logs 7f8a9b3c --limit 500

Dashboard Integration​

For real-time monitoring and visualization, use the Sekuire Dashboard:

  • Live Logs: Stream logs in real-time
  • Metrics Charts: CPU, memory, request rates
  • Alert Configuration: Set up notifications for errors
  • Audit Trail: Full searchable history

Access the dashboard at https://sekuire.ai/dashboard.


Next Steps​

  • lifecycle - Pause, resume, and terminate agents
  • metrics - View performance metrics
  • test - Test agent health checks