Áú»¢¶Ä²©

3 Agente Áú»¢¶Ä²© (UNIX)

Vis?o geral

Os par?metros suportados pelo arquivo de configura??o do agente Áú»¢¶Ä²© (zabbix_agentd.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 n?o s?o obrigat¨®rios, a menos que seja explicitamente declarado que o par?metro ¨¦ obrigat¨®rio.

Observe que:

• Os valores padr?o refletem os padr?es do daemon, n?o os valores nos arquivos de configura??o arquivos de configura??o enviados;
• O Áú»¢¶Ä²© suporta arquivos de configura??o somente na codifica??o UTF-8 sem ;
• Os coment¨¢rios que come?am com "#" s?o suportados somente no in¨ªcio da linha da linha.

Detalhes do par?metro

Alias

Define um alias para uma chave de item. Pode ser usado para substituir uma chave de item longa e complexa por uma mais curta e mais 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 fazer refer¨ºncia ¨¤ mesma chave de item.
Os aliases podem ser usados em HostMetadataItem, mas n?o no par?metro HostnameItem.

Exemplo 1: Recupera??o do 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: obter a utiliza??o da 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 da CPU com par?metros padr?o, bem como usar cpu.util[all, idle, avg15] para obter dados espec¨ªficos sobre a utiliza??o da CPU.

Exemplo 3: Execu??o de v¨¢rias regras low-level discovery processando os mesmos itens de descoberta.

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 das chaves de item que correspondem a um padr?o. O padr?o de chave ¨¦ uma express?o curinga que suporta o caractere "*" para corresponder a qualquer n¨²mero de caracteres.
V¨¢rias regras de correspond¨ºncia de chave podem ser definidas em combina??o com DenyKey. Os par?metros s?o processados um a um de acordo com sua ordem de aparecimento. Consulte tamb¨¦m: Restringindo verifica??es do agente.

AllowRoot

Permite que o agente seja executado como "root". Se estiver desativado e o agente for iniciado por "root", o agente tentar¨¢ mudar para o usu¨¢rio "zabbix". N?o ter¨¢ efeito se for iniciado por um usu¨¢rio comum.

Padr?o: 0
Valores: 0 - n?o permitir; 1 - permitir

BufferSend

N?o mantenha dados com mais de N segundos no buffer.

Padr?o: 5
Intervalo: 1-3600

BufferSize

O n¨²mero m¨¢ximo de valores no buffer de mem¨®ria. O agente enviar¨¢ todos os dados coletados para o servidor ou proxy do Áú»¢¶Ä²© se o buffer estiver cheio.

Padr?o: 100
Intervalo: 2-65535

DebugLevel

Especifique o n¨ªvel de depura??o:
0 - informa??es b¨¢sicas sobre a inicializa??o e a interrup??o dos processos do Áú»¢¶Ä²©
1 - informa??es cr¨ªticas;
2 - informa??es sobre erros;
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

Nega a execu??o das chaves de item que correspondem a um padr?o. O padr?o de chave ¨¦ uma express?o curinga que suporta o caractere "*" para corresponder a qualquer n¨²mero de caracteres.
V¨¢rias regras de correspond¨ºncia de chave podem ser definidas em combina??o com AllowKey. Os par?metros s?o processados um a um de acordo com sua ordem de aparecimento. Consulte tamb¨¦m: Restringir verifica??es do agente.

EnableRemoteCommands

Se os comandos remotos do servidor Áú»¢¶Ä²© s?o permitidos. Esse par?metro est¨¢ depreciado; em vez disso, use AllowKey=system.run[*] ou DenyKey=system.run[*].
? um alias interno para os par?metros AllowKey/DenyKey, dependendo do valor:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

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

HeartbeatFrequency

A frequ¨ºncia das mensagens de heartbeat em segundos. Usada para monitorar a disponibilidade de verifica??es ativas.
0 - mensagens de heartbeat desativadas.

Padr?o: 60
Intervalo: 0-3600

HostInterface

Um par?metro opcional que define a interface do host. A interface do host ¨¦ usada no processo autoregistration do host. Se n?o for definido, o valor ser¨¢ adquirido de HostInterfaceItem.
O agente emitir¨¢ um erro e n?o iniciar¨¢ se o valor ultrapassar o limite de 255 caracteres.

Intervalo: 0-255 caracteres

HostInterfaceItem

Um par?metro opcional que define um item usado para obter a interface do host.
A interface do host ¨¦ usada no processo autoregistration do host.
Durante uma solicita??o de autorregistro, o agente registrar¨¢ uma mensagem de aviso se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres.
O item system.run[] ¨¦ suportado independentemente dos valores de AllowKey/DenyKey.
Essa op??o s¨® ¨¦ usada quando HostInterface n?o est¨¢ definido.

HostMetadata

Um par?metro opcional que define os metadados do host. Os metadados do host s?o usados somente no processo de autorregistro do host (agente ativo). Se n?o for definido, o valor ser¨¢ adquirido de HostMetadataItem.
O agente emitir¨¢ um erro e n?o iniciar¨¢ se o valor especificado estiver acima do limite de 2034 bytes ou for uma cadeia de caracteres n?o-UTF-8.

Intervalo: 0-2034 bytes

HostMetadataItem

Um par?metro opcional que define um item do agente Áú»¢¶Ä²© usado para obter metadados do host. Essa op??o s¨® ¨¦ usada quando HostMetadata n?o ¨¦ definido. Par?metros de usu¨¢rio e aliases s?o suportados. O item system.run[] ¨¦ suportado independentemente dos valores AllowKey/DenyKey.
O valor HostMetadataItem ¨¦ recuperado em cada tentativa de autorregistro e ¨¦ usado somente no processo de autorregistro do host (agente ativo).
Durante uma solicita??o de autorregistro, o agente registrar¨¢ uma mensagem de aviso se o valor retornado pelo item especificado estiver acima do limite de 65535 pontos de c¨®digo UTF-8. O valor retornado pelo item deve ser uma cadeia de caracteres UTF-8, caso contr¨¢rio, ser¨¢ ignorado.

Nome do host

Uma lista de nomes de host delimitados por v¨ªrgulas, exclusivos e sens¨ªveis a mai¨²sculas e min¨²sculas. Necess¨¢rio para verifica??es ativas e deve corresponder aos nomes de host configurados no servidor. O valor ¨¦ adquirido de HostnameItem se n?o estiver definido.
Caracteres permitidos: alfanum¨¦rico, '.', ' ', '_' e '-'. Comprimento m¨¢ximo: 128 caracteres por nome de host, 2048 caracteres para a linha inteira.

Padr?o: Definido por HostnameItem

HostnameItem

Um par?metro opcional que define um item do agente Áú»¢¶Ä²© usado para obter o nome do host. Essa op??o s¨® ¨¦ usada 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

Inclui

Voc¨º pode incluir arquivos individuais ou todos os arquivos de um diret¨®rio no arquivo de configura??o. Para incluir somente arquivos relevantes no diret¨®rio especificado, h¨¢ suporte para o caractere curinga asterisco para correspond¨ºncia de padr?es.
Consulte special notes para saber sobre as limita??es.

Exemplo:

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

ListenBacklog

O n¨²mero m¨¢ximo de conex?es pendentes na fila TCP.
O valor padr?o ¨¦ uma constante codificada, que depende do sistema.
O valor m¨¢ximo suportado depende do sistema; valores muito altos podem ser silenciosamente truncados para o "m¨¢ximo especificado pela implementa??o".

Padr?o: SOMAXCONN
Intervalo: 0 - INT_MAX

ListenIP

Uma lista de endere?os IP delimitados por v¨ªrgulas nos quais o agente deve escutar.

Padr?o: 0.0.0.0

ListenPort

O agente escutar¨¢ nessa porta as conex?es do servidor.

Padr?o: 10050
Intervalo: 1024-32767

LoadModule

O m¨®dulo a ser carregado na inicializa??o do agente. Os m¨®dulos s?o usados para ampliar a funcionalidade do agente. O m¨®dulo deve estar localizado no diret¨®rio especificado por LoadModulePath ou o caminho deve preceder o nome do m¨®dulo. Se o caminho anterior for absoluto (come?a com '/'), LoadModulePath ser¨¢ ignorado.
Formatos:
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
? permitido incluir v¨¢rios par?metros LoadModule.

LoadModulePath

O caminho completo para o local dos m¨®dulos do agente. O padr?o depende das op??es de compila??o.

LogFile

O nome do arquivo de registro.

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 - 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

LogRemoteCommands

Habilita o registro em log dos comandos do shell executados como avisos. Os comandos ser?o registrados somente se forem executados remotamente. As entradas de registro 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

LogType

O tipo da sa¨ªda de registro:
file - grava o registro no arquivo especificado pelo par?metro LogFile;
system - grava o registro no syslog;
console - grava o registro na sa¨ªda padr?o.

Padr?o: file

MaxLinesPerSecond

O n¨²mero m¨¢ximo de novas linhas que o agente enviar¨¢ por segundo para o servidor ou proxy do Áú»¢¶Ä²© ao processar verifica??es ativas de 'log' e 'logrt'. O valor fornecido ser¨¢ substitu¨ªdo pelo par?metro 'maxlines', fornecido na chave do item 'log' ou 'logrt'.
Nota: O Áú»¢¶Ä²© processar¨¢ 10 vezes mais novas linhas do que o definido em MaxLinesPerSecond para buscar a string necess¨¢ria nos itens de registro.

Padr?o: 20
Faixa: 1-1000

PidFile

O nome do arquivo PID.

Padr?o: /tmp/zabbix_agentd.pid

RefreshActiveChecks

Com que frequ¨ºncia a lista de verifica??es ativas ¨¦ atualizada, em segundos. Observe que, ap¨®s a falha na atualiza??o das verifica??es ativas, a pr¨®xima atualiza??o ser¨¢ tentada em 60 segundos.

Padr?o: 5
Intervalo: 1-86400

Server

Uma lista de endere?os IP delimitados por v¨ªrgulas, opcionalmente em nota??o CIDR, ou nomes DNS de servidores Áú»¢¶Ä²© e proxies Áú»¢¶Ä²©. As conex?es de entrada ser?o aceitas somente dos hosts listados aqui. Se o suporte a IPv6 estiver ativado, 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. Observe que os "endere?os IPv6 compat¨ªveis com IPv4" (prefixo 0000::/96) s?o suportados, mas preteridos pela [RFC4291] (https://tools.ietf.org/html/rfc4291#section-2.5.5). Espa?os s?o permitidos.

Exemplo:

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

Obrigat¨®rio: sim, se StartAgents n?o estiver explicitamente definido como 0

ServerActive

O endere?o do servidor/proxy do Áú»¢¶Ä²© ou a configura??o do cluster para obter verifica??es ativas. O endere?o do servidor/proxy ¨¦ um endere?o IP ou nome DNS e uma porta opcional separados por dois pontos.
A configura??o do cluster ¨¦ um ou mais endere?os de servidor separados por ponto e v¨ªrgula. V¨¢rios servidores/clusters e proxies Áú»¢¶Ä²© podem ser especificados, separados por v¨ªrgula. N?o deve ser especificado mais de um proxy Áú»¢¶Ä²© para cada servidor/cluster Áú»¢¶Ä²©. Se o proxy Áú»¢¶Ä²© for especificado, ent?o o servidor/cluster Áú»¢¶Ä²© para esse proxy n?o deve ser especificado.
V¨¢rios endere?os delimitados por v¨ªrgulas podem ser fornecidos para usar v¨¢rios servidores Áú»¢¶Ä²© independentes em paralelo. S?o permitidos espa?os.
Se a porta n?o for especificada, ser¨¢ usada a porta padr?o.
Os 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 esse par?metro n?o for especificado, as verifica??es ativas ser?o desativadas.

Exemplo para o proxy Áú»¢¶Ä²©:

ServerActive=127.0.0.1:10051

Exemplo para v¨¢rios servidores:

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

Exemplo de alta disponibilidade:

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

Exemplo de alta disponibilidade com dois clusters e um servidor:

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

SourceIP

O endere?o IP de origem para:
- conex?es de sa¨ªda para o Áú»¢¶Ä²© Server ou Áú»¢¶Ä²© Proxy;
- conex?es durante a execu??o de alguns itens (web.page.get, net.tcp.port, etc.).

StartAgents

O n¨²mero de inst?ncias pr¨¦-forked do zabbix_agentd que processam verifica??es passivas. Se definido como 0, as verifica??es passivas ser?o desativadas e o agente n?o escutar¨¢ em nenhuma porta TCP.

Padr?o: 3
Intervalo: 0-100

Timeout

N?o gaste mais do que Timeout segundos no processamento.

Padr?o: 3
Intervalo: 1-30

TLSAccept

Quais conex?es de entrada devem ser aceitas. 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 o certificado TLS ou os par?metros PSK estiverem definidos (mesmo para conex?o n?o criptografada); caso contr¨¢rio, n?o

TLSCAFile

O nome completo do caminho do arquivo que cont¨¦m os certificados da(s) CA(s) de n¨ªvel superior para verifica??o de certificados de pares, usados para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©.

TLSCertFile

O nome completo do caminho do arquivo que cont¨¦m o certificado do agente ou a cadeia de certificados, usado para comunica??es criptografadas com os componentes do Áú»¢¶Ä²©.

TLSCipherAll

A cadeia de prioridade GnuTLS ou a cadeia de cifras OpenSSL (TLS 1.2). Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em certificado e PSK.

Exemplo:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherAll13

A cadeia de cifras para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em certificado e PSK.

Exemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

Exemplo para OpenSSL:

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

TLSCipherCert

A string de prioridade GnuTLS ou a string de cifra OpenSSL (TLS 1.2). Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em certificado.

Exemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

Exemplo para OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128

TLSCipherCert13

A cadeia de cifras para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em certificado.

TLSCipherPSK

A string de prioridade GnuTLS ou a string de cifra OpenSSL (TLS 1.2). Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em PSK.

Exemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

Exemplo para OpenSSL:

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

A cadeia de cifras para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substitui os crit¨¦rios de sele??o de cifras padr?o para criptografia baseada em PSK.

Exemplo:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSConnect

Como o agente deve se conectar ao servidor Áú»¢¶Ä²© ou ao proxy. Usado para verifica??es ativas. Somente um valor pode ser especificado:
unencrypted - conecta-se sem criptografia (padr?o)
psk - conecta-se usando TLS e uma chave pr¨¦-compartilhada (PSK)
cert - conecta-se usando TLS e um certificado

Obrigat¨®rio: sim, se o certificado TLS ou os par?metros PSK estiverem definidos (mesmo para conex?o unencrypted); caso contr¨¢rio, n?o

TLSCRLFile

O nome completo do caminho do arquivo que cont¨¦m os certificados revogados. Esse par?metro ¨¦ usado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©.

TLSKeyFile

O nome completo do caminho do arquivo que cont¨¦m a chave privada do agente, usada para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©.

TLSPSKFile

O nome completo do caminho do arquivo que cont¨¦m a chave pr¨¦-compartilhada do agente, usada para comunica??es criptografadas com o servidor Áú»¢¶Ä²©.

TLSPSKIdentity

A string de identidade da chave pr¨¦-compartilhada, usada para comunica??es criptografadas com o servidor Áú»¢¶Ä²©.

TLSServerCertIssuer

O emissor do certificado do servidor (proxy) permitido.

TLSServerCertSubject

O assunto do certificado do servidor (proxy) permitido.

UnsafeUserParameters

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

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

±«²õ³Ü¨¢°ù¾±´Ç

Reduz os privil¨¦gios de um usu¨¢rio espec¨ªfico existente no sistema.
S¨® ter¨¢ efeito se for executado como "root" e se AllowRoot estiver desativado.

Padr?o: zabbix

UserParameter

Um par?metro definido pelo usu¨¢rio a ser monitorado. Pode haver v¨¢rios par?metros definidos pelo usu¨¢rio.
Formato: UserParameter=<key>,<shell command>
Observe que o comando do shell n?o deve retornar uma cadeia de caracteres vazia ou apenas EOL. Os comandos do shell podem ter caminhos relativos, se o par?metro UserParameterDir for especificado.

Exemplo:

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

UserParameterDir

O caminho de pesquisa padr?o para comandos UserParameter. Se for usado, o agente alterar¨¢ seu diret¨®rio de trabalho para o especificado aqui antes de executar um comando. Dessa forma, os comandos UserParameter podem ter um prefixo relativo ./ em vez de um caminho completo.
? permitida apenas uma entrada.

Exemplo:

UserParameterDir=/opt/myscripts

Consulte tamb¨¦m