1~
2पहली बार आपको वास्तव में अवलोकन की आवश्यकता तब नहीं होती जब आप शांति से डैशबोर्ड को देख रहे होते हैं। ऐसा तब होता है जब कोई उपयोगकर्ता "चेकआउट धीमा है" लिखता है, त्रुटि ग्राफ़ सामान्य दिखता है और लॉग में आपको केवल डिस्कनेक्ट किए गए संदेशों की एक पंक्ति मिलती है।
3~
4OpenTelemetry उस क्षण से बचने के लिए बनाया गया था: अधिक ग्राफिक्स के लिए नहीं, बल्कि टुकड़ों को जोड़ने के लिए। एक अनुरोध API में प्रवेश करता है, एक डेटाबेस को कॉल करता है, एक बाहरी प्रदाता के माध्यम से जाता है, एक कतारबद्ध नौकरी पोस्ट करता है, और हो सकता है कि बाद में तीन सेवाएं विफल हो जाएं। वितरित अनुरेखण के बिना, आप हाथ से उस कहानी का पुनर्निर्माण करते हैं। OpenTelemetry के साथ कम से कम आपके पास एक नक्शा है।
5~
6## बात trace की नहीं, कहानी की है
7~
8ए trace span का एक क्रम है। ऐसे डालें कि ठंड लगे. व्यवहार में, प्रत्येक span कहानी का एक अंश है: `POST /checkout`, `SELECT inventory`, `call payment provider`, `publish order.created`।
9~
10महत्व तब आता है जब आप वास्तविक प्रश्नों का उत्तर देना शुरू करते हैं:
11~
12- कौन सी बाह्य सेवा धीमी हो रही है?
13- क्या त्रुटियाँ किसी विशिष्ट संस्करण से आती हैं?
14- क्या समस्या सभी को प्रभावित करती है या सिर्फ एक किरायेदार को?
15- क्या पुनः प्रयास एक टाइमआउट छुपा रहा है?
16- अतुल्यकालिक कार्य शुरू होता है लेकिन फिर कहीं और समाप्त हो जाता है?
17~
18ये प्रश्न जल्दबाजी में फेंके गए `console.log` से हल नहीं हो सकते। दरअसल, अक्सर आपात स्थिति में जोड़ा गया लॉग आज आपकी मदद करता है और कल शोर बन जाता है।
19~
20## मैं इसे किसी ऐप में कैसे डालूंगा Node.js
21~
22सबसे स्वस्थ सेटअप सरल है: ऐप टेलीमेट्री उत्पन्न करता है, Collector तय करता है कि इसे कहां भेजना है।
23~
24```text
25Node.js app -> OpenTelemetry Collector -> backend di observability
26```
27~
28सीधे विक्रेता को निर्यात क्यों नहीं किया जाता? क्योंकि पहले तो यह तेज़ लगता है, फिर आपको एहसास होता है कि प्रत्येक सेवा में अलग-अलग कॉन्फ़िगरेशन, अलग-अलग पुनः प्रयास, अलग-अलग फ़िल्टर होते हैं और संवेदनशील डेटा को हटाने या गंतव्य बदलने के लिए कोई केंद्रीय बिंदु नहीं होता है।
29~
30Collector सभी सही मायनों में उबाऊ है। यह OTLP प्राप्त करता है, बैचिंग करता है, फ़िल्टर कर सकता है, सैंपलिंग कर सकता है, सामान्य विशेषताएँ जोड़ सकता है और कई सिस्टम में निर्यात कर सकता है।
31~
32## स्व-यंत्रीकरण: अच्छा है, लेकिन पर्याप्त नहीं
33~
34Node.js में मैं ऑटो-इंस्ट्रूमेंटेशन से शुरुआत करूंगा। यह आपको HTTP, समर्थित फ्रेमवर्क, डेटाबेस और सामान्य पुस्तकालयों में तत्काल दृश्यता प्रदान करता है।
35~
36```bash
37npm install @opentelemetry/sdk-node \
38  @opentelemetry/auto-instrumentations-node \
39  @opentelemetry/exporter-trace-otlp-http
40```
41~
42फिर आप बाकी ऐप से पहले SDK को इनिशियलाइज़ करें:
43~
44```typescript
45import { NodeSDK } from '@opentelemetry/sdk-node';
46import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
47import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
48~
49const sdk = new NodeSDK({
50  traceExporter: new OTLPTraceExporter({
51    url: process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT,
52  }),
53  instrumentations: [getNodeAutoInstrumentations()],
54});
55~
56sdk.start();
57```
58~
59हालाँकि, यह रूपरेखा को देखता है, आपके उत्पाद को नहीं। यह जानता है कि आपने एक क्वेरी बनाई है, लेकिन यह नहीं जानता कि वह क्वेरी "क्रिएट ऑर्डर" या "रिन्यू सब्सक्रिप्शन" में थी। इसके लिए आपको उन बिंदुओं पर span मैनुअल की आवश्यकता है जहां प्रभुत्व मायने रखता है।
60~
61```typescript
62const span = tracer.startSpan('checkout.create_order');
63~
64try {
65  span.setAttribute('cart.items_count', input.items.length);
66  const order = await createOrder(input);
67  span.setAttribute('order.id', order.id);
68  return order;
69} catch (error) {
70  span.recordException(error as Error);
71  throw error;
72} finally {
73  span.end();
74}
75```
76~
77मैं कहीं भी span मैनुअल नहीं रखूंगा। मैं उन्हें वहां रखूंगा जहां, सुबह तीन बजे, मैं यह समझना चाहूंगा कि आधा कोड आधार पढ़े बिना क्या हुआ।
78~
79## तीन नियम जो बहुत अधिक अराजकता से बचते हैं
80~
81पहला नियम: प्रत्येक सेवा में `service.name`, वातावरण और संस्करण होना चाहिए। यह मामूली लगता है, लेकिन इन विशेषताओं के बिना trace बहुत कम उपयोगी है। जब कोई परिनियोजन किसी चीज़ को तोड़ता है, तो आप दो सेकंड में संस्करण के अनुसार फ़िल्टर करना चाहते हैं।
82~
83दूसरा नियम: विशेषताओं में संवेदनशील डेटा न डालें। ईमेल, टोकन, पूर्णांक पेलोड और पते दुर्घटनावश अवलोकनीय बैकएंड में समाप्त नहीं होने चाहिए। यदि आपको किसी उपयोगकर्ता की पहचान करने की आवश्यकता है, तो आंतरिक आईडी, हैशिंग या कम संवेदनशील फ़ील्ड पर विचार करें।
84~
85तीसरा नियम: कार्डिनैलिटी पर ध्यान दें. `user.id` को trace की विशेषता के रूप में समझा जा सकता है। एक मीट्रिक लेबल के रूप में यह आपकी लागत और प्रदर्शन को नष्ट कर सकता है।
86~
87## मेट्रिक्स: कुछ, लेकिन अच्छे
88~
89मैं बहुत व्यावहारिक मेट्रिक्स के साथ शुरुआत करूंगा:
90~
91- दरें, त्रुटियां और अनुरोधों की अवधि;
92- बाहरी निर्भरता की विलंबता;
93- टाइमआउट और पुनः प्रयास की संख्या;
94- पूंछ की गहराई;
95- कार्य की अवधि;
96- प्रति संस्करण त्रुटियों का प्रतिशत.
97~
98बाकी जरूरत पड़ने पर जोड़ दिया जाता है. ग्राफ़ से भरे डैशबोर्ड जिन्हें कोई नहीं देखता, वे फर्नीचर हैं, अवलोकनीयता नहीं।
99~
100## लॉग: अभी भी उपयोगी है, लेकिन जुड़ा हुआ है
101~
102लॉग गायब नहीं होते. जब वे `trace_id` और `span_id` रखते हैं तो वे और अधिक उपयोगी हो जाते हैं। तो आप एक त्रुटि लॉग से शुरू कर सकते हैं और trace खोल सकते हैं, या धीमी trace से शुरू कर सकते हैं और केवल उस पथ में उत्पादित लॉग को पढ़ सकते हैं।
103~
104सहसंबंध के बिना, आप सुइयों की तलाश कर रहे हैं। सहसंबंध के साथ, कम से कम आप जानते हैं कि किस दराज में देखना है।
105~
106## वह चेकलिस्ट जिसका उपयोग मैं यह कहने से पहले करूंगा कि "हम कवर हो गए हैं"
107~
108- trace वास्तव में कई सेवाओं को पार करता है।
109- लॉग में `trace_id` और `span_id` शामिल हैं।
110- Collector को बैचिंग और मेमोरी सीमा के साथ कॉन्फ़िगर किया गया है।
111- त्रुटियाँ span में दर्ज की जाती हैं।
112- एक सैंपलिंग नीति है.
113- मेट्रिक्स ने कार्डिनैलिटी को नियंत्रित किया है।
114- संवेदनशील डेटा फ़िल्टर किया जाता है।
115- अलर्ट उपयोगकर्ता के लक्षणों से शुरू होते हैं, यादृच्छिक ग्राफ़ से नहीं।
116~
117## निष्कर्ष
118~
119OpenTelemetry उत्पादन समस्याओं को अपने आप हल नहीं करता है। लेकिन आपके उनसे निपटने का तरीका बदल जाता है। आँख बंद करके लॉग जोड़ने के बजाय, आप अनुरोध के वास्तविक पथ का अनुसरण करना शुरू करते हैं।
120~
121मेरे लिए यह संकेत सरल है कि यह काम कर रहा है: जब कुछ होता है, तो टीम यह पूछना बंद कर देती है कि "हम कहाँ देख रहे हैं?" और पूछने लगता है "वह टुकड़ा धीमा क्यों है?" यहीं पर अवलोकनशीलता एक उपकरण बन जाती है, न कि डैशबोर्ड का संग्रह।
122~
123## स्रोत
124~
125- [OpenTelemetry: Overview](https://opentelemetry.io/docs/specs/otel/overview/)
126- [OpenTelemetry Collector: Configuration](https://opentelemetry.io/docs/collector/configuration/)
127- [OpenTelemetry JavaScript: Node.js getting started](https://opentelemetry.io/docs/languages/js/getting-started/nodejs/)
128- [OpenTelemetry Semantic Conventions](https://opentelemetry.io/docs/concepts/semantic-conventions/)
129~