summaryrefslogtreecommitdiff
path: root/docs/reference/example-queries.md
blob: e78aaec9bb6c84d51fe885bc973ec5dfd6107cb2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# Example Queries

PromQL and curl examples for Epimetheus test metrics. Use your Prometheus (or Prometheus-compatible) query URL; after port-forward, that is often http://localhost:9090.

## Basic PromQL

```promql
# Total requests
epimetheus_test_requests_total

# Request rate (last 5 minutes)
rate(epimetheus_test_requests_total[5m])

# Active connections
epimetheus_test_active_connections

# Temperature
epimetheus_test_temperature_celsius
```

## Histogram

```promql
# 95th percentile request duration
histogram_quantile(0.95, rate(epimetheus_test_request_duration_seconds_bucket[5m]))

# Median (50th percentile)
histogram_quantile(0.50, rate(epimetheus_test_request_duration_seconds_bucket[5m]))

# Average request duration
rate(epimetheus_test_request_duration_seconds_sum[5m]) /
rate(epimetheus_test_request_duration_seconds_count[5m])
```

## Labeled counter

```promql
# Failed jobs by type
epimetheus_test_jobs_processed_total{status="failed"}

# Job success rate
rate(epimetheus_test_jobs_processed_total{status="success"}[5m]) /
rate(epimetheus_test_jobs_processed_total[5m])

# Total jobs by type
sum by (job_type) (epimetheus_test_jobs_processed_total)
```

## Curl (HTTP API)

```bash
# Port-forward if needed
kubectl port-forward -n monitoring svc/prometheus-kube-prometheus-prometheus 9090:9090 &

# Total requests
curl -s "http://localhost:9090/api/v1/query?query=epimetheus_test_requests_total" | jq .

# Temperature
curl -s "http://localhost:9090/api/v1/query?query=epimetheus_test_temperature_celsius" | jq .

# Request rate
curl -s "http://localhost:9090/api/v1/query?query=rate(epimetheus_test_requests_total[5m])" | jq .

# Histogram p95
curl -s "http://localhost:9090/api/v1/query?query=histogram_quantile(0.95,rate(epimetheus_test_request_duration_seconds_bucket[5m]))" | jq .
```