Home / Integracje i pluginy / ElastAlert2 SMS integration

+

Wysyłaj alerty SMS/głosowe z Elasticsearch

Alerty z Elasticsearch trafiają do osoby dyżurującej jako SMS lub połączenie telefoniczne. SMSEagle wysyła je przez własne połączenie komórkowe, więc nie zależą od dostępu do internetu ani od usługi w chmurze.

Wbudowane w ElastAlert2

ElastAlert2 ma wbudowany alerter SMSEagle, więc do reguły wystarczy dodać adres urządzenia i klucz API.

Wysyłka na numery, do kontaktów lub grup

W regule wskazujesz numery telefonów, kontakty lub całe grupy z książki adresowej SMSEagle.

Brak hasła zapisanego w ustawieniach

Elasticsearch łączy się z SMSEagle za pomocą klucza API, więc w konfiguracji nie trzeba zapisywać nazwy użytkownika ani hasła.

Jak to działa

1

Zdarzenie

Reguła ElastAlert2 wykrywa warunek w danych Elasticsearch, na przykład nagły wzrost liczby błędów lub zdarzenie bezpieczeństwa.

2

Komunikacja

Wbudowany alerter SMSEagle w ElastAlert2 wysyła żądanie HTTP API do urządzenia SMSEagle w Twojej sieci lokalnej.

3

Alert

SMSEagle dostarcza alert przez własne połączenie komórkowe, a nie przez usługę zewnętrzną, jako SMS lub połączenie telefoniczne na telefon odbiorcy.

Konfiguracja w około 10 minut

Konfiguracja jest prosta i zajmuje około 10-15 minut. Wygeneruj token API w SMSEagle, dodaj alerter SMSEagle do reguły ElastAlert2 i gotowe.

SMSEagle dostarcza alerty z Elasticsearch do właściwej osoby przez SMS lub połączenie telefoniczne, dzień i noc.

SMS i połączenia głosowe z jednego urządzenia

SMSEagle wysyła alerty z Elasticsearch jako SMS, połączenie dzwoniące lub połączenie, w którym treść alertu jest odczytywana na głos, wszystko z jednego urządzenia.

Fill-in-the-call-4

Jeśli pierwsza osoba nie odpowie, alert trafia do kolejnej

Grupy eskalacji i harmonogramy zmian sprawiają, że alert z Elasticsearch trafia do osoby dyżurującej, a gdy nikt nie odpowie, do kolejnej osoby z listy.

Alerty działają nawet po awarii jednego urządzenia

Dwa urządzenia SMSEagle mogą pracować jako klaster HA: gdy jedno ulegnie awarii, drugie przejmuje wysyłkę.

Konfiguracja SMSEagle

  1. Utwórz nowego użytkownika w SMSEagle (menu System > Users, poziom dostępu: “User”).
  2. Utwórz klucz API dla tego użytkownika:
    • przejdź do Settings > Global settings > API i otwórz stronę API v2
    • kliknij Create API key, wpisz nazwę w polu Key name i wskaż utworzonego wyżej użytkownika w polu Owner
    • Dla wiadomości tekstowych dodaj uprawnienia w sekcji Messages do: Send SMS
    • Dla alertów głosowych dodaj uprawnienia w sekcji Calls do: Make a ring call, Make a TTS call, Make a TTS Advanced call.
    • kliknij Create key. Token dostępu jest pokazywany tylko raz, zaraz po zapisaniu, więc skopiuj go od razu

Konfiguracja Elasticsearch

1. Zainstaluj ElastAlert2 zgodnie z dokumentacją.

2. Utwórz regułę i w parametrze „alert” zdefiniuj konfigurację SMSEagle.

Przykład konfiguracji w pliku YAML:

[…]
alert:
- "smseagle"
smseagle_url: "https://192.168.1.101"
smseagle_token: "123abc456def789"
smseagle_message_type: "sms"
smseagle_to: ["+123456789", "987654321"]
smseagle_contacts: [2, 7]
[…]

Dostępne parametry:

Wymagane:

  • smseagle_url: adres Twojego urządzenia SMSEagle, np. http://192.168.1.101
  • smseagle_token: token dostępu do API (można go wygenerować w Settings > Global settings > API > API v2)
  • smseagle_message_type: typ wiadomości/połączenia do wysłania. Dostępne wartości: sms, ring, tts, tts_adv, odpowiednio dla SMS, połączenia dzwoniącego (ring), połączenia TTS i zaawansowanego połączenia TTS.

Wymagane jedno z poniższych:

  • smseagle_to: numer(y) telefonu, na które chcesz wysłać wiadomość
  • smseagle_contacts: nazwa(y) kontaktów z Książki adresowej SMSEagle, do których chcesz wysłać wiadomość
  • smseagle_groups: nazwa(y) grup z Książki adresowej SMSEagle, do których chcesz wysłać wiadomość

Opcjonalne:

  • smseagle_duration: czas trwania połączenia, wymagany dla połączeń ring, TTS i zaawansowanych TTS. Wartość domyślna: 10
  • smseagle_voice_id: ID modelu głosowego, wymagane dla zaawansowanego połączenia TTS. Wartość domyślna: 1
  • smseagle_text: nadpisanie treści powiadomienia własnym tekstem

Więcej informacji znajdziesz w dokumentacji ElastAlert2: https://elastalert2.readthedocs.io/en/latest/alerts.html#smseagle

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowe i programowe, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po zarejestrowaniu się w wersji demonstracyjnej otrzymasz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

  • 14-dniowy bezpłatny okres próbny
  • Dostęp do ponad 20 funkcjonalności

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle