Instalação da interface web

Esta seção fornece instruções passo a passo para instalar a interface web do Zabbix. Siga estas etapas depois de ter instalado o backend do Zabbix - Zabbix server, agent e banco de dados.

O frontend do Zabbix é escrito em PHP, portanto, para executá-lo, é necessário um servidor web com suporte a PHP.

Installation wizard

To install the web interface, open the Zabbix frontend URL in a browser:

  • For Apache: http://<server_ip_or_name>/zabbix
  • For NGINX: http://<server_ip_or_name>

Tela de boas-vindas

Abra a URL do frontend do Zabbix no navegador:

  • Para Apache: http://<server_ip_or_name>/zabbix
  • Para Nginx: http://<server_ip_or_name>

Você deverá ver a primeira tela do assistente de instalação do frontend.

Use o menu suspenso Idioma padrão para alterar o idioma padrão do sistema e continuar o processo de instalação no idioma selecionado (opcional). Para mais informações, consulte Instalação de idiomas adicionais do frontend.

Observe que definir o idioma como English (en_US) também habilitará o formato de data/hora dos EUA no frontend.

Verificação de pré-requisitos

Certifique-se de que todos os pré-requisitos obrigatórios do frontend do Zabbix sejam atendidos.

Pré-requisito Valor mínimo Descrição
Versão do PHP 8.2.0
Opção do PHP memory_limit 128MB Em php.ini: memory_limit = 128M
Opção do PHP post_max_size 16MB Em php.ini: post_max_size = 16M
Opção do PHP upload_max_filesize 2MB Em php.ini: upload_max_filesize = 2M
Opção do PHP max_execution_time 300 segundos Em php.ini: max_execution_time = 300 (os valores 0 e -1 também são permitidos)
Opção do PHP max_input_time 300 segundos Em php.ini: max_input_time = 300 (os valores 0 e -1 também são permitidos)
Suporte a bancos de dados PHP Um de: MySQL, PostgreSQL Consulte Requirements para a lista de todas as extensões PHP obrigatórias e opcionais. Observe que os pré-requisitos opcionais com falha são exibidos com um status vermelho de Warning, e o processo de configuração pode continuar mesmo que eles não sejam atendidos.
PHP bcmath deve estar habilitado
PHP mbstring deve estar habilitado
Opção do PHP session.auto_start deve estar desabilitada Em php.ini: session.auto_start = 0
Opção do PHP arg_separator.output & Em php.ini: arg_separator.output = "&" (o valor "&amp;" também é permitido)

Se o usuário ou grupo de usuários do Apache precisar ser alterado, verifique as permissões da pasta de sessão; caso contrário, a configuração do Zabbix pode não conseguir continuar.

Configurar conexão com o banco de dados

Informe os detalhes para conectar ao banco de dados. O banco de dados do Zabbix já deve ter sido criado.

Para MySQL, informar localhost ou deixar o campo Database host em branco resulta na conexão via socket Unix padrão. O formulário de configuração não fornece um campo separado Database socket, portanto, para usar um socket personalizado, configure-o nas definições do Zabbix server (por exemplo, com DBSocket= em zabbix_server.conf). Isso mantém o frontend alinhado com as definições de conexão entre o server e o banco de dados.

Para PostgreSQL, o campo Database host pode conter várias entradas host:port separadas por vírgulas. A string é dividida em partes e cada porta é validada da mesma forma que o campo Database port. Após a validação bem-sucedida, a string é analisada em hosts e portas para compor a string de conexão. Se uma porta não estiver definida para um host na lista separada por vírgulas, o valor de Database port é usado como porta padrão. Se o campo Database host for deixado em branco, o socket Unix de domínio padrão será usado. Se um caminho de socket for informado (por exemplo, /var/run/pgbouncer), esse socket Unix de domínio será usado em seu lugar.

Se a opção Database TLS encryption estiver marcada, campos adicionais para configurar a conexão TLS com o banco de dados aparecerão no formulário (somente MySQL ou PostgreSQL).

Se Store credentials in estiver definido como HashiCorp Vault ou CyberArk Vault, parâmetros adicionais ficarão disponíveis:

  • para HashiCorp Vault: endpoint da API do Vault, prefixo do Vault, caminho do segredo e token de autenticação ou AppRole;

  • para CyberArk Vault: endpoint da API do Vault, prefixo do Vault, string de consulta do segredo e certificados. Ao marcar a caixa Vault certificates, dois novos campos para especificar os caminhos do arquivo de certificado SSL e do arquivo de chave SSL serão exibidos.

Configurações

Inserir um nome para o Zabbix server é opcional; no entanto, se informado, ele será exibido na barra de menu e nos títulos das páginas.

Defina o fuso horário e o tema padrão para o frontend.

Se a opção Criptografar conexões da interface web estiver marcada, campos adicionais para configurar a conexão TLS entre o Zabbix server e o frontend aparecerão no formulário.

Resumo da pré-instalação

Revise um resumo das configurações.

A subpágina mostrará os dados se a configuração TLS tiver sido adicionada.

Instalação

Se estiver instalando o Zabbix a partir do código-fonte, faça o download do arquivo de configuração e coloque-o em conf/ no subdiretório de documentos HTML do webserver onde você copiou os arquivos PHP do Zabbix.

Se o usuário do webserver tiver permissão de gravação no diretório conf/, o arquivo de configuração será salvo automaticamente e será possível prosseguir para a próxima etapa imediatamente.

Conclua a instalação.

Fazer login

O frontend do Zabbix está pronto! O nome de usuário padrão é Admin, a senha é zabbix.

Continue para o guia de monitoramento Linux.

Frontend configuration file

After installation, you can reconfigure the Zabbix frontend by updating parameters in the zabbix.conf.php frontend configuration file.

The default path to the configuration file depends on the operating system and Zabbix installation method:

  • For installation from packages: /usr/share/zabbix/ui/conf/zabbix.conf.php
  • For installation from sources: /var/www/html/zabbix/conf/zabbix.conf.php
  • For appliance: /etc/zabbix/web/zabbix.conf.php

See the configuration file options for details on configuring the Zabbix frontend.