get_consumer_requests
Retrieve and analyze API requests made by a specific consumer within a configurable time range, filtering by success, failure, or max results. Provides usage statistics, request details, and breakdowns by service and status code.
Instructions
Retrieve and analyze API requests made by a specific consumer.
INPUT:
- consumerId: String - ID of the consumer to analyze. The format of this field must be "controlPlaneID".
- timeRange: String - Time range for data retrieval (15M, 1H, 6H, 12H, 24H, 7D)
- successOnly: Boolean - Filter to only show successful (2xx) requests (default: false)
- failureOnly: Boolean - Filter to only show failed (non-2xx) requests (default: false)
- maxResults: Number - Maximum number of results to return (1-1000)
OUTPUT:
- metadata: Object - Contains consumerId, totalRequests, timeRange, and filters
- statistics: Object - Usage statistics including:
- averageLatencyMs: Number - Average response time in milliseconds
- successRate: Number - Percentage of successful requests
- statusCodeDistribution: Array - Breakdown of requests by status code
- serviceDistribution: Array - Breakdown of requests by service
- requests: Array - List of requests with details for each request
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consumerId | Yes | Consumer ID to filter by (obtainable from analyze-failed-requests or query-api-requests tools) | |
| failureOnly | No | Show only failed (non-2xx) requests | |
| maxResults | No | Number of items to return per page | |
| successOnly | No | Show only successful (2xx) requests | |
| timeRange | No | Time range for data retrieval (15M = 15 minutes, 1H = 1 hour, etc.) | 1H |