Table of Contents
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 informando 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 determinado módulo. Recomenda-se instalar novos módulos um por um para identificar falhas facilmente.
Antes de instalar um módulo:
- Certifique-se de que você baixou 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 versão pode ser habilitada por vez
Etapas para instalar um módulo:
- Descompacte seu módulo em sua própria pasta dentro da pasta
modulesdo frontend do Zabbix - Certifique-se de que a pasta do seu módulo contenha pelo menos o arquivo manifest.json
- Navegue até a Administração de módulos e clique no botão Procurar diretório
- 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, certifique-se de que o manifest.json existe em modules/seu-modulo/. Se não existir, você pode ter 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 acesso de leitura e execução (+rx) à pasta do módulo e a todos os subdiretórios, e acesso de leitura (+r) a todos os arquivos dentro dela. |
| 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 servidor. 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 Procurar diretório novamente para remover módulos inexistentes do banco de dados. |
| Mensagem de erro sobre namespace, ID ou ações idênticas | O novo módulo tentou registrar um namespace, ID ou ações que já estão registrados por outros módulos habilitados. Desabilite o módulo conflitante (mencionado na mensagem de erro) antes de habilitar o novo. |
| Mensagens de erro técnico aparecem | Reporte os erros ao desenvolvedor do módulo. |
Desenvolvendo módulos
Para obter informações sobre o desenvolvimento de módulos personalizados, consulte o Centro do desenvolvedor.