आम्ही JavaScript वापरून Zabbix मध्ये व्यावहारिक समस्या सोडवतो

टिखॉन उसकोव्ह, Zabbix एकत्रीकरण संघ अभियंता

Zabbix एक सानुकूल करण्यायोग्य प्लॅटफॉर्म आहे जो कोणत्याही प्रकारच्या डेटाचे परीक्षण करण्यासाठी वापरला जातो. Zabbix च्या सुरुवातीच्या आवृत्त्यांपासून, देखरेख प्रशासकांना विविध स्क्रिप्ट्सद्वारे चालविण्याची क्षमता आहे क्रिया लक्ष्य नेटवर्क नोड्सच्या तपासणीसाठी. त्याच वेळी, स्क्रिप्ट लाँच केल्यामुळे स्क्रिप्टला समर्थन देण्याची गरज, कम्युनिकेशन नोड्स आणि प्रॉक्सींना त्यांचे वितरण, तसेच विविध आवृत्त्यांसाठी समर्थन यासह अनेक अडचणी निर्माण झाल्या.

Zabbix साठी JavaScript

एप्रिल 2019 मध्ये, Zabbix 4.2 JavaScript प्रीप्रोसेसिंगसह सादर केले गेले. कोठेतरी डेटा घेऊन जाणाऱ्या स्क्रिप्ट लिहिणे सोडून देणे, ते पचवणे आणि Zabbix ला समजेल अशा फॉरमॅटमध्ये प्रदान करणे, आणि Zabbix द्वारे स्टोरेज आणि प्रोसेसिंगसाठी तयार नसलेला डेटा प्राप्त होईल अशा सोप्या तपासण्या करायच्या कल्पनेने बरेच लोक उत्साहित झाले. नंतर Zabbix आणि JavaScript टूल्स वापरून या डेटा स्ट्रीमवर प्रक्रिया करा. Zabbix 3.4 मध्ये दिसणार्‍या निम्न-स्तरीय शोध आणि आश्रित वस्तूंच्या संयोगाने, आम्हाला प्राप्त झालेल्या डेटाची क्रमवारी लावण्यासाठी आणि व्यवस्थापित करण्यासाठी बर्‍यापैकी लवचिक संकल्पना मिळाली.

Zabbix 4.4 मध्ये, JavaScript मध्ये प्री-प्रोसेसिंगची तार्किक निरंतरता म्हणून, एक नवीन सूचना पद्धत आली आहे - Webhook, ज्याचा वापर तृतीय-पक्ष अनुप्रयोगांसह Zabbix सूचना सहजपणे एकत्रित करण्यासाठी केला जाऊ शकतो.

JavaScript आणि Duktapes

JavaScript आणि Duktape का निवडले गेले? भाषा आणि इंजिनसाठी विविध पर्यायांचा विचार केला गेला:

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

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

निवड निकष आणि कामगिरी चाचणी

Duktap ची वैशिष्ट्ये:

- मानक ECMAScript E5/E5.1
- डक्टॅपसाठी झब्बीक्स मॉड्यूल्स:

• Zabbix.log() - तुम्हाला थेट Zabbix सर्व्हर लॉगमध्ये तपशीलाच्या विविध स्तरांसह संदेश लिहिण्याची परवानगी देते, ज्यामुळे त्रुटींशी संबंध जोडणे शक्य होते, उदाहरणार्थ, वेबहुकमध्ये, सर्व्हर स्थितीसह.
• CurlHttpRequest() - तुम्हाला नेटवर्कवर HTTP विनंत्या करण्याची परवानगी देते, ज्यावर Webhook चा वापर आधारित आहे.
• atob() आणि btoa() - तुम्हाला बेस64 फॉरमॅटमध्ये स्ट्रिंग्स एन्कोड आणि डीकोड करण्याची परवानगी देते.

टीप. Duktape ACME मानकांचे पालन करते. Zabbix स्क्रिप्टची 2015 आवृत्ती वापरते. त्यानंतरचे बदल किरकोळ आहेत, त्यामुळे त्यांच्याकडे दुर्लक्ष केले जाऊ शकते..

JavaScript जादू

JavaScript ची सर्व जादू डायनॅमिक टायपिंग आणि टाइप कास्टिंगमध्ये आहे: स्ट्रिंग, संख्यात्मक आणि बुलियन.

याचा अर्थ व्हेरिएबलने कोणत्या प्रकारची व्हॅल्यू परत करावी हे आधीच घोषित करणे आवश्यक नाही.

गणितीय क्रियांमध्ये, फंक्शन ऑपरेटरद्वारे परत केलेली मूल्ये संख्यांमध्ये रूपांतरित केली जातात. अशा ऑपरेशन्सना अपवाद जोडणे आहे, कारण किमान एक अटी स्ट्रिंग असल्यास, स्ट्रिंग रूपांतरण सर्व अटींवर लागू केले जाते.

टीप. अशा परिवर्तनांसाठी जबाबदार असलेल्या पद्धती सामान्यतः ऑब्जेक्टच्या मूळ प्रोटोटाइपमध्ये लागू केल्या जातात, ची किंमत и toString. ची किंमत संख्यात्मक रूपांतरण दरम्यान आणि नेहमी पद्धतीच्या आधी कॉल केला जातो toString. पद्धत ची किंमत आदिम मूल्ये परत करणे आवश्यक आहे, अन्यथा त्याचा परिणाम दुर्लक्षित केला जाईल.

ऑब्जेक्टवर पद्धत म्हणतात ची किंमत. जर ते सापडले नाही किंवा आदिम मूल्य परत केले नाही तर, पद्धत म्हणतात toString. जर पद्धत toString सापडले नाही, शोधत आहे ची किंमत ऑब्जेक्टच्या प्रोटोटाइपमध्ये, आणि मूल्याची प्रक्रिया पूर्ण होईपर्यंत आणि अभिव्यक्तीमधील सर्व मूल्ये समान प्रकारात टाकल्या जाईपर्यंत सर्वकाही पुनरावृत्ती होते. जर ऑब्जेक्टने पद्धत लागू केली toString, जे एक आदिम मूल्य देते, नंतर तेच स्ट्रिंग रूपांतरणासाठी वापरले जाते. तथापि, ही पद्धत लागू करण्याचा परिणाम स्ट्रिंग असणे आवश्यक नाही.

उदाहरणार्थ, जर ऑब्जेक्टसाठी 'हरकत' पद्धत परिभाषित केली आहे toString,

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

पद्धत toString तंतोतंत एक स्ट्रिंग मिळवते, आणि नंबरसह स्ट्रिंग जोडताना, आम्हाला एक चिकटलेली स्ट्रिंग मिळते:

`obj + 1 // '2001'` 

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

पण जर तुम्ही पुन्हा लिहिलं toString, जेणेकरून पद्धत एक संख्या देईल, जेव्हा ऑब्जेक्ट जोडला जाईल, तेव्हा अंकीय रूपांतरणासह एक गणितीय ऑपरेशन केले जाईल आणि गणितीय जोडणीचा परिणाम प्राप्त होईल.

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

`obj + 1 // '2001'`

या प्रकरणात, आपण स्ट्रिंगसह जोडल्यास, एक स्ट्रिंग रूपांतरण केले जाते आणि आपल्याला एक चिकटलेली स्ट्रिंग मिळते.

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

नवशिक्या JavaScript वापरकर्त्यांद्वारे मोठ्या संख्येने चुका होण्याचे हे कारण आहे.

पद्धत toString तुम्ही एक फंक्शन लिहू शकता जे ऑब्जेक्टचे वर्तमान मूल्य 1 ने वाढवेल.

स्क्रिप्टची अंमलबजावणी, जर व्हेरिएबल 3 च्या समान असेल आणि ते 4 च्या समान असेल.

कास्ट (==) शी तुलना केल्यावर, पद्धत प्रत्येक वेळी अंमलात आणली जाते toString मूल्य वाढ कार्यासह. त्यानुसार, प्रत्येक त्यानंतरच्या तुलनेसह, मूल्य वाढते. नॉन-कास्ट तुलना (===) वापरून हे टाळता येते.

प्रकार कास्टिंगशिवाय तुलना

टीप. कास्ट तुलना अनावश्यकपणे वापरू नका.

क्लिष्ट स्क्रिप्ट्ससाठी, जसे की क्लिष्ट लॉजिकसह वेबहूक्स, ज्यांना टाइप कास्टिंगशी तुलना करणे आवश्यक आहे, व्हेरिएबल्स परत करणाऱ्या आणि विसंगती आणि त्रुटी हाताळणाऱ्या मूल्यांसाठी पूर्व-लेखन तपासण्याची शिफारस केली जाते.

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

2019 च्या उत्तरार्धात आणि 2020 च्या सुरुवातीस, Zabbix इंटिग्रेशन टीम सक्रियपणे Webhooks आणि आउट-ऑफ-द-बॉक्स एकीकरण विकसित करत आहे जे Zabbix वितरणासह येतात.

• विचित्र
• Jira
• जिरा सर्व्हिस डेस्क
• सर्वात मोठा
• मायक्रोसॉफ्ट टीम्स
• Opsgenie
• इतर
• पेजड्युटी
• पुशओव्हर
• रेडमिने
• सेवा
• SINGL4
• मंदीचा काळ
• तार
• झम्मद
• झेंडेस्क

चा दुवा दस्तऐवजीकरण

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

• JavaScript मध्ये प्रीप्रोसेसिंगच्या आगमनाने बहुतेक बाह्य स्क्रिप्ट सोडणे शक्य झाले आणि सध्या Zabbix मध्ये तुम्हाला कोणतेही मूल्य मिळू शकते आणि ते पूर्णपणे भिन्न मूल्यामध्ये रूपांतरित केले जाऊ शकते.
• Zabbix मध्ये प्रीप्रोसेसिंग जावास्क्रिप्ट कोडद्वारे लागू केले जाते, जे, जेव्हा बायकोडमध्ये संकलित केले जाते, तेव्हा एका फंक्शनमध्ये रूपांतरित केले जाते जे पॅरामीटर म्हणून एकल मूल्य घेते. मूल्य स्ट्रिंग म्हणून (स्ट्रिंगमध्ये अंक आणि संख्या दोन्ही असू शकतात).
• आउटपुट हे फंक्शन असल्याने, स्क्रिप्टच्या शेवटी आवश्यक आहे परत.
• कोडमध्ये सानुकूल मॅक्रो वापरणे शक्य आहे.
• संसाधने केवळ ऑपरेटिंग सिस्टीम स्तरावरच नव्हे तर प्रोग्रामॅटिकरित्या देखील मर्यादित असू शकतात. प्रीप्रोसेसिंग स्टेपमध्ये जास्तीत जास्त 10 मेगाबाइट RAM आणि 10 सेकंदांची रन टाईम मर्यादा दिली जाते.

टीप. 10 सेकंदांचे कालबाह्य मूल्य बरेच आहे, कारण ऐवजी "जड" प्रीप्रोसेसिंग परिस्थितीनुसार 1 सेकंदात सशर्त हजारो डेटा आयटमचे संकलन झब्बीक्सची गती कमी करू शकते. म्हणूनच, तथाकथित शॅडो डेटा एलिमेंट्स (डमी आयटम) द्वारे पूर्ण जावास्क्रिप्ट स्क्रिप्ट कार्यान्वित करण्यासाठी प्रीप्रोसेसिंग वापरण्याची शिफारस केलेली नाही, जी केवळ प्रीप्रोसेसिंग करण्यासाठी चालविली जाते..

तुम्ही तुमचा कोड प्रीप्रोसेसिंग चाचणीद्वारे किंवा युटिलिटी वापरून तपासू शकता 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 सेकंदांसाठी "हॅक" करते आणि शेवटच्या सेकंदात ते तपासणे आणि गणना करणे सुरू करते. हे एक रांग तयार करते आणि कार्यप्रदर्शन प्रभावित करते. म्हणून, जर खरोखर आवश्यक असेल तरच निश्चित अंतराल वापरण्याची शिफारस केली जाते.

या समस्येमध्ये, इष्टतम उपाय म्हणजे एक-लाइन JavaScript प्रीप्रोसेसिंग आहे जे डिग्री फॅरेनहाइटचे डिग्री सेल्सिअसमध्ये रूपांतरित करते:

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

हे जलद आणि सोपे आहे, तुम्हाला अनावश्यक डेटा आयटम तयार करण्याची आणि त्यावर इतिहास ठेवण्याची आवश्यकता नाही आणि तुम्ही तपासण्यासाठी लवचिक अंतराल देखील वापरू शकता.

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

परंतु, जर काल्पनिक परिस्थितीत प्राप्त डेटा घटक जोडणे आवश्यक असेल, उदाहरणार्थ, मॅक्रोमध्ये परिभाषित केलेल्या कोणत्याही स्थिरतेसह, हे पॅरामीटर लक्षात घेतले पाहिजे मूल्य स्ट्रिंगमध्ये विस्तारते. स्ट्रिंग अॅडिशन ऑपरेशनमध्ये, दोन स्ट्रिंग्स फक्त एकामध्ये एकत्र केल्या जातात.

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

गणितीय ऑपरेशनचा परिणाम प्राप्त करण्यासाठी, प्राप्त मूल्यांचे प्रकार संख्यात्मक स्वरूपात रूपांतरित करणे आवश्यक आहे. यासाठी तुम्ही फंक्शन वापरू शकता parseInt(), जे एक पूर्णांक, एक कार्य तयार करते पार्सफ्लोट(), जे दशांश किंवा कार्य तयार करते संख्या, जे पूर्णांक किंवा दशांश मिळवते.

कार्य २

प्रमाणपत्र संपेपर्यंत काही सेकंदात वेळ मिळवा.

अट: सेवा "फेब्रुवारी 12 12:33:56 2022 GMT" स्वरूपात प्रमाणपत्र कालबाह्यता तारीख जारी करते.

ECMAScript5 मध्ये date.parse() ISO 8601 फॉरमॅटमध्ये तारीख स्वीकारते (YYYY-MM-DDTHH:mm:ss.sssZ). त्यावर MMM DD YYYY HH:mm:ss ZZ या फॉरमॅटमध्ये स्ट्रिंग टाकणे आवश्यक आहे.

समस्या: महिन्याचे मूल्य मजकूर म्हणून व्यक्त केले जाते, संख्या म्हणून नाही. या स्वरूपातील डेटा Duktap द्वारे स्वीकारला जात नाही.

उपाय उदाहरण:

• सर्व प्रथम, व्हेरिएबल घोषित केले जाते जे मूल्य घेते (संपूर्ण स्क्रिप्ट ही स्वल्पविरामाने विभक्त केलेली व्हेरिएबल्सची घोषणा असते).

• पहिल्या ओळीत आपल्याला पॅरामीटरमध्ये तारीख मिळते मूल्य आणि पद्धत वापरून स्पेससह वेगळे करा विभाजित करा. अशा प्रकारे, आम्हाला एक अॅरे मिळतो, जिथे अॅरेचा प्रत्येक घटक, इंडेक्स 0 पासून सुरू होणारा, एका स्पेसच्या आधी आणि नंतरच्या तारखेच्या घटकाशी संबंधित असतो. विभाजन(0) - महिना, विभाजन(1) - संख्या, विभाजन(2) - वेळेसह एक स्ट्रिंग, इ. त्यानंतर, तारखेचा प्रत्येक घटक अॅरेमधील अनुक्रमणिकेद्वारे ऍक्सेस केला जाऊ शकतो.

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

• प्रत्येक महिना (कालक्रमानुसार) अॅरेमधील त्याच्या स्थानाच्या निर्देशांकाशी संबंधित असतो (0 ते 11 पर्यंत). मजकूर मूल्य अंकीय मूल्यामध्ये रूपांतरित करण्यासाठी, महिन्याच्या निर्देशांकात एक जोडला जातो (कारण 1 पासून महिने क्रमांकित केले जातात). या प्रकरणात, एक जोडलेली अभिव्यक्ती कंसात घेतली जाते, कारण अन्यथा एक स्ट्रिंग प्राप्त होईल, संख्या नाही. शेवटी आम्ही करतो तुकडा() - फक्त दोन वर्ण सोडण्यासाठी अ‍ॅरे शेवटपासून कट करा (जे दोन-अंकी संख्येसह महिन्यांसाठी महत्त्वाचे आहे).

`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 आपल्याला केवळ मॅक्रोसह ऑपरेट करण्याची परवानगी देतो {तारीख и {वेळ}, जे वापरकर्ता-अनुकूल स्वरूपात तारीख आणि वेळ परत करतात.

• त्यानंतर आम्ही युनिक्स टाइमस्टॅम्प फॉरमॅटमध्ये JavaScript मधील वर्तमान तारीख मिळवू शकतो आणि प्रमाणपत्र कालबाह्य होईपर्यंत आतापासून मिलीसेकंदांची संख्या मिळवण्यासाठी परिणामी प्रमाणपत्र कालबाह्यता तारखेपासून वजा करू शकतो.

`now = Date.now();`

• Zabbix मध्ये सेकंद मिळविण्यासाठी आम्ही प्राप्त मूल्यास हजाराने विभाजित करतो.

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

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

टीप. वापराकडे लक्ष द्या parseInt() कार्यात परतमिलिसेकंदांच्या भागाकारामुळे निर्माण होणारी अपूर्णांक संख्या पूर्णांकात रूपांतरित करण्यासाठी. आपण देखील वापरू शकता पार्सफ्लोट() आणि फ्रॅक्शनल डेटा साठवा.

अहवाल पहा

स्त्रोत: www.habr.com