Comandos remotos

Visão geral

Com comandos remotos, você pode definir que um determinado comando predefinido seja executado automaticamente no host monitorado quando uma determinada condição ocorrer.

Assim, os comandos remotos são um mecanismo poderoso para monitoramento proativo inteligente.

Nos usos mais óbvios do recurso, você pode tentar:

• Reiniciar automaticamente algum aplicativo (servidor web, middleware, CRM) se ele não responder
• Usar o comando IPMI 'reboot' para reiniciar algum server remoto se ele não responder às solicitações
• Liberar automaticamente espaço em disco (removendo arquivos mais antigos, limpando /tmp) se o espaço em disco estiver acabando
• Migrar uma VM de uma máquina física para outra com base na carga de CPU
• Adicionar novos nós a um ambiente de nuvem quando houver recursos insuficientes de CPU (disco, memória, o que for)

Configurar uma ação para comandos remotos é semelhante a configurar o envio de uma mensagem; a única diferença é que o Zabbix executará um comando em vez de enviar uma mensagem.

Os comandos remotos podem ser executados por Zabbix server, proxy ou agent. Os comandos remotos no Zabbix agent podem ser executados diretamente pelo Zabbix server ou por meio do Zabbix proxy. Tanto no Zabbix agent quanto no Zabbix proxy, os comandos remotos são desabilitados por padrão. Eles podem ser habilitados por meio de:

• adicionar um parâmetro AllowKey=system.run[*] na configuração do agent;
• definir o parâmetro EnableRemoteCommands como 1 na configuração do proxy.

Os comandos remotos executados pelo Zabbix server são executados conforme descrito em Execução de comandos, incluindo a verificação do código de saída.

Os comandos remotos são executados mesmo que o host de destino esteja em manutenção.

Limite de comando remoto

O limite de comando remoto após resolver todas as macros depende do tipo de banco de dados e do conjunto de caracteres (caracteres não ASCII exigem mais de um byte para serem armazenados):

A saída da execução do comando remoto (valor de retorno) é limitada a 16MB (incluindo espaços em branco à direita que são truncados). O limite do comando remoto IPMI é baseado na biblioteca IPMI instalada. Observe que os limites do banco de dados se aplicam a todos os comandos remotos.

Configuração

Esses comandos remotos que são executados no Zabbix agent (scripts personalizados) devem primeiro ser habilitados na configuração do agent.

Certifique-se de que o parâmetro AllowKey=system.run[<command>,*] seja adicionado para cada comando permitido na configuração do agent, para permitir um comando específico no modo nowait. Reinicie o daemon do agent se esse parâmetro for alterado.

Em seguida, ao configurar uma nova ação em Alerts > Actions > Trigger actions:

1. Defina as condições apropriadas, por exemplo, configure a ação para ser ativada em caso de quaisquer problemas de disaster em uma das aplicações Apache.

2. Na aba Operations, clique em Add no bloco Operations, Recovery operations ou Update operations.

3. Selecione um dos scripts predefinidos na lista suspensa Operation e defina a Target list para o script.

Scripts predefinidos

Scripts que estão disponíveis para operações de ação (webhook, script, SSH, Telnet, IPMI) são definidos em global scripts com Action operation selecionado como seu escopo.

Por exemplo:

sudo /etc/init.d/apache restart 

Nesse caso, o Zabbix tentará reiniciar um processo do Apache. Com este comando, certifique-se de que o comando seja executado no Zabbix agent (clique no botão Zabbix agent em Execute on).

Comandos remotos no Zabbix agent são executados sem timeout pela chave system.run[,nowait] e não são verificados quanto aos resultados de execução. No Zabbix server e no Zabbix proxy, os comandos remotos são executados com timeout conforme definido no parâmetro TrapperTimeout do arquivo zabbix_server.conf ou zabbix_proxy.conf e são verificados quanto aos resultados de execução. Para informações adicionais, consulte Script timeout.

Permissões de acesso

Certifique-se de que o usuário 'zabbix' tenha permissões de execução para os comandos configurados. Pode ser interessante usar sudo para conceder acesso a comandos privilegiados. Para configurar o acesso, execute como root:

visudo

Exemplos de linhas que podem ser usadas no arquivo sudoers:

# permite que o usuário 'zabbix' execute todos os comandos sem senha.
zabbix ALL=NOPASSWD: ALL

# permite que o usuário 'zabbix' reinicie o apache sem senha.
zabbix ALL=NOPASSWD: /etc/init.d/apache restart

Comandos remotos com múltiplas interfaces

Se o sistema de destino tiver várias interfaces do tipo selecionado (agent Zabbix ou IPMI), os comandos remotos serão executados na interface padrão.

É possível executar comandos remotos via SSH e Telnet usando uma interface diferente da agent Zabbix. A interface disponível para uso é selecionada na seguinte ordem:

• interface padrão do agent Zabbix
• interface padrão SNMP
• interface padrão JMX
• interface padrão IPMI

Comandos remotos IPMI

Para comandos remotos IPMI, a seguinte sintaxe deve ser usada:

<comando> [<valor>]

onde

• <comando> - um dos comandos IPMI sem espaços
• <valor> - 'on', 'off' ou qualquer número inteiro sem sinal. <valor> é um parâmetro opcional.

Exemplos

Exemplos de scripts globais que podem ser usados como comandos remotos em operações de ação.

Exemplo 1

Reinicialização do Windows em determinada condição.

Para reiniciar automaticamente o Windows quando um problema for detectado pelo Zabbix, defina o seguinte script:

Exemplo 2

Reinicie o host usando o controle IPMI.

Exemplo 3

Desligue o host usando o controle IPMI.