Skip to main content

​
statistics

Usage statistics and analytics. 
type statistics {
  id: ID!
  name: String!
  label: String!
  type: String!
  trigger: String!
  count: Int!
  user: ID
  role: ID
  createdAt: Date!
  updatedAt: Date!
}

​
Aggregate Statistics

Query aggregate statistics with grouping: 
query {
  statisticsStatistics(
    groupBy: "label"
    filters: [
      { type: { eq: "agent_run" } }
    ]
    limit: 10
  ) {
    group
    count
  }
}

​
Common Statistics Types

  • agent_run - Agent execution count
  • api_call - API request count
  • workflow_execution - Workflow run count
  • eval_run - Evaluation execution count
  • context_search - Vector search count

​
Usage Analytics

Statistics track usage across:
  • Per user - Track individual user activity
  • Per role - Aggregate by role
  • Per resource - Track specific agents, workflows, etc.
  • Time-based - Query by date ranges

​
Example: Agent Usage Report

query {
  statisticsStatistics(
    groupBy: "label"
    filters: [
      {
        type: { eq: "agent_run" }
        createdAt: { gte: "2025-01-01T00:00:00Z" }
      }
    ]
  ) {
    group  # Agent name
    count  # Number of executions
  }
}

User Management

User and role statistics

Agent Types

Agent usage tracking

Workflow Types

Workflow execution stats

Back to Overview

View all core types