Parâmetros de configuração: Zabbix agent 2

Visão geral

Os parâmetros de configuração permitem personalizar o comportamento do Zabbix agent 2.

O Zabbix agent 2 é uma nova geração do Zabbix agent e pode ser usado no lugar do Zabbix agent.

Especifique os valores dos parâmetros no arquivo de configuração (zabbix_agent2.conf). Todos os parâmetros são opcionais, a menos que seja explicitamente indicado que o parâmetro é obrigatório.

Esta página está estruturada da seguinte forma:

• Visão geral dos parâmetros (para ver os detalhes completos de um parâmetro, clique no nome dele)
• Detalhes dos parâmetros

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

Alias

Defina um alias para uma chave de item. Ele pode ser usado para substituir uma chave de item longa e complexa por uma mais curta e simples.
Vários parâmetros Alias podem estar presentes. Não são permitidos vários parâmetros com a mesma chave Alias.
Diferentes chaves Alias podem referenciar a mesma chave de item.
Aliases podem ser usados em HostMetadataItem, mas não no parâmetro HostnameItem.

Exemplo 1: Recuperando o ID do usuário 'zabbix'.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Agora a chave abreviada zabbix.userid pode ser usada para recuperar dados.

Exemplo 2: Obtendo a utilização de CPU com parâmetros padrão e personalizados.

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

Isso permite usar a chave cpu.util para obter a porcentagem de utilização de CPU com parâmetros padrão, bem como usar cpu.util[all, idle, avg15] para obter dados específicos sobre a utilização de CPU.

Exemplo 3: Executando várias regras de descoberta em baixo nível processando os mesmos itens descobertos.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Agora é possível configurar várias regras de descoberta usando vfs.fs.discovery com parâmetros diferentes para cada regra, por exemplo, vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc.

AllowKey

Permite a execução daqueles item keys que correspondem a um padrão. O padrão da key é uma expressão curinga que suporta o caractere "*" para corresponder a qualquer número de quaisquer caracteres.
Várias regras de correspondência de key podem ser definidas em combinação com DenyKey. Os parâmetros são processados um a um de acordo com a ordem em que aparecem. Veja também: Restricting agent checks.

BufferSend

Defina a frequência de envio dos valores do buffer para o Zabbix server/proxy (em segundos).
Observe que, se o buffer estiver cheio, os dados serão enviados mais cedo.

Padrão: 5
Intervalo: 1-3600

BufferSize

Define o número máximo de valores no buffer de memória.
O agent enviará todos os dados coletados para o Zabbix server ou proxy se o buffer estiver cheio. Este parâmetro deve ser usado somente se o buffer persistente estiver desativado (EnablePersistentBuffer=0).

Padrão: 1000
Intervalo: 2-65535

ControlSocket

Especifique o socket de controle para enviar comandos em tempo de execução com a opção '-R'.

Padrão: /tmp/agent.sock

DebugLevel

Defina o nível de depuração:
0 - informações básicas sobre o início e a parada 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

DenyKey

Negue a execução das chaves de item que correspondam a um padrão.
O padrão da chave é uma expressão curinga que suporta o caractere "*" para corresponder a qualquer número de quaisquer caracteres.
Várias regras de correspondência de chaves podem ser definidas em combinação com AllowKey. Os parâmetros são processados um a um de acordo com a ordem em que aparecem. Veja também: Restricting agent checks.

EnablePersistentBuffer

Habilita o uso de armazenamento persistente local para items ativos.
Se o armazenamento persistente estiver desabilitado, o buffer de memória será usado.

Padrão: 0
Valores: 0 - desabilitado, 1 - habilitado

ForceActiveChecksOnStart

Executa verificações ativas imediatamente após a reinicialização, para a primeira configuração recebida.
Também disponível como um parâmetro de configuração por plugin, por exemplo: Plugins.Uptime.System.ForceActiveChecksOnStart=1

Padrão: 0
Valores: 0 - desativado, 1 - ativado

HeartbeatFrequency

Define a frequência das mensagens de heartbeat em segundos.
Usado para monitorar a disponibilidade de active checks.
0 - mensagens de heartbeat desativadas.

Padrão: 60
Intervalo: 0-3600

HostInterface

Especifique a interface do host (endereço IP ou nome DNS) usada durante a autoregistration do host.
Esse valor será usado para preencher a interface no host recém-criado e permite configurar explicitamente um endereço IP ou DNS.
Para mais detalhes, consulte Using DNS as default interface.

Se não for definido, o valor será obtido de HostInterfaceItem.

O agent emitirá um erro e não será iniciado se o valor ultrapassar o limite de 255 caracteres.

Intervalo: 0-255 caracteres

HostInterfaceItem

Especifique um item para determinar a interface do host (endereço IP ou nome DNS) durante a autoregistration do host.
Esse valor é usado somente se HostInterface não estiver definido.
Para mais detalhes, consulte Using DNS as default interface.

Durante uma solicitação de autoregistration, o agent registrará uma mensagem de aviso se o valor retornado pelo item especificado exceder o limite de 255 caracteres.

O item system.run[] é suportado independentemente das configurações AllowKey/DenyKey.

HostMetadata

Especifique os metadados usados para identificar ou distinguir o host durante a autoregistration do host.
HostMetadata permite distinguir entre hosts além do hostname.

Se não for definido, o valor será obtido de HostMetadataItem.

O agent emitirá um erro e não será iniciado se o valor especificado exceder o limite de 2034 bytes ou se for uma string não UTF-8. Quando um parâmetro espera um endereço IP ou nome DNS, valores que sejam UTF-8 válidos, mas que não sejam IPs ou nomes DNS válidos, também serão rejeitados e reportados como inválidos.

Metadados com várias linhas não são suportados — a saída será truncada na primeira quebra de linha.

Intervalo: 0-2034 bytes

HostMetadataItem

Especifique um item para obter metadados do host.
Esta opção é usada somente quando HostMetadata não está definido.

O valor de HostMetadataItem é recuperado em cada tentativa de autoregistro e é usado apenas no processo de autoregistro do host. HostMetadataItem permite distinguir hosts além do hostname.

Parâmetros de usuário e aliases são suportados. O item system.run[] é suportado independentemente das configurações AllowKey/DenyKey.

Durante uma solicitação de autoregistro, o agent registrará uma mensagem de aviso se o valor retornado pelo item especificado exceder o limite de 65535 pontos de código UTF-8. O valor retornado pelo item deve ser uma string UTF-8; caso contrário, será ignorado. Quando um parâmetro espera um endereço IP ou nome DNS, valores que sejam válidos em UTF-8, mas não sejam IPs ou nomes DNS válidos, também serão rejeitados e reportados como inválidos.

Metadados com várias linhas não são suportados — a saída será truncada na primeira quebra de linha.

Nome do host

Especifique nomes de host exclusivos e sensíveis a maiúsculas e minúsculas. Uma lista delimitada por vírgulas.
Obrigatório para verificações ativas e deve corresponder aos nomes de host conforme configurados no server.
O valor é obtido de HostnameItem se não estiver definido.
Caracteres permitidos: alfanuméricos, '.', ' ', '_' e '-'. Comprimento máximo: 128 caracteres por nome de host, 2048 caracteres para a linha inteira.

Padrão: Definido por HostnameItem

HostnameItem

Especifique um item para obter o hostname.
Esta opção é usada somente quando Hostname não está definido.
Parâmetros de usuário ou aliases não são suportados, mas o item system.run[] é suportado independentemente dos valores de AllowKey/DenyKey.

Padrão: system.hostname

Incluir

Especifique um diretório ou arquivos individuais para serem incluídos no arquivo de configuração.
Durante a instalação, o Zabbix criará o diretório de inclusão em /usr/local/etc, a menos que isso seja modificado durante a compilação. O caminho pode ser relativo ao local do arquivo zabbix_agent2.conf.
Para incluir apenas os arquivos relevantes no diretório especificado, o caractere curinga asterisco é suportado para correspondência de padrões.
Consulte observações especiais sobre limitações.

Exemplo:

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

ListenIP

Especifique o endereço IP de escuta do agent para conexões do server/proxy. Uma lista delimitada por vírgulas.
O primeiro endereço IP é enviado ao Zabbix server, se estiver se conectando a ele, para recuperar a lista de verificações ativas.

Padrão: 0.0.0.0

ListenPort

Especifique a porta de escuta do agent para conexões vindas do server/proxy.

Padrão: 10050
Intervalo: 1024-32767

LogFile

Especifique o arquivo de log do agent.

Padrão: /tmp/zabbix_agent2.log
Obrigatório: Sim, se LogType estiver definido como file; caso contrário, não

LogFileSize

Defina o tamanho máximo do arquivo de log (em MB).
0 - desativa a rotação automática de logs.
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

Especifique o tipo de saída do 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

PersistentBufferFile

Especifique o arquivo para manter o banco de dados SQLite. Deve ser um nome de arquivo completo.
Este parâmetro é usado somente se o buffer persistente estiver habilitado (EnablePersistentBuffer=1).

PersistentBufferPeriod

Defina o período de tempo para armazenar dados quando não houver conexão com o Zabbix server ou proxy. Dados mais antigos serão perdidos.
Dados de log serão preservados. Este parâmetro é usado somente se o buffer persistente estiver habilitado (EnablePersistentBuffer=1).

Padrão: 1h
Intervalo: 1m-365d

PidFile

Especifique o arquivo PID.

Padrão: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

Define o limite de verificações por plugin <PluginName> que podem ser executadas ao mesmo tempo.

Padrão: 1000 Intervalo: 1-1000

Plugins.Log.MaxLinesPerSecond

Define o número máximo de novas linhas por segundo para envio ao Zabbix server/proxy ao processar verificações ativas log ou logrt.
O valor fornecido será substituído pelo parâmetro 'maxlines', informado na chave do item 'log' e 'logrt'.
Nota: O Zabbix processará 10 vezes mais novas linhas do que o definido em MaxLinesPerSecond para localizar a string necessária em itens de log.

Padrão: 20
Intervalo: 1-1000

Plugins.SystemRun.LogRemoteCommands

Ative o registro dos comandos de shell executados como avisos.
Os comandos serão registrados somente se forem executados remotamente.
Entradas de log não serão criadas se system.run[] for iniciado localmente pelos parâmetros HostMetadataItem, HostInterfaceItem ou HostnameItem.

Padrão: 0
Valores: 0 - desativado, 1 - ativado

PluginSocket

Especifique o caminho para o socket UNIX para comunicações de plugins carregáveis.

Padrão: /tmp/agent.plugin.sock

PluginTimeout

Especifique o tempo limite para conexões com plugins carregáveis, em segundos.

Padrão: Timeout
Intervalo: 1-30

RefreshActiveChecks

Especifique a frequência de atualização da lista de active checks, em segundos.
Observe que, após falhar ao atualizar os active checks, a próxima atualização será tentada em 60 segundos.

Padrão: 5
Intervalo: 1-86400

Server

Especifique os endereços IP, opcionalmente em notação CIDR, ou os nomes DNS dos servers/proxies do Zabbix. Uma lista separada por vírgulas.
As conexões de entrada serão aceitas somente 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' serã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. Espaços são permitidos. Se este parâmetro não for especificado, desativa as verificações passivas e o agent não escutará em nenhuma porta TCP.

Exemplo:

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

ServerActive

Especifique o endereço do server/proxy do Zabbix ou a configuração de cluster para obter checks ativos.
O endereço do server/proxy é um endereço IP ou nome DNS, com porta opcional separada por dois-pontos.
A configuração de cluster é um ou mais endereços de membros de grupo de server ou proxy separados por ponto e vírgula. Vários servers/clusters do Zabbix e proxies do Zabbix podem ser especificados, separados por vírgula. A menos que esteja usando grupos de proxy, não deve ser especificado mais de um proxy do Zabbix para cada server/cluster do Zabbix. Se um proxy do Zabbix for especificado, então o server/cluster do Zabbix para esse proxy não deve ser especificado.
Vários endereços delimitados por vírgula podem ser fornecidos para usar vários servers independentes do Zabbix em paralelo. Espaços são permitidos.
Se a porta não for especificada, a porta padrão será usada.
Endereços IPv6 devem ser colocados entre colchetes se a porta para esse host for especificada. Se a porta não for especificada, os colchetes para endereços IPv6 são opcionais.
Se este parâmetro não for especificado, os checks ativos serão desativados.

Exemplo para proxy do Zabbix:

ServerActive=127.0.0.1:10051

Exemplo para grupo de proxy do Zabbix:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Exemplo para vários servers:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Exemplo para alta disponibilidade:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Exemplo para alta disponibilidade com dois clusters e um server:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain

SourceIP

Especifique o endereço IP de origem para:

• conexões de saída para o Zabbix server ou Zabbix proxy.
• estabelecer conexões ao executar alguns items (web.page.get, net.tcp.port, etc.).

StatusPort

Especifique a porta para ouvir solicitações de status HTTP (http://localhost:<port>/status).

Intervalo: 1024-32767

Tempo limite

Especifique por quanto tempo aguardar (em segundos) para estabelecer a conexão e trocar dados com o proxy ou server do Zabbix.

Este parâmetro define a duração de várias operações de comunicação, incluindo:

• aguardar uma resposta do server do Zabbix;
• enviar solicitações ao server do Zabbix, incluindo solicitações de configuração de item e dados de item em verificações ativas;
• recuperar dados de log por meio de logfile;
• enviar mensagens de heartbeat;
• duração máxima para verificações vfs.*;
• atuar como fallback em cenários em que um server ou proxy mais antigo que a versão 7.0 envia verificações sem timeouts.

Este timeout não será usado para aquelas verificações do agent que têm configurações de timeout ajustáveis no frontend (em nível global, de proxy ou por item).

Padrão: 3
Intervalo: 1-30

TLSAccept

Especifique o nível de criptografia exigido para conexões de entrada.
Usado para verificações passivas.
Vários valores podem ser especificados, separados por vírgula:
unencrypted - aceita conexões sem criptografia (padrão)
psk - aceita conexões com TLS e uma chave pré-compartilhada (PSK)
cert - aceita conexões com TLS e um certificado

Obrigatório: sim, se os parâmetros de certificado TLS ou PSK estiverem definidos (mesmo para conexão unencrypted); caso contrário, não

TLSCAFile

Especifique o caminho completo do arquivo que contém os certificados 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

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

TLSCipherAll

Especifique a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado e em PSK.

Exemplo:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128

TLSCipherAll13

Especifique a string de cifra do OpenSSL (TLS 1.3) para OpenSSL 1.1.1 ou mais recente. Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado e em PSK.

Exemplo:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherCert

Especifique a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.

Exemplo:

EECDH+aRSA+AES128:RSA+aRSA+AES128

Observe que este parâmetro não pode ser usado junto com TLSAccept=cert,psk; para conexão por certificado (TLSConnect=cert), use TLSCipherAll em vez disso.

TLSCipherCert13

Especifique a string de cifra do OpenSSL (TLS 1.3) para OpenSSL 1.1.1 ou mais recente. Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.

Observe que este parâmetro não pode ser usado junto com TLSAccept=cert,psk; para conexão por certificado (TLSConnect=cert), use TLSCipherAll13 em vez disso.

TLSCipherPSK

Especifique a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.

Exemplo:

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

Especifique a string de cifra do OpenSSL (TLS 1.3) para OpenSSL 1.1.1 ou mais recente. Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.

Exemplo:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSConnect

Especifique o nível de criptografia exigido para conexões do agent com o Zabbix server ou proxy.
Usado para verificações ativas.
Apenas um valor pode ser especificado:
unencrypted - conectar sem criptografia (padrão)
psk - conectar usando TLS e uma chave pré-compartilhada (PSK)
cert - conectar usando TLS e um certificado

Obrigatório: sim, se os parâmetros de certificado TLS ou PSK estiverem definidos (mesmo para conexão unencrypted); caso contrário, não

TLSCRLFile

Especifique o caminho completo do arquivo que contém os certificados revogados. Este parâmetro é usado para comunicações criptografadas entre os componentes do Zabbix.

TLSKeyFile

Especifique o caminho completo do arquivo que contém a chave privada do agent, usada para comunicações criptografadas entre os componentes do Zabbix.

TLSPSKFile

Especifique o caminho completo do arquivo que contém a chave pré-compartilhada do agent, usada para comunicações criptografadas com o server Zabbix.

TLSPSKIdentity

Especifique a string de identidade da chave pré-compartilhada, usada para comunicações criptografadas com o Zabbix server.

TLSServerCertIssuer

Especifique o emissor do certificado do server (proxy) permitido.

TLSServerCertSubject

Especifique o subject do certificado do server (proxy) permitido.

UnsafeUserParameters

Permite que todos os caracteres sejam passados nos argumentos para parâmetros definidos pelo usuário. Os seguintes caracteres não são permitidos: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Além disso, caracteres de nova linha não são permitidos.

Padrão: 0
Valores: 0 - não permitir, 1 - permitir

UserParameter

Especifique um parâmetro definido pelo usuário para monitorar. Pode haver vários parâmetros definidos pelo usuário.
Formato: UserParameter=<key>,<shell command>
Observe que o comando de shell não deve retornar uma string vazia nem apenas EOL. Os comandos de shell podem usar caminhos relativos, se o parâmetro UserParameterDir estiver especificado.

Exemplo:

UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh

UserParameterDir

Especifique o caminho de busca padrão para comandos UserParameter. Se usado, o agent alterará seu diretório de trabalho para o diretório especificado aqui antes de executar um comando. Assim, os comandos UserParameter podem usar um prefixo relativo ./ em vez de um caminho completo.
Apenas uma entrada é permitida.

Exemplo:

UserParameterDir=/opt/myscripts