Monitoring: Porovnání verzí

Z Freenetis Wiki
Přejít na: navigace, hledání
 
(Není zobrazeno 24 mezilehlých verzí od 2 dalších uživatelů.)
Řádek 1: Řádek 1:
#!/bin/bash
+
[[en:Monitoring (english)]]
+
__TOC__
# URL with IP addresses to monitor
+
 
HOSTS_INPUT_URL="http://freenetis.slfree.net/cs/web_interface/monitoring_hosts/"
+
Monitoring ve FreenetISu je založena na nástroji '''fping'''. Samotný monitoring je deamon běžící na linuxuvém stroji, který má přístup do Vaší vnitřní sítě a k serveru, na kterém běží FreenetIS. ''(FreenetIS i monitoring mohou běžet na jednom stroji, ale tato konfigurace není doporučena, jelikož monitoring vytváří velkou zátěž na běhový server)''
+
 
# URL to which we send result
+
Monitoring komunikuje s FreenetISem pomocí nástroje '''wget'''. Z FreenetiISu získává IP adresy v síti, které má monitorovat. Poté proběhne samotný test dostupnosti jednotlivých adres. Výstup testu je zaslán zpět FreenetISu, který jej zobrazí v rozhraní monitoringu.
HOSTS_OUTPUT_URL="http://freenetis.slfree.net/cs/web_interface/monitoring_states/"
+
 
+
=== Priorita monitorování ===  
# temporary file with list of IP addresses to monitor
+
 
HOSTS_INPUT=`mktemp`
+
Nejedná se o priority v pravém slova smyslu, spíše priority jdou pomocí něj simulovat. Přesnější termín by byl zřejmě skupiny.
   
+
 
  # temporary file with result to send
+
Ve FreenetISu si zařízení rozdělíme do jednotlivých priorit. Pro každou prioritu je spustit jeden samostatný proces monitorování.
  HOSTS_OUTPUT=`mktemp`
+
 
   
+
''Praktické použití: Zařízení sdružení (tj. nejdůležitější) si označíme prioritou 1 (např. 500 zařízení), ostatní zařízení, které chceme z nějakého důvodu monitorovat si označíme prioritou 2 (např. 2500 zařízení).''
  echo "Downloading list of IP addresses to monitor..."
+
 
+
=== Upozornění na e-mail ===
  # get ip addresses from FreenetIS
+
 
  wget -q "$HOSTS_INPUT_URL$1" -O "$HOSTS_INPUT"
+
FreenetIS posílá informace na e-mail o zařízeních, které nejsou dostupné a o zařízeních, které byly nedostupné a již jsou opět dostupné. Interval upozorňování se postupně zvyšuje - první minuty se posílá upozornění každou minutu, po 5 minutách již každé 3 minutách, po 10 minutách po 5 minutách atd. U znovu funkčních zařízení se pak posílájí e-maily jenom do 10 minut od znovu najetí.
+
 
# use fping to get ip addresses states
+
Programátorsky je pak vše řešené přes e-mailové fronty a metody push, která e-mail s upozorněním vloží na vršek fronty (tj. odešle se jako první).
  fping -e -f "$HOSTS_INPUT" 2>/dev/null | while read host
+
 
do
+
== Instalace ze zdrojových kódů ==
# ip address
+
 
ip=`echo $host | awk '{print $1}'`
+
'''Tento postup instalace je zde pro vývojářské účely. Koncový uživatelé by měli instalovat pomocí balíku [http://wiki.freenetis.org/index.php/Instalace#Bal.C3.ADk_freenetis-monitoring frenetis-monitoring].'''
+
 
# state of host (alive or unreachable)
+
=== Závislosti ===
state=`echo $host | awk '{print $3}'`
+
 
+
apt-get install fping
# latency of host (only for alive state)
+
 
lat=`echo $host | awk '{print $4}' | sed 's/(//'`
+
=== Instalace ===
+
 
# do not add ampersand to beginning of file with result
+
Skripty a konfigurační soubor nalezneme ve složce '''/application/vendors/monitoring''' ve zdrojových souborech FreenetISu. Postup instalace:
if [ -s "$HOSTS_OUTPUT" ];
+
 
then
+
1) Zkopírujeme soubory
echo -n "&" >> "$HOSTS_OUTPUT";
+
 
fi
+
  sudo mkdir /etc/freenetis
+
  cd ./application/vendors/monitoring
# add variables to file with result
+
  sudo cp ./freenetis-monitoring.init.sh /etc/init.d/freenetis-monitoring
echo "ip[]=$ip&state[]=$state&lat[]=$lat" >> "$HOSTS_OUTPUT"
+
  sudo cp ./freenetis-monitord.sh /usr/sbin/freenetis-monitord
done
+
  sudo cp ./freenetis-monitoring.conf /etc/freenetis
+
 
# remove temporary file with IP addresses to monitor
+
2) Nastavit práva pro spouštění
rm "$HOSTS_INPUT"
+
 
+
  sudo chmod +x /etc/init.d/freenetis-monitoring
  echo "Sending result data back to FreenetIS..."
+
  sudo chmod +x /usr/sbin/freenetis-monitord
+
 
# send file with result back to FreenetIS
+
3) Přidat automatické spouštění po bootu
  wget -q --post-file="$HOSTS_OUTPUT" "$HOSTS_OUTPUT_URL"
+
 
+
  sudo update-rc.d freenetis-monitoring defaults
# remove temporary file with result
+
 
  rm "$HOSTS_OUTPUT"
+
=== Konfigurace ===
 +
 
 +
V konfiguračním souboru ''(/etc/freenetis/freenetis-monitoring.conf)'' '''je nutné nastavit cestu ke FreenetISu ''(proměnná PATH_FN)''.'''
 +
 
 +
Dále lze nastavit chování priorit ''(proměnná MAX_PRIORITY)''. Pokud nastavíte proměnnou na hodnotu 0, všechny proměnné se budou spouštět ve stejném procesu. Pokud nastavíte číslo na hodnotu větší než 0, budou monitorovány všechny priority do nastaveného čísla v samostatném procesu pro každou prioritu.
 +
 
 +
== Spuštění a správa ==
 +
 
 +
Skript je spouštěn automaticky po startu systému.
 +
 
 +
Manuální spuštění:
 +
 
 +
  sudo /etc/init.d/freenetis-monitoring start
 +
 
 +
Manuální zastavení:
 +
 
 +
  sudo /etc/init.d/freenetis-monitoring stop
 +
 
 +
Aktuální stav monitoringu:
 +
 
 +
  sudo /etc/init.d/freenetis-monitoring status

Aktuální verze z 21. 5. 2013, 12:08

Monitoring ve FreenetISu je založena na nástroji fping. Samotný monitoring je deamon běžící na linuxuvém stroji, který má přístup do Vaší vnitřní sítě a k serveru, na kterém běží FreenetIS. (FreenetIS i monitoring mohou běžet na jednom stroji, ale tato konfigurace není doporučena, jelikož monitoring vytváří velkou zátěž na běhový server)

Monitoring komunikuje s FreenetISem pomocí nástroje wget. Z FreenetiISu získává IP adresy v síti, které má monitorovat. Poté proběhne samotný test dostupnosti jednotlivých adres. Výstup testu je zaslán zpět FreenetISu, který jej zobrazí v rozhraní monitoringu.

Priorita monitorování

Nejedná se o priority v pravém slova smyslu, spíše priority jdou pomocí něj simulovat. Přesnější termín by byl zřejmě skupiny.

Ve FreenetISu si zařízení rozdělíme do jednotlivých priorit. Pro každou prioritu je spustit jeden samostatný proces monitorování.

Praktické použití: Zařízení sdružení (tj. nejdůležitější) si označíme prioritou 1 (např. 500 zařízení), ostatní zařízení, které chceme z nějakého důvodu monitorovat si označíme prioritou 2 (např. 2500 zařízení).

Upozornění na e-mail

FreenetIS posílá informace na e-mail o zařízeních, které nejsou dostupné a o zařízeních, které byly nedostupné a již jsou opět dostupné. Interval upozorňování se postupně zvyšuje - první minuty se posílá upozornění každou minutu, po 5 minutách již každé 3 minutách, po 10 minutách po 5 minutách atd. U znovu funkčních zařízení se pak posílájí e-maily jenom do 10 minut od znovu najetí.

Programátorsky je pak vše řešené přes e-mailové fronty a metody push, která e-mail s upozorněním vloží na vršek fronty (tj. odešle se jako první).

Instalace ze zdrojových kódů

Tento postup instalace je zde pro vývojářské účely. Koncový uživatelé by měli instalovat pomocí balíku frenetis-monitoring.

Závislosti

apt-get install fping

Instalace

Skripty a konfigurační soubor nalezneme ve složce /application/vendors/monitoring ve zdrojových souborech FreenetISu. Postup instalace:

1) Zkopírujeme soubory

sudo mkdir /etc/freenetis
cd ./application/vendors/monitoring
sudo cp ./freenetis-monitoring.init.sh /etc/init.d/freenetis-monitoring
sudo cp ./freenetis-monitord.sh /usr/sbin/freenetis-monitord
sudo cp ./freenetis-monitoring.conf /etc/freenetis

2) Nastavit práva pro spouštění

sudo chmod +x /etc/init.d/freenetis-monitoring
sudo chmod +x /usr/sbin/freenetis-monitord

3) Přidat automatické spouštění po bootu

sudo update-rc.d freenetis-monitoring defaults

Konfigurace

V konfiguračním souboru (/etc/freenetis/freenetis-monitoring.conf) je nutné nastavit cestu ke FreenetISu (proměnná PATH_FN).

Dále lze nastavit chování priorit (proměnná MAX_PRIORITY). Pokud nastavíte proměnnou na hodnotu 0, všechny proměnné se budou spouštět ve stejném procesu. Pokud nastavíte číslo na hodnotu větší než 0, budou monitorovány všechny priority do nastaveného čísla v samostatném procesu pro každou prioritu.

Spuštění a správa

Skript je spouštěn automaticky po startu systému.

Manuální spuštění:

sudo /etc/init.d/freenetis-monitoring start

Manuální zastavení:

sudo /etc/init.d/freenetis-monitoring stop

Aktuální stav monitoringu:

sudo /etc/init.d/freenetis-monitoring status