🦔 🦊 👩🏿‍⚕️ कैक्टि डेटा क्वेश्चन 🤰🏼 👾 🕴🏻

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

यह समझने के लिए कि डेटा क्वेरी क्या है और इसे कैसे काम करना है, केवल नए साल की छुट्टियों के लिए समय था।

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

कैक्टि में, यह दृष्टिकोण बिल्ट-इन है, जैसा कि वे कहते हैं, बॉक्स से बाहर। जेनेरिक एसएनएमपी टेम्पलेट का उपयोग करने वाले नोड्स के लिए, आप सभी नेटवर्क इंटरफेस की एक सूची देख सकते हैं, आवश्यक का चयन कर सकते हैं और संबंधित डेटा क्वेरी एसएनएमपी - इंटरफ़ेस सांख्यिकी के साथ उन पर आवश्यक ग्राफ़ बना सकते हैं। ऐसा लगता है कि यह देखना आसान है कि यह कैसे काम करता है, यहां और यहां के प्रलेखन को पढ़ें , और इसे अपने लिए फिर से बनाएं। लेकिन यह दर्दनाक है, मेरी राय में, विवरण के लिए एक स्क्रिप्ट का असफल और जटिल उदाहरण चुना जाता है, जिसे मैंने सब कुछ करने के बाद पता लगाया। यद्यपि उपयोगकर्ता घटक, जहां काम करने के लिए इंटरफ़ेस में क्या क्लिक करना है, सवाल नहीं उठाता है।

तो, डेटा क्वेरी को तीन किस्मों द्वारा दर्शाया जाता है: एसएनएमपी डेटा प्राप्त करें , स्क्रिप्ट सर्वर डेटा प्राप्त करें , स्क्रिप्ट डेटा प्राप्त करें

एसएनएमपी डेटा प्राप्त करें केवल एक एक्सएमएल टेम्पलेट द्वारा दर्शाया जाता है जो एसएनएमपी प्रोटोकॉल का उपयोग करके कौन से पैरामीटर को निकालना है और कहां सेट करता है;
स्क्रिप्ट सर्वर डेटा प्राप्त करें और स्क्रिप्ट डेटा तरीके एक XML टेम्पलेट और उससे संबंधित स्क्रिप्ट द्वारा परिभाषित किए गए हैं। केवल स्क्रिप्ट स्क्रिप्ट डेटा प्राप्त करने के मामले में, निष्पादन की गति को सामान्य PHP प्रक्रिया का उपयोग करके अनुकूलित किया गया था, जिसे PHP के उपयोग की आवश्यकता होती है। Get Script Data सबसे सामान्य दृष्टिकोण है, इसके बाद हम केवल इस पर विचार करेंगे।

कैक्टि की तरफ से ऐसा दिखता है। स्क्रिप्ट पैरामीटर और तर्क जिन्हें प्रदर्शित करने की आवश्यकता होगी, XML टेम्पलेट से पढ़े जाते हैं। डेटा क्वेरीज़ को नोड से बाँधने के बाद, स्क्रिप्ट का अनुरोध किया जाएगा और सभी संभावित तत्वों (सूचकांकों) की एक सूची संग्रहीत की जाएगी जिसके लिए यह मान लौटाएगा। यदि डेटा बदलता है, तो आपको बाध्य विधि के लिए रीलोड डेटा क्वेरी इंटरफ़ेस से निष्पादित करके उन्हें फिर से पढ़ने की आवश्यकता है। अगले सर्वेक्षण के दौरान, एक ही स्क्रिप्ट को निर्दिष्ट सूचकांक और तर्क के लिए अनुरोधित डेटा वापस करना होगा। हर बार यह एक अलग स्क्रिप्ट कॉल होगा, सभी संग्रहीत अनुक्रमित और प्रत्येक प्रदर्शित तर्कों के लिए। उसके बाद, डेटा स्रोत को सहेजें और चार्ट पर ड्रा करें।

जिस कार्य को हल करने की आवश्यकता है, वह है कि नियंत्रित सर्वर से fping पोल के परिणामों को लेना, जहां दूरस्थ नोड, उदाहरण के लिए, ya.ru या habrahabr.ru , को एक पैरामीटर के रूप में निर्दिष्ट किया गया है। और उत्तर देरी और नुकसान के मूल्यों है। तदनुसार, प्रत्येक सर्वर से हम कई अन्य नोड्स को पिंग कर सकते हैं। नोड्स की सूची स्वचालित रूप से प्राप्त की जानी चाहिए।

सबसे पहले हम एक XML टेम्पलेट बनाएंगे

सामान्य विकल्प

name और description - यह क्या है और इसका क्या उद्देश्य है, ताकि भ्रमित न हों:

 <name>Get fping stats</name> <description>Remote monitoring fping statistics</description>

<script_path> - स्क्रिप्ट फ़ाइल में पूर्ण पथ, आप वैरिएबल का उपयोग कर सकते हैं |path_cacti| :

 <script_path>|path_cacti|/scripts/query-fping-stat.sh</script_path>

<arg_index> , <arg_num_indexes> , <arg_query> , <arg_get> - स्क्रिप्ट को दिए गए मापदंडों के मान, जो इसके संचालन मोड को निर्धारित करेगा और यह किस मूल्य पर वापस आएगा। केवल चार मोड, जटिल कुछ भी आविष्कार नहीं करते हैं:

 <arg_index>index</arg_index> <arg_num_indexes>num_indexes</arg_num_indexes> <arg_query>query</arg_query> <arg_get>get</arg_get>

<arg_prepend> - पहले स्क्रिप्ट की कमांड लाइन पर पास होने वाले पैरामीटर। स्वचालित रूप से, स्क्रिप्ट को कोई अन्य पैरामीटर हस्तांतरित नहीं किया जाएगा, सिवाय उन लोगों के जो इसके संचालन मोड को निर्धारित करते हैं, अर्थात, हमें नहीं पता है कि हम किस सर्वर के लिए अपने कार्यों का प्रदर्शन कर रहे हैं। आवश्यक अतिरिक्त तर्क यहां परिभाषित किए गए हैं। इसे चर का उपयोग करने की भी अनुमति है:

 <arg_prepend>|host_hostname|</arg_prepend>

<output_delimeter> रिटर्न वैल्यू में सीमांकक वर्ण है। कुछ भी नहीं फैंसी, या तो - एक बृहदान्त्र का उपयोग करें:

 <output_delimeter>:</output_delimeter>

यह हमारे लिए पर्याप्त है, बहुत सारे विकल्प नहीं हैं, यही है ।

डेटा फ़ील्ड

यहां हम वर्णन करते हैं कि आउटपुट पर क्या डेटा प्राप्त किया जाना चाहिए। मान दो प्रकार के इनपुट और आउटपुट में विभाजित हैं।

इनपुट प्रकार ऑपरेशन के क्वेरी मोड के साथ जुड़ा हुआ है और किसी विशेष सूचकांक को चिह्नित करने वाले मानों को वापस करना चाहिए। उदाहरण के लिए, नेटवर्क इंटरफ़ेस के लिए: हस्ताक्षर, भौतिक पता, प्रकार - वह सब जो समय के साथ नहीं बदलेगा। इस प्रकार प्राप्त डेटा को डेटा स्रोत को प्रेषित किया जाएगा जो बदले में इसे वांछित सूचकांक के साथ जोड़ देगा। कम से कम एक इनपुट तत्व आवश्यक होना चाहिए, क्योंकि यह वह है जो डेटा स्रोत के साथ जुड़ा हुआ है।

इसके अलावा, वैरिएबल |query__| जिसका उपयोग ग्राफ़ के हस्ताक्षर में किया जा सकता है और उनके मूल्यों को तत्वों की सामान्य सूची में प्रदर्शित किया जाएगा, जब इस होस्ट के लिए अलग-अलग कॉलम के रूप में ग्राफ़ बनाएँ ।

आउटपुट प्रकार - फ़ील्ड, जिसका डेटा ग्राफ़ पर बनाया जाएगा।

फ़ील्ड को बहुत ही सरलता से परिभाषित किया गया है:

name - name, query_name - वह मान जो स्क्रिप्ट और direction - इनपुट या आउटपुट टाइप करें।

हमारे पास एक इनपुट फ़ील्ड है जो नोड का नाम देता है। जो वैरिएबल बनाया जाएगा |query_host| :

 <host> <name>host</name> <direction>input</direction> <query_name>host</query_name> </host>

और चार आउटपुट फ़ील्ड, अधिकतम, न्यूनतम, औसत प्रतिक्रिया देरी और पैकेट हानि प्रतिशत:

 <avg> <name>avg</name> <direction>output</direction> <query_name>avg</query_name> </avg> <max> <name>max</name> <direction>output</direction> <query_name>max</query_name> </max> <min> <name>min</name> <direction>output</direction> <query_name>min</query_name> </min> <loss> <name>loss</name> <direction>output</direction> <query_name>loss</query_name> </loss>

XML टेम्पलेट पूरी तरह से

 <interface> <name>Get fping stats</name> <description>Remote monitoring fping statistics</description> <script_path>|path_cacti|/scripts/query-fping-stat.sh</script_path> <arg_index>index</arg_index> <arg_query>query</arg_query> <arg_get>get</arg_get> <arg_num_indexes>num_indexes</arg_num_indexes> <arg_prepend>|host_hostname|</arg_prepend> <output_delimeter>:</output_delimeter> <fields> <host> <name>host</name> <direction>input</direction> <query_name>host</query_name> </host> <avg> <name>avg</name> <direction>output</direction> <query_name>avg</query_name> </avg> <max> <name>max</name> <direction>output</direction> <query_name>max</query_name> </max> <min> <name>min</name> <direction>output</direction> <query_name>min</query_name> </min> <loss> <name>loss</name> <direction>output</direction> <query_name>loss</query_name> </loss> </fields> </interface>

लिपि

टेम्प्लेट ने हमें पहले से ही सब कुछ वर्णित किया है जो आवश्यक है। ऑपरेशन के चार मोड हैं, और इसलिए चार कॉल मोड हैं।

सूची

<script_path> <arg_prepend> <arg_index>

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

 hosts="ya.ru habrahabr.ru" zabbix="/usr/local/bin/zabbix_get -s $1" case $2 in index) for host in $hosts; do echo $host; done ;; esac

Num_indexes

<script_path> <arg_prepend> <arg_num_indexes>

पहले मोड से सूचकांकों की संख्या:

 numhosts=`echo $hosts | wc -w` case $2 in num_indexes) echo $numhosts ;; esac

सवाल

<script_path> <arg_prepend> <arg_query> <query_name>

इनपुट के रूप में परिभाषित सभी डेटा फ़ील्ड के लिए निष्पादित। आउटपुट को प्रत्येक इंडेक्स और निर्दिष्ट डेटा फ़ील्ड के लिए index output_delimeter <> मिलना चाहिए, प्रत्येक एक नई लाइन के साथ। चूंकि टेम्पलेट में केवल एक मान परिभाषित किया गया है, और हमारे सूचकांक को पढ़ना आसान है, इसलिए हम इसे परिणाम के रूप में उपयोग करते हैं:

 case $2 in query) for host in $hosts do case $3 in host) echo $host:$host ;; esac done ;; esac

सभी सूचीबद्ध मोड नोड तत्वों की सूची बनाने के समय निष्पादित किए जाते हैं। प्रत्येक सूचकांक और प्रत्येक तर्क के लिए डेटा के अगले मतदान के दौरान अगली बार प्रत्येक मोड को कहा जाता है।

मिलना

<script_path> <arg_prepend> <arg_get> <query_name>
आउटपुट के रूप में परिभाषित सभी डेटा फ़ील्ड के लिए कहा जाता है। आउटपुट को निर्दिष्ट फ़ील्ड और इंडेक्स के लिए <> मिलना चाहिए। डेटा इनपुट की तुलना में सरल क्या है, जहां प्रारूपित स्ट्रिंग में मानों को आउटपुट करना आवश्यक है, यहां सब कुछ पहले से ही टेम्पलेट में परिभाषित किया गया है:
 zabbix="/usr/local/bin/zabbix_get -s $1" get_ping () { res=`$zabbix -k ping[$1,$2]` if [ -z $res ] then res=-1 fi echo $res } case $2 in get) echo $(get_ping $4 $3) ;; esac 
पूरा कोड
 #!/bin/sh hosts="ya.ru habrahabr.ru" numhosts=`echo $hosts | wc -w` zabbix="/usr/local/bin/zabbix_get -s $1" get_ping () { res=`$zabbix -k ping[$1,$2]` if [ -z $res ] then res=-1 fi echo $res } case $2 in index) for host in $hosts; do echo $host; done ;; num_indexes) echo $numhosts ;; query) for host in $hosts do case $3 in host) echo $host:$host ;; esac done ;; get) echo $(get_ping $4 $3) ;; esac exit 0 
यह जाँच करने के लिए बना हुआ है - हम डेटा क्वेरी बनाते हैं , इसे नोड में बाँधते हैं और वर्बोज़ क्वेरी के डिबगिंग रन करते हैं।

त्रुटि मुक्त टेम्पलेट:
 + Found data query XML file at '/usr/local/cacti/resource/script_queries/fping-stat.xml' + XML file parsed ok. 
Num_indexes मोड, तत्वों की संख्या:
 + Executing script for num of indexes '/usr/local/cacti/scripts/query-fping-stat.sh server num_indexes' + Found number of indexes: 2 
सूचकांक मोड, सभी तत्वों की सूची:
 + Executing script for list of indexes '/usr/local/cacti/scripts/query-fping-stat.sh server index' Index Count: 2 + Found index: ya.ru + Found index: habrahabr.ru 
क्वेरी मोड, सभी तत्वों के लिए सभी तर्कों के आउटपुट मान:
 + Executing script query '/usr/local/cacti/scripts/query-fping-stat.sh server query host' + Found item [host='ya.ru'] index: ya.ru + Found item [host='habrahabr.ru'] index: habrahabr.ru 
यदि सब कुछ काम करता है, तो हम हमेशा कैक्टि में ही करते हैं, डेटा टेम्पलेट, चार्ट टेम्पलेट बनाते हैं । हम एक साथ बांधते हैं , इसे सीधे डेटा क्वेरी में किया जाना चाहिए। उसके बाद, हमें इस Host के लिए Create Graphs का उपयोग करते समय स्वचालित रूप से उपलब्ध विकल्पों की एक सूची प्राप्त करनी चाहिए।

अब हम एक ग्राफ बनाते हैं, जिसके बाद प्रत्येक इनपुट तर्क, प्रत्येक सूचकांक और प्रत्येक नोड के लिए स्क्रिप्ट में कॉल को पोलर में जोड़ा जाता है। पोलर कैश को देखने पर , आप देख सकते हैं, जिसमें स्क्रिप्ट शामिल है और किन मापदंडों के साथ:
 Script: /usr/local/cacti/scripts/query-fping-stat.sh server get avg ya.ru 
इसका मतलब है कि आप नए शेड्यूल के लगभग स्वचालित जोड़ का आनंद ले सकते हैं, और सिस्टम व्यवस्थापक अधिक महत्वपूर्ण कार्य करना जारी रख सकते हैं।

PS क्या आपने तय किया था कि क्या टूट गया था?
जब पाठ पूरी तरह से तैयार था, तो ग्राफ को देखते हुए, मैंने महसूस किया कि पिछले साल के सुंदर संस्करण भी समस्या को ठीक नहीं करते हैं। कई अन्य ग्राफ़ पर जो मानक डेटा क्वेरी स्क्रिप्ट का उपयोग करते हैं, वर्णित समाधान के दोहराए जाने के कुछ समय बाद, दिन में कई बार डेटा हटाने और प्रदर्शन नहीं होता है। शायद उपयोग की गई अवसंरचना, या कॉन्फ़िगरेशन त्रुटियों की एक विशेषता। किसी भी मामले में, यह डेटा क्वेरी की सुविधा को नकारता नहीं है, लेकिन इसका कारण ...: "हम खोज करेंगे" (c)

कैक्टि डेटा क्वेश्चन