हामी जाभास्क्रिप्ट प्रयोग गरेर Zabbix मा व्यावहारिक समस्याहरू समाधान गर्छौं

Tikhon Uskov, Zabbix एकीकरण टोली इन्जिनियर

Zabbix एक अनुकूलन प्लेटफर्म हो जुन कुनै पनि प्रकारको डाटा निगरानी गर्न प्रयोग गरिन्छ। Zabbix को प्रारम्भिक संस्करणहरु देखि, निगरानी प्रशासकहरु को माध्यम बाट विभिन्न स्क्रिप्टहरु चलाउन को लागी क्षमता भएको छ। कार्यहरू लक्षित नेटवर्क नोडहरूमा जाँचहरूको लागि। एकै समयमा, स्क्रिप्टको प्रक्षेपणले धेरै कठिनाइहरू निम्त्यायो, जस्तै स्क्रिप्टहरूलाई समर्थन गर्ने आवश्यकता, सञ्चार नोडहरू र प्रोक्सीहरूमा तिनीहरूको डेलिभरी, साथै विभिन्न संस्करणहरूको लागि समर्थन।

Zabbix को लागि जाभास्क्रिप्ट

अप्रिल 2019 मा, Zabbix 4.2 जाभास्क्रिप्ट प्रिप्रोसेसिङको साथ पेश गरिएको थियो। कतै डाटा लिने, यसलाई पचाउने र Zabbix ले बुझेको ढाँचामा उपलब्ध गराउने, र Zabbix द्वारा भण्डारण र प्रशोधनका लागि तयार नभएको डाटा प्राप्त गर्ने सरल जाँचहरू गर्ने, र त्यसपछि Zabbix र JavaScript उपकरणहरू प्रयोग गरेर यो डाटा स्ट्रिम प्रक्रिया गर्नुहोस्। Zabbix 3.4 मा देखा परेको निम्न-स्तर खोज र निर्भर वस्तुहरूको संयोजनमा, हामीले प्राप्त डाटा क्रमबद्ध र व्यवस्थापनको लागि एकदम लचिलो अवधारणा पायौं।

Zabbix 4.4 मा, जाभास्क्रिप्टमा पूर्व-प्रक्रियाको तार्किक निरन्तरताको रूपमा, नयाँ सूचना विधि देखा पर्‍यो - वेबहुक, जुन तेस्रो-पक्ष अनुप्रयोगहरूसँग Zabbix सूचनाहरू सजिलै एकीकृत गर्न प्रयोग गर्न सकिन्छ।

JavaScript र Duktapes

किन JavaScript र Duktape छानियो? भाषाहरू र इन्जिनहरूको लागि विभिन्न विकल्पहरू विचार गरियो:

• लुआ - लुआ 5.1
• Lua - LuaJIT
• Javascript - Duktape
• जाभास्क्रिप्ट - जेरीस्क्रिप्ट
• इम्बेडेड पाइथन
• एम्बेडेड पर्ल

मुख्य चयन मापदण्डहरू व्यापकता, उत्पादनमा इन्जिनको एकीकरणको सहजता, कम स्रोतको खपत र इन्जिनको समग्र कार्यसम्पादन, र अनुगमनमा यस भाषामा कोड परिचय गर्ने सुरक्षा थियो। सूचकहरूको संयोजनमा आधारित, जाभास्क्रिप्टले डक्टेप इन्जिनमा जित्यो।

चयन मापदण्ड र प्रदर्शन परीक्षण

Duktape को विशेषताहरु:

- मानक ECMAScript E5/E5.1
- Duktape को लागि Zabbix मोड्युलहरू:

• Zabbix.log() - तपाईंलाई Zabbix सर्भर लगमा सीधै विवरणको विभिन्न स्तरका सन्देशहरू लेख्न अनुमति दिन्छ, जसले त्रुटिहरूलाई सम्बद्ध गर्न सम्भव बनाउँछ, उदाहरणका लागि, वेबहुकमा, सर्भर अवस्थासँग।
• CurlHttpRequest() - तपाईंलाई नेटवर्कमा HTTP अनुरोधहरू गर्न अनुमति दिन्छ, जसमा Webhook को प्रयोग आधारित छ।
• atob() र btoa() - तपाईंलाई Base64 ढाँचामा स्ट्रिङहरू इन्कोड र डिकोड गर्न अनुमति दिन्छ।

नोट. Duktape ACME मापदण्डहरूको पालना गर्दछ। Zabbix ले स्क्रिप्टको 2015 संस्करण प्रयोग गर्दछ। त्यसपछिका परिवर्तनहरू साना छन्, त्यसैले तिनीहरूलाई बेवास्ता गर्न सकिन्छ।.

जाभास्क्रिप्ट जादू

जाभास्क्रिप्टको सबै जादू गतिशील टाइपिङ र टाइप कास्टिङमा निहित छ: स्ट्रिङ, संख्यात्मक र बुलियन।

यसको मतलब यो हो कि कुन प्रकारको चरले मान फिर्ता गर्नुपर्छ भनेर अग्रिम घोषणा गर्न आवश्यक छैन।

गणितीय अपरेसनहरूमा, प्रकार्य अपरेटरहरूद्वारा फर्काइएका मानहरूलाई सङ्ख्याहरूमा रूपान्तरण गरिन्छ। त्यस्ता अपरेसनहरूको अपवाद थप हो, किनभने कम्तिमा एउटा सर्त स्ट्रिङ हो भने, स्ट्रिङ रूपान्तरण सबै सर्तहरूमा लागू हुन्छ।

नोट. त्यस्ता रूपान्तरणका लागि जिम्मेवार विधिहरू सामान्यतया वस्तुको अभिभावक प्रोटोटाइपहरूमा लागू गरिन्छ, मूल्य и स्ट्रिंग. मूल्य संख्यात्मक रूपान्तरणको समयमा र सधैं विधि अघि बोलाइन्छ स्ट्रिंग। विधि मूल्य आदिम मानहरू फर्काउनु पर्छ, अन्यथा यसको परिणामलाई बेवास्ता गरिन्छ।

वस्तुमा विधि भनिन्छ valueOF। यदि यो फेला परेन वा आदिम मान फिर्ता गर्दैन भने, विधि भनिन्छ स्ट्रिंग। यदि विधि हो स्ट्रिंग फेला परेन, खोज्दै मूल्य वस्तुको प्रोटोटाइपमा, र मानको प्रशोधन पूरा नभएसम्म सबै कुरा दोहोर्याइन्छ र अभिव्यक्तिका सबै मानहरू समान प्रकारमा कास्ट हुन्छन्।. यदि वस्तुले विधि लागू गर्दछ स्ट्रिंग, जसले एक आदिम मान फर्काउँछ, त्यसपछि यो स्ट्रिङ रूपान्तरणको लागि प्रयोग गरिन्छ। यद्यपि, यो विधि लागू गर्ने परिणाम आवश्यक रूपमा एक स्ट्रिङ होइन।

उदाहरण को लागी, यदि वस्तु को लागी 'obj' विधि परिभाषित गरिएको छ स्ट्रिंग,

`var obj = { toString() { return "200" }}` 

विधि स्ट्रिंग ठ्याक्कै एक स्ट्रिङ फर्काउँछ, र संख्याको साथ स्ट्रिङ थप्दा, हामी एक टाँसिएको स्ट्रिङ पाउँछौं:

`obj + 1 // '2001'` 

`obj + 'a' // ‘200a'`

तर यदि तपाइँ पुन: लेख्नुहोस् स्ट्रिंग, ताकि विधिले संख्या फर्काउँछ, जब वस्तु थपिन्छ, संख्यात्मक रूपान्तरणको साथ एक गणितीय अपरेशन प्रदर्शन गरिनेछ र गणितीय थपको परिणाम प्राप्त गरिनेछ।

`var obj = { toString() { return 200 }}` 

`obj + 1 // '2001'`

यस अवस्थामा, यदि हामीले स्ट्रिङको साथ थप गर्छौं भने, एक स्ट्रिङ रूपान्तरण गरिन्छ, र हामीले टाँसिएको स्ट्रिङ पाउँछौं।

`obj + 'a' // ‘200a'`

यो नौसिखिया JavaScript प्रयोगकर्ताहरू द्वारा गल्तीहरूको ठूलो संख्याको कारण हो।

विधि स्ट्रिंग तपाईले एउटा प्रकार्य लेख्न सक्नुहुन्छ जसले वस्तुको हालको मान 1 ले बढाउँछ।

लिपिको कार्यान्वयन, चर 3 को बराबर छ, र यो 4 को बराबर छ।

कास्ट (==) सँग तुलना गर्दा, विधि प्रत्येक पटक कार्यान्वयन गरिन्छ स्ट्रिंग मूल्य वृद्धि कार्य संग। तदनुसार, प्रत्येक पछिको तुलना संग, मूल्य बढ्छ। यसलाई गैर-कास्ट तुलना (===) प्रयोग गरेर बच्न सकिन्छ।

प्रकार कास्टिङ बिना तुलना

नोट. अनावश्यक रूपमा कास्ट तुलना प्रयोग नगर्नुहोस्.

जटिल स्क्रिप्टहरूका लागि, जस्तै जटिल तर्कसहितको वेबहुक्स, जसलाई टाइप कास्टिङसँग तुलना गर्न आवश्यक हुन्छ, भ्यारीएबलहरू फर्काउने र असंगतता र त्रुटिहरू ह्यान्डल गर्ने मानहरूको लागि पूर्व-लेखन जाँच गर्न सिफारिस गरिन्छ।

वेबहुक मिडिया

2019 को अन्त र 2020 को प्रारम्भमा, Zabbix एकीकरण टोलीले सक्रिय रूपमा Webhooks र Zabbix वितरणको साथमा आउट-अफ-द-बक्स एकीकरणहरू विकास गर्दै आएको छ।

• त्याग
• Jira
• जिरा सर्भिस डेस्क
• Mattermost
• माइक्रोसफ्ट टोलीहरू
• Opsgenie
• अन्य
• पृष्ठ कर्तव्य
• पुशओभर
• रेडमाइन
• अब सेवा
• SINGL4
• सुस्त
• तार
• जम्माद
• Zendesk

लि Link्क कागजात

प्रिप्रोसेसिing

• जाभास्क्रिप्टमा प्रिप्रोसेसिङको आगमनले धेरैजसो बाह्य स्क्रिप्टहरू त्याग्न सम्भव बनायो, र हाल Zabbix मा तपाईंले कुनै पनि मान प्राप्त गर्न सक्नुहुन्छ र यसलाई पूर्ण रूपमा फरक मानमा रूपान्तरण गर्न सक्नुहुन्छ।
• Zabbix मा प्रिप्रोसेसिङ जाभास्क्रिप्ट कोड द्वारा लागू गरिएको छ, जुन बाइटकोडमा कम्पाइल गर्दा, एक प्रकार्यमा रूपान्तरण हुन्छ जसले प्यारामिटरको रूपमा एकल मान लिन्छ। मूल्य स्ट्रिङको रूपमा (स्ट्रिङमा अंक र संख्या दुवै समावेश हुन सक्छ)।
• आउटपुट एक प्रकार्य भएकोले, स्क्रिप्टको अन्त्यमा आवश्यक छ फिर्ती.
• कोडमा अनुकूलन म्याक्रोहरू प्रयोग गर्न सम्भव छ।
• स्रोतहरू अपरेटिङ सिस्टम स्तरमा मात्र सीमित हुन सक्दैन, तर कार्यक्रमगत रूपमा पनि। प्रिप्रोसेसिङ चरणमा अधिकतम १० मेगाबाइट RAM र १० सेकेन्डको चल्ने समय सीमा तोकिएको छ।

नोट. 10 सेकेन्डको टाइमआउट मान एकदम धेरै छ, किनकि सशर्त हजारौं डेटा वस्तुहरू 1 सेकेन्डमा सङ्कलन गर्नाले "भारी" पूर्वप्रक्रिया परिदृश्य अनुसार Zabbix लाई ढिलो गर्न सक्छ। तसर्थ, तथाकथित छायाँ डेटा तत्वहरू (डमी वस्तुहरू) मार्फत पूर्ण-प्रक्रियाको जाभास्क्रिप्ट स्क्रिप्टहरू कार्यान्वयन गर्न पूर्व-प्रोसेसिङ प्रयोग गर्न सिफारिस गरिँदैन, जुन पूर्व-प्रक्रिया गर्नका लागि मात्र चलाइन्छ।.

तपाइँ तपाइँको कोड preprocessing परीक्षण वा उपयोगिता प्रयोग गरेर जाँच गर्न सक्नुहुन्छ zabbix_js:

`zabbix_js -s *script-file -p *input-param* [-l log-level] [-t timeout]`

`zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]`

`zabbix_js -h`

`zabbix_js -V`

व्यावहारिक कार्यहरू

उद्देश्य 1

गणना गरिएको वस्तुलाई प्रिप्रोसेसिङसँग बदल्नुहोस्।

सर्त: सेल्सियसमा भण्डारण गर्न सेन्सरबाट फरेनहाइटमा तापक्रम प्राप्त गर्नुहोस्।

पहिले, हामी डिग्री फरेनहाइटमा तापक्रम सङ्कलन गर्ने वस्तु सिर्जना गर्नेछौं। त्यस पछि, अर्को डेटा वस्तु (गणना गरिएको) जसले फारेनहाइटलाई एक सूत्र प्रयोग गरेर सेल्सियसमा रूपान्तरण गर्नेछ।

समस्याहरू:

• डाटा तत्वहरू नक्कल गर्न र डाटाबेसमा सबै मानहरू भण्डारण गर्न आवश्यक छ।
• तपाईंले सूत्रमा गणना र प्रयोग गरिएको "अभिभावक" डेटा वस्तु र गणना गरिएको डेटा वस्तुको लागि अन्तरालहरूमा सहमत हुनुपर्छ। अन्यथा, गणना गरिएको वस्तु असमर्थित अवस्थामा जान सक्छ वा अघिल्लो मान गणना गर्न सक्छ, जसले अनुगमन परिणामहरूको विश्वसनीयतालाई असर गर्नेछ।

एउटा समाधान भनेको निश्चित अन्तरालहरूको पक्षमा लचिलो चेक अन्तरालहरूबाट टाढा जानको लागि डेटा प्राप्त गर्ने वस्तु (हाम्रो अवस्थामा, डिग्री फरेनहाइटमा तापक्रम) पछि गणना गरिएको वस्तुको मूल्याङ्कन गरिएको सुनिश्चित गर्न थियो।

तर यदि, उदाहरणका लागि, हामीले ठूलो संख्यामा उपकरणहरू जाँच गर्न टेम्प्लेट प्रयोग गर्छौं, र जाँच प्रत्येक 30 सेकेन्डमा एक पटक गरिन्छ, Zabbix "ह्याक्स" 29 सेकेन्डमा, र अन्तिम सेकेन्डमा यो जाँच र गणना सुरु हुन्छ। यसले लाम सिर्जना गर्छ र कार्यसम्पादनलाई असर गर्छ। तसर्थ, यो वास्तवमै आवश्यक भएमा मात्र निश्चित अन्तरालहरू प्रयोग गर्न सिफारिस गरिन्छ।

यस समस्यामा, इष्टतम समाधान एक-लाइन जाभास्क्रिप्ट प्रिप्रोसेसिङ हो जसले डिग्री फरेनहाइटलाई डिग्री सेल्सियसमा रूपान्तरण गर्दछ:

`return (value - 32) * 5 / 9;`

यो छिटो र सजिलो छ, तपाईंले अनावश्यक डेटा वस्तुहरू सिर्जना गर्न र तिनीहरूमा इतिहास राख्न आवश्यक पर्दैन, र तपाईंले जाँचका लागि लचिलो अन्तरालहरू पनि प्रयोग गर्न सक्नुहुन्छ।

`return (parseInt(value) + parseInt("{$EXAMPLE.MACRO}"));`

तर, यदि एक काल्पनिक स्थिति मा प्राप्त डाटा तत्व थप्न आवश्यक छ, उदाहरण को लागी, म्याक्रो मा परिभाषित कुनै पनि स्थिर संग, यो मापदण्ड मा लिनु पर्छ। मूल्य स्ट्रिङमा विस्तार हुन्छ। स्ट्रिङ थप सञ्चालनमा, दुई स्ट्रिङहरू मात्र एकमा मिलाइन्छ।

`return (value + "{$EXAMPLE.MACRO}");`

गणितीय सञ्चालनको नतिजा प्राप्त गर्न, प्राप्त मानहरूको प्रकारहरूलाई संख्यात्मक ढाँचामा रूपान्तरण गर्न आवश्यक छ। यसका लागि तपाईंले प्रकार्य प्रयोग गर्न सक्नुहुन्छ parseInt(), जसले एक पूर्णांक, एक प्रकार्य उत्पादन गर्दछ पार्सफ्लोट(), जसले दशमलव, वा कार्य उत्पादन गर्दछ नम्बर, जसले पूर्णांक वा दशमलव फर्काउँछ।

कार्य २

प्रमाणपत्रको अन्त्य सम्म सेकेन्डमा समय प्राप्त गर्नुहोस्।

सर्त: सेवाले "फेब्रुअरी १२ 12:12:33 56 GMT" ढाँचामा प्रमाणपत्रको म्याद सकिने मिति जारी गर्छ।

ECMAScript5 मा date.parse() ISO 8601 ढाँचा (YYYY-MM-DDTHH:mm:ss.sssZ) मा मिति स्वीकार गर्दछ। यसलाई MMM DD YYYY HH:mm:ss ZZ ढाँचामा स्ट्रिङ कास्ट गर्न आवश्यक छ।

समस्या: महिनाको मान पाठको रूपमा व्यक्त गरिन्छ, संख्याको रूपमा होइन। यस ढाँचामा डाटा Duktape द्वारा स्वीकार गर्दैन।

समाधान उदाहरण:

• सबै भन्दा पहिले, एउटा चर घोषणा गरिएको छ जसले मान लिन्छ (पूरा लिपि अल्पविरामद्वारा विभाजित सूचीबद्ध चरहरूको घोषणा हो)।

• पहिलो पङ्क्तिमा हामीले प्यारामिटरमा मिति पाउँछौं मूल्य र विधि प्रयोग गरेर यसलाई खाली ठाउँहरूसँग अलग गर्नुहोस् विभाजित। यसरी, हामीले एउटा एरे पाउँछौं, जहाँ एरेको प्रत्येक तत्व, अनुक्रमणिका ० मा सुरु हुन्छ, स्पेस अघि र पछिको एक मिति तत्वसँग मेल खान्छ। विभाजन(०) - महिना, विभाजन(०) - नम्बर, विभाजन(०) - समय सहितको स्ट्रिङ, इत्यादि। त्यस पछि, मितिको प्रत्येक तत्व एरेमा अनुक्रमणिकाद्वारा पहुँच गर्न सकिन्छ।

`var split = value.split(' '),`

• प्रत्येक महिना (कालानुक्रमिक क्रममा) एरेमा यसको स्थितिको अनुक्रमणिकासँग मेल खान्छ (० देखि ११ सम्म)। पाठ मानलाई संख्यात्मक मानमा रूपान्तरण गर्न, महिनाको अनुक्रमणिकामा एउटा थपिएको छ (किनभने महिनाहरू १ बाट सुरु हुने गरी अंकित हुन्छन्)। यस अवस्थामा, एक जोडिएको अभिव्यक्ति कोष्ठकमा लिइन्छ, किनभने अन्यथा स्ट्रिङ प्राप्त हुनेछ, संख्या होइन। अन्तमा हामी गर्छौं टुक्रा () - केवल दुई क्यारेक्टरहरू छोड्नको लागि अन्तबाट एरे काट्नुहोस् (जुन दुई-अङ्कको संख्याको साथ महिनाहरूको लागि महत्त्वपूर्ण छ)।

`MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],`

`month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),`

• हामीले प्राप्त मानहरूबाट ISO ढाँचामा स्ट्रिङलाई उपयुक्त क्रममा स्ट्रिङको सामान्य थपेर बनाउँछौं।

`ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],`

नतिजा ढाँचामा डाटा 1970 देखि भविष्यमा केही बिन्दु सेकेन्ड को संख्या हो। ट्रिगरहरूमा प्राप्त ढाँचामा डाटा प्रयोग गर्न लगभग असम्भव छ, किनकि Zabbix ले तपाईंलाई म्याक्रोसँग मात्र सञ्चालन गर्न अनुमति दिन्छ। {मिति и {समय}, जसले प्रयोगकर्ता-अनुकूल ढाँचामा मिति र समय फर्काउँछ।

• हामी त्यसपछि युनिक्स टाइमस्ट्याम्प ढाँचामा जाभास्क्रिप्टमा हालको मिति प्राप्त गर्न सक्छौं र प्रमाणपत्रको म्याद समाप्त नभएसम्म मिलिसेकेन्डको संख्या प्राप्त गर्नको लागि परिणामी प्रमाणपत्र समाप्ति मितिबाट घटाउन सक्छौं।

`now = Date.now();`

• Zabbix मा सेकेन्ड प्राप्त गर्न हामीले प्राप्त मानलाई हजारले विभाजन गर्छौं।

`return parseInt((Date.parse(ISOdate) - now) / 1000);`

ट्रिगरमा, तपाइँ अभिव्यक्ति निर्दिष्ट गर्न सक्नुहुन्छ 'अन्तिम' अंकहरूको सेट पछि जुन अवधिमा तपाईले प्रतिक्रिया दिन चाहनु भएको सेकेन्डको संख्यासँग मेल खान्छ, उदाहरणका लागि, हप्ताहरूमा। यसरी, ट्रिगरले एक हप्तामा प्रमाणपत्रको म्याद सकिन्छ भनेर सूचित गर्नेछ।

नोट. उपयोग मा ध्यान दिनुहोस् parseInt() कार्यमा फिर्तीमिलिसेकेन्डको विभाजनबाट प्राप्त हुने भिन्न संख्यालाई पूर्णांकमा रूपान्तरण गर्न। तपाईं पनि प्रयोग गर्न सक्नुहुन्छ पार्सफ्लोट() र आंशिक डाटा भण्डारण गर्नुहोस्.

रिपोर्ट हेर्नुहोस्

स्रोत: www.habr.com