3 Módulos do frontend

Visão geral

É possível aprimorar a funcionalidade do frontend do Zabbix adicionando módulos de terceiros ou desenvolvendo seus próprios módulos sem a necessidade de alterar o código-fonte do Zabbix.

Observe que o código do módulo será executado com os mesmos privilégios do código-fonte do Zabbix. Isso significa:

  • módulos de terceiros podem ser prejudiciais. Você deve confiar nos módulos que está instalando;
  • Erros no código de um módulo de terceiros podem travar o frontend. Se isso acontecer, basta remover o código do módulo do frontend. Assim que você recarregar o frontend do Zabbix, verá uma nota dizendo que alguns módulos estão ausentes. Vá para Administração de módulos (em Administração → Geral → Módulos) e clique em Verificar diretório novamente para remover módulos inexistentes do banco de dados.

Instalação

Leia sempre o manual de instalação de um módulo específico. É recomendável instalar novos módulos um por um para identificar falhas com facilidade.

Logo antes de instalar um módulo:

  • Certifique-se de ter baixado o módulo de uma fonte confiável. A instalação de código malicioso pode levar a consequências, como perda de dados
  • Diferentes versões do mesmo módulo (mesmo ID) podem ser instaladas em paralelo, mas apenas uma única versão pode ser habilitada por vez

Etapas para instalar um módulo:

  • Descompacte seu módulo dentro da própria pasta dele na pasta modules do frontend do Zabbix
  • Verifique se a pasta do módulo contém pelo menos o arquivo manifest.json
  • Navegue até Administração de módulos e clique no botão Scan directory
  • O novo módulo aparecerá na lista junto com sua versão, autor, descrição e status
  • Habilite o módulo clicando em seu status

Solução de problemas:

Problema Solução
O módulo não apareceu na lista Se o seu módulo não apareceu na lista, verifique se manifest.json existe em modules/seu-modulo/. Se não existir, talvez você tenha descompactado o módulo no diretório errado. Se existir, o módulo pode não ser compatível com a sua versão do Zabbix. Além disso, verifique se o usuário do servidor web tem pelo menos permissão de leitura e busca (r-x) para a pasta do módulo e todos os subdiretórios, e permissão de leitura (r--) para todos os arquivos dentro dela.
O frontend travou O código do módulo não é compatível com a versão atual do Zabbix ou com a configuração do server. Exclua os arquivos do módulo e recarregue o frontend. Você verá um aviso de que alguns módulos estão ausentes. Vá para Administração de módulos e clique em Scan directory novamente para remover do banco de dados os módulos inexistentes.
Aparece uma mensagem de erro sobre namespace, ID ou actions idênticos O novo módulo tentou registrar um namespace, ID ou actions que já estão registrados por outros módulos habilitados. Desabilite o módulo em conflito (mencionado na mensagem de erro) antes de habilitar o novo.
Aparecem mensagens de erro técnicas Reporte os erros ao desenvolvedor do módulo.

Desenvolvendo módulos

Para informações sobre o desenvolvimento de módulos personalizados, consulte o Centro de desenvolvedores.