Košík
Košík

Integrace Microsoft Teams v pěti krocích

Co nás čeká?

Tento návod vás provede pěti základními kroky k propojení Zabbixu s Microsoft Teams. Naučíte se vytvořit příchozí webhook v Teams, nastavit media type v Zabbixu a přizpůsobit notifikace vašim potřebám. Krátce se zaměříme také na aktualizaci zastaralých webhooků, aby vaše notifikace do Teams fungovaly bez přerušení.

Upozorňujeme, že bezplatný plán Teams nepodporuje funkci MS Teams Workflow.

Pokud ve svém MS Teams vidíte hlášku: ‚Important: You must update your Webhook URL for this connection in order for your notifications to keep posting into Microsoft Teams.‚ tento návod vás provede novou možností integrace, která nahrazuje starou verzi konektoru za MS Teams Workflow.

Kontrola hlášky v MS Teams

Tato část je pouze pro uživatele Zabbixu, kteří již mají integraci s MS Teams nastavenou. Pokud ji nemáte, tento krok ignorujte a pokračujte na další.

  • Ověřte, zda v MS Teams vidíte hlášku: „Important: You must update your Webhook URL for this connection in order for your notifications to keep posting into Microsoft Teams.“
  • Tato hláška znamená, že je třeba aktualizovat webhook URL pro zachování funkčnosti notifikací.

Nastavení v MS Teams

  • Klikněte na menu v levé části obrazovky označené třemi tečkami.
  • Do vyhledávacího pole napište „Workflows“.
  • Ze seznamu vyberte oficiální verzi (poznáte ji podle obrázku) a klikněte na tlačítko „Add“.
  • V levé části se nám v menu objeví nové tlačítko s názvem „Workflows“ a klikneme na něj.
  • V okně Workflows klikneme na „+ New flow“.
  • V okně Workflows klikneme na vyhledávání a zadáme: „Post a channel when a webhook request is received“.
  • Ve výsledcích vyhledávání klikneme na první výsledek, který není svázán s žádným uživatelem, jak je zobrazeno na obrázku.
  • V nově otevřeném pop-up okně zadáme název naší aplikace, abychom ji v budoucnu snadno identifikovali.
  • Po zadání názvu můžeme pokračovat tlačítkem „Next“.
  • Na další stránce vybereme naši Teams skupinu, kam budeme chtít posílat notifikace, případně zvolíme stejnou skupinu, kterou již používáme pro staré nastavení webhooku.
  • Uvnitř naší Teams skupiny si vybereme konkrétní kanál.
  • Na finální stránce si zkopírujeme naši vygenerovanou URL, která bude používána v Zabbixu.
  • Doporučujeme zatím stránku v Teams nezavírat a pro jistotu si URL poznamenat mimo Zabbix a Teams.

Nastavení URL Zabbixu

V Zabbix webovém rozhraní přejděte na Administration → Macros.

Nastavte globální proměnnou {$ZABBIX.URL} s URL Zabbix frontend rozhraní. Ujistěte se, že URL obsahuje protokol (http nebo https). Tato URL adresa bude součástí vaší události jako odkaz na problém.

Import media typu

Přejděte do Alerts → Media types a naimportujte soubor media_msteams_workflow.yaml. Je možné, že šablonu již ve vašem Zabbixu máte, ale pro jistotu ji znovu importujte, může obsahovat aktualizace. Je potřeba přepnout se na konkrétní verzi v levém horním rohu, kde si zvolíte vaši verzi Zabbixu.

Konfigurace media typu MS Teams Workflow

Otevřete nastavení pro nový media type MS Teams Workflow a nahraďte zástupný text <PLACE WEBHOOK URL HERE> URL adresou workflow endpointu získanou v posledním kroku v části „Nastavení v MS Teams„.

Nezapomeňte nastavení uložit.

Otestování našeho nastavení

Pro otestování našeho nastavení využijeme vestavěnou funkci tlačítka Test na úrovni Media.

Je potřeba vyplnit základní parametry (jedná se o testovací data), část teams_endpoint se vyplní automaticky.

  • alert_message = TEST Message
  • alert_subject = TEST Subject
  • event_severity = 3 (Zde lze napsat cokoliv; zde je číslo 3 pro příklad, protože do části event_severity lze zadávat čísla podle úrovní závažnosti. Možné hodnoty: 0 – Not classified, 1 – Information, 2 – Warning, 3 – Average, 4 – High, 5 – Disaster.)
  • event_source = 1 (Možné hodnoty: 0 – Trigger, 1 – Discovery, 2 – Autoregistration, 3 – Internal, 4 – Service.)
  • zabbix_url = https://www.initmax.cz/zabbix (Zde vyplňte stejnou URL adresu, kterou jste zadali do makra; bohužel v této části si Zabbix neumí makro přeložit, proto ji vyplníme ručně.)

Po vyplnění parametrů odešlete formulář kliknutím na tlačítko Test.

Po odeslání uvidíte ověřovací zprávu a v části Response uvidíte výsledek. Mělo by se vám vrátit „OK“.

Pokud se vám vrátila zpráva „OK,“ je vše v pořádku. Pokud se nevrátí, v této části nebo v horní části pop-up okna uvidíte, co konkrétně nefunguje. K dispozici je také velmi užitečná sekce pod tlačítkem Open log.

Nyní se můžeme podívat do naší Teams skupiny na novou zprávu, která byla vytvořena pomocí Zabbixu přes funkcionalitu Microsoft Teams – Workflows.

Finalizace a rady na závěr

Pro použití nastavení si musíte vytvořit odpovídající akci nebo ji upravit. Nezapomeňte uživatelům, kterým se zasílá notifikace, doplnit adresu v médiích – obvykle se jedná o sběrný účet. Toto není součástí tohoto návodu, protože se jedná o běžné nastavení notifikací a není zde potřeba nic speciálního.

Do části Send to je jedno, co zadáte. Na obrázku vidíte původní a nové nastavení pro našeho uživatele používaného pro notifikace. Nezapomeňte také upravit odpovídající akce.

Použití parametru http_proxy pro media type v Zabbixu umožňuje přesměrovat požadavky přes proxy server. Tento parametr je užitečný, pokud váš Zabbix server nemá přímý přístup k internetu (např. kvůli bezpečnostním omezením) a připojuje se k externím službám (např. webhooky pro Microsoft Teams) přes proxy server.

Obsah zprávy a vzhled zprávy v Microsoft Teams si můžete upravit na úrovni šablony zprávy (message template) v části nastavení media typu v Zabbixu nebo přímou úpravou JavaScriptového kódu. Můžete například nastavit různé barvy pro odlišné úrovně závažnosti (severity). Podrobnější dokumentaci naleznete na webu Microsoftu.

×Košík

Your cart is empty.