मेट्रिक्स आर्किटेक्चर

मेट्रिक्स आर्किटेक्चर

मेट्रिक्स आर्किटेक्चर नियमों, कलाकृतियों और सेवाओं की एक प्रणाली है जो पूरे संगठन में संकेतकों की अस्पष्ट परिभाषा, प्रजनन योग्य गणना, पारदर्शी पहुंच और विश्वसनीय संचालन प्रदान करती है। लक्ष्य "MAU", "रिटेंशन D30" या "ARPPU" के लिए सभी डैशबोर्ड, प्रयोगों और रिपोर्टों में समान माना जाता है।

1) सिद्धांत

1. सूत्रों और संदर्भ पुस्तकों के लिए सत्य का एकल स्रोत।

2. कार्यान्वयन से शब्दार्थों का पृथक्करण: व्यावसायिक परिभाषा एक शब्दार्थ परत में रहती है, न कि हर SQL/लैपटॉप में।

3. प्रबंधित इतिहास प्रवास के साथ मैट्रिक्स, स्कीमा और सूत्र (v1→v2) का संस्करण।

4. प्रजनन क्षमता और परीक्षण: गणना नियतात्मक हैं, परीक्षणों द्वारा कवर किए गए हैं।

5. अवलोकन: ताजगी, परिपूर्णता, स्थिरता और बहाव - एसएलओ और अलर्ट के साथ।

6. सुरक्षा और गोपनीयता: पीआईआई न्यूनतम, आरएलएस/सीएलएस, ऑडिट।

7. कोड के रूप में ऑपरेटिंग सिस्टम: परिभाषाएं, परिवर्तन, नीतियां - सीआई/सीडी के साथ भंडार में।

2) वास्तुकला परतें

स्रोत डेटा: घटनाएँ/लेनदेन, संदर्भ पुस्तकें, मॉडल लॉग/इंफ्रा।

एकीकरण और सफाई: सीडीसी/वृद्धिशील लोडिंग, डीडप, समय क्षेत्रों का एकीकरण।

डेटा मॉडल (DWH): स्टार/स्नोफ्लेक, धीरे-धीरे बदलते माप (SCD), सरोगेट कुंजियाँ।

मैट्रिक्स की शब्दार्थ परत: समान परिभाषाएँ, एकत्रीकरण, फिल्टर, समय अनाज, रोलअप तर्क।

डिजाइन परत: बैच/माइक्रोबैच/स्ट्रीम; खिड़कियां, पानी के निशान, चाबियाँ।

कैटलॉग और शब्दकोश: "पासपोर्ट मैट्रिक्स", वंश, मालिक, अधिकार।

पहुंच और खपत: बीआई/डैशबोर्ड, एपीआई मैट्रिक्स, अपलोड, प्रयोग/एबी।

3) डेटा और मेट्रिक्स अनुबंध

स्रोत संविदा (घटनाएँ/सारणी)

स्कीमा: क्षेत्र, प्रकार, शून्यता, प्राथमिक कुंजी।

SLA: ताजगी (उदाहरण के लिए, "≤10 मिनट अंतराल"), आवृत्ति, अधिकतम विलंबित आगमन।

विशेषता: कुंजी विशिष्टता, वैध मूल्य डोमेन, समयक्षेत्र, पहचान.

परिवर्तन: योजना विकास नीति (पिछड़ा/आगे), विचलन योजना।

मीट्रिक अनुबंध

नाम/आईडी: 'आरईटी _ D30 _ v2'

डोमिन/मालिक: उत्पाद एनालिटिक्स

परिभाषा (मानव भाषा में)

सूत्र: SQL/स्यूडोकोड + इनपुट स्टोरफ्रंट/सिमेंटिक ऑब्जेक्ट्स

दानेदारी/लौकिक तर्क: दिन/सप्ताह; पॉइंट-इन-टाइम नियम, टाइमज़ोन

डिफ़ॉल्ट सेगमेंट/फ़िल्टर

इकाइयां और मुद्राएं (रूपांतरण दर/तिथि)

SLO: ताजगी ≤ X, सटीकता ≥ Y, उपलब्धता ≥ Z

संस्करण/परिवर्तन इतिहास/प्रभावी तिथि

गार्ड: वैध रेंज, Winzorization नियम p1/p99

4) मैट्रिक्स की शब्दार्थ परत

• तत्व: आयाम (तिथि, देश, मंच), तथ्य (घटनाएं, राजस्व), मैट्रिक्स (एआरपीयू, प्रतिधारण डी 30), गणना क्षेत्र, कैलेंडर (कार्य/सप्ताहांत, छुट्टियां)।
• समय व्यवहार: कैलेंडर टेबल, लैग्स, कोहोर्ट्स, "स्लाइडिंग" विंडो (7/30/90)।
• रोलअप और स्थिरता: डबल काउंटिंग (अलग उपयोगकर्ताओं) को छोड़ कर दिन = महीने की राशि।
• मिक्स-समायोजन: ईमानदार YoY के लिए चैनलों/देशों के निरंतर मिश्रण के लिए सामान्यीकरण।
• मल्टीक्यूरेंसी/टाइमज़ोन: लेनदेन की तारीख पर आधार मुद्रा में समायोजित; स्थानीय और "विहित" यूटीसी स्लाइस।

5) गणना: बैच, माइक्रोबैच, स्ट्रीम

बैच: रात/घंटे की नौकरियां, पूर्ण/वृद्धिशील पुनर्गणना, पहचान नियंत्रण।

माइक्रोबैच: परिचालन डैशबोर्ड के लिए खिड़कियां 1-15 मिनट।

स्ट्रीम: टायर के माध्यम से घटनाएं; खिड़कियां (टंबलिंग/स्लाइडिंग/सत्र), पानी के निशान (देर से डेटा), वास्तव में एक बार शब्दार्थ (गतिरोध + ऑफसेट स्टोर)।

• 'HOP 5m, WINDOW 1h' for ऑपरेशनल KPI;
• 'TUMBLE 1d' for दैनिक मैट्रिक्स;
• 'सत्र 30 मीटर' फोर सत्र।

6) गुणवत्ता और सत्यापन

डेटा परीक्षण: योजनाबद्ध, डोमेन (रेंज), संदर्भित लिंक।

मेट्रिक्स के परीक्षण: अपरिवर्तनीय (DAU≤MAU), गैर-खाली खंड, एकरसता की अपेक्षाएं (संचयी)।

सुलह: शब्दार्थ परत और संदर्भ रिपोर्ट/लेखांकन के बीच।

डेटा स्वास्थ्य: ताजगी, पूर्णता, डुप्लिकेट, NULL अंश, असामान्य कूदता है।

बहाव मैट्रिक्स: प्रमुख विशेषताओं पर पीएसआई/केएल/जेएस, विशेष रूप से एमएल मैट्रिक्स के लिए।

7) वर्शनिंग और माइग्रेशन

फॉर्मूला संस्करण 'METRIC _ NAME _ vN' है। संस्करण को बदले बिना परिभाषा को "चुपचाप" बदलना मना है।

• साइड-बाय-साइड: v1 और v2 को समानांतर में गिना जाता है; उपयोगकर्ताओं का सामंजस्य और प्रशिक्षण किया जाता है।
• कट-ओवर: कम लोड विंडो में उपभोक्ताओं को v2 पर स्विच करना; संग्रह v1।
• इतिहास की पुनर्गणना: ऐतिहासिक आंकड़ों के अनुसार बैकफिल; अंतर प्रोटोकॉल (डिफ रिपोर्ट)।
• संचार: चेंजलॉग, प्रवेश की तारीख, जो प्रभावित होगी, निर्देश।

8) मेट्रिक्स के लिए डेटा मॉडल

तथ्य: अनाज (event_id, transaction_id, user_day), घटना समय, योग/मूल्य।

आयाम: उपयोगकर्ता, उपकरण, भूगोल, चैनल, उत्पाद, कैलेंडर; ऐतिहासिकता के लिए एससीडी प्रकार।

कुंजी: सरोगेट आईडी, स्थिर व्यवसाय कुंजी, मैपिंग टेबल।

एंटी-डुप्लिकेट: पहचान नियम (उपयोगकर्ता विलय), सत्र "ग्लूइंग" विंडो।

9) इकाइयाँ, मुद्राएँ, मौसमी

इकाइयाँ/प्रारूप: स्पष्ट इकाइयाँ, गोल, तराजू (लॉग/रैखिक)।

मल्टीक्यूरेंसी: लेनदेन की तारीख पर विनिमय दर पर रूपांतरण; दोनों "कच्चे" और सामान्यीकृत राशि को संग्रहीत करें

मौसमी: YoY और मौसमी सूचकांक; अलग "छुट्टी" प्रभाव।

10) सुरक्षा और पहुंच

रो-लेवल सिक्योरिटी (आरएलएस): देश/ब्रांड/पार्टनर द्वारा मैट्रिक्स तक पहुंच।

कॉलम-स्तरीय सुरक्षा (CLS) -Masking PII/वित्तीय क्षेत्र।

ऑडिट: किसने मीट्रिक का अनुरोध किया, जो फ़िल्टर करता है, जो डेटा निर्यात करता है।

एपीआई भेदभाव: "भूमिका द्वारा समुच्चय" बनाम "विस्तृत अपलोड"।

11) अवलोकन और एसएलओ

एसएलओ ताजगी: उदाहरण के लिए, "ऑपरेशनल केपीआई - लैग ≤ 15 मिनट, दैनिक - 06:00 स्थानीय समय तक।"

उपलब्धता एसएलओ: ≥ 99। एपीआई/सिमेंटिक परत के लिए 9%।

अलर्ट: SLO अपराधी, मीट्रिक जंप, NULL/डुप्लिकेट ग्रोथ, वैरिएंस v1 बनाम v2> X%।

रनबुक: अपमानित होने पर क्या करना है - आरसीए कदम, फॉलबैक (उदाहरण के लिए, अंतिम मान्य "स्नैपशॉट मीट्रिक" पर स्विच करना)।

12) प्रयोग और मैट्रिक्स

रेलिंग मैट्रिक्स: स्कोरिंग के लिए विलंबता, लचीलापन, एफपीआर/एफएनआर।

A/B के लिए वर्दी परिभाषाएँ: रूपांतरण, प्रतिधारण, NSM - एक ही शब्दार्थ परत के माध्यम से।

न्यूनतम विशिष्ट प्रभाव (एमडीई), बिजली विश्लेषण: मेट्रिक्स कार्ड में मापदंडों को स्टोर करें।

कारण: मिश्रण-समायोजन और नियंत्रण समूहों द्वारा नीतियां।

13) एपीआई मैट्रिक्स और खपत

Запросы: 'GET/metrics/{ name}? = 2025-09-01 और = 2025-10-01 और डिम्स = देश, प्लेटफ़ॉर्म और फ़िल्टर = चैनल: पेड' से।

नीतियां: सीमा, कैश, पृष्ठभूमि, पहचान "निर्यात"।

संस्करण: 'एक्स-मेट्रिक-संस्करण: v2' हेडर, मूल्यह्रास चेतावनी।

14) पैटर्न और कलाकृतियाँ

मीट्रिक पासपोर्ट (उदाहरण)

कोड/संस्करण: 'ARPPU _ v3'

परिभाषा: अवधि के लिए प्रति भुगतान उपयोगकर्ता औसत राजस्व

Формула: 'योग (revenue_net )/ count_distinct (user_id जहां paying_flag=1)'

ग्रैन्युलरिटी: दिन; रोलअप: सप्ताह/महीना = अंश राशि/भाजक राशि

स्रोत: 'तथ्य _ भुगतान _ v2', 'dim _ user _ scd'

इकाइयाँ: मुद्रा 'आधार _ ccy'; के रूप में विनिमय दर पर रूपांतरण

डिफ़ॉल्ट फ़िल्टर: सक्रिय बाजार, परीक्षण लेनदेन को बाहर करें

एसएलओ: ताजगी ≤ 1 घंटा; API ≥ 99 उपलब्धता। 9%

गार्ड: ARPPU ∈ [0; 10 000]; vinzorization p1/p99

मालिक: मुद्रीकरण विश्लेषण; संशोधन तिथि: 2025-10-01

जाँच-सूची मीट्रिक रिलीज़

• परिभाषा और सूत्र सहमत, परीक्षणों से कवर
• शब्दार्थ वस्तु निर्मित; वंश प्रलेखित
• बैकफिल और संदर्भ पूरा
• SLO/अलर्ट कॉन्फ़िगर किए गए हैं; रनबुक तैयार
• अधिकार और आरएलएस कॉन्फ़िगर; पीआईआई छिपा हुआ
• डैशबोर्ड/प्रयोगों में प्रतिस्थापित पुराने संस्करण
• Changelog/संचार भेजा गया

प्वाइंट-इन-टाइम SQL छद्म कोड (उदाहरण प्रतिधारण D30)

sql
WITH cohort AS (
SELECT user_id, MIN(event_date) AS signup_date
FROM fact_events
WHERE event_type = 'signup'
GROUP BY 1
),
activity AS (
SELECT user_id, event_date
FROM fact_events
WHERE event_type = 'app_open'
),
ret AS (
SELECT c. signup_date,
COUNT(DISTINCT CASE WHEN a. event_date = c. signup_date + INTERVAL '30 day' THEN a. user_id END) AS returned,
COUNT(DISTINCT c. user_id) AS cohort_size
FROM cohort c
LEFT JOIN activity a
ON a. user_id = c. user_id
AND a. event_date BETWEEN c. signup_date AND c. signup_date + INTERVAL '30 day'
GROUP BY 1
)
SELECT signup_date, returned / cohort_size AS retention_d30
FROM ret;

15) बार-बार गलतियाँ और उनसे कैसे बचें

शांत सूत्र संपादित करता है: हमेशा संस्करण और चेंजलॉग के माध्

"हर लैपटॉप में अलग" मैट्रिक्स: सिमेंटिक लेयर/एपीआई पर बल।

असंगत समय क्षेत्र/मुद्राएँ: केंद्रीकृत कैलेंडर और एफएक्स तालिका।

डबल उपयोगकर्ता लेखांकन: रोलअप नियम और अद्वितीय कुंजी।

अपारदर्शी ताजगी: स्पष्ट रूप से अंतराल/अद्यतन समय दिखाएं।

एक इंजीनियर पर निर्भरता: सब कुछ एक कोड की तरह है, एक समीक्षा और एक ऑन्कल के साथ।

कुल

मेट्रिक्स आर्किटेक्चर शब्दकोश + शब्दार्थ परत + मजबूत गणना + शासन और एसएलओ है। वर्णित सिद्धांतों (अनुबंध, परीक्षण, संस्करण, अवलोकन, सुरक्षा) का पालन करके, आप "संख्या विवादों" से मैट्रिक्स को एक स्थायी उत्पाद और व्यवसाय प्रबंधन तंत्र में बदल देते हैं।