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

Assim, os comandos remotos são um mecanismo avançado para o monitoramento proativo inteligente.

Nos usos mais óbvios desse recurso, você pode:

Reiniciar automaticamente algum aplicativo (web server, middleware, CRM) se ele não responder
Usar o comando reboot do IPMI para reiniciar algum server remoto se ele não responder às solicitações
Liberar espaço em disco automaticamente (removendo arquivos antigos, limpando /tmp) quando o espaço em disco estiver acabando
Migrar uma VM de um equipamento físico para outro dependendo da carga da CPU
Adicionar novos nós a um ambiente de nuvem quando os recursos de CPU (disco, memória ou qualquer outro) forem insuficientes

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

Os comandos remotos podem ser executados pelo Zabbix server, pelo Zabbix proxy ou pelo Zabbix agent. Observe o seguinte:

Os comandos remotos no Zabbix agent podem ser executados diretamente pelo Zabbix server ou por meio do Zabbix 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 quando o host de destino está em modo de manutenção.

Os comandos remotos são desabilitados por padrão tanto no Zabbix agent quanto no Zabbix proxy. Eles podem ser habilitados da seguinte forma:

Para comandos remotos executados pelo Zabbix agent, adicione um parâmetro AllowKey=system.run[<command>,*] ou AllowKeyRegexp=^system\.run\[<command>,.*\]$ para cada comando permitido na configuração do agent, em que * corresponde a qualquer um dos modos de execução (wait ou nowait).
Para comandos remotos executados pelo Zabbix proxy, defina o parâmetro EnableRemoteCommands como 1 na configuração do proxy. Observe que não é necessário habilitar os comandos remotos no Zabbix proxy quando eles são executados pelo Zabbix agent em um host monitorado pelo proxy.

Não use AllowKey=system.run[*] ou AllowKeyRegexp=^system\.run\[.*\]$ a menos que seja necessário, pois isso permite a execução de qualquer comando no host. Por motivos de segurança, é recomendável permitir apenas comandos exatos, enquanto system.run[*] é negado por padrão (DenyKey=system.run[*]).

Consulte também Restringindo verificações do agent.

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):

Banco de dados	Limite em caracteres	Limite em bytes
MySQL	65535	65535
PostgreSQL	65535	sem limite
SQLite (apenas Zabbix proxy)	65535	sem limite

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

Os comandos remotos executados pelo Zabbix agent devem primeiro ser permitidos na configuração do agent usando o parâmetro AllowKey ou AllowKeyRegexp.

Certifique-se de que o parâmetro AllowKey=system.run[<command>,*] ou AllowKeyRegexp=^system\.run\[<command>,.*\]$ seja adicionado à configuração do agent para cada comando permitido, a fim de permitir sua execução no modo nowait. Reinicie o daemon do agent após alterar o parâmetro.

Em seguida, ao configurar uma nova ação em Alertas > Ações > Ações de trigger:

Defina as condições apropriadas; por exemplo, configure a ação para ser ativada quando ocorrer qualquer problema de desastre em uma das aplicações Apache.

Na aba Operações, clique em Adicionar na seção Operações, Operações de recuperação ou Operações de atualização.

Selecione um dos scripts predefinidos na lista suspensa Operação e defina a Lista de destinos 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).

Observe o uso de sudo - o usuário do Zabbix não tem permissões para reiniciar serviços do sistema por padrão. Veja abaixo dicas sobre como configurar sudo.

A partir do Zabbix agent 7.0, comandos remotos também podem ser executados em um agent que esteja operando em modo ativo. O Zabbix agent - seja ativo ou passivo - deve ser executado no host remoto e executa os comandos em segundo plano.

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

Em alguns sistemas, o arquivo sudoers impedirá que usuários não locais executem comandos. Para alterar isso, comente a opção requiretty em /etc/sudoers.

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:

Script parameter	Value
Scope	'Action operation'
Type	'Script'
Command	`c:\windows\system32\shutdown.exe -r -f`

Exemplo 2

Reinicie o host usando o controle IPMI.

Parâmetro do script	Valor
Escopo	'Operação de ação'
Tipo	'IPMI'
Comando	reset

Exemplo 3

Desligue o host usando o controle IPMI.

Parâmetro do script	Valor
Escopo	'Operação de ação'
Tipo	'IPMI'
Comando	desligar

O que vem a seguir?

Operações adicionais

Docs

Comandos remotos

Visão geral