LibreNMS é um fork do Observium

Requisitos:

Instalação Debian 10 Limpa

Instale os pacotes necessários

# apt install acl curl composer fping git graphviz imagemagick \
  mariadb-client mariadb-server mtr-tiny nginx-full nmap php7.3-cli \
  php7.3-curl php7.3-fpm php7.3-gd php7.3-json php7.3-mbstring \
  php7.3-mysql php7.3-snmp php7.3-xml php7.3-zip python-memcache \
  python-mysqldb rrdtool snmp snmpd whois python3-pymysql \
  python3-dotenv python3-redis python3-setuptools

Criaremos um usuário librenms

# useradd librenms -d /opt/librenms -M -r
# usermod -a -G librenms www-data

Download LibreNMS

# cd /opt
# git clone https://github.com/librenms/librenms.git

Ajustes as permissões

# chown -R librenms:librenms /opt/librenms
# chmod 770 /opt/librenms
# setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
# setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

Instale dependências de PHP

# su - librenms
$ ./scripts/composer_wrapper.php install --no-dev
$ exit

Configuração do MariaDB

# mariadb -u root

Defina a senha para o usuario root do MariaDB e em seguida crie o banco/usuário
librenms e defina também uma senha para o mesmo, recomendo você gerar uma senha aleatória
em https://senhasegura.remontti.com.br Não esqueção de alterar nas linhas a baixo SENHA_ROOT/SENHA_LIBRENMS

USE mysql;
UPDATE user SET password=PASSWORD('SENHA_ROOT') WHERE User='root';
UPDATE user SET plugin="mysql_native_password";

CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'SENHA_LIBRENMS';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;
quit;

Ative o innodb_file_per_table e desative o lower_case_table_names no banco de dados

# vim /etc/mysql/mariadb.conf.d/50-server.cnf

Adicione logo a baixo de “[mysqld]”

[mysqld]
innodb_file_per_table=1
lower_case_table_names=0

Reinicie o serviço

# systemctl  restart mariadb

Altere a memoria limite usada pelo php, bem como tempo de execução, e time zone: https://www.php.net/manual/pt_BR/timezones.php

# sed -i 's/memory_limit = 128M/memory_limit = 256M/' /etc/php/7.3/fpm/php.ini /etc/php/7.3/cli/php.ini
# sed -i 's/max_input_time = 60/max_input_time = 300/' /etc/php/7.3/fpm/php.ini /etc/php/7.3/cli/php.ini
# sed -i 's/;date.timezone =/date.timezone = America\/Sao_Paulo/' /etc/php/7.3/fpm/php.ini /etc/php/7.3/cli/php.ini
# echo 'opcache.enable=1' >> /etc/php/7.3/fpm/conf.d/10-opcache.ini
# echo 'opcache.memory_consumption=256' >> /etc/php/7.3/fpm/conf.d/10-opcache.ini
# systemctl restart php7.3-fpm

NGINX

Remova o arquivo default

# rm /etc/nginx/sites-enabled/default
# vim /etc/nginx/sites-available/librenms.conf

Criaremos um novo arquivo, altere o server_name, se desejar restringir pode desomtar as linhas onde cito.

server {
 listen      80;
 listen      [::]:80;
 server_name librenms.seudominio.com.br 192.168.0.100;
 root        /opt/librenms/html;
 index       index.php;

 # Desmomente para deixar restringido apenas para determinados prefixos
 #allow  192.168.87.0/24;
 #allow  2001:0db8::/32;
 #deny   all;
 #error_page  403   http://www.remontti.com.br;

 charset utf-8;
 gzip on;
 gzip_types text/css application/javascript text/javascript application/x-javascript image/svg+xml text/plain text/xsd text/xsl text/xml image/x-icon;

 proxy_read_timeout 300;
 proxy_connect_timeout 300;
 proxy_send_timeout 300;

 location / {
  try_files $uri $uri/ /index.php?$query_string;
 }
 location /api/v0 {
  try_files $uri $uri/ /api_v0.php?$query_string;
 }
 location ~ \.php {
  include fastcgi.conf;
  fastcgi_split_path_info ^(.+\.php)(/.+)$;
  fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
 }
 location ~ /\.ht {
  deny all;
 }
}

Crie o link em sites-available e reinicie o nginx

# ln -s /etc/nginx/sites-available/librenms.conf /etc/nginx/sites-enabled/
# systemctl restart nginx

Configurando o snmpd

# mv /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf.old
# cp /opt/librenms/snmpd.conf.example /etc/snmp/snmpd.conf
# chmod 600 /etc/snmp/snmpd.conf

Altere as variáveis para seus valores

# SUA_COMMUNITY="minhacommunity"
# SEU_NOME="Rudimar Remontti"
# SEU_EMAIL="noc@remontti.com.br"
# LOCALIZACAO="Rua RR, Frederico Westphalen/RS, Brasil [-27.334143, -53.420506]"

Agora rodamos o comando que ira trocar alterar as variáveis em /etc/snmp/snmpd.conf

# sed -i "s/RANDOMSTRINGGOESHERE/$SUA_COMMUNITY/" /etc/snmp/snmpd.conf
# sed -i "s/Your Name/$SEU_NOME/" /etc/snmp/snmpd.conf
# sed -i "s/your@email.address/$SEU_EMAIL/" /etc/snmp/snmpd.conf
# sed -i "s/syslocation/#syslocation/" /etc/snmp/snmpd.conf
# sed -i "9i\syslocation $LOCALIZACAO" /etc/snmp/snmpd.conf

Baixa o script de detecção de distro

# curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro
# chmod +x /usr/bin/distro
# systemctl restart snmpd

Ajustando rotinas no Cron

# cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms
# systemctl  restart cron

Configuração do logrotate

# cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms
# logrotate /etc/logrotate.d/librenms --debug
# systemctl restart logrotate

Agora acesse seu servido em seu navegador: “http://librenms.seudominio.com.br/install”

Tenha todos os pré-requisitos

Clique no ícone do banco de dados e preencha os dados do banco com usuário e senha criada anteriormente.

Clique em Build database para ele criar todo seu banco de dados.

Se tudo deu certo clique no ícone da chave

Crie o usuário para acessar seu LibreNMS web

Clique no ícone “v” para finalizar

Um “erro” irá aparecer, não se assuste, ele apenas não conseguiu modificar o /opt/librenms/.env, então copie o conteúdo:

Iremos limpar o arquivo atual, e edite o mesmo

# echo > /opt/librenms/.env
# vim /opt/librenms/.env

Colando as informações copiadas do navegado.

APP_KEY=base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/xxxx=

DB_HOST=localhost
DB_DATABASE=librenms
DB_USERNAME=librenms
DB_PASSWORD=SENHA_LIBRENMS

#APP_URL=
NODE_ID=xxxxxxxxxxxxx

Mais uma vez altere as permissões bem como faça alguns ajustes

# chown -R librenms:librenms /opt/librenms
# setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
# chmod -R ug=rwX /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
# cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/
# ln -s /opt/librenms/lnms /usr/bin/lnms

Logue com librenms e rode o comando:

# su - librenms
$  ./scripts/github-remove -d 
Are you sure you want to delete all modified and untracked files? [y/N] y <<<
$ exit

Finalize

Entre com usuário senha que criou


Adicione seu próprio servidor para monitorar

Valide as configurações

Extra: Plugin Weathermap

# cd /opt/librenms/html/plugins
# git clone https://github.com/librenms-plugins/Weathermap.git
# chown -R librenms:librenms /opt/librenms/html/plugins/Weathermap/
# chmod 775 /opt/librenms/html/plugins/Weathermap/configs
# echo '*/5 * * * * librenms /opt/librenms/html/plugins/Weathermap/map-poller.php' >> /etc/cron.d/librenms

Ative o plugin em OverView ->Plugins -> Plugin Admin

Recomendo a leitura: https://docs.librenms.org/

Gostou? Quer me ajudar?

Se quiser fazer uma doação para o café ficarei muito feliz pelo seu reconhecimento!

Se não puder doar pode deixar seu agradecimento nos comentário também ficarei feliz em saber que ajudei. Se tiver qualquer pergunta deixe-a também. Se preferir entrar em Contato clique aqui.

Fontes:
https://github.com/librenms/librenms
https://docs.librenms.org/Installation/

O post Instalação do LibreNMS no Debian 10, ferramenta de monitoramento de dispositivos apareceu primeiro em Remontti.

Observium oferece suporte a vários hardwares de rede e sistemas operacionais, incluindo Linux, Windows, FreeBSD, Cisco, Dell, Netscaler, Huawei, Mikrotik e muito mais. O Observium oferece uma interface poderosa, simples e fácil de usar para monitorar a saúde e o status de sua rede.

Profissionalmente desenvolvido e mantido por uma equipe de experientes engenheiros de rede e administradores de sistemas, o Observium é uma plataforma projetada e construída por seus usuários.

A Comunidade Observium está disponível gratuitamente para todos e recebe atualizações e recursos duas vezes por ano. O Observium Professional adiciona acesso prioritário a atualizações diárias e novos recursos por uma pequena taxa anual.

Requisitos:

* Debian 10 (Buster) -> Instalação Limpa
* Passo-a-passo como criar um servidor WEB Apache + PHP + MariaDB + phpMyAdmin no Debian 10 Buster “LAMP”
A instalação do phpMyAdmin não é necessária.

Instale os pacotes necessários:

# apt install snmp fping python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz imagemagick wget

Crie o banco de dados do observium

# mariadb -u root -p

Não esqueça de alterar SUA_SENHA

CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY 'SUA_SENHA';
FLUSH PRIVILEGES;
QUIT;

Edições Observium

Como dito o Observium vem em duas edições, uma Open Source Community Edition lançada em um ciclo semestral e uma edição com recursos adicionais, correções rápidas de bugs e melhorias de recursos diariamente. Caso queira a versão “Pro” acesse https://www.observium.org/

Como a a gente é pobre (zueira) vamos instalar a versão Community Edition
Se desejar instalar o Community Edition, instale usando a versão .tar.gz mais recente.

Baixe o .tar.gz mais recente do Observium e descompacte:

# cd /var/www/
# wget http://www.observium.org/observium-community-latest.tar.gz
# tar zxvf observium-community-latest.tar.gz

Crie o diretório para armazenar RRDs e ous logs:

# mkdir /var/www/observium/rrd 
# mkdir /var/www/observium/logs

Ajustes as permissões:

# chown www-data. /var/www/observium/ -R 

Crie uma cópia do config.php.default para config.php e ajustes os valores do banco de dados colocando os valores criado no passo anterior:

# cp /var/www/observium/config.php.default /var/www/observium/config.php
# vim /var/www/observium/config.php

$config['db_extension'] = 'mysqli';
$config['db_host']      = 'localhost';
$config['db_user']      = 'observium';
$config['db_pass']      = 'SUA_SENHA';
$config['db_name']      = 'observium';

Configure o banco de dados:

# php /var/www/observium/discovery.php -u 

Retornará:

  ___   _                              _
 / _ \ | |__   ___   ___  _ __ __   __(_) _   _  _ __ ___
| | | || '_ \ / __| / _ \| '__|\ \ / /| || | | || '_ ` _ \
| |_| || |_) |\__ \|  __/| |    \ V / | || |_| || | | | | |
 \___/ |_.__/ |___/ \___||_|     \_/  |_| \__,_||_| |_| |_|
                     Observium Community Edition 20.9.10731
                                  https://www.observium.org

Install initial database schema ... done.
-- Updating database/file schema
416 -> 417 # (db) .. Done (0s).
417 -> 418 # (db) . Done (0s).
418 -> 419 # (db) .... Done (1s).
419 -> 420 # (db) .. Done (0s).
420 -> 421 # (db) ... Done (0s).
421 -> 422 # (db) .. Done (0s).
422 -> 423 # (db) ...... Done (0s).
423 -> 424 # (php)  Done (0s).
424 -> 425 # (db) . Done (0s).
425 -> 426 # (db) ............... Done (0s).
426 -> 427 # (db) ... Done (0s).
427 -> 428 # (db) ... Done (0s).
428 -> 429 # (db) ... Done (0s).
429 -> 430 # (db) (WARNING! Required MySQL version 5.6+ or MariaDB 10.0+).... Done (0s).
430 -> 431 # (db) ..... Done (0s).
431 -> 432 # (php)  Done (0s).
432 -> 433 # (db) ......... Done (0s).
433 -> 434 # (db) ... Done (0s).
434 -> 435 # (db) . Done (0s).
-- Done.

Como o php-mcrypt não está mais no repositório do Debian 10 (php.7.3) vamos instala-lo na mão:

# apt install php-dev libmcrypt-dev mcrypt
# pecl channel-update pecl.php.net
# pecl install channel://pecl.php.net/mcrypt-1.0.2

Edite o php.ini

# vim /etc/php/7.3/cli/php.ini

Inclua:

extension=mcrypt.so

Verifique se a extensão esta sendo carregada, deve retornar o valor mcrypt.

# php -m | grep mcrypt

Faremos a configuração do apache para que quando o servidor for acessado no navegado o mesmo já abra o Observium, caso você esteja instalando com outros serviços web, ou gosta das coisas organizadas pode pular para o próximo exemplo.

# vim /etc/apache2/sites-available/000-default.conf

Ajuste para:

<VirtualHost *:80>
    ServerAdmin noc@remontti.com.br

    DocumentRoot /var/www/observium/html

    <FilesMatch \.php$>
      SetHandler application/x-httpd-php
    </FilesMatch>

    <Directory />
            Options FollowSymLinks
            AllowOverride None
    </Directory>

    <Directory /var/www/observium/html/>
            DirectoryIndex index.php
            Options FollowSymLinks MultiViews
            AllowOverride All
            Require all granted
    </Directory>

    ErrorLog  ${APACHE_LOG_DIR}/error_observium.log    
    CustomLog  ${APACHE_LOG_DIR}/access_observium.log combined
    ServerSignature On

</VirtualHost>

Caso você queira proteger para algumas classes de IPs e usar um subdomíno pode usar este modelo. (Mas você pode filtrar por IP também no modelo anterior ajustando os “Require”)

# vim /etc/apache2/sites-available/observium.conf

<virtualhost *:80>
   ServerName observium.remontti.com.br
   ServerAdmin noc@remontti.com.br

   # Sem permissões será redirecionada para
   ErrorDocument 403 http://www.remontti.com.br
 
   DocumentRoot /var/www/observium/html

    <FilesMatch \.php$>
      SetHandler application/x-httpd-php
    </FilesMatch>

    <Directory />
      Options FollowSymLinks
      AllowOverride None
    </Directory>
 
   <Directory /var/www/observium/html/>
      DirectoryIndex index.php
      Options FollowSymLinks MultiViews
      AllowOverride All
      Require all denied
      <RequireAll>
         <RequireAny>
            Require ip 127.0.0.1 ::1 45.80.51.0/29 2804:f123:bebe:c0ca::/64
         </RequireAny>
      </RequireAll>
   </Directory>
 
   ErrorLog ${APACHE_LOG_DIR}/error_observium.log
   CustomLog ${APACHE_LOG_DIR}/access_observium.log combined
 
</VirtualHost>

Habilite a configuração criada acima:

# a2ensite observium

Habilite o o modulo rewrite

# a2enmod rewrite

Reinicie o serviço do apache

# systemctl restart apache2

Vamos utilizar as MIBs do Observium, para isso vamos chama-las (Você pode adicionar outras, verifique quais disponiveis em /var/www/observium/mibs).

# vim /etc/snmp/snmp.conf

Ajuste:

mibs : /var/www/observium/mibs/rfc:/var/www/observium/mibs/net-snmp:/var/www/observium/mibs/mikrotik:/var/www/observium/mibs/huawei

Precisamos ajustar

Observium opera em uma frequência de poller fixa de 5 minutos ou 300 segundos. O processo poller-wrapper deve ser executado nesta frequência NÃO funcionará de outra forma. então vamos criar o /etc/cron.d/observium

# vim /etc/cron.d/observium

Adicione:

# Execute uma descoberta completa de todos os dispositivos uma vez a cada 6 horas
# Run a complete discovery of all devices once every 6 hours
33  */6   * * *   root    /var/www/observium/discovery.php -h all >> /dev/null 2>&1

# Execute a descoberta automática de dispositivos recém-adicionados a cada 5 minutos
# Run automated discovery of newly added devices every 5 minutes
*/5 *     * * *   root    /var/www/observium/discovery.php -h new >> /dev/null 2>&1

# Execute o multithreaded poller wrapper a cada 5 minutos
# Run multithreaded poller wrapper every 5 minutes
*/5 *     * * *   root    /var/www/observium/poller-wrapper.py >> /dev/null 2>&1

# Execute o script de manutenção diariamente para syslog, log de eventos e log de alerta
# Run housekeeping script daily for syslog, eventlog and alert log
13 5      * * *   root    /var/www/observium/housekeeping.php -ysel >> /dev/null 2>&1

# Execute o script de manutenção diariamente para rrds, portas, entradas órfãs no banco de dados e dados de desempenho
# Run housekeeping script daily for rrds, ports, orphaned entries in the database and performance data
47 4      * * *   root    /var/www/observium/housekeeping.php -yrptb >> /dev/null 2>&1

Reinicie o Cron:

# systemctl restart cron

Adicione o primeiro usuário, use o level 10 para o administrador:

# php /var/www/observium/adduser.php <usuario> <senha> <level>

Ex.:

# php /var/www/observium/adduser.php admin suasenha 10

Adicione um primeiro dispositivo para monitorar: (Não esqueça de configurar o SNMP)

# php /var/www/observium/add_device.php <hostname> <community> v2c
# php /var/www/observium/add_device.php 10.0.0.100 publicsnmp v2c

Agora acesse seu servidor em seu navegador e entre com usuário e senha criado.

Parabéns!

Espero que tenha lhe instigado/inspirado a buscar mais aprender um pouquinho +

Se quiser fazer uma doação para o café ficarei muito feliz pelo seu reconhecimento!

Participe do canal no telegram para ficar atualizado sempre que publicar um novo tutorial.

Se não puder doar pode deixar seu agradecimento nos comentário também ficarei feliz em saber que ajudei. Se tiver qualquer pergunta deixe-a também. Se preferir entrar em Contato clique aqui.

Fonte:
https://docs.observium.org/install_debian/
https://docs.observium.org/web_config/
https://docs.observium.org/dashboard/

O post Monitoramento com o Observium no Debian 10 apareceu primeiro em Remontti.