query_loki_stats
Retrieve statistics about log streams matching a LogQL selector from a Loki datasource within specified time ranges to analyze log volume and stream metrics.
Instructions
Retrieves statistics about log streams matching a given LogQL selector within a Loki datasource
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| datasourceUid | Yes | The UID of the datasource to query | |
| endRfc3339 | No | The end time of the query in RFC3339 format | |
| logql | Yes | The LogQL matcher expression to execute | |
| startRfc3339 | No | The start time of the query in RFC3339 format |
Implementation Reference
- src/clients/loki-client.ts:62-78 (helper)The LokiClient.queryStats method that performs the HTTP request to Loki's /index/stats endpoint to retrieve log statistics.
async queryStats(query: string, start?: string, end?: string): Promise<LokiStats> { try { const params: any = { query }; if (start) params.start = start; if (end) params.end = end; const response = await this.client.get('/loki/api/v1/index/stats', { params }); if (response.data.status !== 'success') { throw new Error(`Loki stats query failed: ${response.data.error || 'Unknown error'}`); } return response.data.data; } catch (error) { this.handleError(error); } }