जटिल अलर्ट के साथ आसान काम। या Balerter के निर्माण का इतिहास

हर किसी को अलर्ट पसंद होते हैं.

निःसंदेह, जब कुछ घटित हो गया हो (या ठीक कर लिया गया हो) तो सूचित किया जाना बेहतर है बजाय इसके कि बैठ कर ग्राफ़ देखें और विसंगतियों को देखें।

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

हमने, अपनी कंपनी में, तब तक अलग-अलग समाधानों का उपयोग किया जब तक कि हमें जटिलता, या, बल्कि, जटिल, समग्र अलर्ट बनाने की असंभवता का सामना नहीं करना पड़ा। हम जो चाहते थे और हमने जो किया वह कटौती से नीचे है। टीएलडीआर: इस तरह ओपन सोर्स प्रोजेक्ट सामने आया Balerter

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

मान लीजिए कि एक निश्चित चार्ट में XX% की गिरावट/वृद्धि हुई है और एम घंटे की पिछली अवधि की तुलना में एन मिनट तक रहा है? ऐसा लगता है कि आप इसे ग्राफाना या अलर्टमैनेजर के साथ लागू करने का प्रयास कर सकते हैं, लेकिन यह बिल्कुल आसान नहीं है। (या शायद यह संभव नहीं है, मैं अभी नहीं कहूंगा)

चीजें तब और भी जटिल हो जाती हैं जब विभिन्न स्रोतों से प्राप्त डेटा के आधार पर सतर्क निर्णय लिया जाना चाहिए। जीवंत उदाहरण:

हम दो क्लिकहाउस डेटाबेस से डेटा की जांच करते हैं, फिर इसकी तुलना पोस्टग्रेज के कुछ डेटा से करते हैं, और अलर्ट पर निर्णय लेते हैं। संकेत दें या रद्द करें

हमने अपने निर्णय के बारे में सोचने के लिए ऐसी ही बहुत सारी इच्छाएँ जमा कर ली हैं। और फिर हमने इस सेवा की आवश्यकताओं/क्षमताओं की पहली सूची संकलित करने का प्रयास किया, जो अभी तक नहीं बनाई गई है।

• विभिन्न डेटा स्रोतों तक पहुंचें। उदाहरण के लिए, प्रोमेथियस, क्लिकहाउस, पोस्टग्रेज

• विभिन्न चैनलों - टेलीग्राम, स्लैक, आदि को अलर्ट भेजें।

• सोचने की प्रक्रिया में, यह स्पष्ट हो गया कि मुझे घोषणात्मक विवरण नहीं, बल्कि स्क्रिप्ट लिखने की क्षमता चाहिए थी

• एक शेड्यूल पर स्क्रिप्ट चलाना

• सेवा को पुनरारंभ किए बिना स्क्रिप्ट का आसान अद्यतन

• स्रोत कोड से सेवा का पुनर्निर्माण किए बिना किसी तरह कार्यक्षमता का विस्तार करने की क्षमता

यह सूची अनुमानित है और संभवतः बहुत सटीक नहीं है। कुछ बिंदु बदल गये, कुछ ख़त्म हो गये। सब कुछ हमेशा की तरह है.

दरअसल, इस तरह से बैलरटर का इतिहास शुरू हुआ।

मैं संक्षेप में यह बताने का प्रयास करूँगा कि आख़िर में क्या हुआ और यह कैसे काम करता है। (हां, बिल्कुल, यह अंत नहीं है। उत्पाद विकास के लिए कई योजनाएं हैं। मैं बस आज ही रुकूंगा)

यह कैसे काम करता है?

आप लुआ में एक स्क्रिप्ट लिखते हैं जहां आप स्पष्ट रूप से अनुरोध भेजते हैं (प्रोमेथियस, क्लिकहाउस, आदि को)। आप उत्तर प्राप्त करते हैं और किसी तरह उन्हें संसाधित करते हैं और उनकी तुलना करते हैं। फिर किसी प्रकार का अलर्ट चालू/बंद करें। Balerter स्वयं उन चैनलों को एक सूचना भेजेगा जिन्हें आपने कॉन्फ़िगर किया है (ईमेल, टेलीग्राम, स्लैक, आदि)। स्क्रिप्ट को निर्दिष्ट अंतराल पर निष्पादित किया जाता है। और... सामान्य तौर पर, बस इतना ही)

एक उदाहरण के साथ दिखाना सर्वोत्तम है:

-- @interval 10s
-- @name script1

local minRequestsRPS = 100

local log = require("log")
local ch1 = require("datasource.clickhouse.ch1")

local res, err = ch1.query("SELECT sum(requests) AS rps FROM some_table WHERE date = now()")
if err ~= nil then
    log.error("clickhouse 'ch1' query error: " .. err)
    return
end

local resultRPS = res[1].rps

if resultRPS < minResultRPS then
    alert.error("rps-min-limit", "Requests RPS are very small: " .. tostring(resultRPS))
else
    alert.success("rps-min-limit", "Requests RPS ok")
end 

यहाँ क्या चल रहा है:

• हम इंगित करते हैं कि इस स्क्रिप्ट को हर 10 सेकंड में निष्पादित किया जाना चाहिए

• स्क्रिप्ट का नाम बताएं (एपीआई के लिए, लॉग में प्रदर्शित करने के लिए, परीक्षणों में उपयोग के लिए)

• आउटपुट लॉग के लिए मॉड्यूल कनेक्ट करें

• नाम के साथ क्लिकहाउस तक पहुंचने के लिए एक मॉड्यूल कनेक्ट करें ch1 (कनेक्शन स्वयं कॉन्फ़िगरेशन में कॉन्फ़िगर किया गया है)

• क्लिकहाउस को एक अनुरोध भेजें

• किसी त्रुटि की स्थिति में, हम लॉग में एक संदेश प्रदर्शित करते हैं और बाहर निकल जाते हैं

• क्वेरी परिणाम की तुलना एक स्थिरांक से करें (एक जीवंत उदाहरण में, हम यह मान प्राप्त कर सकते हैं, उदाहरण के लिए, पोस्टग्रेज डेटाबेस से)

• आईडी के साथ अलर्ट सक्षम या अक्षम करें rps-min-limit

• यदि चेतावनी स्थिति बदल गई है तो आपको एक सूचना प्राप्त होगी

उदाहरण काफी सरल और समझने योग्य है. हालाँकि, निस्संदेह, वास्तविक जीवन में स्क्रिप्ट काफी लंबी और जटिल हो सकती हैं। भ्रमित होना और गलतियाँ करना आसान है।

इसलिए, एक तार्किक इच्छा परिपक्व हो गई है - अपनी स्क्रिप्ट के लिए परीक्षण लिखने में सक्षम होने की। और संस्करण v0.4.0 में यह दिखाई दिया।

परीक्षण स्क्रिप्ट

उपरोक्त उदाहरण से हमारी स्क्रिप्ट के लिए उदाहरण परीक्षण:

-- @test script1
-- @name script1-test

test = require('test')

local resp = {
    {
        rps = 10
    }
} 

test.datasource('clickhouse.ch1').on('query', 'SELECT sum(requests) AS rps FROM some_table WHERE date = now()').response(resp)

test.alert().assertCalled('error', 'rps-min-limit', 'Requests RPS are very small: 10')
test.alert().assertNotCalled('success', 'rps-min-limit', 'Requests RPS ok')

क्रमशः:

• उस स्क्रिप्ट का नाम बताएं जिसके लिए परीक्षण लिखा गया है

• परीक्षण का नाम (लॉग के लिए)

• परीक्षण मॉड्यूल कनेक्ट करें

• हम कहते हैं कि क्लिकहाउस को किसी विशिष्ट अनुरोध के लिए क्या परिणाम लौटाया जाना चाहिए ch1

• हम जांचते हैं कि निर्दिष्ट संदेश के साथ अलर्ट (त्रुटि) आरपीएस-मिन-लिमिट को कॉल किया गया था

• जांचें कि आरपीएस-मिन-लिमिट अलर्ट अक्षम नहीं किया गया था (सफलता)

Balerter और क्या कर सकता है?

मैं, मेरी राय में, सबसे महत्वपूर्ण, बैलेटर कौशल को छूने की कोशिश करूंगा। आप आधिकारिक वेबसाइट पर सब कुछ विस्तार से देख सकते हैं https://balerter.com

• से डेटा प्राप्त करें

  • क्लिकहाउस

  • postgres

  • MySQL

  • प्रोमेथियस

  • लोकी

• चैनलों को सूचनाएं भेजें

  • ढीला

  • तार

  • syslog

  • सूचित करें (आपके कंप्यूटर पर यूआई सूचनाएं)

  • ईमेल

  • कलह

• अपने डेटा के आधार पर ग्राफ़ बनाएं, छवि को S3 संगत स्टोरेज पर अपलोड करें और इसे सूचनाओं के साथ संलग्न करें (चित्रों सहित उदाहरण)

• आपको स्क्रिप्ट के बीच डेटा का आदान-प्रदान करने की अनुमति देता है - वैश्विक कुंजी/मूल्य भंडारण

• लुआ में अपनी खुद की लाइब्रेरी लिखें और उन्हें स्क्रिप्ट में उपयोग करें (डिफ़ॉल्ट रूप से, लुआ लाइब्रेरी को json, csv के साथ काम करने के लिए आपूर्ति की जाती है)

• अपनी स्क्रिप्ट से HTTP अनुरोध भेजें (और निश्चित रूप से प्रतिक्रियाएँ प्राप्त करें)

• एक एपीआई प्रदान करता है (अभी तक उतना कार्यात्मक नहीं है जितना हम चाहेंगे)

• प्रोमेथियस प्रारूप में मेट्रिक्स निर्यात करता है

आप और क्या करने में सक्षम होना चाहेंगे?

यह पहले से ही स्पष्ट है कि उपयोगकर्ता और हम सिंटैक्स का उपयोग करके स्क्रिप्ट के लॉन्च को नियंत्रित करने की क्षमता चाहते हैं क्रॉन. यह संस्करण v1.0.0 से पहले किया जाएगा

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

किसी न किसी को हमेशा कुछ न कुछ याद आ रहा है) यहां हम प्राथमिकताओं को सही ढंग से निर्धारित करने के लिए समुदाय के अनुरोध पर भरोसा करते हैं। और हर चीज़ को साकार करने में समुदाय की मदद करना

अंत में

हम प्रयोग करते हैं Balerter यह मेरे पास काफी समय से है। दर्जनों स्क्रिप्ट हमारे मन की शांति की रक्षा करती हैं। मुझे आशा है कि यह कार्य किसी और के लिए उपयोगी होगा।

और आपके अंक और पीआर के साथ आपका स्वागत है।

स्रोत: www.habr.com