ऑपरेशन मेट्रिक्स एपीआई

1) जिम्मेदारी का उद्देश्य और क्

• सुसंगत SLI/SLO (लॉगिन, जमा, दर, वापसी);
• केआरआई (प्रारंभिक जोखिम संकेतक: पीएसपी/केवाईसी/कतारें/प्रतिकृतियां);
• व्यावसायिक मैट्रिक्स (GEO/PSP/बैंक प्राधिकरणों की सफलता, सफल दांव का हिस्सा, p95/p99 प्रमुख पथ अवधि);
• डैशबोर्ड, अलर्टिंग, स्थिति पृष्ठों, रिपोर्टिंग के लिए सुरक्षित, सस्ते और पूर्वानुमानित रीडिंग।

2) वास्तुशिल्प सिद्धांत

पढ़ें-भारी, लिखें-कुछ: एपीआई केवल टीएसडीबी/कैश से एकत्रीकरण पढ़ ता है।

एसएलओ-पहला: प्रतिक्रियाएं समय में अनुमानित हैं; त्रुटियों और गिरावट - पारदर्शी रूप से संकेतित हैं।

लागत-जागरूक: एसडीके में डाउनसैम्पलिंग, कोटा, कैनरी सुविधाएँ।

गोपनीयता-दर-डिजाइन: मेटाडेटा/लेबल में कोई पीआईआई नहीं; टोकन, भू-द्वार, SoD।

बहु-किरायेदार: ब्रांड/क्षेत्र/पर्यावरण द्वारा अलगाव

3) डेटा मॉडल (सतह)

मीट्रिक श्रृंखला = 'मीट्रिक _ आईडी' + 'लेबल {}' + 'टाइमस्टैम्प' + 'मान' (+ वैकल्पिक 'अनुकरणीय {trace _ id =...}')।

3. 1 श्रेणियाँ

SLI/SLO: 'auth _ emply _ rate', 'bettle _ settle _ p99 _ ms', 'extrow _ tat _ p95 _ ms', 'api _ 5xx _ rate'।

केआरआई: 'कतार _ उपभोक्ता _ लाग', 'db _ replication _ lag', 'psp _ soft _ dince _ rate'।

Бизнес: 'डिपॉजिट _ सक्सेस _ पीसीटी', 'बेट्स _ सक्सेस _ पीसीटी', 'kyc _ pass _ रेट'।

Инфра: 'cpu _ util', 'cache _ hit _ ratio', 'cdn _ waf _ block _ rate'।

3. 2 लेबल (सख्ती से लिमिटेड)

'रीजन', 'किरायेदार', 'पर्यावरण', 'सेवा', 'psp', 'बैंक _ group', 'जियो', 'डिवाइस', 'संस्करण', 'घटक'।

निषिद्ध: 'UsureId', 'SummartId', कच्चा कार्ड/दस्तावेज़संख्या।

4) वर्शनिंग और संगतता

आधार पथ: '/v1/metrics/... '; असंगत परिवर्तन - केवल नए 'vX' में।

लेबल/श्रृंखला जोड़ ना - पीछे-संगत।

शब्दार्थ परिवर्तन प्रतिक्रिया और अनुग्रह अवधि में 'schema _ version' फ़ील्ड के माध्यम से होता है।

स्कीमा निर्देशिका '/v1/स्कीमा 'के रूप में प्रकाशित होती है।

5) एंडपॉइंट (REST, gRPC/GraphQL में समान)

1. 'GET/v1/metrics/query'

• 'मेट्रिक' (मल्टी), 'से', 'से', 'स्टेप' (резолюция), 'एग' ('avg'sum'min'max'p50|p95|p99'),
• 'फ़िल्टर [लेबल] = मूल्य' (बहु), 'समूह _ by = label1, label2',
• 'downsample=1m|5m|1h', 'exemplars = true' false ',' सीमा '(рядов),' पृष्ठ '।
• उत्तर: श्रृंखला '{metric, लेबल {}, बिंदु: [[ts, value]], उदाहरण?}' की सरणी।

2. 'POST/v1/metrics/बल्क-query'

शरीर: एक बैच में 50 अनुरोध तक। जटिल डैशबोर्ड के लिए अनुरोध सहेजता है।

3. 'GET/v1/metrics/इंस्टेंट'

निर्दिष्ट फ़िल्टर के साथ 'ts' (या 'अब') पर मौजूदा मान.

4. 'GET/v1/metrics/callog'

उपलब्ध मैट्रिक्स, विवरण, लेबल, अनुमत एकत्रीकरण, एसएलओ बाइंडिंग की सूची।

5. 'GET/v1/metrics/health'

एपीआई की स्थिति: विलंबता पी 95, कैश लचीलापन, कैश हिट का हिस्सा।

6. 'GET/v1/metrics/sloo'

रेडी एसएलओ दृश्य: त्रुटि बजट की खपत (तेज/धीमी), लक्ष्य स्थिति।

6) नमूना अनुरोध

6. 1 टीआर में पीएसपी प्राधिकरणों की सफलता, 1-मिनट ग्रिड, 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 "bet→settle", उदाहरण के साथ (ट्रेस उदाहरण):

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

6. 3 ईयू तात्कालिक जमा एसएलओ स्थिति:

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

6. 4 बैच ऑफ 3 क्वेरी (POST/बल्क-क्वेरी) - परतों के साथ एक ग्राफ के लिए।

7) एकत्रीकरण और प्रतिशत

Percentiles p50/p95/p99 की गणना TSDB/एग्रीगेटर स्तर पर की जाती है; 'डाउनसैम्पल' के साथ - सही रचना (टी-डाइजेस्ट/एचडीआर) के साथ।

'ग्रुप _ बाय' केवल व्हाइटलिस्टेड लेबल पर अनुमति है ताकि कार्डिनैलिटी को न उड़ाया जा सके।

'स्टेप' मान्य: रियलटाइम के लिए न्यूनतम 10, सार्वजनिक डैशबोर्ड के लिए 1 मी।

8) नकदी, डाउनसैम्पलिंग और ताजगी

बहु-स्तरीय कैश: इन-मेमोरी (30-60 एस तक), वितरित (5 मिनट तक), सार्वजनिक एसएलओ विचारों के लिए सीडीएन।

डाउनसैम्पलिंग: बड़ी विंडो ('> 24h') → 5m/1h अंक के साथ स्वचालित।

Freshness- заголовки: 'X-Data-Freshness: 12s', 'X-Downsample: 1m', 'X-Partical: true' false '।

9) बहु-किरायेदार और अलगाव

प्रत्येक निवेदन में 'किरायेदार' (टोकन/लेबल में) होना चाहिए।

ABAC/RBAC: भूमिका/नीति 'किरायेदार, क्षेत्र, पर्यावरण, metric_id' द्वारा पहुंच को प्रतिबंधित करती है।

दिखाएँ/चार्ज-बैक: 'एक्स-क्वेरी-कॉस्ट-एस्टिमेट' हेडर और उपयोग-काउंटर।

10) प्रमाणीकरण और सुरक्षा

OAuth2 mTLS/स्कोप सेवा टोकन।

SoD: संभावित नियामक जोखिमों (वित्त, आरजी) के साथ मैट्रिक्स तक पहुंच - व्यक्तिगत भूमिकाएं।

दर सीमाएँ: क्लाइंट कुंजी द्वारा और 'मीट्रिक _ आईडी' द्वारा।

PII स्वच्छता: सर्वर निषिद्ध फिल्टर/लेबल की अनुपस्थिति को मान्य करता है।

11) भू-रेजीडेंसी और अनुपालन

रेजीडेंसी पॉलिसी पर क्षेत्रीय भंडारण (EU/LATAM/APAC) से डेटा पढ़ा जाता है।

क्रॉस-क्षेत्रीय प्रश्न - केवल पीआईआई के बिना और 'अनुपालन _ स्कोप' के साथ समुच्चय के लिए।

12) उदाहरण और सहसंबंध

'exemplars = true' के साथ, प्रतिशत बिंदुओं पर प्रतिक्रिया तेजी से आरसीए के लिए प्रतिनिधि 'ट्रेस _ आईडी' (पीआईआई के बिना) की एक जोड़ी के संदर्भ में लौटाती है।

सहसंबंध: 'सहसंबंध _ id' प्रतिक्रिया मेटाडेटा में उपलब्ध है।

13) एसएलए एपीआई और कीड़े

प्रतिक्रिया SLA: p95 ≤ 300 ms (कैश), ≤ 1। 5 एस (ठंडा रास्ता), उपलब्धता ≥ 99। 9%.

• '400' - अमान्य अनुरोध (बहुत ज्यादा 'समूह _ बाय', बुरा 'कदम'),
• '403' - अपर्याप्त अधिकार/किरायेदार,
• '409' - सर्किट संघर्ष,
• '429' - कोटा/दर सीमा,
• '502/504' - भंडारण का क्षरण (हेडर में - डाउनसैम्पल/चरण के लिए सिफारिशें),
• '206' एक आंशिक प्रतिक्रिया है (कुछ शार्क उपलब्ध नहीं हैं)।
• नैदानिक हेडर: 'एक्स-क्वेरी-प्लान', 'एक्स-क्वेरी-कैश', 'एक्स-क्वेरी-शार्ड्स', 'एक्स-रेटलिमिट-शेष'।

14) कोटा, दर सीमा और बैकप्रेशर

डिफ़ॉल्ट: 10 आरपीएस प्रति क्लाइंट, 50 एपिसोड प्रति प्रतिक्रिया, 3 घंटे की खिड़की, 'चरण ≥ 10c'।

बर्स्ट टोकन: बड़े स्क्रीन, समन्वित विंडो के लिए डैशबोर्ड के लिए।

Backpressure: सर्वर 'स्टेप '/सक्षम' downsample 'को बढ़ाने की सलाह देते हुए' Retry-After 'वापस कर सकता है।

15) एसडीके और सर्वोत्तम अभ्यास

एसडीके: टाइपस्क्रिप्ट/गो/पायथन। डिफ़ॉल्ट: आक्रामक कैश, घातीय बैकऑफ, 'इफ-नो-मैच'।

• '/बल्क-क्वेरी 'द्वारा समूह प्रश्न;
• 'समूह _ by' संयम से उपयोग करें;
• ऐतिहासिक समीक्षाओं के लिए - 'डाउनसैम्पल = 1h';
• टाइमआउट ≤ 2 सेकंड और 'रद्द' टोकन जोड़ें।

15. 1 मिनी उदाहरण (टीएस)

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) एपीआई मैट्रिक्स की अवलोकन क्षमता

SLI API: , , , , ।

उपयोग केपीआई: आरपीएस, औसत प्रतिक्रिया मात्रा, शीर्ष लागत मैट्रिक्स।

अलर्ट: त्रुटियों पर बर्न-रेट, स्पाइक '429', ड्रॉप कैश-हिट <लक्ष्य।

लॉग: पीआईआई के बिना संरचित; 'किरायेदार', 'मीट्रिक _ आईडी', 'क्वेरी _ कॉस्ट _ क्लास'।

17) फिनोप्स नीतियां

अनुरोध कक्षाएं: ए (रियलटाइम डैशबोर्ड), बी (परिचालन), सी (एनालिटिक्स)। विभिन्न कोटा/टीटीएल।

लागत: $/GB पढ़ ता है, $/अनुरोध, $/ग्राफ। "भारी" मैट्रिक्स और लेबल पर मासिक रिपोर्ट।

अनुकूलन: सर्वर मर्ज, लोकप्रिय एसएलओ-दृश्य के लिए पूर्व-समुच्चय, क्लाइंट को ऑटो-टिप्स (सुझाए गए 'स्टेप/डाउनसैम्पल')।

18) एकीकरण

स्थिति पृष्ठ: तैयार एसएलओ दृश्य पढ़ ता है।

अलर्टिंग: नियम '/स्लो 'और' इंस्टेंट 'पर भरोसा करते हैं।

हादसा-बॉट: छोटे प्रीसेट के माध्यम से रेखांकन/स्लाइस के त्वरित स्निपेट।

वर्कफ़्लो/रिलीज़-गेट्स: लाल एसएलओ पर रिलीज़ ब्लॉक।

19) कार्यान्वयन रोडमैप (6-10 सप्ताह)

नेड। 1-2: मेट्रिक्स कैटलॉग, लेबल व्हाइटलिस्ट, '/कैटलॉग 'स्कीमा, '/क्वेरी' प्रोटोटाइप कैश के साथ, और डाउनसैम्पल।

नेड। 3-4: '/बल्क-क्वेरी ', '/स्लो', उदाहरण, आरबीएसी/एबीएसी, कोटा/दर सीमा।

नेड। 5-6: जियो-शार्डिंग, सार्वजनिक दृश्य के लिए सीडीएन, फिनोप्स सुर्खियां, एसएलआई एपीआई डैशबोर्ड।

नेड। 7-8: एसडीके (टीएस/गो/पाई), सिफारिशें/क्वेरी लिंटर, कैनरी परीक्षण।

नेड। 9-10: अराजकता शिक्षा (शार्द/कैश विफलता), मूल्य अनुकूलन, मूल्यह्रास नीति।

20) कलाकृतियाँ

मेट्रिक कैटलॉग: आईडी, इकाइयाँ, विवरण, उपलब्ध 'एग', वैध लेबल।

एक्सेस पॉलिसी: भूमिकाएं, क्षेत्र, सीमा, SoD।

क्वैरी स्टाइल गाइड - सही/गलत प्रश्नों के उदाहरण।

एसएलओ मानचित्र: एसएलआई अनुपालन ↔ सार्वजनिक लक्ष्य।

लागत रिपोर्ट: शीर्ष महंगी प्रश्न/टैग, अनुकूलन योजना।

21) केपीआई/केआरआई एपीआई मेट्रिक्स

p95/99 विलंबता, त्रुटि दर, आंशिक प्रतिक्रियाएँ।

कैश हिट अनुपात और सीपीयू/आईओ बचत।

औसत प्रतिक्रिया आकार और $/अनुरोध।

डैशबोर्ड का अनुपात जो '/बल्क-क्वेरी 'में बदल गया।

उच्च कार्डिनैलिटी अनुरोधों के कारण घटनाएं।

22) एंटीपैटर्न

दर्जनों निशानों से मुक्त 'समूह _ बाय' - कार्डिनैलिटी का एक विस्फोट।

क्लाइंट - विकृतियों पर प्रतिशत "मुड़ाहुआ"।

डाउनसैम्पल के बिना 30-90 दिनों के लिए अनुरोध - महंगा और धीमा।

प्राधिकरण के बिना किरायेदारों/क्षेत्रों को एक प्रतिक्रिया में मिलाना।

कैश/सीडीएन के बिना सार्वजनिक पैनल।

'vX' और अनुग्रह अवधि के बिना मैट्रिक्स के शब्दार्थ को बदलना।

कुल

ऑपरेशन मैट्रिक्स एपीआई टेलीमेट्री पर एक स्थिर, सुरक्षित और लागत प्रभावी रीडिंग परत है: मानकीकृत स्कीमैटिक्स और प्रतिशत, कैश और डाउनसैम्पलिंग, सख्त लेबल और एक्सेस, आरसीए, पारदर्शी एसएलए और लागत। यह परत आपको गोपनीयता, बजट और प्रदर्शन को जोखिम में डाले बिना विश्वसनीय डैशबोर्ड, अलर्ट, स्थिति संचार और रिलीज गेट बनाने की अनुमति देती है।