Analytics¶

The Analytics API allows you to retrieve high-level metrics and granular time-series data about your agent executions. This is useful for building custom dashboards or integrating with your own BI tools.

Analytics API¶

Get Summary Stats¶

GET /v1/analytics/summary

Returns high-level statistics for a given time range.

Parameters:

• timeRange (optional): One of 24h, 7d, 30d (default: 7d).

Response:

{
  "timeRange": "7d",
  "stats": {
    "totalExecutions": 150,
    "activeExecutions": 2,
    "pendingApprovals": 1,
    "successfulExecutions": 140,
    "failedExecutions": 7,
    "successRate": 93.33
  }
}

Get Time Series Data¶

GET /v1/analytics/timeseries

Returns granular trend data for execution counts, error rates, and costs.

Parameters:

• startDate: ISO 8601 start timestamp.
• endDate: ISO 8601 end timestamp.
• granularity (optional): hour, day, week (default: day).

Response:

{
  "granularity": "day",
  "data": [
    {
      "timestamp": "2023-10-27T00:00:00Z",
      "executionCount": 20,
      "avgDurationMs": 450,
      "errorRate": 0.05,
      "totalCost": 1.25
    },
    ...
  ],
  "summary": {
    "totalExecutions": 150,
    "avgErrorRate": 0.04,
    "totalCost": 10.50
  }
}