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