Operation Metrics API

1) מטרה ותחום אחריות

• עקבית SLI/SLO (התחברות, הפקדה, קצב, משיכה);
• KRI (אינדיקטורים בסיכון מוקדם: PSP/KYC/תורים/שכפולים);
• מדדים עסקיים (הצלחה בהרשאות GEO/PSP/Bank);
• קריאות בטוחות, זולות וצפויות ללוחות מחוונים, התראות, דפי מצב, דיווח.

2) עקרונות אדריכליים

לקרוא-כבד, לכתוב-מעטים: API קורא רק צבירה מ-TSDB/מטמון.
SLO-ראשון: תגובות צפויות בזמן; שגיאות והשפלה - הם אותות שקופים.
עלות מודעת: ירידה במחירים, מכסות, מאפיינים קנריים באס-די-קיי.
פרטיות על ידי עיצוב: אין PII במטאדטה/תוויות; אסימונים, גיאו-גייט, סיד.
רב-דייר: בידוד על ידי מותג/אזור/סביבה.

3) מודל נתונים (משטח)

סדרה מטרית = "" metric _ id' + "labels' d' +" timestamp "+" value "(+ optional 'exemplar _ trace _ id =...).

3. 1 קטגוריות

SLI/SLO: 'auth _ success _ rate', 'have _ pile _ p99 _ ms',' api _ 5xx _ rate '.
KRI: ”תור _ צרכן _ לאג”, ”db _ שכפול _ לאג”, ”psp _ soft _ down _ rate”.
expedites _ success _ pct ',' hets _ success _ pct ',' kyc _ pass _ rate '.
”cpu _ util”, ”cache _ hit _ ratio”, ”cdn _ waf _ block _ rate”.

3. 2 תוויות (מוגבל לחלוטין)

”region”, ”דייר”, ”סביבה”, ”שירות”, ”psp”, ”bank _ group”, ”geo”, ”מכשיר”, ”גרסה”, ”רכיב”.
אסור: ”AverId',” Id', מספרי כרטיס גולמי/מסמך.

4) ורסינציה ותאימות

נתיב בסיס: '/v1/metrics/... '; שינויים לא מתאימים - רק ב- ”vX” החדש.
הוספת תוויות/סדרות - התאמה לאחור.
שינוי הסמנטיקה הוא דרך שדה ה- ”schema _ version 'field” בתגובה ובתקופת החסד.
תיקיית הסכמות מתפרסמת בשם '/v1/סכמות '.

5) נקודות קצה (מנוחה, בדומה ל ־ GRPC/GraphQL)

1. GET/V1/metrics/queryfost

• 'metric' (רב), 'מ', 'עד', 'צעד' (metric), 'ag' ('avg'sum'min'max'p50|p95|p99'),
• 'filter[label]=value' (רב), 'קבוצה _ by = label1, label2',
• 'downsample=1m|5m|1h', 'מופת' = אמת 'false', 'גבול' (extrough), 'דף'.
• תשובה: מערך של סדרות, תוויות, נקודות: ts, ערך , מופת? "

2. 'פוסט/V1/Metrics/balk-queryweather &pospos

עד 50 בקשות בצרור אחד. חוסך בקשות ללוחות מחוונים מורכבים.

3. GET/V1/Metrics/instant &fost

הערכים הנוכחיים ב ”ט” (או ”עכשיו”) עם המסננים המצוינים.

4. GET/V1/Metrics/catalogfost

רשימת מדדים זמינים, תיאורים, תוויות, התקבצות מותרת, קשירות SLO.

5. GET/V1/metrics/healtly &fost

מצב API עצמו: latency p95, עמידות מטמון, נתח של פגיעות מטמון.

6. GET/V1/metrics/sloffost

תצוגות SLO מוכנות: צריכת תקציב השגיאה (מהיר/איטי), מצבי יעד.

6) בקשות מדגם

6. 1 הצלחה באישורי PSP ב-TR, רשת של 1-min, p95:

GET /v1/metrics/query? metric=auth_success_rate&from=2025-11-01T13:00:00Z&to=2025-11-01T16:00:00Z&step=1m&agg=p95&filter[geo]=TR&group_by=psp&downsample=1m

6. 2 p99 ”הימור” להתיישב על ידי אזור, עם מופת (דוגמאות עקבות):

GET /v1/metrics/query? metric=bet_settle_p99_ms&from=...&to=...&step=5m&group_by=region&exemplars=true

6. 3 האיחוד האירופי הפקיד באופן מיידי מעמד SLO:

GET /v1/metrics/slo? domain=payments&region=EU&tenant=brandA

6. 4 אצווה של 3 שאילתות (POST/balk-query) - עבור גרף אחד עם שכבות.

7) אגרגציות ואחוזון

אחרונים p50/p95/p99 מחושבים ברמת TSDB/aggregator; עם 'downsample' - עם ההרכב הנכון (t-digest/HDR).
'group _ by' מותר רק על תוויות לבנים כדי לא לפוצץ את הקרדינליות.
"סטפ 'הוא תוקף: מינימום 10 לשעת ממלכה, 1 מ' ללוחות מחוונים ציבוריים.

8) מזומנים, ירידות ורעננות

מטמון רב-רמה: בזיכרון (עד 30-60 ש '), מופץ (עד 5 דק'), CDN לתצוגות SLO ציבוריות.
הידרדרות: אוטומטי עם חלונות גדולים ('> 24h') = 5m/1h נקודות.
רעננות: X-Data-Freseness: 12, X-Downsample: 1M, X-Partial: True 'false.

9) דייר רב ־ דייר ובידוד

כל בקשה חייבת להכיל ”דייר” (בתוויות).
תפקיד/מדיניות מגבילה גישה על ידי דייר, אזור, סביבה, metric_id'.
הצג/טעינה-חזרה: ”X-Query-עלות-אומדן” כותרות דלפקי שימוש.

10) אימות וביטחון

OAuth2 MTLS/היקף אסימונים שירות.
גישה למדדים עם סיכונים רגולטוריים אפשריים (פיננסים, ר "ג) - תפקידים אישיים.
מגבלות קצב: על ידי מפתח לקוח ועל ידי "metric _ id'.
תברואה PII: השרת נותן תוקף להיעדר פילטרים/תוויות אסורות.

11) גאו-תושבות וציות

נתונים נקראים מסעיפים אזוריים (EU/LATAM/APAC) על מדיניות ההתמחות.
שאילתות חוצה אזורי - רק עבור צבירים ללא PII ועם 'ציות _ היקף'.

12) מקרים וקורלציה

עם "מופת = אמת", התגובה בנקודות אחוריות מחזירה אזכורים לזוג של "trace _ id' (ללא PII) עבור RCA מהיר.
קורלציה: "correlation _ id' זמין במטאדטה התגובה.

13) SLA API וחרקים

תגובה SLA: p95 ms 300 (מטמון), סימון 1. 5 ס '(נתיב קר), זמינות 99. 9%.

• 400 - בקשה לא תקפה (יותר מדי ”קבוצה _ ע” י ”, צעד רע”),
• '403 - לא מספיק זכויות/דייר,
• '409 - עימות מעגלי,
• '429 - מכסת/מגבלת תעריף,
• 502/504 - ירידה באחסון (בכותרות - המלצות לירידה במדרגה),
• '206 &fospos היא תגובה חלקית (כמה רסיסים אינם זמינים).
• כותרות אבחון: 'X-Query-Plan', 'X-Query-Cache', 'X-Query-Shards', 'X-Extlimit-Resident'.

14) מכסות, מגבלות קצב ותפיסת גב

ברירת מחדל: 10 RPS ללקוח, 50 פרקים לכל תגובה, חלון 3 שעות, ”צעד 10 C”.
אסימונים מתפוצצים: ללוחות מחוונים למסך הגדול, חלונות מתואמים.
Backpresser: השרת רשאי לחזור "Retry-After", ומייעץ להגדיל "step "/label 'downsample".

15) SDK והמנהגים הטובים ביותר

SDK: Typescippe/Go/Python. ברירת מחדל: מטמון אגרסיבי, גיבוי מעריכי, ”אם-אף התאמה”.

• שאילתות קבוצתיות מאת '/נפח שאילתה ';
• השתמש ”קבוצה _ by” בדלילות;
• לביקורות היסטוריות - 'ירידה במס = 1';
• הוספת פסקי זמן ב2 שניות ו ”ביטול” אסימונים.

15. דוגמה קטנה 1 (TS)

ts const res = await client. query({
metric: ["auth_success_rate"],
from: "-3h", to: "now", step: "1m",
agg: "p95",
filter: { geo: "TR", tenant: "brandA" },
group_by: ["psp"],
downsample: "1m",
exemplars: true,
timeoutMs: 1800
});

16) יכולת תצפית של מדדי API

, , .
שימוש ב-KPI: rps, נפח תגובה ממוצע, מדדים עליונים.
התראות: לשרוף קצב על שגיאות, ספייק '429', טיפה מטמון-פגע <היעד.
יומנים: מובנים, ללא PII; 'דייר', 'מטרי _ id',' query _ cost _ class '.

17) מדיניות FinOps

כיתות בקשה: A (לוח מחוונים בזמן אמת), B (תפעולי), C (אנליטיקה). מכסות שונות/TTL.
עלות: $/GB קורא, $/בקשה, $/גרף. דו "ח חודשי על מדדים ותוויות" כבדים ".
אופטימיזציות: מיזוג שרתים, קדם-צבירה עבור תצוגת SLO פופולרית, טיפים אוטומטיים ללקוח (המוצע ”step/downsample”).

18) אינטגרציות

עמוד מצב: קורא תצוגות SLO מוכנות.
התראה: חוקים מסתמכים על '/סלו 'ו' מיידי '.
רובוט-אירוע: קטעים מהירים של גרפים/פרוסות דרך קורות חיים קצרות.
Facksflow/Lettle-Gates: block free at red SLOs.

19) מימוש מפת דרכים (שבועות 6-10)

נד. 1-2: קטלוג מדדים, תווית וויטליסטים, '/קטלוג 'סכמות, '/שאילתה' אב טיפוס עם מטמון, ומטה.
נד. 3-4: '/נפח שאילתה ', '/slo', מופת, RBAC/ABAC, מכסות/מגבלות קצב.
נד. 5-6: Geo-sharding, CDN לצפייה ציבורית, כותרות FinOps, לוח מחוונים SLI API.
נד. 7-8: SDK (TS/Go/Py), המלצות/קווי שאילתה, בדיקות כנרית.
נד. 9-10: תורות כאוס (כשל חרס/מטמון), אופטימיזציה ערך, מדיניות פחת.

20) חפצים

קטלוג מטרי: זיהוי, יחידות, תיאורים, 'אג' זמין ', תוויות תקפות.
מדיניות גישה: תפקידים, אזורים, גבולות, זון.
מדריך סגנון השאילתה - דוגמאות לשאילתות נכונות/שגויות.
ציות ↔ מטרות ציבוריות.
דו "ח עלות: שאילתות/תגיות יקרות ביותר, תוכנית אופטימיזציה.

21) KPI/KRI API Metrics

p95/99 latency, שיעור שגיאות, תגובות חלקיות.
יחס להיט מטמון וחיסכון מעבד/IO.
גודל תגובה ממוצע ו/בקשה $.
הפרופורציה של לוחות מחוונים שעברו ל ”/נפח שאילתה ”.
תקריות עקב בקשות חשאיות גבוהות.

22) תרופות אנטי ־ פטריות

Free 'group _ by' על ידי עשרות סימנים = = פיצוץ של קרדינליות.
אחוזון ”מקופל” על הלקוח * עיוותים.
בקשות ל-30-90 יום ללא ירידה במחיר, יקרות ואיטיות.
ערבוב דיירים/אזורים בתגובה אחת ללא אישור.
לוחות ציבוריים ללא מטמון/CDN.
שינוי הסמנטיקה של מדדים ללא 'vX' ותקופת חסד.

סך הכל

ה-API (ראשי תיבות של Operations Metrics API) הוא שכבת קריאה יציבה, מאובטחת ויעילה על פני טלמטריה: שרטוטים סטנדרטיים ואחרונים, מטמון ומורדות, תוויות ונגישות קפדניות, תצוגת SLO ומופת עבור RCA, SLA שקוף ועלויות. שכבה זו מאפשרת לבנות לוחות מחוונים אמינים, התראות, תקשורת סטטוס ושערי שחרור מבלי לסכן פרטיות, תקציב וביצועים.