mirror of
https://github.com/EZ-Api/ez-api.git
synced 2026-01-13 17:47:51 +00:00
feat(api): add dashboard summary and system realtime endpoints
Add new admin API endpoints for dashboard metrics and system-wide realtime statistics: - Add /admin/dashboard/summary endpoint with aggregated metrics including requests, tokens, latency, masters, keys, and provider keys statistics with time period filtering - Add /admin/realtime endpoint for system-level realtime stats aggregated across all masters - Add status filter parameter to ListAPIKeys endpoint - Add hour grouping option to log stats aggregation - Update OpenAPI documentation with new endpoints and schemas
This commit is contained in:
zenfun
451
docs/docs.go
451
docs/docs.go
@@ -51,7 +51,7 @@ const docTemplate = `{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "List API keys",
|
||||
"description": "List API keys with optional filters",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -77,6 +77,12 @@ const docTemplate = `{
|
||||
"description": "filter by group_id",
|
||||
"name": "group_id",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "string",
|
||||
"description": "filter by status (active, suspended, auto_disabled, manual_disabled)",
|
||||
"name": "status",
|
||||
"in": "query"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
@@ -362,6 +368,37 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/apikey-stats/summary": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Aggregate APIKey success/failure stats across all provider groups",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "APIKey stats summary (admin)",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.APIKeyStatsSummaryResponse"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/bindings": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -680,6 +717,63 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/dashboard/summary": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Returns aggregated metrics for dashboard display including requests, tokens, latency, masters, keys, and provider keys statistics",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "Dashboard summary",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "time period: today, week, month, all",
|
||||
"name": "period",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"description": "unix seconds",
|
||||
"name": "since",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"description": "unix seconds",
|
||||
"name": "until",
|
||||
"in": "query"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.DashboardSummaryResponse"
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/features": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -1011,7 +1105,7 @@ const docTemplate = `{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Aggregate log stats with basic filtering. Use group_by param for grouped statistics (model/day/month). Without group_by returns LogStatsResponse; with group_by returns GroupedStatsResponse.",
|
||||
"description": "Aggregate log stats with basic filtering. Use group_by param for grouped statistics (model/day/month/hour). Without group_by returns LogStatsResponse; with group_by returns GroupedStatsResponse.",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -1036,10 +1130,11 @@ const docTemplate = `{
|
||||
"enum": [
|
||||
"model",
|
||||
"day",
|
||||
"month"
|
||||
"month",
|
||||
"hour"
|
||||
],
|
||||
"type": "string",
|
||||
"description": "group by dimension: model, day, month. Returns GroupedStatsResponse when specified.",
|
||||
"description": "group by dimension: model, day, month, hour. Returns GroupedStatsResponse when specified.",
|
||||
"name": "group_by",
|
||||
"in": "query"
|
||||
}
|
||||
@@ -2776,6 +2871,37 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/realtime": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Return aggregated realtime counters across all masters",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "System-level realtime stats (admin)",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.SystemRealtimeView"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/stats": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -2898,6 +3024,52 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"/internal/apikey-stats/flush": {
|
||||
"post": {
|
||||
"description": "Internal endpoint for flushing accumulated APIKey stats from DP to CP database",
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"internal"
|
||||
],
|
||||
"summary": "Flush API key stats",
|
||||
"parameters": [
|
||||
{
|
||||
"description": "Stats to flush",
|
||||
"name": "request",
|
||||
"in": "body",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.apiKeyStatsFlushRequest"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/internal/stats/flush": {
|
||||
"post": {
|
||||
"description": "Internal endpoint for flushing accumulated key usage stats from DP to CP database",
|
||||
@@ -3573,6 +3745,12 @@ const docTemplate = `{
|
||||
"github_com_ez-api_ez-api_internal_dto.APIKeyDTO": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"access_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"account_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"api_key": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3585,9 +3763,18 @@ const docTemplate = `{
|
||||
"ban_until": {
|
||||
"type": "string"
|
||||
},
|
||||
"expires_at": {
|
||||
"type": "string"
|
||||
},
|
||||
"group_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"project_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"refresh_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3666,6 +3853,9 @@ const docTemplate = `{
|
||||
"google_project": {
|
||||
"type": "string"
|
||||
},
|
||||
"headers_profile": {
|
||||
"type": "string"
|
||||
},
|
||||
"models": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -3675,6 +3865,9 @@ const docTemplate = `{
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"static_headers": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3686,6 +3879,12 @@ const docTemplate = `{
|
||||
"github_com_ez-api_ez-api_internal_model.APIKey": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"access_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"account_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"api_key": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3704,15 +3903,36 @@ const docTemplate = `{
|
||||
"deletedAt": {
|
||||
"$ref": "#/definitions/gorm.DeletedAt"
|
||||
},
|
||||
"expires_at": {
|
||||
"type": "string"
|
||||
},
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"group_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"project_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"updatedAt": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3911,12 +4131,21 @@ const docTemplate = `{
|
||||
"deletedAt": {
|
||||
"$ref": "#/definitions/gorm.DeletedAt"
|
||||
},
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"google_location": {
|
||||
"type": "string"
|
||||
},
|
||||
"google_project": {
|
||||
"type": "string"
|
||||
},
|
||||
"headers_profile": {
|
||||
"type": "string"
|
||||
},
|
||||
"id": {
|
||||
"type": "integer"
|
||||
},
|
||||
@@ -3927,9 +4156,21 @@ const docTemplate = `{
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"static_headers": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"type": {
|
||||
"description": "openai, anthropic, gemini",
|
||||
"type": "string"
|
||||
@@ -4046,6 +4287,26 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.APIKeyStatsSummaryResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.AboutResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4161,6 +4422,17 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.CountStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"active": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.CreateMasterRequest": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
@@ -4182,6 +4454,41 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.DashboardSummaryResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"keys": {
|
||||
"$ref": "#/definitions/internal_api.CountStats"
|
||||
},
|
||||
"latency": {
|
||||
"$ref": "#/definitions/internal_api.LatencyStats"
|
||||
},
|
||||
"masters": {
|
||||
"$ref": "#/definitions/internal_api.CountStats"
|
||||
},
|
||||
"period": {
|
||||
"type": "string"
|
||||
},
|
||||
"provider_keys": {
|
||||
"$ref": "#/definitions/internal_api.ProviderKeyStats"
|
||||
},
|
||||
"requests": {
|
||||
"$ref": "#/definitions/internal_api.RequestStats"
|
||||
},
|
||||
"tokens": {
|
||||
"$ref": "#/definitions/internal_api.TokenStats"
|
||||
},
|
||||
"top_models": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.TopModelStat"
|
||||
}
|
||||
},
|
||||
"updated_at": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.DeleteLogsRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4217,6 +4524,10 @@ const docTemplate = `{
|
||||
"description": "For group_by=day",
|
||||
"type": "string"
|
||||
},
|
||||
"hour": {
|
||||
"description": "For group_by=hour",
|
||||
"type": "string"
|
||||
},
|
||||
"model": {
|
||||
"description": "For group_by=model",
|
||||
"type": "string"
|
||||
@@ -4284,6 +4595,14 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.LatencyStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"avg_ms": {
|
||||
"type": "number"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ListLogsResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4460,6 +4779,20 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.MasterRealtimeSummaryView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"master_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"qps": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rate_limited": {
|
||||
"type": "boolean"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.MasterRealtimeView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4633,6 +4966,23 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ProviderKeyStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"active": {
|
||||
"type": "integer"
|
||||
},
|
||||
"auto_disabled": {
|
||||
"type": "integer"
|
||||
},
|
||||
"suspended": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ProviderUsageAgg": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4653,6 +5003,23 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.RequestStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"error_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failed": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.StatusResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4670,6 +5037,43 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.SystemRealtimeView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"by_master": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.MasterRealtimeSummaryView"
|
||||
}
|
||||
},
|
||||
"qps": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rate_limited_count": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rpm": {
|
||||
"type": "integer"
|
||||
},
|
||||
"updated_at": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TokenStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"input": {
|
||||
"type": "integer"
|
||||
},
|
||||
"output": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TokenView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4741,6 +5145,20 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TopModelStat": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"model": {
|
||||
"type": "string"
|
||||
},
|
||||
"requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"tokens": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.UpdateAccessRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4896,6 +5314,31 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.apiKeyStatsFlushEntry": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"api_key_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.apiKeyStatsFlushRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"keys": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.apiKeyStatsFlushEntry"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.refreshModelRegistryRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
|
||||
@@ -45,7 +45,7 @@
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "List API keys",
|
||||
"description": "List API keys with optional filters",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -71,6 +71,12 @@
|
||||
"description": "filter by group_id",
|
||||
"name": "group_id",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "string",
|
||||
"description": "filter by status (active, suspended, auto_disabled, manual_disabled)",
|
||||
"name": "status",
|
||||
"in": "query"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
@@ -356,6 +362,37 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/apikey-stats/summary": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Aggregate APIKey success/failure stats across all provider groups",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "APIKey stats summary (admin)",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.APIKeyStatsSummaryResponse"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/bindings": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -674,6 +711,63 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/dashboard/summary": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Returns aggregated metrics for dashboard display including requests, tokens, latency, masters, keys, and provider keys statistics",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "Dashboard summary",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "time period: today, week, month, all",
|
||||
"name": "period",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"description": "unix seconds",
|
||||
"name": "since",
|
||||
"in": "query"
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"description": "unix seconds",
|
||||
"name": "until",
|
||||
"in": "query"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.DashboardSummaryResponse"
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/features": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -710,7 +804,7 @@
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Updates selected feature flags (meta:features). Values are stored as strings. Example: dp_claude_cross_upstream controls whether /v1/messages can route to OpenAI/compatible and Google-family providers.",
|
||||
"description": "Updates selected feature flags (meta:features). Values are stored as strings.",
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -1005,7 +1099,7 @@
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Aggregate log stats with basic filtering. Use group_by param for grouped statistics (model/day/month). Without group_by returns LogStatsResponse; with group_by returns GroupedStatsResponse.",
|
||||
"description": "Aggregate log stats with basic filtering. Use group_by param for grouped statistics (model/day/month/hour). Without group_by returns LogStatsResponse; with group_by returns GroupedStatsResponse.",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -1030,10 +1124,11 @@
|
||||
"enum": [
|
||||
"model",
|
||||
"day",
|
||||
"month"
|
||||
"month",
|
||||
"hour"
|
||||
],
|
||||
"type": "string",
|
||||
"description": "group by dimension: model, day, month. Returns GroupedStatsResponse when specified.",
|
||||
"description": "group by dimension: model, day, month, hour. Returns GroupedStatsResponse when specified.",
|
||||
"name": "group_by",
|
||||
"in": "query"
|
||||
}
|
||||
@@ -2770,6 +2865,37 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/realtime": {
|
||||
"get": {
|
||||
"security": [
|
||||
{
|
||||
"AdminAuth": []
|
||||
}
|
||||
],
|
||||
"description": "Return aggregated realtime counters across all masters",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"admin"
|
||||
],
|
||||
"summary": "System-level realtime stats (admin)",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.SystemRealtimeView"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/admin/stats": {
|
||||
"get": {
|
||||
"security": [
|
||||
@@ -2892,6 +3018,52 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/internal/apikey-stats/flush": {
|
||||
"post": {
|
||||
"description": "Internal endpoint for flushing accumulated APIKey stats from DP to CP database",
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"internal"
|
||||
],
|
||||
"summary": "Flush API key stats",
|
||||
"parameters": [
|
||||
{
|
||||
"description": "Stats to flush",
|
||||
"name": "request",
|
||||
"in": "body",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"$ref": "#/definitions/internal_api.apiKeyStatsFlushRequest"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
},
|
||||
"500": {
|
||||
"description": "Internal Server Error",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/gin.H"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/internal/stats/flush": {
|
||||
"post": {
|
||||
"description": "Internal endpoint for flushing accumulated key usage stats from DP to CP database",
|
||||
@@ -3567,6 +3739,12 @@
|
||||
"github_com_ez-api_ez-api_internal_dto.APIKeyDTO": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"access_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"account_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"api_key": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3579,9 +3757,18 @@
|
||||
"ban_until": {
|
||||
"type": "string"
|
||||
},
|
||||
"expires_at": {
|
||||
"type": "string"
|
||||
},
|
||||
"group_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"project_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"refresh_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3660,6 +3847,9 @@
|
||||
"google_project": {
|
||||
"type": "string"
|
||||
},
|
||||
"headers_profile": {
|
||||
"type": "string"
|
||||
},
|
||||
"models": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -3669,6 +3859,9 @@
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"static_headers": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3680,6 +3873,12 @@
|
||||
"github_com_ez-api_ez-api_internal_model.APIKey": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"access_token": {
|
||||
"type": "string"
|
||||
},
|
||||
"account_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"api_key": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3698,15 +3897,36 @@
|
||||
"deletedAt": {
|
||||
"$ref": "#/definitions/gorm.DeletedAt"
|
||||
},
|
||||
"expires_at": {
|
||||
"type": "string"
|
||||
},
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"group_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"project_id": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"updatedAt": {
|
||||
"type": "string"
|
||||
},
|
||||
@@ -3905,12 +4125,21 @@
|
||||
"deletedAt": {
|
||||
"$ref": "#/definitions/gorm.DeletedAt"
|
||||
},
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"google_location": {
|
||||
"type": "string"
|
||||
},
|
||||
"google_project": {
|
||||
"type": "string"
|
||||
},
|
||||
"headers_profile": {
|
||||
"type": "string"
|
||||
},
|
||||
"id": {
|
||||
"type": "integer"
|
||||
},
|
||||
@@ -3921,9 +4150,21 @@
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"static_headers": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"type": {
|
||||
"description": "openai, anthropic, gemini",
|
||||
"type": "string"
|
||||
@@ -4040,6 +4281,26 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.APIKeyStatsSummaryResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"failure_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failure_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total_requests": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.AboutResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4155,6 +4416,17 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.CountStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"active": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.CreateMasterRequest": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
@@ -4176,6 +4448,41 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.DashboardSummaryResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"keys": {
|
||||
"$ref": "#/definitions/internal_api.CountStats"
|
||||
},
|
||||
"latency": {
|
||||
"$ref": "#/definitions/internal_api.LatencyStats"
|
||||
},
|
||||
"masters": {
|
||||
"$ref": "#/definitions/internal_api.CountStats"
|
||||
},
|
||||
"period": {
|
||||
"type": "string"
|
||||
},
|
||||
"provider_keys": {
|
||||
"$ref": "#/definitions/internal_api.ProviderKeyStats"
|
||||
},
|
||||
"requests": {
|
||||
"$ref": "#/definitions/internal_api.RequestStats"
|
||||
},
|
||||
"tokens": {
|
||||
"$ref": "#/definitions/internal_api.TokenStats"
|
||||
},
|
||||
"top_models": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.TopModelStat"
|
||||
}
|
||||
},
|
||||
"updated_at": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.DeleteLogsRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4211,6 +4518,10 @@
|
||||
"description": "For group_by=day",
|
||||
"type": "string"
|
||||
},
|
||||
"hour": {
|
||||
"description": "For group_by=hour",
|
||||
"type": "string"
|
||||
},
|
||||
"model": {
|
||||
"description": "For group_by=model",
|
||||
"type": "string"
|
||||
@@ -4278,6 +4589,14 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.LatencyStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"avg_ms": {
|
||||
"type": "number"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ListLogsResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4454,6 +4773,20 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.MasterRealtimeSummaryView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"master_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"qps": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rate_limited": {
|
||||
"type": "boolean"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.MasterRealtimeView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4627,6 +4960,23 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ProviderKeyStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"active": {
|
||||
"type": "integer"
|
||||
},
|
||||
"auto_disabled": {
|
||||
"type": "integer"
|
||||
},
|
||||
"suspended": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.ProviderUsageAgg": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4647,6 +4997,23 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.RequestStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"error_rate": {
|
||||
"type": "number"
|
||||
},
|
||||
"failed": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.StatusResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4664,6 +5031,43 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.SystemRealtimeView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"by_master": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.MasterRealtimeSummaryView"
|
||||
}
|
||||
},
|
||||
"qps": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rate_limited_count": {
|
||||
"type": "integer"
|
||||
},
|
||||
"rpm": {
|
||||
"type": "integer"
|
||||
},
|
||||
"updated_at": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TokenStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"input": {
|
||||
"type": "integer"
|
||||
},
|
||||
"output": {
|
||||
"type": "integer"
|
||||
},
|
||||
"total": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TokenView": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4735,6 +5139,20 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.TopModelStat": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"model": {
|
||||
"type": "string"
|
||||
},
|
||||
"requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"tokens": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.UpdateAccessRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4890,6 +5308,31 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.apiKeyStatsFlushEntry": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"api_key_id": {
|
||||
"type": "integer"
|
||||
},
|
||||
"requests": {
|
||||
"type": "integer"
|
||||
},
|
||||
"success_requests": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.apiKeyStatsFlushRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"keys": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/internal_api.apiKeyStatsFlushEntry"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"internal_api.refreshModelRegistryRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -4999,4 +5442,4 @@
|
||||
"in": "header"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -5,6 +5,10 @@ definitions:
|
||||
type: object
|
||||
github_com_ez-api_ez-api_internal_dto.APIKeyDTO:
|
||||
properties:
|
||||
access_token:
|
||||
type: string
|
||||
account_id:
|
||||
type: string
|
||||
api_key:
|
||||
type: string
|
||||
auto_ban:
|
||||
@@ -13,8 +17,14 @@ definitions:
|
||||
type: string
|
||||
ban_until:
|
||||
type: string
|
||||
expires_at:
|
||||
type: string
|
||||
group_id:
|
||||
type: integer
|
||||
project_id:
|
||||
type: string
|
||||
refresh_token:
|
||||
type: string
|
||||
status:
|
||||
type: string
|
||||
weight:
|
||||
@@ -66,12 +76,16 @@ definitions:
|
||||
type: string
|
||||
google_project:
|
||||
type: string
|
||||
headers_profile:
|
||||
type: string
|
||||
models:
|
||||
items:
|
||||
type: string
|
||||
type: array
|
||||
name:
|
||||
type: string
|
||||
static_headers:
|
||||
type: string
|
||||
status:
|
||||
type: string
|
||||
type:
|
||||
@@ -79,6 +93,10 @@ definitions:
|
||||
type: object
|
||||
github_com_ez-api_ez-api_internal_model.APIKey:
|
||||
properties:
|
||||
access_token:
|
||||
type: string
|
||||
account_id:
|
||||
type: string
|
||||
api_key:
|
||||
type: string
|
||||
auto_ban:
|
||||
@@ -91,12 +109,26 @@ definitions:
|
||||
type: string
|
||||
deletedAt:
|
||||
$ref: '#/definitions/gorm.DeletedAt'
|
||||
expires_at:
|
||||
type: string
|
||||
failure_rate:
|
||||
type: number
|
||||
failure_requests:
|
||||
type: integer
|
||||
group_id:
|
||||
type: integer
|
||||
id:
|
||||
type: integer
|
||||
project_id:
|
||||
type: string
|
||||
status:
|
||||
type: string
|
||||
success_rate:
|
||||
type: number
|
||||
success_requests:
|
||||
type: integer
|
||||
total_requests:
|
||||
type: integer
|
||||
updatedAt:
|
||||
type: string
|
||||
weight:
|
||||
@@ -228,10 +260,16 @@ definitions:
|
||||
type: string
|
||||
deletedAt:
|
||||
$ref: '#/definitions/gorm.DeletedAt'
|
||||
failure_rate:
|
||||
type: number
|
||||
failure_requests:
|
||||
type: integer
|
||||
google_location:
|
||||
type: string
|
||||
google_project:
|
||||
type: string
|
||||
headers_profile:
|
||||
type: string
|
||||
id:
|
||||
type: integer
|
||||
models:
|
||||
@@ -239,8 +277,16 @@ definitions:
|
||||
type: string
|
||||
name:
|
||||
type: string
|
||||
static_headers:
|
||||
type: string
|
||||
status:
|
||||
type: string
|
||||
success_rate:
|
||||
type: number
|
||||
success_requests:
|
||||
type: integer
|
||||
total_requests:
|
||||
type: integer
|
||||
type:
|
||||
description: openai, anthropic, gemini
|
||||
type: string
|
||||
@@ -317,6 +363,19 @@ definitions:
|
||||
description: Valid is true if Time is not NULL
|
||||
type: boolean
|
||||
type: object
|
||||
internal_api.APIKeyStatsSummaryResponse:
|
||||
properties:
|
||||
failure_rate:
|
||||
type: number
|
||||
failure_requests:
|
||||
type: integer
|
||||
success_rate:
|
||||
type: number
|
||||
success_requests:
|
||||
type: integer
|
||||
total_requests:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.AboutResponse:
|
||||
properties:
|
||||
description:
|
||||
@@ -393,6 +452,13 @@ definitions:
|
||||
id:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.CountStats:
|
||||
properties:
|
||||
active:
|
||||
type: integer
|
||||
total:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.CreateMasterRequest:
|
||||
properties:
|
||||
global_qps:
|
||||
@@ -407,6 +473,29 @@ definitions:
|
||||
- group
|
||||
- name
|
||||
type: object
|
||||
internal_api.DashboardSummaryResponse:
|
||||
properties:
|
||||
keys:
|
||||
$ref: '#/definitions/internal_api.CountStats'
|
||||
latency:
|
||||
$ref: '#/definitions/internal_api.LatencyStats'
|
||||
masters:
|
||||
$ref: '#/definitions/internal_api.CountStats'
|
||||
period:
|
||||
type: string
|
||||
provider_keys:
|
||||
$ref: '#/definitions/internal_api.ProviderKeyStats'
|
||||
requests:
|
||||
$ref: '#/definitions/internal_api.RequestStats'
|
||||
tokens:
|
||||
$ref: '#/definitions/internal_api.TokenStats'
|
||||
top_models:
|
||||
items:
|
||||
$ref: '#/definitions/internal_api.TopModelStat'
|
||||
type: array
|
||||
updated_at:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.DeleteLogsRequest:
|
||||
properties:
|
||||
before:
|
||||
@@ -430,6 +519,9 @@ definitions:
|
||||
date:
|
||||
description: For group_by=day
|
||||
type: string
|
||||
hour:
|
||||
description: For group_by=hour
|
||||
type: string
|
||||
model:
|
||||
description: For group_by=model
|
||||
type: string
|
||||
@@ -474,6 +566,11 @@ definitions:
|
||||
tokens:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.LatencyStats:
|
||||
properties:
|
||||
avg_ms:
|
||||
type: number
|
||||
type: object
|
||||
internal_api.ListLogsResponse:
|
||||
properties:
|
||||
items:
|
||||
@@ -590,6 +687,15 @@ definitions:
|
||||
tokens_out:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.MasterRealtimeSummaryView:
|
||||
properties:
|
||||
master_id:
|
||||
type: integer
|
||||
qps:
|
||||
type: integer
|
||||
rate_limited:
|
||||
type: boolean
|
||||
type: object
|
||||
internal_api.MasterRealtimeView:
|
||||
properties:
|
||||
qps:
|
||||
@@ -703,6 +809,17 @@ definitions:
|
||||
user_agent:
|
||||
type: string
|
||||
type: object
|
||||
internal_api.ProviderKeyStats:
|
||||
properties:
|
||||
active:
|
||||
type: integer
|
||||
auto_disabled:
|
||||
type: integer
|
||||
suspended:
|
||||
type: integer
|
||||
total:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.ProviderUsageAgg:
|
||||
properties:
|
||||
provider_id:
|
||||
@@ -716,6 +833,17 @@ definitions:
|
||||
tokens:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.RequestStats:
|
||||
properties:
|
||||
error_rate:
|
||||
type: number
|
||||
failed:
|
||||
type: integer
|
||||
success:
|
||||
type: integer
|
||||
total:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.StatusResponse:
|
||||
properties:
|
||||
status:
|
||||
@@ -728,6 +856,30 @@ definitions:
|
||||
example: 0.1.0
|
||||
type: string
|
||||
type: object
|
||||
internal_api.SystemRealtimeView:
|
||||
properties:
|
||||
by_master:
|
||||
items:
|
||||
$ref: '#/definitions/internal_api.MasterRealtimeSummaryView'
|
||||
type: array
|
||||
qps:
|
||||
type: integer
|
||||
rate_limited_count:
|
||||
type: integer
|
||||
rpm:
|
||||
type: integer
|
||||
updated_at:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.TokenStats:
|
||||
properties:
|
||||
input:
|
||||
type: integer
|
||||
output:
|
||||
type: integer
|
||||
total:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.TokenView:
|
||||
properties:
|
||||
allow_ips:
|
||||
@@ -775,6 +927,15 @@ definitions:
|
||||
used_tokens:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.TopModelStat:
|
||||
properties:
|
||||
model:
|
||||
type: string
|
||||
requests:
|
||||
type: integer
|
||||
tokens:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.UpdateAccessRequest:
|
||||
properties:
|
||||
default_namespace:
|
||||
@@ -884,6 +1045,22 @@ definitions:
|
||||
example: 1703505600
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.apiKeyStatsFlushEntry:
|
||||
properties:
|
||||
api_key_id:
|
||||
type: integer
|
||||
requests:
|
||||
type: integer
|
||||
success_requests:
|
||||
type: integer
|
||||
type: object
|
||||
internal_api.apiKeyStatsFlushRequest:
|
||||
properties:
|
||||
keys:
|
||||
items:
|
||||
$ref: '#/definitions/internal_api.apiKeyStatsFlushEntry'
|
||||
type: array
|
||||
type: object
|
||||
internal_api.refreshModelRegistryRequest:
|
||||
properties:
|
||||
ref:
|
||||
@@ -974,7 +1151,7 @@ paths:
|
||||
- Public
|
||||
/admin/api-keys:
|
||||
get:
|
||||
description: List API keys
|
||||
description: List API keys with optional filters
|
||||
parameters:
|
||||
- description: page (1-based)
|
||||
in: query
|
||||
@@ -988,6 +1165,10 @@ paths:
|
||||
in: query
|
||||
name: group_id
|
||||
type: integer
|
||||
- description: filter by status (active, suspended, auto_disabled, manual_disabled)
|
||||
in: query
|
||||
name: status
|
||||
type: string
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
@@ -1174,6 +1355,25 @@ paths:
|
||||
summary: Batch api keys
|
||||
tags:
|
||||
- admin
|
||||
/admin/apikey-stats/summary:
|
||||
get:
|
||||
description: Aggregate APIKey success/failure stats across all provider groups
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/internal_api.APIKeyStatsSummaryResponse'
|
||||
"500":
|
||||
description: Internal Server Error
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
security:
|
||||
- AdminAuth: []
|
||||
summary: APIKey stats summary (admin)
|
||||
tags:
|
||||
- admin
|
||||
/admin/bindings:
|
||||
get:
|
||||
description: List all configured bindings
|
||||
@@ -1377,6 +1577,43 @@ paths:
|
||||
summary: Batch bindings
|
||||
tags:
|
||||
- admin
|
||||
/admin/dashboard/summary:
|
||||
get:
|
||||
description: Returns aggregated metrics for dashboard display including requests,
|
||||
tokens, latency, masters, keys, and provider keys statistics
|
||||
parameters:
|
||||
- description: 'time period: today, week, month, all'
|
||||
in: query
|
||||
name: period
|
||||
type: string
|
||||
- description: unix seconds
|
||||
in: query
|
||||
name: since
|
||||
type: integer
|
||||
- description: unix seconds
|
||||
in: query
|
||||
name: until
|
||||
type: integer
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/internal_api.DashboardSummaryResponse'
|
||||
"400":
|
||||
description: Bad Request
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
"500":
|
||||
description: Internal Server Error
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
security:
|
||||
- AdminAuth: []
|
||||
summary: Dashboard summary
|
||||
tags:
|
||||
- admin
|
||||
/admin/features:
|
||||
get:
|
||||
description: Returns all feature flags stored in Redis (meta:features)
|
||||
@@ -1400,8 +1637,7 @@ paths:
|
||||
consumes:
|
||||
- application/json
|
||||
description: Updates selected feature flags (meta:features). Values are stored
|
||||
as strings. Example: dp_claude_cross_upstream controls whether /v1/messages
|
||||
can route to OpenAI/compatible and Google-family providers.
|
||||
as strings.
|
||||
parameters:
|
||||
- description: Feature map
|
||||
in: body
|
||||
@@ -1589,7 +1825,7 @@ paths:
|
||||
/admin/logs/stats:
|
||||
get:
|
||||
description: Aggregate log stats with basic filtering. Use group_by param for
|
||||
grouped statistics (model/day/month). Without group_by returns LogStatsResponse;
|
||||
grouped statistics (model/day/month/hour). Without group_by returns LogStatsResponse;
|
||||
with group_by returns GroupedStatsResponse.
|
||||
parameters:
|
||||
- description: unix seconds
|
||||
@@ -1600,12 +1836,13 @@ paths:
|
||||
in: query
|
||||
name: until
|
||||
type: integer
|
||||
- description: 'group by dimension: model, day, month. Returns GroupedStatsResponse
|
||||
- description: 'group by dimension: model, day, month, hour. Returns GroupedStatsResponse
|
||||
when specified.'
|
||||
enum:
|
||||
- model
|
||||
- day
|
||||
- month
|
||||
- hour
|
||||
in: query
|
||||
name: group_by
|
||||
type: string
|
||||
@@ -2719,6 +2956,25 @@ paths:
|
||||
summary: Update provider group
|
||||
tags:
|
||||
- admin
|
||||
/admin/realtime:
|
||||
get:
|
||||
description: Return aggregated realtime counters across all masters
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/internal_api.SystemRealtimeView'
|
||||
"500":
|
||||
description: Internal Server Error
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
security:
|
||||
- AdminAuth: []
|
||||
summary: System-level realtime stats (admin)
|
||||
tags:
|
||||
- admin
|
||||
/admin/stats:
|
||||
get:
|
||||
description: Aggregate request stats across all masters
|
||||
@@ -2801,6 +3057,37 @@ paths:
|
||||
summary: Get current identity
|
||||
tags:
|
||||
- auth
|
||||
/internal/apikey-stats/flush:
|
||||
post:
|
||||
consumes:
|
||||
- application/json
|
||||
description: Internal endpoint for flushing accumulated APIKey stats from DP
|
||||
to CP database
|
||||
parameters:
|
||||
- description: Stats to flush
|
||||
in: body
|
||||
name: request
|
||||
required: true
|
||||
schema:
|
||||
$ref: '#/definitions/internal_api.apiKeyStatsFlushRequest'
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
"400":
|
||||
description: Bad Request
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
"500":
|
||||
description: Internal Server Error
|
||||
schema:
|
||||
$ref: '#/definitions/gin.H'
|
||||
summary: Flush API key stats
|
||||
tags:
|
||||
- internal
|
||||
/internal/stats/flush:
|
||||
post:
|
||||
consumes:
|
||||
|
||||
Reference in New Issue
Block a user