Table of Contents
4 Áú»¢¶Ä²© Agent 2 (UNIX)
Vis?o geral
O Áú»¢¶Ä²© Agent 2 ¨¦ uma nova gera??o de agente Áú»¢¶Ä²© e pode ser usado no lugar do Áú»¢¶Ä²© Agent.
Esta se??o lista os par?metros suportados em um arquivo de configura??o do Áú»¢¶Ä²© Agent 2 (zabbix_agent2.conf).
Observe que:
- Os valores padr?o refletem os padr?es do processo, n?o os valores nos arquivos de configura??o transportados;
- O Áú»¢¶Ä²© suporta apenas arquivos de configura??o codificados em UTF-8 sem ;
- Coment¨¢rios come?ando com "#" s?o suportados somente no in¨ªcio da linha.
Par?metros
| Par?metro | °¿²ú°ù¾±²µ²¹³Ù¨®°ù¾±´Ç | Intervalo | Padr?o | Descri??o | |
|---|---|---|---|---|---|
| Alias | n?o | Configura um apelido para uma chave de item. Ele pode ser usado para substituir uma chave de item longa e complexa por uma menor e mais simples. M¨²ltiplos par?metros Alias podem estar presentes. M¨²ltiplos par?metros com a mesma chave Alias s?o permitidos. Diferentes chaves Alias podem referenciar a mesma chave de item. Apelidos podem ser usados nos par?metros HostMetadataItem mas n?o nos HostnameItem. Exemplos: 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 recupera??o deste dado. 2. Obtendo utiliza??o de CPU com par?metros padr?o e customizados. Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] Isto permite usar a chave cpu.util para obter a porcentagem de utiliza??o de CPU com par?metros padr?o assim como usar cpu.util[all, idle, avg15] para obter dados espec¨ªficos sobre utiliza??o de CPU. 3. Execu??o de m¨²ltiplas regras de descoberta de 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, p.e., vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc. |
|||
| AllowKey | n?o | Permite execu??o das chaves de item que correspondem ao padr?o. Padr?o de chave ¨¦ uma express?o curinga que suporta o caracter "*" para corresponder a qualquer n¨²mero de quaisquer caracteres. M¨²ltiplas regras de correspond¨ºncia de chave podem ser definidas em combina??o com DenyKey. Os par?metros s?o processados um por um de acordo com sua ordem de apari??o. Este par?metro ¨¦ suportado desde o Áú»¢¶Ä²© 5.0.0. Veja tamb¨¦m: Restringindo verifica??es do agente. |
|||
| BufferSend | n?o | 1-3600 | 5 | O intervalo de tempo em segundos que determina com que frequ¨ºncia os valores s?o enviados do buffer para o Áú»¢¶Ä²© Server. Note que se o buffer estiver cheio, os dados ser?o enviados mais cedo. |
|
| BufferSize | n?o | 2-65535 | 100 | N¨²mero m¨¢ximo de valores em um buffer de mem¨®ria. O agente enviar¨¢ todos os dados coletados para o Áú»¢¶Ä²© Server ou Proxy se o buffer estiver cheio. Este par?metro deve ser usado apenas se o buffer persistente estiver desabilitado (EnablePersistentBuffer=0). |
|
| ControlSocket | n?o | /tmp/agent.sock | O socket de controle, usado para enviar comandos de tempo de execu??o com a op??o '-R'. | ||
| DebugLevel | n?o | 0-5 | 3 | Especifica n¨ªvel de depura??o (debug): 0 - informa??es b¨¢sicas sobre in¨ªcio e parada dos processos do Áú»¢¶Ä²© 1 - informa??es cr¨ªticas 2 - informa??es de erro 3 - alertas 4 - para depura??o (produz bastante informa??o) 5 - depura??o estendida (produz ainda mais informa??es) |
|
| DenyKey | n?o | Nega a execu??o das chaves de item que correspondem ao padr?o. Padr?o de chave ¨¦ uma express?o curinga que suporta o caracter "*" para corresponder a qualquer n¨²mero de quaisquer caracteres. M¨²ltiplas regras de correspond¨ºncia de chave podem ser definidas em combina??o com DenyKey. Os par?metros s?o processados um por um de acordo com sua ordem de apari??o. Este par?metro ¨¦ suportado desde o Áú»¢¶Ä²© 5.0.0. Veja tamb¨¦m: Restringindo verifica??es do agente. |
|||
| EnablePersistentBuffer | n?o | 0-1 | 0 | Habilita o uso de armazenamento local persistente para itens ativos. 0 - desabilitado 1 - habilitado Se o armazenamento persistente estiver desabilitado, o buffer de mem¨®ria ser¨¢ usado. |
|
| HostInterface | n?o | 0-255 caracteres | Par?metro opcional que define interface do host. A interface do host ¨¦ usada no processo de autoregistro de host. Um agente emitir¨¢ um erro e n?o iniciar¨¢ se o valor estiver acima do limite de 255 caracteres. Se n?o definido, o valor ser¨¢ adquirido de HostInterfaceItem. Suportado desde o Áú»¢¶Ä²© 4.4.0. |
||
| HostInterfaceItem | n?o | Par?metro opcional que define um item usado para obten??o da interface do host. A interface do host ¨¦ usada no processo de autoregistro de host. Durante uma requisi??o de autoregistro um agente registrar¨¢ em log uma mensagem de alerta se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres. Esta op??o ¨¦ usada apenas quando HostInterface n?o ¨¦ definido. Suportado desde o Áú»¢¶Ä²© 4.4.0. |
|||
| HostMetadata | n?o | 0-255 caracteres | Par?metro opcional que define os metadados do host. Os metadados de host s?o usados no processo de autoregistro. Um agente emitir¨¢ um erro e n?o iniciar¨¢ se o valor especificado estiver acima do limite ou for uma string n?o-UTF-8. Se n?o definido, o valor ser¨¢ adquirido de HostMetadataItem. |
||
| HostMetadataItem | n?o | Par?metro opcional que define um item usado para obten??o de metadados de host. O item de metadados de host ¨¦ recuperado em cada tentativa de autoregistro para o processo de autoregistro de host. Durante uma requisi??o de autoregistro um agente registrar¨¢ em log uma mensagem de alerta se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres. Esta op??o ¨¦ usada apenas quando HostMetadata n?o ¨¦ definido. Suporta UserParameters e apelidos (aliases). Suporta system.run[] independentemente dos valores de AllowKey/DenyKey. O valor retornado pelo item deve ser uma string UTF-8 caso contr¨¢rio ele ser¨¢ ignorado. |
|||
| Hostname | n?o | Configurado por HostnameItem | Lista separada por v¨ªrgula de nomes de host ¨²nicos, sens¨ªveis a mai¨²sculas e min¨²sculas. Necess¨¢rio para verifica??es ativas e deve corresponder aos nomes de host conforme configurado no Server. O valor ¨¦ adquirido de HostnameItem se n?o definido. Caracteres permitidos: alfanum¨¦ricos, '.', ' ', '_' e '-'. Comprimento m¨¢ximo: 128 caracteres por nome de host, 2048 caracteres para a linha inteira. |
||
| HostnameItem | n?o | system.hostname | Item usado para gera??o do Hostname se ele n?o estiver definido. Ignorado se Hostname estiver definido. N?o suporta UserParameters ou apelidos, mas suporta system.run[] independentemente dos valores de AllowKey/DenyKey. O comprimento de sa¨ªda ¨¦ limitado em 512KB. |
||
| Include | n?o | Voc¨º pode incluir arquivos individuais ou todos os arquivos de um diret¨®rio no arquivo de configura??o. Durante a instala??o o Áú»¢¶Ä²© criar¨¢ o diret¨®rio de include em /usr/local/etc, a menos que modificado durante o tempo de compila??o. Para incluir apenas arquivos relevantes no diret¨®rio especificado, o caracter curinga asterisco ¨¦ suportado para correspond¨ºncia de padr?o. Por exemplo: /absolute/path/to/config/files/*.conf.Desde o Áú»¢¶Ä²© 6.0.0 um caminho pode ser relativo ¨¤ localiza??o do arquivo zabbix_agent2.conf. Consulte notas especiais sobre limita??es. |
|||
| ListenIP | n?o | 0.0.0.0 | Lista separada por v¨ªrgula de endere?os IP que o agente deve ouvir. O primeiro endere?o IP ¨¦ enviado para o Áú»¢¶Ä²© Server, se conectando a ele, para recuperar a lista de verifica??es ativas. |
||
| ListenPort | n?o | 1024-32767 | 10050 | O agente ouvir¨¢ nesta porta por conex?es vindas do Server. | |
| LogFile | sim, se LogType estiver configurado como file, caso contr¨¢rio n?o |
/tmp/zabbix_agent2.log | Nome do arquivo de log se LogType for 'file'. | ||
| LogFileSize | n?o | 0-1024 | 1 | Tamanho m¨¢ximo do arquivo de log em MB. 0 - desabilita rota??o de log autom¨¢tica. Nota: Se o limite de tamanho de arquivo de log for alcan?ado e a rota??o do arquivo falhar, por qualquer raz?o, o arquivo de log existente ¨¦ truncado e iniciado outra vez. |
|
| LogType | n?o | file | Especifica onde as mensagens de log s?o gravadas: system - syslog, file - arquivo especificado pelo par?metro LogFile, console - sa¨ªda padr?o. |
||
| PersistentBufferFile | n?o | O arquivo, onde o Áú»¢¶Ä²© Agent2 deve manter o banco de dados SQLite. Deve ser um nome de arquivo completo. Este par?metro ¨¦ usado apenas se o buffer persistente estiver habilitado (EnablePersistentBuffer=1). |
|||
| PersistentBufferPeriod | n?o | 1m-365d | 1h | O per¨ªodo de tempo pelo qual o dado deve ser armazenado, quando n?o h¨¢ conex?o com o 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). |
|
| PidFile | n?o | /tmp/zabbix_agent2.pid | Nome do arquivo PID. | ||
| Plugins | n?o | Desde o Áú»¢¶Ä²© 6.0.0 a maioria dos plugins tem seus pr¨®prios arquivos de configura??o. O arquivo de configura??o cont¨¦m os par?metros de plugin listados abaixo. | |||
| Plugins.Log.MaxLinesPerSecond | n?o | 1-1000 | 20 | N¨²mero m¨¢ximo de novas linhas que o agente enviar¨¢ por segundo para o Áú»¢¶Ä²© Server ou Proxy quando processando verifica??es ativas de 'log' e 'eventlog'. O valor fornecido ser¨¢ sobrescrito pelo par?metro 'maxlines', provido na chave de item 'log' ou 'eventlog'. Nota: O Áú»¢¶Ä²© processar¨¢ 10 vezes mais novas linhas que o configurado em MaxLinesPerSecond para procurar a string requerida em itens de log. Este par?metro ¨¦ suportado desde o 4.4.2 e substitui MaxLinesPerSecond. |
|
| Plugins.SystemRun.LogRemoteCommands | n?o | 0 | Habilita registro de log de comandos shell executados como alertas. 0 - desabilitado 1 - habilitado Comandos ser?o registrados em log apenas se executados remotamente. Entradas de log n?o ser?o criadas se system.run[] for lan?ado localmente pelos par?metros HostMetadataItem, HostInterfaceItem ou HostnameItem. Este par?metro ¨¦ suportado desde o 4.4.2 e substitui LogRemoteCommands. |
||
| RefreshActiveChecks | n?o | 60-3600 | 120 | Com que frequ¨ºncia a lista de verifica??es ativas ¨¦ atualizada, em segundos. Note que ap¨®s uma falha em atualizar as verifica??es ativas a pr¨®xima atualiza??o ser¨¢ tentada ap¨®s 60 segundos. |
|
| Server | sim | Lista separada por v¨ªrgula de endere?os IP, opcionalmente em nota??o CIDR, ou nomes DNS de Áú»¢¶Ä²© Servers e Áú»¢¶Ä²© Proxies. Conex?es de entrada ser?o aceitas apenas a partir dos hosts listados aqui. Se o suporte a IPv6 estiver habilitado ent?o '127.0.0.1', '::ffff:127.0.0.1' s?o tratados igualmente e '::/0' permitir?o qualquer endere?o IPv4 ou IPv6. '0.0.0.0/0' pode ser usado para permitir quaisquer endere?os IPv4. Exemplo: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com Espa?os s?o permitidos. |
|||
| ServerActive | n?o | Lista separada por v¨ªrgula de pares de endere?os IP ou nome DNS (endere?o:porta) ou clusters (endere?o:porta;endere?o2:porta) de Áú»¢¶Ä²© Servers e Áú»¢¶Ä²© Proxies para verifica??es ativas. N¨®s de cluster devem ser separados por um ponto-e-v¨ªrgula. M¨²ltiplos endere?os separados por v¨ªrgula podem ser fornecidos para usar v¨¢rios Áú»¢¶Ä²© Servers independentes em paralelo. Espa?os s?o permitidos. Se porta n?o for especificada, a porta padr?o ¨¦ usada. Endere?os IPv6 devem ser envoltos por colchetes se a porta para o host for especificado. Se a porta n?o for especificada, os colchetes para endere?os IPv6 s?o opcionais. Se este par?metro n?o for especificado, verifica??es ativas s?o desabilitadas. Exemplo para m¨²ltiplos 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 | n?o | Endere?os IP de origem para: - conex?es de sa¨ªda para o Áú»¢¶Ä²© Server ou Áú»¢¶Ä²© Proxy; - cria??o de conex?es quando executando alguns itens (web.page.get, net.tcp.port, etc.) |
|||
| StatusPort | n?o | 1024-32767 | Se configurado, o agente ouvir¨¢ nesta porta por requisi??es de estado HTTP (http://localhost:<porta>/status). | ||
| Timeout | n?o | 1-30 | 3 | Gastar n?o mais do que Timeout segundos no processamento. | |
| TLSAccept | sim, se certificado TLS ou par?metros PSK s?o definidos (mesmo para conex?o n?o criptografada), caso contr¨¢rio n?o | Quais conex?es de entrada aceitar. Usado para verifica??es passivas. M¨²ltiplos 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 |
|||
| TLSCAFile | n?o | Caminho completo de um arquivo contendo certificados CA(s) de topo-de-n¨ªvel para verifica??o de pares de certificado, usado para comunica??es criptografadas entre componentes Áú»¢¶Ä²©. | |||
| TLSCertFile | n?o | Caminho completo de um arquivo contendo os certificados de agente ou cadeia de certificado, usado para comunica??es criptografadas com componentes Áú»¢¶Ä²©. | |||
| TLSConnect | sim, se certificado TLS ou par?metros PSK est?o definidos (mesmo para conex?es n?o criptografadas), caso contr¨¢rio n?o | Como o agente deve se conectar ao Áú»¢¶Ä²© Server ou Proxy. Usado para verifica??es ativas. Apenas um valor pode ser especificado: unencrypted - conecta sem criptografia (padr?o) psk - conecta usando TLS e uma chave pr¨¦-compartilhada (PSK) cert - conecta usando TLS e um certificado |
|||
| TLSCRLFile | n?o | Caminho completo de um arquivo contendo certificados revogados. Este par?metro ¨¦ usado para comunica??es criptografadas com componentes Áú»¢¶Ä²©. | |||
| TLSKeyFile | n?o | Caminho completo de um arquivo contendo a chave privada do agente usada para comunica??es criptografadas com componentes Áú»¢¶Ä²©. | |||
| TLSPSKFile | n?o | Caminho completo de um arquivo contendo a chave pr¨¦-compartilhada do agente usada para comunica??es criptografadas com componentes Áú»¢¶Ä²©. | |||
| TLSPSKIdentity | n?o | String de identidade de chave pr¨¦-compartilhada, usada para comunica??es criptografadas com o Áú»¢¶Ä²© Server. | |||
| TLSServerCertIssuer | n?o | Emissor de certificado de Server (Proxy) permitido. | |||
| TLSServerCertSubject | n?o | Cliente de certificado de Server (Proxy) permitido. | |||
| UnsafeUserParameters | n?o | 0,1 | 0 | Permite que todos os caracteres sejam passados em argumentos para par?metros definidos por usu¨¢rio. Os seguintes caracteres n?o s?o permitidos: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Adicionalmente, caracteres de nova linha n?o s?o permitidos. |
|
| UserParameter | n?o | Par?metro definido por usu¨¢rio para monitoramento. Podem existir v¨¢rios par?metros definidos por usu¨¢rio. Formato: UserParameter=<chave>,<comando shell> Note que o comando shell n?o deve retornar uma string vazia ou apenas EOL. Comandos shell podem ter caminhos relativos, se o par?metro UserParameterDir for especificado. Exemplos: UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh |
|||
| UserParameterDir | n?o | Caminho de busca padr?o para comandos UserParameter. Se usado, o agente alterar¨¢ seu diret¨®rio de opera??o para o especificado aqui antes da execu??o de um comando. Deste modo, comandos UserParameter podem ter um prefixo relativo ./ em vez de um caminho completo.Apenas uma entrada ¨¦ permitida. Exemplo: UserParameterDir=/opt/myscripts |