Monitoring

MonitoringService provides low-cost, on-demand observability endpoints for the Admin UI. Design goals: - Prefer CloudWatch metrics + Logs Insights queries (no always-on alarms/dashboards). - Support a lightweight “drill-down” flow from error summaries to surrounding log context.

Base path: /monitoring

POST /monitoring/GetOverview

GetOverview returns a coarse, low-cost snapshot of key metrics.

Request (GetOverviewRequest)

Field	Type	Description
lookback_minutes	int32	Lookback window for metrics aggregation (minutes). Defaults to 60 when unset.
period_seconds	int32	Period for metric datapoints (seconds). Defaults to 60 when unset.

Response (GetOverviewResponse)

Field	Type	Description
api_gateways	ApiGatewayOverview[]
cloudfront_distributions	CloudFrontOverview[]
lambdas	LambdaOverview[]
sqs_queues	SqsQueueOverview[]

POST /monitoring/ListRecentErrors

ListRecentErrors returns recent error log entries across configured log groups.

Request (ListRecentErrorsRequest)

Field	Type	Description
lookback_minutes	int32	Lookback window for error query (minutes). Defaults to 60 when unset.
limit	int32	Maximum number of error entries to return. Defaults to 50 when unset.

Response (ListRecentErrorsResponse)

Field	Type	Description
entries	ErrorLogEntry[]

POST /monitoring/GetLogContext

GetLogContext returns log lines around a specific timestamp for drill-down.

Request (GetLogContextRequest)

Field	Type	Description
log_group	string	Log group to query.
center_timestamp	Timestamp	Center timestamp for context window.
window_seconds	int32	Window size around center (seconds). Default 60 when unset.
correlation_id	string?	Optional: filter by correlation id when present.
aws_request_id	string?	Optional: filter by aws request id when present.
limit	int32	Maximum log lines to return. Default 200 when unset.

Response (GetLogContextResponse)

Field	Type	Description
lines	LogLine[]