Skip to content

Get Aggregated Analytics

GET
/api/analytics/

Aggregated analytics from all real data sources.

time_range
Time Range

Time range for analytics

string
default: day /^(hour|day|week|month|year)$/

Time range for analytics

Successful Response

AnalyticsAggregateResponse

Combined analytics response for dashboard.

Comprehensive analytics payload aggregating all analytics data sources including performance, usage, agent metrics, errors, time series, endpoints, and module usage for complete dashboard visualization.

Fields: performance: Performance metrics (CPU, memory, disk, network, response time) usage: Usage metrics (users, sessions, API calls, documents, conversations) agents: Agent metrics (requests, response time, success rate, active agents) errors: Error metrics (total, rate, critical, resolved) time_series: Time series data for trend charts top_endpoints: List of top endpoints by request volume module_usage: List of module usage statistics time_range: Time range for analytics (hour, day, week, month, year) health_score: Overall system health score (0-100) productivity_score: Overall productivity score (0-100) last_update: Last update timestamp (ISO 8601)

Used By: - GET /api/analytics/ endpoint - Analytics dashboard main view - System health overview

object
performance
required
AnalyticsPerformanceMetrics

Performance metrics

object
cpuUsage
required
Cpuusage

CPU usage percentage

number
<= 100
memoryUsage
required
Memoryusage

Memory usage percentage

number
<= 100
diskUsage
required
Diskusage

Disk usage percentage

number
<= 100
networkLatency
required
Networklatency

Network latency in ms

number
responseTime
required
Responsetime

Average response time in ms

number
usage
required
AnalyticsUsageMetrics

Usage metrics

object
activeUsers
required
Activeusers

Active users count

integer
totalSessions
required
Totalsessions

Total sessions count

integer
averageSessionDuration
required
Averagesessionduration

Average session duration in seconds

number
apiCalls
required
Apicalls

API calls count

integer
documentsCreated
required
Documentscreated

Documents created count

integer
conversationsStarted
required
Conversationsstarted

Conversations started count

integer
agents
required
AnalyticsAgentMetrics

Agent metrics

object
totalRequests
required
Totalrequests

Total agent requests

integer
averageResponseTime
required
Averageresponsetime

Average response time in ms

number
successRate
required
Successrate

Success rate percentage

number
<= 100
activeAgents
required
Activeagents

Active agents count

integer
collaborations
required
Collaborations

Agent collaborations count

integer
errors
required
AnalyticsErrorMetrics

Error metrics

object
totalErrors
required
Totalerrors

Total errors count

integer
errorRate
required
Errorrate

Error rate percentage

number
<= 100
criticalErrors
required
Criticalerrors

Critical errors count

integer
resolvedErrors
required
Resolvederrors

Resolved errors count

integer
timeSeries
required
AnalyticsTimeSeriesMetrics

Time series metrics

object
cpuUsage
Cpuusage

CPU usage time series

Array<object>
AnalyticsTimeSeriesDataPoint

Time series data point for analytics charts.

Represents a single data point in time series analytics with timestamp, value, and optional label for chart visualization.

Fields: timestamp: Unix timestamp in milliseconds value: Data point value label: Optional label for the data point

Used By: - AnalyticsTimeSeriesMetrics model - Analytics dashboard time series charts - Trend visualization

object
timestamp
required
Timestamp

Data point timestamp (ms)

integer
value
required
Value

Data point value

number
label
Any of:
string
memoryUsage
Memoryusage

Memory usage time series

Array<object>
AnalyticsTimeSeriesDataPoint

Time series data point for analytics charts.

Represents a single data point in time series analytics with timestamp, value, and optional label for chart visualization.

Fields: timestamp: Unix timestamp in milliseconds value: Data point value label: Optional label for the data point

Used By: - AnalyticsTimeSeriesMetrics model - Analytics dashboard time series charts - Trend visualization

object
timestamp
required
Timestamp

Data point timestamp (ms)

integer
value
required
Value

Data point value

number
label
Any of:
string
apiCalls
Apicalls

API calls time series

Array<object>
AnalyticsTimeSeriesDataPoint

Time series data point for analytics charts.

Represents a single data point in time series analytics with timestamp, value, and optional label for chart visualization.

Fields: timestamp: Unix timestamp in milliseconds value: Data point value label: Optional label for the data point

Used By: - AnalyticsTimeSeriesMetrics model - Analytics dashboard time series charts - Trend visualization

object
timestamp
required
Timestamp

Data point timestamp (ms)

integer
value
required
Value

Data point value

number
label
Any of:
string
agentRequests
Agentrequests

Agent requests time series

Array<object>
AnalyticsTimeSeriesDataPoint

Time series data point for analytics charts.

Represents a single data point in time series analytics with timestamp, value, and optional label for chart visualization.

Fields: timestamp: Unix timestamp in milliseconds value: Data point value label: Optional label for the data point

Used By: - AnalyticsTimeSeriesMetrics model - Analytics dashboard time series charts - Trend visualization

object
timestamp
required
Timestamp

Data point timestamp (ms)

integer
value
required
Value

Data point value

number
label
Any of:
string
errorRate
Errorrate

Error rate time series

Array<object>
AnalyticsTimeSeriesDataPoint

Time series data point for analytics charts.

Represents a single data point in time series analytics with timestamp, value, and optional label for chart visualization.

Fields: timestamp: Unix timestamp in milliseconds value: Data point value label: Optional label for the data point

Used By: - AnalyticsTimeSeriesMetrics model - Analytics dashboard time series charts - Trend visualization

object
timestamp
required
Timestamp

Data point timestamp (ms)

integer
value
required
Value

Data point value

number
label
Any of:
string
topEndpoints
required
Topendpoints

Top endpoints list

Array<object>
AnalyticsTopEndpoint

Top endpoint statistics for analytics dashboard.

Represents a single endpoint’s performance metrics for endpoint ranking and API performance analysis.

Fields: endpoint: Endpoint path requests: Request count for endpoint average_response_time: Average response time in milliseconds error_rate: Error rate percentage for endpoint

Used By: - GET /api/analytics/ endpoint - Analytics dashboard top endpoints section - API performance analysis

object
endpoint
required
Endpoint

Endpoint path

string
requests
required
Requests

Request count

integer
averageResponseTime
required
Averageresponsetime

Average response time in ms

number
errorRate
required
Errorrate

Error rate percentage

number
<= 100
moduleUsage
required
Moduleusage

Module usage list

Array<object>
AnalyticsModuleUsage

Module usage statistics for analytics dashboard.

Tracks individual module usage metrics including usage count, time spent, and engagement scores for module performance analysis.

Fields: module: Module name usage: Usage count time_spent: Time spent in seconds engagement_score: Engagement score (0-100)

Used By: - GET /api/analytics/ endpoint - Analytics dashboard module usage section - User engagement analysis

object
module
required
Module

Module name

string
usage
required
Usage

Usage count

integer
timeSpent
required
Timespent

Time spent in seconds

number
engagementScore
required
Engagementscore

Engagement score

number
<= 100
timeRange
required
Timerange

Time range for analytics

string
healthScore
required
Healthscore

Overall health score

number
<= 100
productivityScore
required
Productivityscore

Overall productivity score

number
<= 100
lastUpdate
required
Lastupdate

Last update timestamp (ISO 8601)

string

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object