المراقبة: السجلات والمقاييس والتتبع

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

1سجلات منظمة بمعرّف طلب

كل سطر JSON بنفس الحقول، وكل سطر من نفس الطلب يحمل نفس request_id، فتبحث عنه وترى قصة الطلب كاملة:

import json

def log(level, message, **fields):
    record = {"level": level, "msg": message, **fields}
    print(json.dumps(record, ensure_ascii=False))

request_id = "req-8f2a"
log("info", "order received", request_id=request_id, user_id=42, items=2)
log("warning", "payment slow", request_id=request_id, provider="pay", ms=2400)
log("error", "payment failed", request_id=request_id, status=502)

2المقاييس الذهبية من السجلات

من نفس بيانات الطلبات تحسب الإشارات الأربع لدقيقة واحدة، وتقرر إن كان يجب التنبيه:

requests = [
    {"ms": 120, "status": 200}, {"ms": 95, "status": 200}, {"ms": 2300, "status": 502},
    {"ms": 110, "status": 200}, {"ms": 130, "status": 201}, {"ms": 2500, "status": 504},
    {"ms": 105, "status": 200}, {"ms": 140, "status": 200}, {"ms": 98, "status": 200},
    {"ms": 115, "status": 200},
]
cpu_percent = 64

latencies = sorted(r["ms"] for r in requests)
p95 = latencies[max(0, round(0.95 * len(latencies)) - 1)]
error_rate = sum(r["status"] >= 500 for r in requests) / len(requests)

print(f"latency p95 : {p95} ms")
print(f"traffic     : {len(requests)} req/min")
print(f"errors      : {error_rate:.0%}")
print(f"saturation  : {cpu_percent}% cpu")

SLO_ERROR_RATE = 0.01
if error_rate > SLO_ERROR_RATE:
    print("ALERT: error rate above SLO, users are affected")

3التتبع الموزع وOpenTelemetry

الطلب يمر عبر الواجهة ثم خدمة الطلبات ثم الدفع ثم القاعدة. التتبع يرسم كل خطوة بزمنها، فترى أن 2 من 2.4 ثانية كانت في مزود الدفع. OpenTelemetry يضيف هذا آليًا لأغلب الأطر:

pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install

OTEL_SERVICE_NAME=cafe-api \
OTEL_EXPORTER_OTLP_ENDPOINT=http://collector:4317 \
opentelemetry-instrument uvicorn main:app

مثال محلول

المسألة: مستخدمون يشتكون «الدفع يعلق أحيانًا»، والمعالج 30% ولا تنبيه. المقاييس: p95 للدفع 2.4 ثانية، ونسبة 5xx 4% منذ أمس. التتبع: 85% من الزمن في استدعاء مزود الدفع. السجلات (بحث بـ request_id): أخطاء مهلة من المزود بعد تحديث شهادته. الإصلاح: مهلة 3 ثوانٍ مع إعادة محاولة واحدة، وتنبيه جديد على نسبة أخطاء الدفع لا على المعالج.

خرافة مقابل حقيقة

أين تقابله في العمل

اختبر فهمك

بطاقات مراجعة سريعة

تحقق من فهمك