Last Updated on 05/08/2024 by administrator
LibreNMS zasílání alertů Telegram
LibreNMS zasílání alertů na Telegram
Motivace:
Článek popisuje návod, jak nastavit v LibreNMS zasílání alertů na Telegram.
OS:
Implementace instalace byla prováděna na LibreNMS verze 24.7.0-39.
Implementace [1]:
Přihlásit se do LibreNMS přes prohlížeč a přejít do Alerts > Alerts Transports:
Kliknout na Create alert transport:
V kolonce Transport name zvolit libovolné jméno. Jako Transport type zvolit Telegram a povolit Default Alert na ON a kliknout na Save Transport:
Před zprovozněním je potřeba zajistit Token a Chat ID. To se provede tak, že nejdříve nutné se přihlásit přes Telegram Web. Do vyhledávajícího okna zadat @botfather a spustit.
Vytvoří se nabídka s příkazy:
1. Vytvořit nového chatbota pomocí /newbot.
2. Zvolit libovolné jméno chatbota, v tomto případě je to librenmsnet123
3. V posledním bodě je potřeba vytvořit jméno chatbota s koncovkou _bot, v tomto případě je to librenmsnet123_bot
Tímto se vytvoří Token, který se vloží do pole Token v Librenms, při vytváření nového Alert Transport
Do LibreNMS je pak potřeba zkopírovat celý Token:
Ve webovém telegramu vytvořit novou skupinu (New Group) kliknutím na modré tlačítko s tužkou:
Vložit zvolené jméno chatbota, což bylo v tomto případě librenmsnet123
A přidat tohoto chatbota kliknutím na modrou šipku:
Zvolit libovolné jméno skupiny, v tomto případě bylo zvoleno LibreNMS_alert a kliknout na modrou šipku:
Tímto se vytvořila nová skupina, do které se budou později zasílat Alerty z LibreNMS. Zkopírovat Chat ID číslo (včetně znaménka -)
A zkopírovat jej do Chat ID okna v LibreNMS. Tímto je nastavení pro zasílání alertů na Telegram hotový.
Pro otestování, zda zprávy do telegram skupiny chodí kliknout na oranžovou fajfku.
Takto nějak podobně by měla vypadat testovací zpráva z LibreNMS:
Nastavení, které alerty se budou zasílat:
Příklad: Bude vytvořen Alert pokud LibreNMS ztratí konektivitu s WEB SERVERem:
Přejít do rubriky Alerts > Alert Rules:
Je možné vytvořit své vlastní pravidlo, nicméně v mnoha případech je dostačující použít předdefinované rule, ty se vyberou kliknutím na Create rule from collection:
Kliknout Select první rule Device up/down:
Otevře se okno níže. V poli Match devices, groups and location list, byl vybrán WEB SERVER. V poli Transports pak Telegram. Nic dalšího není potřeba měnit.
Pozn. Pokud se pole Match devices, groups and location list nevyplní, aplikuje se Alert rule na všechna zařízení v LibreNMS.
Info k obrázku výše: V defaultním nastavení poli Max Alerts = 1 se při ztrátě konektivity zašle pouze 1 zpráva na telegram. Až pokud bude konektivita s WEB SERVERem navázána a zároveň je Recovery alerts na ON, přijde také notifikace na Telegram o obnovení.
V LibreNMS je standardně nastaven interval polleru na 5 min. Čili maximálně do 5 min by měla přijít notifikace o ztrátě konektivity na Telegram:
Pokud LibreNMS obnoví konektivitu s WEB SERVERem, přijde také upozornění:
Zdroj:
[1] https://www.youtube.com/watch?v=YmbH2Q_lwDA&ab_channel=NETVN82
