ज़ैबिक्स - स्थूल सीमाओं का विस्तार

एक ग्राहक के लिए समाधान बनाते समय, 2 कार्य सामने आए जिन्हें मैं खूबसूरती से और नियमित ज़ैबिक्स कार्यक्षमता के साथ हल करना चाहता था।

कार्य 1। मिक्रोटिक राउटर्स पर वर्तमान फर्मवेयर संस्करण को ट्रैक करना।

कार्य आसानी से हल हो जाता है - HTTP टेम्पलेट में एक एजेंट जोड़कर। एजेंट मिकरोटिक वेबसाइट से वर्तमान संस्करण प्राप्त करता है, और ट्रिगर वर्तमान संस्करण की तुलना वर्तमान संस्करण से करता है और विसंगति के मामले में अलर्ट जारी करता है।

जब आपके पास 10 राउटर हों, तो ऐसा एल्गोरिदम महत्वपूर्ण नहीं है, लेकिन 3000 राउटर के साथ क्या करें? सर्वर पर 3000 अनुरोध भेजें? बेशक, ऐसी योजना काम करेगी, लेकिन 3000 अनुरोधों का विचार ही मुझे पसंद नहीं आया, मैं दूसरा समाधान खोजना चाहता था। इसके अलावा, इस तरह के एल्गोरिदम में अभी भी एक खामी थी: दूसरा पक्ष DoS हमले के लिए एक आईपी से इतने सारे अनुरोधों की गिनती कर सकता है, वे बस इसे प्रतिबंधित कर सकते हैं।

कार्य 2। विभिन्न HTTP एजेंटों में प्राधिकरण सत्र का उपयोग करना।

जब किसी एजेंट को HTTP के माध्यम से "बंद" पृष्ठों से जानकारी प्राप्त करने की आवश्यकता होती है, तो एक प्राधिकरण कुकी की आवश्यकता होती है। ऐसा करने के लिए, आमतौर पर "लॉगिन/पासवर्ड" जोड़ी और कुकी में सत्र आईडी सेट करने के साथ एक मानक प्राधिकरण फॉर्म होता है।

लेकिन एक समस्या है, हेडर में इस मान को प्रतिस्थापित करने के लिए एक HTTP एजेंट आइटम से दूसरे आइटम के डेटा तक पहुंचना असंभव है।

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

इन कार्यों के बारे में थोड़ा सोचने के बाद, मैंने मैक्रोज़ का उपयोग करने का निर्णय लिया जो मॉनिटरिंग सिस्टम के किसी भी हिस्से में पूरी तरह से दिखाई देते हैं: टेम्प्लेट, होस्ट, ट्रिगर या आइटम में। और आप वेब इंटरफ़ेस एपीआई के माध्यम से मैक्रोज़ को अपडेट कर सकते हैं।

ज़ैबिक्स के पास अच्छे और विस्तृत एपीआई दस्तावेज़ हैं। एपीआई के माध्यम से डेटा विनिमय के लिए, Json डेटा प्रारूप का उपयोग किया जाता है। विवरण में पाया जा सकता है आधिकारिक दस्तावेज.

हमें आवश्यक डेटा प्राप्त करने और उन्हें मैक्रो में रिकॉर्ड करने के लिए क्रियाओं का क्रम नीचे दिए गए चित्र में दिखाया गया है।

1 कदम

पहले चरण में एक ही क्रिया या एकाधिक क्रियाएं शामिल हो सकती हैं। सभी मुख्य तर्क पहले चरणों में रखे गए हैं, और अंतिम 3 चरण मुख्य हैं।

मेरे उदाहरण में, पहला कदम पहले कार्य के लिए पीबीएक्स पर प्राधिकरण कुकीज़ प्राप्त करना था। दूसरे कार्य के लिए, मुझे मिकरोटिक फ़र्मवेयर के वर्तमान संस्करण का नंबर मिला।

मिकरोटिक फ़र्मवेयर के वर्तमान संस्करणों का URL

• अपग्रेड.mikrotik.com/routeros/LATEST.6 - वर्तमान स्थिर संस्करण का यूआरएल पता
• अपग्रेड.mikrotik.com/routeros/LATEST.6fix - वर्तमान एलटीएस संस्करण का यूआरएल पता

नवीनतम उपलब्ध फ़र्मवेयर संस्करण प्राप्त होने पर इन पतों को मिकरोटिक उपकरण द्वारा ही एक्सेस किया जाता है।

पहला चरण प्रत्येक मामले के लिए पूरी तरह से व्यक्तिगत है और इसके कार्य का तर्क भिन्न हो सकता है। यह सब आपके कार्य पर निर्भर करता है।

वेब स्क्रिप्टिंग के साथ काम करते समय, इस बात पर नज़र रखें कि आपको किस प्रतिक्रिया पद्धति की आवश्यकता है। सुर्खियों में HTTP प्रतिक्रिया या self тело हेडर के बिना प्रतिक्रिया?
यदि प्राधिकरण कुकीज़ की आवश्यकता है, तो प्रतिक्रिया विधि सेट करें सुर्खियों में जैसा कि तारांकन के मामले में होता है।

यदि आपको डेटा की आवश्यकता है, जैसा कि माइक्रोटिक सर्वर प्रतिक्रिया के मामले में, डालें शव हेडर के बिना प्रतिक्रिया.

2 कदम

चलिए दूसरे चरण पर चलते हैं। प्राधिकरण सत्र प्राप्त करना:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
        "user": "Admin"
        "password": "zabbix"
    },
    "id": 1,
    "auth": null
}

jsonrpc JSON-RPC प्रोटोकॉल का वह संस्करण है जिसका उपयोग किया जा रहा है;
ज़ैबिक्स JSON-RPC संस्करण 2.0 लागू करता है;

• विधि - वह विधि जिसे कहा जाता है;
• पैरामीटर - पैरामीटर जो विधि द्वारा पारित किए जाते हैं;
• आईडी एक मनमाना अनुरोध पहचानकर्ता है;
• प्रमाणीकरण - उपयोगकर्ता प्रमाणीकरण कुंजी; चूँकि यह अभी तक हमारे पास नहीं है, आइए इसे शून्य पर सेट करें।

एपीआई के साथ काम करने के लिए, मैंने सीमित अधिकारों के साथ एक अलग खाता बनाया। सबसे पहले, आपको वहां तक ​​पहुंच देने की आवश्यकता नहीं है जहां आपको इसकी आवश्यकता नहीं है। और दूसरी बात, संस्करण 5.0 से पहले, मैक्रो के माध्यम से सेट किए गए पासवर्ड को पढ़ा जा सकता था। तदनुसार, यदि आप ज़ैबिक्स व्यवस्थापक पासवर्ड का उपयोग करते हैं, तो व्यवस्थापक खाता चोरी करना आसान है।

यह विशेष रूप से सच होगा जब तृतीय-पक्ष स्क्रिप्ट के माध्यम से एपीआई के साथ काम करना और किनारे पर क्रेडेंशियल संग्रहीत करना।

संस्करण 5.0 के बाद से मैक्रो में सहेजे गए पासवर्ड को छिपाने का विकल्प मौजूद है।

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

एपीआई में प्राधिकरण प्राप्त करने के बाद, हम मैक्रोज़ की एक सूची प्राप्त करने के लिए आगे बढ़ते हैं।

3 कदम

एपीआई आपको होस्ट मैक्रो को नाम से अपडेट करने की अनुमति नहीं देता है, आपको पहले मैक्रो आईडी प्राप्त करनी होगी। इसके अलावा, किसी विशिष्ट होस्ट के लिए मैक्रोज़ की सूची प्राप्त करने के लिए, आपको इस होस्ट की आईडी जानना आवश्यक है, और यह एक अतिरिक्त अनुरोध है। डिफ़ॉल्ट मैक्रो का उपयोग करें {होस्ट आईडी} अनुरोध में अनुमति नहीं है. मैंने इस तरह प्रतिबंध को बायपास करने का निर्णय लिया:

मैंने इस होस्ट की आईडी के साथ एक स्थानीय मैक्रो बनाया। वेब इंटरफ़ेस से होस्ट आईडी का पता लगाना बहुत आसान है।

किसी दिए गए होस्ट पर सभी मैक्रोज़ की सूची वाली प्रतिक्रिया को एक पैटर्न द्वारा फ़िल्टर किया जा सकता है:

regex:{"hostmacroid":"([0-9]+)"[A-z0-9,":]+"{$MIKROTIK_VERSION}"

इस प्रकार, हमें उस मैक्रो की आईडी मिलती है जिसकी हमें आवश्यकता है, जहां MIKROTIK_संस्करण यह उस मैक्रो का नाम है जिसे हम ढूंढ रहे हैं। मेरे मामले में, मैक्रो खोजा गया है MIKROTIK_संस्करणवह मेज़बान को सौंपा गया था।

अनुरोध स्वयं इस तरह दिखता है:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.get",
    "params":{
        "output":"extend",
        "hostids":"{$HOST_ID}"
    },
    "auth":"{sid}",
    "id":1
}

परिवर्तनशील {सिड} दूसरे चरण में प्राप्त किया गया और इसका लगातार उपयोग किया जाएगा, जहां आपको एपीआई इंटरफ़ेस के साथ काम करने की आवश्यकता होगी।

अंतिम 4 चरण - मैक्रो को अद्यतन करना

अब हम उस मैक्रो आईडी को जानते हैं जिसे अद्यतन करने की आवश्यकता है, प्राधिकरण कुकी या राउटर का फर्मवेयर संस्करण। आप मैक्रो को ही अपडेट कर सकते हैं.

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.update",
    "params":{
        "hostmacroid":"{hostmacroid}",
        "value":"{mikrotik_version}"
    },
    "auth":"{sid}",
    "id":1
}

{mikrotik_version} पहले चरण में प्राप्त मूल्य है. मेरे उदाहरण में, वर्तमान मिक्रोटिक फर्मवेयर का संस्करण
{hostmacroid} - मान तीसरे चरण में प्राप्त किया गया था - मैक्रो की आईडी जिसे हम अपडेट कर रहे हैं।

निष्कर्ष

मानक कार्यक्षमता के साथ समस्या को हल करने का दृष्टिकोण बहुत अधिक जटिल और लंबा है। खासकर यदि आप प्रोग्रामिंग जानते हैं और स्क्रिप्ट में आवश्यक तर्क तुरंत जोड़ सकते हैं।

इस दृष्टिकोण का स्पष्ट लाभ विभिन्न सर्वरों के बीच समाधान की "पोर्टेबिलिटी" है।

मेरे लिए व्यक्तिगत रूप से, यह अजीब है कि HTTP एजेंट किसी अन्य आइटम के डेटा तक नहीं पहुंच सकता है और उन्हें अनुरोध निकाय या हेडर में प्रतिस्थापित नहीं कर सकता है [ ZBXNEXT-5993].

तैयार टेम्पलेट कर सकते हैं GitHub पर डाउनलोड करें.

स्रोत: www.habr.com