🥇आधा घण्टामा वेब सेवाहरू निगरानी गर्ने बोट: टेलिग्राम + ब्याश + क्रोन

आधा घण्टामा वेब सेवाहरू अनुगमनको लागि बोट: टेलिग्राम + बास + क्रोन

कहिलेकाहीँ तपाईले नयाँ सेवाको लागि तुरुन्तै अनुगमन गर्न आवश्यक छ, तर त्यहाँ कुनै तयार पूर्वाधार/विज्ञता हातमा छैन। यस गाइडमा, आधा घण्टामा हामी कुनै पनि वेब सेवाहरू अनुगमन गर्नका लागि एउटा उपकरण लागू गर्नेछौं, केवल उबुन्टुको निर्मित उपकरणहरू प्रयोग गरेर: bash, cron र curl। हामी अलर्टहरू डेलिभर गर्न टेलिग्राम प्रयोग गर्नेछौं।

"चेरी अन द केक" प्रयोगकर्ताहरूको भावनात्मक संलग्नता हुनेछ। मानिसहरू मा परीक्षण - यो काम गर्दछ।

जब हामी टेलिमेडिसिन सेवामा डाक्टर नेयरबीले प्रयोगकर्ताहरूको तनाव स्तर निर्धारण गर्न च्याटबट सिर्जना गर्‍यो, हामीलाई निगरानीको आवश्यकता पर्‍यो। केही घण्टामा, एउटा मिनी-प्रोजेक्ट सिर्जना गरियो जसले उत्कृष्ट काम मात्र गर्दैन, तर यसको सन्देशहरूसँग सकारात्मकता पनि थप्छ।

पहिले, स्क्रिप्टको साथ भण्डार प्राप्त गरौं:

git clone https://github.com/rshekhovtsov/msms.git

msms फोल्डरमा जानुहोस् र त्यसपछि यसमा काम गर्नुहोस्।

यदि टेलिग्राम अवरुद्ध छ भने, प्रोक्सी प्रयोग गर्नुहोस्। सरल र सबैभन्दा भरपर्दो विकल्प torsocks छ:

sudo apt install tor
sudo apt install torsocks

उदाहरणको रूपमा, तीन चरणहरूमा google.com सुरु पृष्ठको निगरानी सेट अप गरौं।

चरण 1. टेलिग्राममा बोट सिर्जना गर्नुहोस् र प्रयोगकर्ता आईडी प्राप्त गर्नुहोस्

टेलिग्राममा सम्पर्कहरूको खोजी पट्टीमा हामी खोज्छौं @botfather:
हामीले यसलाई स्टार्ट बटनको साथ सुरु गर्छौं, /newbot आदेश प्रविष्ट गर्नुहोस् र प्रश्नहरूको जवाफ दिनुहोस्। तपाईले दिमागमा राख्नु पर्छ कि नाम बोटको नाम हो जुन प्रयोगकर्ताहरूलाई देखाइनेछ, र प्रयोगकर्ता नाम अद्वितीय छ र "बोट" बाट अन्त्य हुनुपर्छ:

अन्य चीजहरू मध्ये, बोटले HTTP API को लागि एक गोप्य टोकन जारी गर्नेछ, जुन प्रतिलिपि गरेर msms फोल्डरमा telegram-api-key.txt फाइलमा बचत गर्नुपर्छ।
हामी टेलिग्राम खोज पट्टीमा हाम्रो बोटको नाम टाइप गर्छौं र यसलाई सुरु गर्छौं।
अन्तिम स्पर्शको रूपमा, अनुगमन अलर्ट प्राप्तकर्ताहरूको सूचीमा आफूलाई थपौं:
```
sudo chmod +x ./recipients-setup.sh
torsocks ./recipients-setup.sh
```
स्क्रिप्टले बोटमा हालैका कलहरूको सूची प्रदर्शन गर्नेछ; टेलिग्राममा हाम्रो आईडी र नामको साथ एउटा लाइन हुनुपर्छ। हामी यो आईडी लिन्छौं र फाइल services/google-recipients.txt मा बचत गर्छौं। फाइल ढाँचा: प्रत्येक लाइन एक आईडी हो। उदाहरण:
```
123456789
987654321
```

नयाँ प्रापक थप्नको लागि, तपाईंले उसलाई टेलिग्राममा बट सुरु गर्न, recipients-setup.sh चलाउन र फाइलमा आईडी थप्न सोध्नु पर्छ।

चरण 2. अनुगमन सेटअप गर्नुहोस्

सेवा फोल्डरमा ini फाइल सिर्जना गरेर सेवा वर्णन गरिएको छ। तपाईंले पाँच प्यारामिटरहरू सेट गर्न आवश्यक छ:

MSMS_SERVICE_NAME: सेवा नाम - अलर्ट र निगरानी लग मा प्रयोग गरिनेछ।
MSMS_SERVICE_ENDPOINT: सेवाको अन्तिम बिन्दु जसमा हामी कर्लसँग सम्पर्क गर्नेछौं।
MSMS_CURL_PARAMS: अतिरिक्त कर्ल विकल्पहरू, तलको उदाहरण हेर्नुहोस्।
MSMS_EXPECTED: सेवाबाट अपेक्षित प्रतिक्रिया। उत्तर छोटो छ भने प्रयोग गरिन्छ।
MSMS_EXPECTED_FILE: अपेक्षित सेवा प्रतिक्रियाको साथ फाइल नाम। यदि निर्दिष्ट गरिएको छ भने, MSMS_EXPECTED अधिलेखन गर्दछ।
MSMS_RECIPIENTS: सूचना प्राप्तकर्ताहरूको सूचीको साथ फाइल।

google.com को अनुरोधले रिडिरेक्टको साथ निश्चित html फर्काउँछ, हामी यसलाई अपेक्षित सर्भर प्रतिक्रियाको रूपमा प्रयोग गर्नेछौं:

curl google.com > services/google-response.html

services/google.ini फाइल सिर्जना गरौं:

MSMS_SERVICE_NAME='google front page'

# service endpoint
MSMS_SERVICE_ENDPOINT='google.com'

# curl parameters
MSMS_CURL_PARAMS='-s --connect-timeout 3 -m 7'

# expected service response
MSMS_EXPECTED_FILE='google-response.html'

# recipients list file
MSMS_RECIPIENTS='google-recipients.txt'

В MSMS_CURL_PARAMS तपाइँ कर्लले गर्न सक्ने सबै कुरा सेट गर्न सक्नुहुन्छ, सहित:

कन्सोल र लग अव्यवस्थित हुनबाट जोगिन कर्ल सन्देशहरू असक्षम गर्नुहोस्: -s
सेवा जाँच गरिँदै जडानको समयावधि सेट गर्नुहोस् (सेकेन्डमा): --connect-timeout 3
प्रतिक्रिया टाइमआउट सेट गर्नुहोस्: -m 7
SSL का लागि प्रमाणपत्र प्रमाणिकरण असक्षम गर्नुहोस् (उदाहरणका लागि, यदि तपाइँ स्व-हस्ताक्षरित प्रमाणपत्र प्रयोग गर्दै हुनुहुन्छ): --insecure
http अनुरोध प्रकार निर्दिष्ट गर्नुहोस्: -X POST
शीर्षक निर्दिष्ट गर्नुहोस्: -H "Content-Type: application/json"
स्ट्रिङ वा फाइलको रूपमा अनुरोधको मुख्य भाग निर्दिष्ट गर्नुहोस्। फाइलको लागि उदाहरण: -d @request.json

हामीले सूचनाहरू असक्षम पार्यौं र 3 सेकेन्डमा टाइमआउट सेट गर्यौं। जडान गर्न र 7 सेकेन्ड। सेवा प्रतिक्रिया प्राप्त गर्न।

सावधानी: उदाहरणमा जस्तै, एकल उद्धरणहरूमा प्यारामिटर मानहरू निर्दिष्ट गर्नुहोस्। दुर्भाग्यवश, bash यस अर्थमा एकदम नाजुक छ, र गलत उद्धरण चिन्हको साथ एक आकस्मिक पुतलीले ब्रह्माण्डको मृत्यु हुन सक्छ निदान गर्न गाह्रो त्रुटिहरूको साथ।

हामीले अनुगमनको व्यवस्था गरेका छौं । सबै ठीक छ भनेर जाँच गरौं:

sudo chmod +x ./monitoring.sh
torsocks ./monitoring.sh

स्क्रिप्टले सन्देश जस्तै प्रदर्शन गर्नुपर्छ:

2020-01-10 12:14:31
health-check "google front page": OK

चरण 3. तालिका सेट अप गर्दै

क्रोनमा अनुगमन तालिका सेट अप गरौं:

sudo crontab -e

प्रत्येक मिनेट google.com जाँच गर्न एउटा लाइन थपौं:

*/1 * * * * torsocks <ПУТЬ К ПАПКЕ РЕПОЗИТОРИЯ>/monitoring.sh >> <ПУТЬ К ПАПКЕ РЕПОЗИТОРИЯ>/monitoring.log 2>&1

हामी हरेक दिन 11.00:XNUMX बजे एक अलर्ट थप्नेछौं, अनुगमनको कार्यक्षमता पुष्टि गर्दै। यो गर्नको लागि, हामी स्क्रिप्टमा DAILY प्यारामिटर पास गर्नेछौं:

0 11 * * * torsocks <ПУТЬ К ПАПКЕ РЕПОЗИТОРИЯ>/monitoring.sh DAILY >> <ПУТЬ К ПАПКЕ РЕПОЗИТОРИЯ>/monitoring.log 2>&1

2>&1 - एक मानक प्रविधि जसले त्रुटिहरूलाई मुख्य आउटपुट स्ट्रिममा रिडिरेक्ट गर्छ। फलस्वरूप, तिनीहरू पनि निगरानी लग मा समाप्त हुनेछ।

परिवर्तनहरू बचत गरौं र तिनीहरूलाई आदेशको साथ उठाउनुहोस्:

 sudo service cron reload

तपाईं क्रोन सेटअप गर्ने बारे थप पढ्न सक्नुहुन्छ, उदाहरणका लागि, यहाँ.

यसरी, प्रत्येक मिनेटमा एक निगरानी स्क्रिप्ट सुरु हुनेछ, जसले कर्ल मार्फत google.com लाई सम्पर्क गर्नेछ। यदि प्राप्त प्रतिक्रिया अपेक्षित भन्दा फरक छ भने, स्क्रिप्टले प्राप्तकर्ताहरूको सूचीमा टेलिग्राम सूचना पठाउनेछ। अडिट लग फाइल Moniting.log मा राखिएको छ

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

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

अब थप सुविधाहरू र स्क्रिप्टहरूको कार्यान्वयनलाई नजिकबाट हेरौं।

सन्देश ढाँचा र भावनात्मक संलग्नता

बोटसँगको सञ्चारलाई अझ जीवन्त बनाउनको लागि, हामीले यसलाई Manechka नाम दियौं, उपयुक्त अवतार चित्र थप्यौं र सन्देश पाठहरू सिर्जना गर्न पेशेवर PR विशेषज्ञहरूलाई काममा राख्यौं। तपाईं हाम्रो अनुभव प्रयोग गर्न वा आफ्नो स्वाद परिवर्तन गर्न सक्नुहुन्छ।

उदाहरण को लागी, यो जस्तै:

आधा घण्टामा वेब सेवाहरू अनुगमनको लागि बोट: टेलिग्राम + बास + क्रोन
वा यो जस्तै:

आधा घण्टामा वेब सेवाहरू अनुगमनको लागि बोट: टेलिग्राम + बास + क्रोन
किन नगर्ने ?

बोट नाम र अवतार मार्फत सेट गरिएको छ @botfather.
सन्देश टेम्प्लेटहरू फोल्डरमा छन् टेम्प्लेट:

curl-fail.txt: कर्लले गैर-शून्य त्रुटि कोड फर्काउँदा सन्देश पठाइयो। सामान्यतया यो सेवा पुग्न असम्भव बारेमा कुरा गर्छ।
daily.txt: सेवा अनुगमन काम गरिरहेको पुष्टि गर्ने दैनिक सन्देश।
service-fail.txt: सेवा प्रतिक्रिया अपेक्षित भन्दा फरक हुँदा पठाइएको सन्देश।

उदाहरणको रूपमा निर्मित सन्देश टेम्प्लेटहरू प्रयोग गरेर अनुकूलन विकल्पहरू हेरौं।
टेम्प्लेटहरूले इमोजी प्रयोग गर्दछ। दुर्भाग्यवश, habr ले तिनीहरूलाई प्रदर्शन गर्दैन।
इमोजी चयन गर्न, यो खोजी प्रयोग गर्न सुविधाजनक छ emojipedia.org:

आधा घण्टामा वेब सेवाहरू अनुगमनको लागि बोट: टेलिग्राम + बास + क्रोन

तपाईले टेम्प्लेट पाठमा उपयुक्त प्रतीक प्रतिलिपि गरेर टाँस्नुहोस् (यो नियमित युनिकोड हो)।

curl-fail.txt:
```
Котёнок,  помоги мне... 
Не могу достучаться до сервиса "$MSMS_SERVICE_NAME" 
`CURL EXIT CODE: $EXIT_CODE`
```
हामीले निर्दिष्ट गरेको सेवा नाम प्रयोग गर्‍यो (चर MSMS_SERVICE_NAME) र कर्ल निकास कोड (EXIT_CODE)। हामीले मार्कअप प्रयोग गरेर सन्देश ढाँचा पनि गर्यौं टेलिग्राम मार्कडाउन: "`" अक्षरहरू निश्चित-चौडाइको पाठलाई घेर्छन्। चूंकि उद्धरणहरू र अपोस्ट्रोफहरू ब्याश प्रतीकहरू हुन्, हामी तिनीहरूलाई "" बाट बचाउँछौं। चर नामहरू अगाडि "$" चिन्ह लगाइन्छ।
परिणाम:
service-fail.txt:
```
Котёнок, помоги мне... 
Сервис "$MSMS_SERVICE_NAME" меня расстроил
Он работает неправильно, вот что он мне отвечает:
`$RESPONSE`
```
परिणाम:

यहाँ हामी अर्को स्क्रिप्ट चर प्रयोग गर्छौं: RESPONSE। यसमा सेवा प्रतिक्रिया समावेश छ।

daily.txt:

Малыш, привет!
У меня всё хорошо, cлежу за сервисом:
"$MSMS_SERVICE_NAME" каждую минутку...
А как у тебя дела?

परिणाम:

आधा घण्टामा वेब सेवाहरू अनुगमनको लागि बोट: टेलिग्राम + बास + क्रोन

लिपिहरूको कार्यान्वयनमा जाऔं।

अनुगमन लिपि

Monitoring.sh एक साधारण स्वत: खोज गर्दछ - यसले सेवा फोल्डरबाट सबै ini फाइलहरू लिन्छ र प्रत्येकको लागि जाँच र अलर्टहरू पठाउनको लागि तर्कको साथ मुख्य स्क्रिप्ट कार्यान्वयन गर्दछ:

#!/bin/bash
cd $(dirname "$0")/services

for service_ini  in $(ls *.ini); do
    bash ../msms.sh "$1" "$service_ini"
done

अनुगमन स्थिति बारे दैनिक सन्देश उत्पन्न गर्न, तपाइँ स्क्रिप्टमा दैनिक प्यारामिटर पास गर्न सक्नुहुन्छ।

कृपया नोट गर्नुहोस् कि जब स्क्रिप्ट सुरु हुन्छ, हालको फोल्डर सेवाहरूमा परिवर्तन हुन्छ। यसले तपाइँलाई ini फाइलहरूमा सेवाहरूसँग सम्बन्धित फाइल मार्गहरू निर्दिष्ट गर्न अनुमति दिन्छ।

सूचनाहरू जाँच गर्न र पठाउनको लागि लिपि

msms.sh सेवा जाँच गर्न र अलर्टहरू पठाउनको लागि मुख्य तर्क समावेश गर्दछ।

टेलिग्रामसँग काम गर्दै:

# telegram endpoint
TG_API_URL="https://api.telegram.org/bot$(cat ../telegram-api-key.txt)/sendMessage"

#################################################################
# send message to telegram
# parameter: message text
#################################################################
function send_message {
    for chat_id  in $(cat ../$MSMS_RECIPIENTS); do
	curl -s -X POST --connect-timeout 10 $TG_API_URL -d chat_id=$chat_id -d parse_mode="Markdown" -d text="$1"
	echo
    done
}

हामीले फाइलमा सुरक्षित गरिएको गोप्य कुञ्जी प्रयोग गरेर टेलिग्राम REST API पहुँच गर्न URL उत्पन्न गर्छौं।

send_message प्रकार्यले यो REST API मा सन्देशहरू पठाउन कर्ल प्रयोग गर्दछ, हामीले ini मा निर्दिष्ट गरेको फाइलबाट प्रापक आईडीहरू लिएर। हामीले पठाउने डेटामा, हामी सन्देश मार्कअप प्रयोग गर्छौं भनेर संकेत गर्छौं: parse_mode="Markdown".

हालको मिति र समय देखाउनुहोस् र ini फाइल लोड गर्नुहोस्।

echo $(date '+%Y-%m-%d %H:%M:%S')

# load variables from .ini file:
. $2

जादुई तार . $2 नियमित स्क्रिप्टको रूपमा दोस्रो प्यारामिटरको रूपमा इनपुटमा पास गरिएको ini फाइललाई कार्यान्वयन गर्दछ, यसमा निर्दिष्ट मानहरूलाई वातावरण चरहरूमा प्रविष्ट गर्दछ।

यदि प्यारामिटर निर्दिष्ट गरिएको छ भने फाइलबाट अपेक्षित प्रतिक्रिया लोड गर्नुहोस् MSMS_EXPECTED_FILE:

if [ -n "$MSMS_EXPECTED_FILE" ]; then
 MSMS_EXPECTED="$(cat "$MSMS_EXPECTED_FILE")"
fi

हामी सेवा जाँच गर्नेछौं र आवश्यक भएमा अलर्टहरू पठाउनेछौं:

RESPONSE="$(eval curl $MSMS_CURL_PARAMS "$MSMS_SERVICE_ENDPOINT")"
EXIT_CODE=$?
if [[ $EXIT_CODE != 0 ]]; then
    echo health-check "$MSMS_SERVICE_NAME" FAILED: CURL EXIT WITH $EXIT_CODE
    MESSAGE="$(cat ../templates/curl-fail.txt)"
    MESSAGE=$(eval echo $MESSAGE)
    send_message "$MESSAGE"
elif [[ "$RESPONSE" != "$MSMS_EXPECTED" ]]; then
    echo health-check "$MSMS_SERVICE_NAME" FAILED: "$RESPONSE"
    MESSAGE="$(cat ../templates/service-fail.txt)"
    MESSAGE=$(eval echo $MESSAGE)
    send_message "$MESSAGE"
else
    echo health-check "$MSMS_SERVICE_NAME": OK
fi

पहिले हामी चरमा असाइन गर्छौं RESPONSE यो सेवाको लागि कर्ल आदेश कार्यान्वयनको परिणाम।

Выражение EXIT_CODE=$? अन्तिम आदेशको नतिजालाई चरमा राख्छ, अर्थात् घुमाउरो। यदि अलर्ट पठाउन आवश्यक छ भने, टेम्प्लेट सम्बन्धित फाइलबाट पढिन्छ र प्राप्तकर्ताहरूलाई पठाइन्छ send_message.

अन्तिम ब्लकले DAILY प्यारामिटरलाई प्रशोधन गर्छ:

if test "$1" = "DAILY"; then
    echo health-check "$MSMS_SERVICE_NAME" DAILY
    MESSAGE="$(cat ../templates/daily.txt)"
    MESSAGE=$(eval echo $MESSAGE)
    send_message "$MESSAGE"
fi

यसले अनुगमनको कार्यक्षमता पुष्टि गर्ने सन्देश पठाउँछ।

प्रयोगकर्ता आईडीहरूको सूची प्राप्त गर्दै

प्राप्तकर्ताहरू-setup.sh बोटलाई सम्बोधन गरिएका नवीनतम सन्देशहरू प्राप्त गर्न टेलिग्राम API लाई कल गर्दछ:

curl -s https://api.telegram.org/bot$(cat telegram-api-key.txt)/getUpdates 
| python recipients-setup.py

यसले पाइथन जादूको प्रयोग गरी सूचीलाई सुन्दर रूपमा प्रदर्शन गर्छ। यो आवश्यक छैन, तपाईले केवल json बाट इच्छित आईडी लिन सक्नुहुन्छ, जुन आदेशले आउटपुट गर्नेछ:

torsocks curl -s https://api.telegram.org/bot$(cat telegram-api-key.txt)/getUpdates

निष्कर्षमा

तसर्थ, तपाईं तयार-निर्मित स्क्रिप्टहरू र सन्देश टेम्प्लेटहरू प्रयोग गर्न सक्नुहुन्छ, केवल निगरानी गरिएका सेवाहरू र अलर्टहरूको लागि सूचीहरू सेटअप गर्न सक्नुहुन्छ; तपाईं बोटको लागि नयाँ "व्यक्तित्व" सिर्जना गर्न सक्नुहुन्छ; वा तपाईंले प्रस्ताव गरेको कुराको आधारमा आफ्नै निर्णय लिन सक्नुहुन्छ।

थप विकासका लागि विकल्पहरूले बोटमा नै निगरानी कन्फिगर र व्यवस्थापन गर्ने सुझाव दिन्छ, तर यहाँ तपाईं पाइथन बिना गर्न सक्नुहुन्न। यदि कसैले मेरो अगाडि यो पाउँछ भने, तपाइँलाई पुल अनुरोध कहाँ पेश गर्ने थाहा छ :)

स्रोत: www.habr.com