[comment]: # ({94469ada-ed2f6c13})
# 2 Módulos do frontend

[comment]: # ({/94469ada-ed2f6c13})

[comment]: # ({8c4f6bda-1060eddf})
#### 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](/manual/web_interface/frontend_sections/administration/general#modules) (em *Administração* → *Geral* → *Módulos*) e clique em *Verificar diretório* novamente para remover módulos inexistentes do banco de dados.

[comment]: # ({/8c4f6bda-1060eddf})

[comment]: # ({5e6af176-cffdc09c})
#### 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
-   Acesse [Administração de módulos](/manual/web_interface/frontend_sections/administration/general#modules)
    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. Acesse [Administração de módulos](/manual/web_interface/frontend_sections/administration/general#modules) 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.|

[comment]: # ({/5e6af176-cffdc09c})

[comment]: # ({5ca56638-26c922c0})
#### Desenvolvendo módulos

Para obter informações sobre o desenvolvimento de módulos personalizados, consulte o [Centro do desenvolvedor](/devel/modules).

[comment]: # ({/5ca56638-26c922c0})