9 Serviço web do Zabbix

Visão geral

O serviço web do Zabbix é um processo usado para comunicação com serviços web externos.

Os parâmetros suportados pelo arquivo de configuração do serviço web do Zabbix (zabbix_web_service.conf) estão listados nesta seção.

Os parâmetros são listados sem informações adicionais. Clique no parâmetro para ver os detalhes completos.

Todos os parâmetros são não obrigatórios, a menos que seja explicitamente indicado que o parâmetro é obrigatório.

Observe que:

• Os valores padrão refletem os padrões do processo, não os valores nos arquivos de configuração fornecidos;
• Os valores suportam variáveis de ambiente;
• O Zabbix suporta arquivos de configuração apenas em codificação UTF-8 sem BOM;
• Comentários que começam com # são suportados apenas no início da linha.

Detalhes do parâmetro

AllowedIP

Uma lista de endereços IP separados por vírgula, opcionalmente na notação CIDR, ou nomes DNS de servidores Zabbix e proxies Zabbix. As conexões de entrada serão aceitas apenas dos hosts listados aqui.
Se o suporte a IPv6 estiver habilitado, então 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 são tratados igualmente e ::/0 permitirá qualquer endereço IPv4 ou IPv6. 0.0.0.0/0 pode ser usado para permitir qualquer endereço IPv4.

Exemplo:

127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Obrigatório: sim

DebugLevel

Especifique o nível de depuração:

• 0 - informações básicas sobre a inicialização e a finalização dos processos do Zabbix;
• 1 - informações críticas;
• 2 - informações de erro;
• 3 - avisos;
• 4 - para depuração (produz muitas informações);
• 5 - depuração estendida (produz ainda mais informações).

Padrão: 3
Intervalo: 0-5

IgnoreURLCertErrors

Especifica o tratamento de erros de validação de certificado TLS ao acessar a URL do frontend:
0 - não ignorar erros de certificado;
1 - ignorar erros de certificado.

Padrão: 0
Intervalo: 0-1

Include

Especifique um diretório ou arquivos individuais a serem incluídos no arquivo de configuração.
Durante a instalação do Zabbix, esse parâmetro é definido como /usr/local/etc, a menos que você altere isso durante o tempo de compilação.

Regras gerais para o parâmetro Include:

• O caminho pode ser relativo ao local do arquivo zabbix_web_service.conf.
• Você pode especificar vários parâmetros Include em um único arquivo de configuração.
• O Zabbix processa o parâmetro Include assim que o lê, portanto considere colocá-lo no final do arquivo de configuração.

Regras para arquivos incluídos:

• Cada arquivo deve ser legível.
• Cada arquivo deve ter sintaxe correta. Caso contrário, o componente não será iniciado.

Regras para incluir diretórios ou padrões de arquivo:

• Não assuma nenhuma ordem de inclusão (por exemplo, os arquivos não são incluídos em ordem alfabética).
• Não defina o mesmo parâmetro em mais de um arquivo incluído (por exemplo, para substituir uma configuração geral por uma específica), pois não é possível prever qual valor será usado.
• Fique atento às cópias de backup que alguns editores de texto criam automaticamente (por exemplo, editar include/my_specific.conf pode criar include/my_specific.conf.BAK), pois ambos os arquivos serão incluídos.

Para incluir apenas os arquivos relevantes de um diretório, use o curinga (*) para correspondência de padrões.

Exemplo:

Include=/absolute/path/to/config/files/*.conf

ListenPort

O serviço irá escutar neste porto por conexões do server.

Padrão: 10053
Intervalo: 1024-32767

LogFile

O nome do arquivo de log.

Exemplo:

/tmp/zabbix_web_service.log

Obrigatório: Sim, se LogType estiver definido como file; caso contrário, não

LogFileSize

O tamanho máximo de um arquivo de log em MB.
0 - desabilita a rotação automática do log.
Nota: Se o limite de tamanho do arquivo de log for atingido e a rotação do arquivo falhar, por qualquer motivo, o arquivo de log existente será truncado e iniciado novamente.

Padrão: 1
Intervalo: 0-1024

LogType

O tipo da saída de log:

• file - grava o log no arquivo especificado pelo parâmetro LogFile;
• system - grava o log no syslog;
• console - grava o log na saída padrão.

Padrão: file

Timeout

O tempo máximo (em segundos) gasto na formatação do relatório em PDF de um dashboard.

Padrão: 10
Intervalo: 1-30

TLSAccept

Quais conexões de entrada aceitar:

• unencrypted - aceitar conexões sem criptografia (padrão);
• cert - aceitar conexões com TLS e um certificado.

Padrão: unencrypted

TLSCAFile

O caminho completo do arquivo contendo o(s) certificado(s) da(s) CA(s) de nível superior para verificação do certificado do par, usado para comunicações criptografadas entre os componentes do Zabbix.

TLSCertFile

O caminho completo do arquivo que contém o certificado do serviço ou cadeia de certificados, usado para comunicações criptografadas com os componentes do Zabbix.

TLSKeyFile

O caminho completo do arquivo contendo a chave privada do serviço, usada para comunicações criptografadas entre os componentes do Zabbix.