Skip to main content

Documentation Index

Fetch the complete documentation index at: https://noradocs.solomontsao.com/llms.txt

Use this file to discover all available pages before exploring further.

The Monitoring API gives you observability into both the Nora platform and your individual agents. You can pull a high-level platform metrics summary, page through the activity event log, query detailed per-agent metrics with time range filters, retrieve pre-aggregated summary statistics, and fetch cost data. All metrics are scoped to agents you own — you cannot query data for another user’s agents.

​
Platform metrics summary

Return aggregate health and usage metrics for the entire platform as seen by the authenticated user. 
GET /monitoring/metrics

​
Response

​
agents_total
number
Total number of agents owned by the user.
​
agents_running
number
Agents currently in running state.
​
agents_stopped
number
Agents in stopped state.
​
agents_error
number
Agents in error or warning state.
​
events_today
number
Number of activity events recorded in the last 24 hours.
curl http://localhost:8080/api/monitoring/metrics \
  -H "Authorization: Bearer $TOKEN"

{
  "agents_total": 4,
  "agents_running": 2,
  "agents_stopped": 1,
  "agents_error": 1,
  "events_today": 37
}

​
Activity event log

Return a chronological log of activity events. When you supply agentId the results are filtered to that agent; otherwise all events across your agents are returned. 
GET /monitoring/events

​
Query parameters

​
agentId
string
Filter events to a specific agent UUID.
​
limit
number
default:"50"
Maximum number of events to return, ordered newest first.

​
Response

​
id
string
Event UUID.
​
type
string
Event type slug, e.g. agent_deployed, agent_redeployed.
​
message
string
Human-readable description of the event.
​
metadata
object
Additional context for the event.
​
created_at
string
ISO 8601 event timestamp.
curl "http://localhost:8080/api/monitoring/events?limit=20" \
  -H "Authorization: Bearer $TOKEN"

[
  {
    "id": "g8h9i0j1-k2l3-4567-mnop-456789012345",
    "type": "agent_deployed",
    "message": "Agent \"My Agent\" (OpenClaw + Docker) queued for deployment",
    "metadata": { "agentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" },
    "created_at": "2025-03-10T09:00:05.000Z"
  }
]

​
API performance data

Return raw API performance metric records. Useful for building latency dashboards or debugging slow endpoints. 
GET /monitoring/performance

​
Query parameters

​
since
string
ISO 8601 start timestamp. Defaults to 24 hours ago.

​
Response

Each record represents a single API call that was instrumented.
​
value
number
Measured value (typically response time in ms).
​
metadata
object
Context for the measurement, such as path and method.
​
recorded_at
string
ISO 8601 timestamp when the metric was recorded.
curl "http://localhost:8080/api/monitoring/performance?since=2025-03-10T00:00:00Z" \
  -H "Authorization: Bearer $TOKEN"

[
  {
    "value": 42,
    "metadata": { "method": "GET", "path": "/agents", "status": 200 },
    "recorded_at": "2025-03-10T09:01:00.000Z"
  }
]

​
Agent metrics

Return time-series metric records for a specific agent. You can filter by metric type and specify an exact time range. 
GET /agents/:id/metrics

​
Path parameters

​
id
string
required
Agent UUID.

​
Query parameters

​
type
string
Metric type filter, e.g. cpu, memory, tokens. When omitted, all types are returned.
​
since
string
ISO 8601 start of the time range. Defaults to 24 hours ago.
​
until
string
ISO 8601 end of the time range. Defaults to now.

​
Response

​
id
string
Metric record UUID.
​
agent_id
string
Agent UUID.
​
metric_type
string
Metric category slug.
​
value
number
Numeric metric value.
​
metadata
object
Additional context for the metric.
​
recorded_at
string
ISO 8601 timestamp.
curl "http://localhost:8080/api/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890/metrics?type=tokens&since=2025-03-10T00:00:00Z" \
  -H "Authorization: Bearer $TOKEN"

[
  {
    "id": "h9i0j1k2-l3m4-5678-nopq-567890123456",
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "metric_type": "tokens",
    "value": 1240,
    "metadata": { "model": "gpt-4o", "direction": "completion" },
    "recorded_at": "2025-03-10T09:10:00.000Z"
  }
]

​
Agent metrics summary

Return pre-aggregated summary statistics for an agent. Useful for dashboards that need totals without querying the full time-series. 
GET /agents/:id/metrics/summary

​
Path parameters

​
id
string
required
Agent UUID.

​
Response

​
total_tokens
number
Total LLM tokens consumed by this agent.
​
total_requests
number
Total LLM API requests made.
​
avg_response_ms
number
Average LLM response latency in milliseconds.
​
last_active_at
string
ISO 8601 timestamp of the most recent metric record.
curl http://localhost:8080/api/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890/metrics/summary \
  -H "Authorization: Bearer $TOKEN"

{
  "total_tokens": 48200,
  "total_requests": 312,
  "avg_response_ms": 1840,
  "last_active_at": "2025-03-10T09:10:00.000Z"
}

​
Agent cost

Return cost data for a specific agent. Costs are computed from token usage and any other billable resource consumption. 
GET /agents/:id/cost

​
Path parameters

​
id
string
required
Agent UUID.

​
Response

​
agent_id
string
Agent UUID.
​
total_cost_usd
number
Total estimated cost in USD.
​
breakdown
object
Cost breakdown by resource type.
​
period_start
string
Start of the billing period (ISO 8601).
​
period_end
string
End of the billing period (ISO 8601).
curl http://localhost:8080/api/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cost \
  -H "Authorization: Bearer $TOKEN"

{
  "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "total_cost_usd": 0.87,
  "breakdown": {
    "tokens_usd": 0.62,
    "compute_usd": 0.25
  },
  "period_start": "2025-03-01T00:00:00.000Z",
  "period_end": "2025-03-31T23:59:59.000Z"
}
StatusCondition
404Agent not found