Introdução
O Monitoramento de Servidores oferece uma série de plugins que permitem que você monitore serviços adicionais, como o desempenho de um servidor Apache ou outras propriedades, como a temperatura de um servidor.
Plugins disponíveis
Plugin predefinido – Apache
Monitora o desempenho de um servidor Apache.
- Métricas
- IdleWorkers
- ReadingWorkers
- WritingWorkers
- KeepaliveWorkers
- DnsWorkers
- ClosingWorkers
- LoggingWorkers
- FinishingWorkers
- CleanupWorkers
- requests_per_second
- Total kBytes
- Total Accesses
- ServerUptimeSeconds
- BusyWorkers
- BytesPerReq
- BytesPerSec
- ConnsAsyncClosing
- ConnsAsyncKeepAlive
- ConnsAsyncWriting
- DnsWorkers
Ativando a página de status
Para ativar a página de status do Apache, inclua o seguinte código no arquivo de configuração (httpd.conf):
<Location "/server-status"> SetHandler server-status Order deny,allow Deny from all Allow from 127.0.0.1 </Location>
A página de status só estará disponível em máquinas que estejam rodando o Apache. Você pode testar isso, através do seguinte comando:
wget -qO- http://127.0.0.1/server-status?auto
Configurando o plugin
Edite o arquivo /etc/httpd/conf.d/zz030_ext-monitoring.conf e adicione as seguintes linhas:
<IfModule mod_status.c> Listen 7050 <VirtualHost 127.0.0.1:7050> ServerName server.local <Location "/httpd-status"> SetHandler server-status Order deny,allow Deny from all Allow from 127.0.0.1 </Location> </VirtualHost> </IfModule>
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[httpd] enabled = true status_page_url = http://127.0.0.1:7050/httpd-status?auto
Testando o plugin
Verifique se o plugin funciona, executando o agent360 –test httpd. Ele deverá mostrar as seguintes métricas:
httpd: { "BusyWorkers": "1", "BytesPerReq": "1183.62", "BytesPerSec": "20.1089", "CleanupWorkers": 0, "ClosingWorkers": 0, "ConnsAsyncClosing": "0", "ConnsAsyncKeepAlive": "0", "ConnsAsyncWriting": "0", "ConnsTotal": "0", "DnsWorkers": 0, "FinishingWorkers": 0, "IdleWorkers": 49, "KeepaliveWorkers": 0, "LoggingWorkers": 0, "ParentServerConfigGeneration": "2", "ParentServerMPMGeneration": "1", "ReadingWorkers": 0, "ServerMPM": "event", "ServerUptimeSeconds": "69102", "ServerVersion": "Apache/2.4.18 (Ubuntu)", "Total Accesses": "1174", "Total kBytes": "1357", "Uptime": "69102", "WritingWorkers": 1, "requests_per_second": 0 }
Agora você pode reiniciar o agente com o comando service agent360 restart
Monitora chamadas Asterisk, assim como chamadas recebidas. O Asterisk é um framework de uso livre, para criação de aplicações relacionadas à comunicação.
Métricas
- Chamadas totais
- Chamadas recebidas
Dependências
O usuário agent360 precisa do acesso ao sudo para executar o sudo asterisk. Para isso, abra o arquivo /etc/sudoers e adicione a seguinte linha ao final do arquivo:
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/asterisk
Este comando parte do princípio de que o asterisk está instalado em /usr/sbin/asterisk. Você pode saber onde o asterisk está instalado executando o comando whereis asterisk
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[asterisk] enabled = yes
Teste o plugin
Execute os comandos su -p agent360 e agent360 test asterisk para ver se tudo foi instalado corretamente.
asterisk:{"calls": 0,"incomingcalls": 0}
Agora, você pode reiniciar o agente com o comando service agent360 restart
Criando gráficos
Clique em Métricas, no menu principal. Selecione asterisk como o tipo da métrica e calls para a métrica. Indique os servidores para os quais você gostaria de ter os gráficos e salve-os no painel principal (dashboard).
Plugin predefinido – CloudLinux DB Governor
Monitora os usuários de um banco de dados Governor, em um sistema Cloud Linux.
Métricas
As métricas estão disponíveis através do comando lveinfo
Dependências
Para configurar o plugin, adicione a seguinte linha ao arquivo /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /REPLACE/PATH/TO/lveinfo
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[cloudlinux-dbgov] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test cloudlinux-dbgov
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – CloudLinux
Monitora usuários de forma individual, em um servidor Cloud Linux.
Dependências
A versão mínima do agent360 deve ser a 1.1.47.
Para fazer upgrade do agente, execute o comando pip install agent360 –upgrade
O usuário agent360 precisa do acesso sudo para executar o lveinfo.
Para isso, abra o arquivo /etc/sudoers e adicione a seguinte linha ao final dele:
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/lveinfo
Obs.: parte-se do princípio que o lveinfo está instalado em /usr/sbin/lveinfo.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[cloudlinux-dbgov] enabled = yes
Testando o plugin
Execute o comando sudo -u agent360 agent360 test cloudlinux para verificar se tudo foi instalado corretamente:
cloudlinux:{"metrics": 0.....}
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – cPanel User Count
Retorna o número de usuários em um servidor cPanel.
Métricas
- Usuários do cPanel
Configurando o plugin
Para ativar o plugin, ediet o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[cpanel] enabled = yes
Testando o plugin
Execute o comando sudo -u agent360 agent360 test cpanel
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – CPU Temperature
Monitora a temperatura da CPU
Dependências
Par permitir que este plugin acesse seu servidor, adicione a seguinte linha ao final do arquivo /etc/sudoers :
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/kamctl
Configurando the plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[temp] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test temp
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Directory Size
Monitora o tamanho das pastas especificadas no arquivo de configuração.
Métricas
- Tamanhos das pastas
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[dirsize] temp, /home, /home/backups
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test dirsize
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Disk Status
Permite monitorar o status do drives HDD, SSD e NVME
Dependências
Este plugin requer a versão 1.1.50 ou superior do agent360. Para fazer upgrade do agente em um sistema que tenha python2, execute o seguinte comando:
pip install agent360 --upgrade
Já para fazer upgrade do agente em um sistema que tenha python3, execute o seguinte comando:
pip3 install agent360 --upgrade
Para executar o comando smartctl, você precisa ter acesso root. Portanto, você também precisa ter acesso root para executar o agente.
Para drives NVMe, você precisa do nvme-cli . Siga estas instruções .
Para outros drives, você precisa do smartctl da smartmontools.
No Debian e Ubuntu, o comando apt-get install smartmontools
No CentOS, execute o comando yum install smartmontools
Instalando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[diskstatus] enabled = yes
Para NVME, adicione as seguintes linhas /etc/agent360.ini file:
[diskstatus-nvme] enabled = yes
Testando o plugin (smartmontools)
Execute o comando agent360 test diskstatus para saber se tudo está funcionando.
Testando o plugin (nvme-cli)
Execute o comando agent360 test diskstatus-nvme para saber se tudo está funcionando.
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Docker
Acompanha as instâncias do Docker em sua máquina.
Métricas
Uso da memória
Memória total
Entrada de rede
Saída de rede
Escrita no disco
Leitura do disco
Uso de CPU
Contador de contêiner Docker
Dependências
O usuário agent360 precisa de acesso sudo para executar as estatísticas do Docker. Para isso, abra o /etc/sudoers e adicione a seguinte linha ao seu final:
agent360 ALL=(ALL) NOPASSWD: /usr/bin/docker
O comando parte do princípio que docker existe em /usr/bin/docker.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[docker] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test docker
dockerdocker: { "containers": 2, "goofy_lewin": { "cpu": "0.00", "disk_in_bytes": 0, "disk_out_bytes": 0, "mem_pct": "0.05", "mem_total_bytes": 1040501964.8, "mem_usage_bytes": 483328.0, "net_in_bytes": 0, "net_out_bytes": 0 }, "pensive_austin": { "cpu": "0.00", "disk_in_bytes": 0, "disk_out_bytes": 0, "mem_pct": "0.05", "mem_total_bytes": 1040501964.8, "mem_usage_bytes": 483328.0, "net_in_bytes": 0, "net_out_bytes": 0 } }
Agora você pode reiniciar o agente com o comando service agent360 restart
Criando gráficos
Clique em Métricas, no menu principal. Selecione docker como o tipo da métrica. Você verá uma lista de contêiners Docker e suas estatísticas. Escolha os servidores os quais você gostaria de obter os gráficos e salve-os em seu painel principal (dashboard).
Plugin predefinido – Elasticsearch
Monitora o desempenho de um serviço Elasticsearch no servidor.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[elasticsearch] enabled = yes status_page_url = http://127.0.0.1:9200/_stats
Se outro processo estiver utilizando a porta 9200, você pode escolher outra porta no arquivo de configuração.
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test elasticsearch
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Exim Queue Size
Monitora o tamanho total da fila ao usar o Exim. O comando exim -bpc retorna o tamanho total da fila dos e-mails.
Métrica
Tamanho total da fila
Dependências
O agent360 precisa de acesso sudo para executar exim -bpc. Para isso, abra o arquivo /etc/sudoers e adicione a seguinte linha ao seu final:
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/exim
Este comando parte do princípio que exim esteja instalado em /usr/sbin/exim.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[exim] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test exim
exim:{"queue_size": 0}
Agora você pode reiniciar o agente com o comando service agent360 restart
Criando gráficos
Clique em Métricas, no menu principal. Selecione exim como o tipo da métrica e queue_size para a métrica. Indique os servidores para os quais você gostaria de ter os gráficos e salve-os no painel principal (dashboard).
Plugin predefinido – GPU Monitor
Monitora o desempenho da placa de vídeo (GPU)
Obs.: o monitoramento do desempenho da placa GPU está disponível apenas para sistemas operacionais Windows.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[gpu] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test gpu
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – HA Proxy
Monitora o desempenho do seu servidor de balanceamento de carga HAProxy.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[haproxy] enabled = yes Test the plugin
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test haproxy
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Janus WebRTC
Monitora servidores WebRTC.
Configurando the plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[janus] enabled = yes
Testando the plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test janus
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Kamailio
Monitora o número de dispositivos conectados a um servidor Kamailio
Métricas
- Dispositivos conectados
Dependências
Para permitir que este plugin acesse seu servidor, adicione a seguinte linha ao arquivo /etc/sudoers
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/kamctl
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[kamailio] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test kamailio
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Litespeed
Monitora um servidor Litespeed.
Dependências
Este plugin requer o módulo requests. Para adicionar este módulo, execute o comando pip install requests
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[litespeed] enabled=yes host=localhost port=7080 username=admin password=pass
Substitua admin pelo seu nome de administrador e pass pela respectiva senha.
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test litespeed
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – MegaRaid
Monitora controladores MegaRaid.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[megacli] enabled=yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test megacli
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Memcached
Monitora serviços Memcached.
Dependências
Este plugin requer o módulo memcached para Python. Para instalar este módulo , execute o comando pip install python-memcached command.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[memcached] enabled=yes host=127.0.0.1 port=11211
Substitua os valores para host e port com o endereço de IP e o número da porta para o memcached no seu servidor.
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test memcached
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Minecraft
Monitora algumas métricas disponíveis nos servidores Minecraft.
Métricas
- Active players
- Max players
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[minecraft] enabled=yes hosts=127.0.0.1:8000,127.0.0.2:8000...
O valor hosts pode aceitar vários hosts Minecraft, sempre separados por vírgula. Você também pode optar por monitorar um único host.
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test minecraft e veja se algum dado é retornado.
Agora você pode reiniciar o agente com o comando service agent360 restart
Create Charts
On the Metrics page, select Minecraft as metric type, then select online to create a chart of your active and online players.
Criando gráficos
Clique em Métricas, no menu principal. Selecione minecraft como o tipo da métrica e, depois, selecione online para criar um gráfico dos jogadores que estejam ativos e online.
Plugin predefinido – Mongo DB
Monitora a instância do Mongo DB.
Métricas
- asserts.msg
- asserts.regular
- asserts.rollovers
- asserts.user
- asserts.warning
- connections.available
- connections.current
- connections.totalCreated
- mem: bits
- mem: mapped
- mem: mappedWithJournal
- mem: resident
- mem: supported
- mem: virtual
- opLatencies.commands.latency
- opLatencies.commands.ops
- opLatencies.reads.latency
- opLatencies.reads.ops
- opLatencies.writes.latency
- opLatencies.writes.ops
- opcounters.command
- opcounters.delete
- opcounters.getmore
- opcounters.insert
- opcounters.query
- opcounters.update
Dependências
Para instalar o plugin do MongoDB, instale o módulo pymongo através do comando pip install pymongo
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[mongodb] enabled=yes connection_string=mongodb://username:password@127.0.0.1:27017/admin
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test mongodb para ver se algum dado é retornado
JSON mongodb: { "asserts.msg": 0, "asserts.regular": 0, "asserts.rollovers": 0, "asserts.user": 0, "asserts.warning": 0, "connections.available": 50743, "connections.current": 457, "connections.totalCreated": 0, "mem": { "bits": 64, "mapped": 0, "mappedWithJournal": 0, "resident": 29966, "supported": true, "virtual": 45514 }, "opLatencies.commands.latency": 0, "opLatencies.commands.ops": 0, "opLatencies.reads.latency": 0, "opLatencies.reads.ops": 0, "opLatencies.writes.latency": 0, "opLatencies.writes.ops": 0, "opcounters.command": 0, "opcounters.delete": 0, "opcounters.getmore": 0, "opcounters.insert": 0, "opcounters.query": 0, "opcounters.update": 0 }
Agora você pode reiniciar o agente com o comando service agent360 restart
Criando gráficos
Clique em Métricas, no menu principal. Selecione mongodb como o tipo da métrica e escolha uma das métricas para criar um gráfico.
Plugin predefinido – MySQL
Monitora o desempenho de um servidor MySQL.
Métricas
- max_used_connections
- open_files
- open_tables
- qcache_free_blocks
- qcache_free_memory
- qcache_total_blocks
- slave_open_temp_tables
- threads_cached
- threads_connected
- threads_running
- uptime
- aborted_clients
- aborted_connects
- binlog_cache_disk_use
- binlog_cache_use
- bytes_received
- bytes_sent
- com_delete
- com_delete_multi
- com_insert
- com_insert_select
- com_load
- com_replace
- com_replace_select
- com_select
- com_update
- com_update_multi
- connections
- created_tmp_disk_tables
- created_tmp_files
- created_tmp_tables
- key_reads
- key_read_requests
- key_writes
- key_write_requests
- max_used_connections
- open_files
- open_tables
- opened_tables
- qcache_free_blocks
- qcache_free_memory
- qcache_hits
- qcache_inserts
- qcache_lowmem_prunes
- qcache_not_cached
- qcache_queries_in_cache
- qcache_total_blocks
- questions
- select_full_join
- select_full_range_join
- select_range
- select_range_check
- select_scan
- slave_open_temp_tables
- slave_retried_transactions
- slow_launch_threads
- slow_queries
- sort_range
- sort_rows
- sort_scan
- table_locks_immediate
- table_locks_waited
- threads_cached
- threads_connected
- threads_created
- threads_running
Dependências
MySQL-python
Execute o comando apt-get install python-mysqldb no Debian ou yum install MySQL-python para instalar o plugin requerido. Como alternativa, você pode executar o comando pip install MySQL-python
Se estiver rodando python3, você precisará exedcutar os comandos apt-get install python3-mysqldb ou pip3 install mysqlclient (mysql-devel é necessário para o CentOS yum install mysql-devel)
Criando um usuário MySQL
Se você estiver usando Plesk, crie um usuário MySQL que tenha acesso ao banco de dados performance_schema através do seguinte comando, onde safeandsecurepassword é a senha a ser atribuída ao usuário:
plesk db "CREATE USER 'agent360'@'127.0.0.1' IDENTIFIED BY 'safeandsecurepassword'"
Caso contrário, crie um usuário MySQL que tenha acesso ao banco de dados performance_schema através do seguinte comando, onde safeandsecurepassword é a senha a ser atribuída ao usuário:
sudo mysql -e "CREATE USER 'agent360'@'127.0.0.1' IDENTIFIED BY 'safeandsecurepassword';"sudo mysql -e "GRANT PROCESS ON *.* TO 'agent360'@'127.0.0.1';"sudo mysql -e "GRANT SELECT ON performance_schema.* TO 'agent360'@'127.0.0.1';"
Caso queira ativar o monitoramento de uma replica do banco de dados, você terá que executar a seguinte query também:
sudo mysql -e "grant replication client on *.* to 'agent360'@'127.0.0.1';"
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[mysql] enabled=yes username=agent360 password=safeandsecurepassword host=127.0.0.1 database=performance_schema port=3306 socket=null
Testando o plugin
Para ver se o plugin está funcionando, execute o comando agent360 –test mysql As seguintes métricas deverão ser mostradas:
JSON mysql: { "aborted_clients": 0, "aborted_connects": 0, "binlog_cache_disk_use": 0, "binlog_cache_use": 0, "bytes_received": 0, "bytes_sent": 0, "com_delete": 0, "com_delete_multi": 0, "com_insert": 0, "com_insert_select": 0, "com_load": 0, "com_replace": 0, "com_replace_select": 0, "com_select": 0, "com_update": 0, "com_update_multi": 0, "connections": 0, "created_tmp_disk_tables": 0, "created_tmp_files": 0, "created_tmp_tables": 0, "key_read_requests": 0, "key_reads": 0, "key_write_requests": 0, "key_writes": 0, "max_used_connections": 2.0, "open_files": 6.0, "open_tables": 71.0, "opened_tables": 0, "qcache_free_blocks": 1.0, "qcache_free_memory": 67091584.0, "qcache_hits": 0, "qcache_inserts": 0, "qcache_lowmem_prunes": 0, "qcache_not_cached": 0, "qcache_queries_in_cache": 0, "qcache_total_blocks": 1.0, "questions": 0, "select_full_join": 0, "select_full_range_join": 0, "select_range": 0, "select_range_check": 0, "select_scan": 0, "slave_open_temp_tables": 0.0, "slow_launch_threads": 0, "slow_queries": 0, "sort_range": 0, "sort_rows": 0, "sort_scan": 0, "table_locks_immediate": 0, "table_locks_waited": 0, "threads_cached": 1.0, "threads_connected": 1.0, "threads_created": 0, "threads_running": 1.0, "uptime": 59949.0 }
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – NGINX
Monitora um servidor web NGiNX.
Métricas
- Requests per second
- Accepts per second
- Handled per second
- Total requests
- Active connections
- Writing
- Waiting
- Reading
Dependências
urllib2
nginx compiled with the –with-http_stub_status_module parameter
Ativando a página de status do NGiNX
Para ativar a página de status do NGiNX, adicione o seguinte código ao arquivo de configuração habilitado para o NGiNX:
server { listen 127.0.0.1:8080; server_name localhost; location /status_page { stub_status on; allow 127.0.0.1; deny all; } }
A página de status somente estará disponível por meio de uma máquina que esteja executando o NGiNX. Se você tiver outra coisa em execução na porta 8080, pode trocá-la para uma página disponível.
Teste se a página de status está funcionando através da seguinte linha:
wget -qO- http://127.0.0.1:8080/status_page
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[nginx] enabled = yes status_page_url = http://127.0.0.1:8080/status_page
Testando o plugin
Para testar o plugin, execute o comando agent360 –test nginx
As seguintes métricas deverão ser exibidas:
JSON nginx: { "accepts": 505768, "accepts_per_second": 0, "active_connections": 198, "handled": 505768, "handled_per_second": 0, "reading": 0, "requests": 8335225, "requests_per_second": 0, "waiting": 196, "writing": 2 }
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Open VPN
Monitora conexões de um servidor OpenVPN.
Criando gráficos
Clique em Métricas, no menu principal. Selecione asterisk como o tipo da métrica e calls para a métrica. Indique os servidores para os quais você gostaria de ter os gráficos e salve-os no painel principal (dashboard).
Dependências
Este plugin requer acesso ao arquivo de log openvpn-status log.
Para permitir este acesso, execute os comandos pip install openvpn-status command ou pip3 install openvpn-status
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[openvpn] enabled=yes status_path = /etc/openvpn/openvpn-status.log
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test openvpn
Se tiver problemas com este plugin, execute o agente de monitoramento como um usuário root.
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Power DNS
Monitora servidores PowerDNS
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[powerdns] enabled=yes statistics_url=<http://localhost:8081/api/v1/servers/localhost/statistics> api_key=changeme
Certifique-se de alterar a configuração api_key da sua chave de API atual, disponível na sua página da API.
Depois, adicione as seguintes linhas ao o arquivo /etc/agent360.ini
ca_file=filename ca_path=path timeout=10
Substitua filename pelo nome do CA do servidor; e path pelo caminho absoluto do arquivo.
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test powerdns
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Rabbit MQ
Monitora o sistema de mensageria RabbitMQ.
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[rabbitmq] enabled=yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test rabbitmg
Agora você pode reiniciar o agente com o comando service agent360 restart
HYPERLINK “https://docs.360monitoring.com/docs/powerdns-plugin”
Plugin predefinido – Redis
Permite monitorar o sistema Redis.
Métricas
As métricas disponíveis no Redis podem ser encontradas no código-fonte do plugin. Você pode habilitá-las ou desabilitá-las através de comentários, iniciando as linhas das métricas que deseja desabilitar com o caractere #.
Dependências
redis pypi
Se você estiver rodando python3, pode executar pip3 install redis. Se estiver rodando uma versão python2 agent360, então pode executar pip install redis.
Encontre a versão do seu Python através do comando agent360 info command. A pasta do plugin terá a versão do Python. P. ex: /usr/local/lib/python3.6/
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[redis_stat] enabled=yes host=agent360 port=123 db=dbname password=safeandsecurepassword
Testando o plugin
Para testar o plugin, execute o comando agent360 test redis_stat
Os seguintes dados deverão ser retornados:
JSON redis_stat: { "uptime_in_seconds": 59949.0,... }
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Software RAID
Mantém o controle de discos com falha, em uma configuração RAID
Métricas
- Faulty
- Active
- Resync
- Read only
Dependências
Este plugin requer o plugin do Python chamado mdstat. Você pode instalá-lo através do comando pip install mdstat
Para funcionar corretamente, o plugin também precisa do acesso sudo . Para isso, edite o arquivo /etc/sudoers e adicione a seguinte linha ao final:
agent360 ALL=(ALL) NOPASSWD: /usr/local/bin/mdjson
É um pré-requisito a existência do mdjson em /usr/local/bin/mdjson.
Para conferir essa localização, execute o comando whereis mdjson
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[mdstat] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test mdstat e verifique se os seguintes dados são retornados:
JSON mdstat: { "md0": { "active": 1, "faulty": 0, "read_only": 0, "resync": 0 }, "md1": { "active": 1, "faulty": 0, "read_only": 0, "resync": 0 }, "md2": {"active": 1, "faulty": 0, "read_only": 0, "resync": 0 } }
Agora você pode reiniciar o agente com o comando service agent360 restart
Criando gráficos
Clique em Métricas, no menu principal. Selecione mdstat como o tipo da métrica e active/faulty/read_only/resync para a métrica. Indique os servidores para os quais você gostaria de ter os gráficos e salve-os no painel principal (dashboard).
Você pode criar um alerta para quando a métrica com problema for maior que zero. Isso irá indicar que um servidor possui uma unidade defeituosa.
Plugin predefinido – PHP-FPM
Permite monitorar o desempenho de processos PHP-FPM no servidor.
Métricas
- Accepted connections (per second, total)
- Active processes
- Total processes
- Idle processes
- Max active processes
- Listen queue
- Listen queue length
- Max listen queue
- Max children reached
- Start time
- Start since
- Pool
- Process manager
- Slow requests
Dependências
urllib2
json
Ativando a página de status PHP-FPM
Para habilitar a página de status do PHP-FPM, adicione o seguinte código ao seu arquivo de configuração do pool PHP-FPM:
pm.status_path = /status_phpfpm
Depois, faça as seguintes alterações no seu arquivo de configuração:
NGINX Text server {listen 127.0.0.1:8080; server_name localhost; location /status_phpfpm { fastcgi_pass 127.0.0.1:9000; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; allow 127.0.0.1; deny all; } }
Apache2
No Apache, edite o arquivo etc/apache2/mods-available/fastcgi.conf (ou similar)
Text <IfModule mod_fastcgi.c> # Define a named handler AddHandler php7-fcgi .php # Generate an alias pointing to /usr/lib/cgi-bin/php[VersionNumber]-fcgi Alias /php7-fcgi /usr/lib/cgi-bin/php7-fcgi # Configure an external server handling your upcoming requests (note where the alias is pointing towards) FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.0-fpm.sock -pass-header Authorization # only on if fpm-status is match. You might want to put this into your concrete vhost.conf file. For the testing, fastcgi.conf should work. <LocationMatch "/status_phpfpm"> Order deny,allowD eny from all Allow from 127.0.0.1 # set the before defined handler here SetHandler php7-fcgi # use the handler for the action handling virtual requests Action php7-fcgi /php7-fcgi virtual </LocationMatch> </IfModule>
Você pode testar se a página de status está funcionando através do seguinte comando:
wget -qO- http://127.0.0.1:8080/status_phpfpm?json
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[phpfpm] enabled = yes status_page_url = http://127.0.0.1:8080/status_phpfpm?json
Testando o plugin
Para ver se o plugin está funcionando, execute o comando agent360 –test phpfpm
As seguintes métricas deverão ser retornadas:
JSON phpfpm: { "accepted_conn": 3015, "accepted_conn_per_second": 0.0, "active_processes": 1, "idle_processes": 0, "listen_queue": 0, "listen_queue_len": 128, "max_active_processes": 1, "max_children_reached": 0, "max_listen_queue": 1, "pool": "www", "process_manager": "ondemand", "slow_requests": 0, "start_since": 294686, "start_time": 1492504250, "total_processes": 1 }
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Unbound DNS
Monitora um servidor denominado Unbound DNS.
Dependências
Este plugin requer que você adicione a seguinte linha em seu arquivo /etc/sudoers :
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/unbound-control
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[unbound] enabled=yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test unbound
Agora você pode reiniciar o agente com o comando service agent360 restart
Plugin predefinido – Virtual Machine
Rastreia máquinas virtuais convidadas no seu servidor (Ex.: KVM, QEMU, Xen, Virtuozzo, VMWare ESX, LXC…)
Métricas
- Disk read (bytes)
- Disk write (bytes)
- Disk read (requests)
- Disk write (requests)
- Networking out (bytes)
- Networking in (bytes)
- CPU Usage
- Memory Usage
- Memory min guaranteed
- Memory hard limit
- Memory soft limit
Dependências
apt-get install python-libxml2 libvirt-dev
O Virtual Machine precisa do plugin libirt-python para funcionar. Você pode instalá-lo através do comando pip install libvirt-python , ou através do comando pip3 install libvirt-python (caso esteja rodando o agente no Python3).
Configurando o plugin
Para ativar o plugin, edite o arquivo /etc/agent360.ini e adicione as seguintes linhas:
[vms] enabled = yes
Testando o plugin
Para testar o plugin, execute o comando sudo -u agent360 agent360 test vms
Agora você pode reiniciar o agente com o comando service agent360 restart