mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 16:36:21 +02:00
71 lines
2.1 KiB
YAML
71 lines
2.1 KiB
YAML
get:
|
|
tags:
|
|
- Metrics
|
|
summary: Metrics - Prometheus metrics endpoint
|
|
description: |
|
|
Proxy to Prometheus metrics for system monitoring.
|
|
|
|
## Metrics Overview
|
|
|
|
Exposes system metrics via Prometheus format:
|
|
- **Gateway metrics**: Request rates, latencies, errors
|
|
- **Flow metrics**: Processing throughput, queue depths
|
|
- **System metrics**: Resource usage, health status
|
|
|
|
## Prometheus Format
|
|
|
|
Returns metrics in Prometheus text exposition format:
|
|
```
|
|
# HELP metric_name Description
|
|
# TYPE metric_name counter
|
|
metric_name{label="value"} 123.45
|
|
```
|
|
|
|
## Available Metrics
|
|
|
|
Common metrics include:
|
|
- Request count and rates
|
|
- Response times (histograms)
|
|
- Error rates
|
|
- Active connections
|
|
- Queue depths
|
|
- Processing latencies
|
|
|
|
## Integration
|
|
|
|
Standard Prometheus scraping:
|
|
- Configure Prometheus to scrape `/api/metrics`
|
|
- Set appropriate scrape interval
|
|
- Use bearer token if authentication enabled
|
|
|
|
## Path Parameter
|
|
|
|
The `{path}` parameter allows querying specific Prometheus endpoints
|
|
or metrics if the backend Prometheus supports it.
|
|
|
|
operationId: getMetrics
|
|
security:
|
|
- bearerAuth: []
|
|
responses:
|
|
'200':
|
|
description: Prometheus metrics
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
example: |
|
|
# HELP http_requests_total Total HTTP requests
|
|
# TYPE http_requests_total counter
|
|
http_requests_total{method="POST",endpoint="/api/v1/flow/my-flow/service/agent"} 1234
|
|
|
|
# HELP http_request_duration_seconds HTTP request latency
|
|
# TYPE http_request_duration_seconds histogram
|
|
http_request_duration_seconds_bucket{le="0.1"} 500
|
|
http_request_duration_seconds_bucket{le="0.5"} 950
|
|
http_request_duration_seconds_bucket{le="1.0"} 990
|
|
http_request_duration_seconds_sum 450.5
|
|
http_request_duration_seconds_count 1000
|
|
'401':
|
|
$ref: '../components/responses/Unauthorized.yaml'
|
|
'500':
|
|
$ref: '../components/responses/Error.yaml'
|