Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Μάθετε το pull μοντέλο του Prometheus, host μετρικές με node_exporter και το δικό σας /metrics endpoint με prom-client.
Ο Prometheus (έκδοση 3.15.1, επαληθευμένη από GitHub releases και Docker Hub tag prom/prometheus:v3.15.1 2026-10-26) δεν περιμένει να του στείλετε μετρικές — τις τραβάει ο ίδιος (pull model): κάθε 15 δευτερόλεπτα κάνει HTTP GET σε κάθε στόχο και αποθηκεύει τις χρονοσειρές. Αν πέσει ένας στόχος, το καταλαβαίνει αμέσως από το χαμένο scrape.
Prometheus για αποθήκευση και ερωτήματα, node_exporter (έκδοση 1.12.1, image prom/node-exporter:v1.12.1) για μετρικές μηχανήματος (CPU, μνήμη, δίσκος, δίκτυο) — όλα δεμένα στο loopback:
services:
prometheus:
image: prom/prometheus:v3.15.1
network_mode: host
command:
- '--config.file=/etc/prometheus/prometheus.yml'
- '--storage.tsdb.path=/prometheus'
- '--web.listen-address=127.0.0.1:9090'
volumes:
- ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
- prometheus-data:/prometheus
restart: unless-stopped
node-exporter:
image: prom/node-exporter:v1.12.1
command: ['--path.procfs=/host/proc', '--path.sysfs=/host/sys', '--path.rootfs=/host/root']
volumes:
- /proc:/host/proc:ro
- /sys:/host/sys:ro
- /:/host/root:ro
ports: ['127.0.0.1:9100:9100']
restart: unless-stopped
networks: [internal-net]
volumes:
prometheus-data:
networks:
internal-net:
driver: bridgeΤο network_mode: host μοιράζεται το network namespace του host: το 127.0.0.1:3000 του scrape target είναι η εφαρμογή που ακούει στο loopback. Χωρίς αυτό, το container θα έβλεπε το δικό του άδειο loopback — το host.docker.internal δείχνει την bridge IP του host, όχι το 127.0.0.1 όπου δένεται η εφαρμογή. Το δικό του UI μένει κλειδωμένο στο loopback με --web.listen-address=127.0.0.1:9090 (χωρίς αυτό θα άκουγε σε όλες τις διεπαφές).
global:
scrape_interval: 15s
evaluation_interval: 15s
scrape_configs:
- job_name: 'prometheus'
static_configs:
- targets: ['127.0.0.1:9090']
- job_name: 'node'
static_configs:
- targets: ['127.0.0.1:9100'] # δημοσιευμένη θύρα: ο Prometheus τρέχει στο host network
- job_name: 'app'
static_configs:
- targets: ['127.0.0.1:3000']
metrics_path: '/metrics'Ο Prometheus μοιράζεται το δίκτυο του host, οπότε όλοι οι στόχοι είναι διευθύνσεις loopback του host. Μετά το docker compose up -d, ανοίξτε το Status → Targets: και οι τρεις στόχοι πρέπει να δείχνουν UP. Αν ο app στόχος είναι DOWN, ελέγξτε πρώτα ότι η εφαρμογή ακούει και ότι το firewall επιτρέπει το loopback.
Η βιβλιοθήκη prom-client (έκδοση 15.1.3 από το npm registry, επαληθευμένη 2026-10-26) εκθέτει μετρικές σε φορμάτ Prometheus. Εγκαταστήστε την στο project σας:
npm install prom-clientΣημείωση: το npm σημειώνει το
prom-clientως deprecated υπέρ του διαδόχου@prometheus-io/client.
Ένα ελάχιστο endpoint με τη βιβλιοθήκη HTTP της Node:
import http from 'node:http';
import client from 'prom-client';
export const register = new client.Registry();
client.collectDefaultMetrics({ register });
export const httpRequestsTotal = new client.Counter({
name: 'http_requests_total',
help: 'Total HTTP requests',
labelNames: ['method', 'route', 'status'],
registers: [register],
});
export const httpRequestDuration = new client.Histogram({
name: 'http_request_duration_seconds',
help: 'HTTP request duration in seconds',
labelNames: ['method', 'route'],
buckets: [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5],
registers: [register],
});
const routeOf = (url) => {
const path = String(url || '/').split('?')[0];
if (path.startsWith('/api/checkout')) return '/api/checkout';
if (path.startsWith('/api/')) return '/api/other';
return '/other';
};
const server = http.createServer(async (req, res) => {
if (req.url === '/metrics') {
res.writeHead(200, { 'Content-Type': register.contentType });
res.end(await register.metrics());
return;
}
const route = routeOf(req.url);
const end = httpRequestDuration.startTimer({ method: req.method, route });
httpRequestsTotal.inc({ method: req.method, route, status: String(res.statusCode) });
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end('ok');
end();
});
server.listen(3000, '127.0.0.1');Το status διαβάζει τον πραγματικό κωδικό απάντησης — με καρφωμένο '200' η σειρά 5xx που ρωτούν τα μαθήματα Grafana/SLO δεν θα εκπεμπόταν ποτέ.
Διαλέξτε τον σωστό τύπο: Counter μόνο ανεβαίνει (σύνολο requests), Gauge ανεβοκατεβαίνει (in-flight requests, μνήμη), Histogram μετρά κατανομές (διάρκειες). Λάθος τύπος σημαίνει λάθος συμπεράσματα — Counter για κάτι που μειώνεται δεν μπορεί ποτέ να δείξει πτώση. Και προσέχετε τα labels: κάθε μοναδικό route φτιάχνει νέα χρονοσειρά — το ωμό req.url με query strings (/?nonce=1, /?nonce=2) θα γέμιζε τον Prometheus με άπειρες σειρές. Η routeOf κόβει το query και χαρτογραφεί σε 3 σταθερές τιμές.
sum(rate(http_requests_total[5m]))
sum(rate(http_requests_total{status=~"5.."}[5m])) / sum(rate(http_requests_total[5m]))
histogram_quantile(0.99, sum by (le) (rate(http_request_duration_seconds_bucket[5m])))Το πρώτο δίνει throughput, το δεύτερο ποσοστό 5xx, το τρίτο το p99 latency. Το rate πάνω σε Counter είναι η θεμελιώδης κίνηση — ποτέ μην κάνετε γραφήματα πάνω σε ακατέργαστο Counter, θα δείτε μια ατέρμονη ανηφόρα.
rate(), ποτέ σε ακατέργαστο Counter.