1 agente Zabbix

Visão geral

Esta seção fornece detalhes sobre as chaves de item que usam a comunicação com o Zabbix Agent para a coleta de dados.

Há verificações do agente passivo e ativo. Ao configurar um item, você pode selecionar o tipo necessário:

• Zabbix agent - para verificações passivas
• Agente Zabbix (ativo) - para verificações ativas

Observe que todas as chaves de item suportadas pelo Zabbix Agent no Windows também são suportadas pela nova geração do Zabbix Agent 2. Consulte as [chaves de item adicionais] (/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) que você pode usar somente com o agente 2.

Plataformas suportadas

Exceto quando especificado de forma diferente nos detalhes do item, os itens do agente (e todos os parâmetros) são compatíveis com:

• Linux
• FreeBSD
• Solaris
• HP-UX
• AIX
• Tru64
• MacOS X
• OpenBSD
• NetBSD

Muitos itens de agente também são compatíveis com o Windows. Consulte a página Windows agent item para obter detalhes.

Detalhes principais do item

Os parâmetros sem colchetes angulares são obrigatórios. Os parâmetros marcados com colchetes angulares < > são opcionais.

kernel.maxfiles

O número máximo de arquivos abertos suportados pelo sistema operacional.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc

O número máximo de processos suportados pelo sistema operacional.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux 2.6 e posterior, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

kernel.openfiles

O número de descritores de arquivos abertos no momento.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux (o item pode funcionar em outras plataformas do tipo UNIX).

log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

O monitoramento de um arquivo de log.
Valor de retorno: Log.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo e o nome de um arquivo de registro;
  
• regexp - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão necessário;
  
• encoding - a página de código identificador;
  
• maxlines - o número máximo de novas linhas por segundo que o agente enviará para o Zabbix Server ou proxy. Esse parâmetro substitui o valor de 'MaxLinesPerSecond' em zabbix_agentd.conf;
  
• mode - valores possíveis: all (padrão) ou skip - ignora o processamento de dados mais antigos (afeta somente os itens recém-criados);
  
• output - um modelo opcional de formatação de saída. A sequência de escape \0 é substituída pela parte correspondida do texto (do primeiro caractere em que a correspondência começa até o caractere em que a correspondência termina), enquanto uma sequência de escape \N (em que N=1...9) é substituída pelo enésimo grupo correspondido (ou uma cadeia de caracteres vazia se N exceder o número de grupos capturados);
  
• maxdelay - o atraso máximo em segundos. Tipo: float. Valores: 0 - (padrão) nunca ignora as linhas do arquivo de log; > 0,0 - ignora as linhas mais antigas para que as linhas mais recentes sejam analisadas dentro de "maxdelay" segundos. Leia as observações de maxdelay antes de usá-lo!
  
• options - opções adicionais:
  mtime-noreread - registros não exclusivos, relidos somente se o tamanho do arquivo for alterado (ignorar alteração de tempo de modificação). (Esse parâmetro está obsoleto desde a versão 5.0.2, pois agora o mtime é ignorado)
  
• persistent dir (somente no zabbix_agentd em sistemas Unix; não suportado no Zabbix agent 2) - o caminho absoluto do diretório onde os arquivos persistentes serão armazenados. Veja também notas adicionais sobre [arquivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentários:

• O item deve ser configurado como uma verificação ativa;
• Se o arquivo estiver ausente ou se as permissões não permitirem o acesso, o item se tornará incompatível;
• Se output for deixado vazio, será retornada a linha inteira que contém o texto correspondente. Observe que todos os tipos de expressão regular global, exceto 'Result is TRUE', sempre retornam toda a linha correspondente e o parâmetro output é ignorado.
• A extração de conteúdo usando o parâmetro output ocorre no agente.

Exemplos:

log[/var/log/syslog]
       log[/var/log/syslog,error]
       log[/home/zabbix/logs/logfile,,,100]

Exemplo de uso do parâmetro output para extrair um número do registro de log:

log[/app1/app.log, "task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #esse item corresponderá a um registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" e enviará apenas "6080" para o servidor. Como um valor numérico está sendo enviado, o "Tipo de informação" desse item pode ser definido como "Numérico (não assinado)" e o valor pode ser usado em gráficos, acionadores etc.

Exemplo de uso do parâmetro output para reescrever um registro de log antes de enviá-lo ao servidor:

log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERROS: \4, DURAÇÃO: \2"] #esse item corresponderá a um registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" e enviará um registro modificado "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" para o servidor.

log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

A contagem de linhas correspondentes em um arquivo de log monitorado.
Valor de retorno: Integer.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo e o nome do arquivo de registro;
  
• regexp - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão necessário;
  
• encoding - a página de código identificador;
  
• maxproclines - o número máximo de novas linhas por segundo que o agente analisará (não pode exceder 10000). O valor padrão é 10*'MaxLinesPerSecond' em zabbix_agentd.conf.
  
• mode - valores possíveis: all (padrão) ou skip - ignora o processamento de dados mais antigos (afeta somente os itens recém-criados).
  
• maxdelay - o atraso máximo em segundos. Tipo: float. Valores: 0 - (padrão) nunca ignora as linhas do arquivo de log; > 0,0 - ignora as linhas mais antigas para que as linhas mais recentes sejam analisadas dentro de "maxdelay" segundos. Leia as observações de maxdelay antes de usá-lo!
  
• options - opções adicionais:
  mtime-noreread - registros não exclusivos, relidos somente se o tamanho do arquivo for alterado (ignorar alteração do tempo de modificação). (Esse parâmetro está obsoleto desde a versão 5.0.2, pois agora o mtime é ignorado)
  
• persistent dir (somente no zabbix_agentd em sistemas Unix; não suportado no Zabbix agent 2) - o caminho absoluto do diretório onde os arquivos persistentes serão armazenados. Veja também notas adicionais sobre [arquivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentários:

• O item deve ser configurado como uma verificação ativa;
• As linhas correspondentes são contadas nas novas linhas desde a última verificação de registro pelo agente e, portanto, dependem do intervalo de atualização do item;
• Se o arquivo estiver ausente ou se as permissões não permitirem o acesso, o item se tornará incompatível.

logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

O monitoramento de um arquivo de log que é rotacionado.
Valor de retorno: Log.
Consulte plataformas suportadas.

Parâmetros:

• file regexp - o caminho absoluto para o arquivo e o nome do arquivo descrito por uma [expressão] regular(/manual/regular_expressions#overview). Observe que somente o nome do arquivo é uma expressão regular.
  
• regexp - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão de conteúdo necessário;
  
• encoding - a página de código identificador;
  
• maxlines - o número máximo de novas linhas por segundo que o agente enviará para o Zabbix Server ou proxy. Esse parâmetro substitui o valor de 'MaxLinesPerSecond' em zabbix_agentd.conf.
  
• mode - valores possíveis: all (padrão) ou skip - ignora o processamento de dados mais antigos (afeta apenas os itens recém-criados).
  
• output - um modelo opcional de formatação de saída. A sequência de escape \0 é substituída pela parte correspondida do texto (do primeiro caractere em que a correspondência começa até o caractere em que a correspondência termina), enquanto uma sequência de escape \N (em que N=1...9) é substituída pelo enésimo grupo correspondido (ou uma cadeia de caracteres vazia se N exceder o número de grupos capturados).
  
• maxdelay - o atraso máximo em segundos. Tipo: float. Valores: 0 - (padrão) nunca ignora as linhas do arquivo de log; > 0,0 - ignora as linhas mais antigas para que as linhas mais recentes sejam analisadas dentro de "maxdelay" segundos. Leia as observações de maxdelay antes de usá-lo!
  
• options - o tipo de rotação do arquivo de log e outras opções. Valores possíveis:
  rotate (padrão),
  copytruncate - observe que copytruncate não pode ser usado junto com maxdelay. Nesse caso, maxdelay deve ser 0 ou não especificado; consulte as notas de copytruncate,
  mtime-reread - registros não exclusivos, relidos se o tempo de modificação ou o tamanho forem alterados (padrão),
  mtime-noreread - registros não exclusivos, relidos somente se o tamanho for alterado (ignorar alteração do tempo de modificação).
  
• dir persistente (somente em zabbix_agentd em sistemas Unix; não suportado no Zabbix agent 2) - o nome do caminho absoluto do diretório onde armazenar os arquivos persistentes. Veja também notas adicionais sobre [arquivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentários:

• O item deve ser configurado como uma [verificação ativa] (/manual/appendix/items/activepassive#active_checks);
• A rotação de registros é baseada na hora da última modificação dos arquivos;
• Observe que o logrt foi projetado para funcionar com um arquivo de registro ativo no momento, com vários outros arquivos inativos correspondentes rotacionados. Se, por exemplo, um diretório tiver muitos arquivos de log ativos, deverá ser criado um item de logrt separado para cada um deles. Caso contrário, se um item do logrt pegar muitos arquivos, isso poderá levar ao esgotamento da memória e a uma falha no monitoramento.
• Se output for deixado em branco, será retornada a linha inteira que contém o texto correspondente. Observe que todos os tipos de expressão regular global, exceto 'Result is TRUE', sempre retornam toda a linha correspondente e o parâmetro output é ignorado.
• A extração de conteúdo usando o parâmetro output ocorre no agente.

Exemplos:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,,100] #esse item corresponderá a um arquivo como "logfile1" (não corresponderá a ".logfile1")
       logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #esse item coletará dados de arquivos como "logfile_abc_1" ou "logfile__001"

Exemplo de uso do parâmetro output para extrair um número do registro de log:

logrt[/app1/^test.*log$, "task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #esse item corresponderá a um registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" e enviará apenas "6080" para o servidor. Como um valor numérico está sendo enviado, o "Tipo de informação" desse item pode ser definido como "Numérico (não assinado)" e o valor pode ser usado em gráficos, acionadores etc.

Exemplo de uso do parâmetro output para reescrever um registro de log antes de enviá-lo ao servidor:

logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERROS: \4, DURAÇÃO: \2"] #esse item corresponderá a um registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" e enviará um registro modificado "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" para o servidor. |

logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

A contagem de linhas correspondentes em um arquivo de registro monitorado que é rotacionado.
Valor de retorno: Integer.
Consulte plataformas suportadas.

Parâmetros:

• file regexp - o caminho absoluto para o arquivo e a [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão do nome do arquivo;
  
• regexp - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão necessário;
  
• encoding - a página de código identificador;
  
• maxproclines - o número máximo de novas linhas por segundo que o agente analisará (não pode exceder 10000). O valor padrão é 10*'MaxLinesPerSecond' em zabbix_agentd.conf.
  
• mode - valores possíveis: all (padrão) ou skip - ignora o processamento de dados mais antigos (afeta somente os itens recém-criados).
  
• maxdelay - o atraso máximo em segundos. Tipo: float. Valores: 0 - (padrão) nunca ignora as linhas do arquivo de log; > 0,0 - ignora as linhas mais antigas para que as linhas mais recentes sejam analisadas dentro de "maxdelay" segundos. Leia as observações de maxdelay antes de usá-lo!
  
• options - o tipo de rotação do arquivo de log e outras opções. Valores possíveis:
  rotate (padrão),
  copytruncate - observe que copytruncate não pode ser usado junto com maxdelay. Nesse caso, maxdelay deve ser 0 ou não especificado; consulte as notas de copytruncate,
  mtime-reread - registros não exclusivos, relidos se o tempo de modificação ou o tamanho forem alterados (padrão),
  mtime-noreread - registros não exclusivos, relidos somente se o tamanho for alterado (ignorar alteração do tempo de modificação).
  
• dir persistente (somente em zabbix_agentd em sistemas Unix; não suportado no Zabbix agent 2) - o nome do caminho absoluto do diretório onde armazenar os arquivos persistentes. Veja também notas adicionais sobre [arquivos persistentes] (log_items#notes-on-persistent-files-for-log-items).

Comentários:

• O item deve ser configurado como uma verificação ativa;
• As linhas correspondentes são contadas nas novas linhas desde a última verificação de registro pelo agente e, portanto, dependem do intervalo de atualização do item;
• A rotação do registro é baseada na hora da última modificação dos arquivos...

modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]

Lê dados Modbus.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux.

Parâmetros:

• endpoint - o endpoint definido como protocol://connection_string;
  
• slave id - a ID do escravo;
  
• function - a função Modbus;
  
• address - o endereço do primeiro registro, bobina ou entrada;
  
• count - o número de registros a serem lidos;
  
• type - o tipo de dados;
  
• endianness - a configuração de endianness;
  
• offset - o número de registros, a partir de 'address', cujos resultados serão descartados.

Consulte uma descrição detalhada dos parâmetros.

net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Verifica se o serviço DNS está ativo.
Valores de retorno: 0 - O DNS está inativo (o servidor não respondeu ou a resolução do DNS falhou); 1 - O DNS está ativo.
Consulte plataformas suportadas.

Parâmetros:

• ip - o endereço IP do servidor DNS (deixe em branco para o servidor DNS padrão, ignorado no Windows, a menos que esteja usando o agente 2 do Zabbix);
• name - o nome DNS a ser consultado;
• type - o tipo de registro a ser consultado (o padrão é SOA);
• timeout (ignorado no Windows, a menos que esteja usando o Zabbix Agent 2) - o tempo limite da solicitação em segundos (o padrão é 1 segundo);
• count (ignorado no Windows, a menos que esteja usando o Zabbix Agent 2) - o número de tentativas para a solicitação (o padrão é 2);
• protocol - o protocolo usado para realizar consultas de DNS: udp (padrão) ou tcp.

Comentários:

• Os valores possíveis para type são: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (não suportado pelo Zabbix Agent no Windows, Zabbix Agent 2 em todos os sistemas operacionais), HINFO, MINFO, TXT, SRV
• Não há suporte para nomes de domínio internacionalizados; em vez disso, use nomes codificados pelo IDNA.

Exemplo:

net.dns[198.51.100.1,example.com,MX,2,1]

net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Executa uma consulta de DNS.
Valor de retorno: uma cadeia de caracteres com o tipo de informação necessário.
Consulte plataformas suportadas.

Parâmetros:

• ip - o endereço IP do servidor DNS (deixe em branco para o servidor DNS padrão, ignorado no Windows, a menos que esteja usando o agente 2 do Zabbix);
• name - o nome DNS a ser consultado;
• type - o tipo de registro a ser consultado (o padrão é SOA);
• timeout (ignorado no Windows, a menos que esteja usando o Zabbix Agent 2) - o tempo limite da solicitação em segundos (o padrão é 1 segundo);
• count (ignorado no Windows, a menos que esteja usando o Zabbix Agent 2) - o número de tentativas para a solicitação (o padrão é 2);
• protocol - o protocolo usado para realizar consultas de DNS: udp (padrão) ou tcp.

Comentários:

• Os valores possíveis para type são:
  ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (não suportado pelo agente Zabbix no Windows, agente Zabbix 2 em todos os sistemas operacionais), HINFO, MINFO, TXT, SRV
• Não há suporte para nomes de domínio internacionalizados; em vez disso, use nomes codificados pelo IDNA.

Exemplo:

net.dns.record[198.51.100.1,example.com,MX,2,1]

net.if.collisions[if]

O número de colisões fora da janela.
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Privilégios de root são necessários no NetBSD.

Parâmetro:

• if - nome da interface de rede

net.if.discovery

A lista de interfaces de rede. Usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

net.if.in[if,<mode>]

As estatísticas de tráfego de entrada em uma interface de rede.
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. É necessário ter privilégios de root no NetBSD.

Parâmetros:

• if - nome da interface de rede (Unix); descrição completa da interface de rede ou endereço IPv4; ou, se estiver entre colchetes, GUID da interface de rede (Windows);
• mode - valores possíveis:
  bytes - número de bytes (padrão)
  packets - número de pacotes
  errors - número de erros
  dropped - número de pacotes descartados
  overruns (fifo) - número de erros de buffer FIFO
  frame - número de erros de enquadramento de pacotes
  compressed - número de pacotes compactados recebidos pelo driver de dispositivo
  multicast - número de quadros multicast recebidos pelo driver de dispositivo

Comentários:

• Você pode usar essa chave com a etapa de pré-processamento Change per second para obter as estatísticas de bytes por segundo;
• O modo dropped é compatível apenas com Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
• Os modos overruns, frame, compressed, multicast são compatíveis apenas com o Linux;
• No HP-UX, esse item não fornece detalhes sobre interfaces de loopback (por exemplo, lo0).

Exemplos:

net.if.in[eth0]
       net.if.in[eth0,errors]

net.if.out[if,<mode>]

As estatísticas de tráfego de saída em uma interface de rede.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. É necessário ter privilégios de root no NetBSD.

Parâmetros:

• if - nome da interface de rede (Unix); descrição completa da interface de rede ou endereço IPv4; ou, se estiver entre colchetes, GUID da interface de rede (Windows);
• mode - valores possíveis:
  bytes - número de bytes (padrão)
  packets - número de pacotes
  errors - número de erros
  dropped - número de pacotes descartados
  overruns (fifo) - número de erros de buffer FIFO
  collisions (colls) - número de colisões detectadas na interface de rede (Unix) o número de colisões detectadas na interface
  carrier - o número de perdas de portadora detectadas pelo driver do dispositivo
  compressed - o número de pacotes compactados transmitidos pelo driver do dispositivo

Comentários:

• Você pode usar essa chave com a etapa de pré-processamento Change per second para obter as estatísticas de bytes por segundo;
• O modo dropped é compatível apenas com o Linux e o HP-UX;
• Os modos overruns, collision, carrier e compressed são compatíveis apenas com o Linux;
• No HP-UX, esse item não fornece detalhes sobre interfaces de loopback (por exemplo, lo0).

Exemplos:

net.if.out[eth0]
       net.if.out[eth0,errors]

net.if.total[if,<mode>]

A soma das estatísticas de tráfego de entrada e saída em uma interface de rede.
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. É necessário ter privilégios de root no NetBSD.

Parâmetros:

• if - nome da interface de rede (Unix); descrição completa da interface de rede ou endereço IPv4; ou, se estiver entre colchetes, GUID da interface de rede (Windows);
• mode - valores possíveis:
  bytes - número de bytes (padrão)
  packets - número de pacotes
  errors - número de erros
  dropped - número de pacotes descartados
  overruns (fifo) - número de erros de buffer FIFO
  collisions (colls) - número de colisões detectadas na interface
  compressed - número de pacotes compactados transmitidos ou recebidos pelo driver de dispositivo

Comentários:

• Você pode usar essa chave com a etapa de pré-processamento Change per second para obter as estatísticas de bytes por segundo;
• O modo dropped é compatível apenas com Linux, HP-UX. Os pacotes descartados são suportados somente se tanto o net.if.in quanto o net.if.out funcionarem para pacotes descartados em sua plataforma.
• Os modos overruns, collision e compressed são suportados somente no Linux;
• No HP-UX, este item não fornece detalhes sobre interfaces de loopback (por exemplo, lo0).

Exemplos:

net.if.total[eth0]
       net.if.total[eth0,errors]

net.tcp.listen[port]

Verifica se essa porta TCP está no estado LISTEN.
Valores de retorno: 0 - não está no estado LISTEN; 1 - está no estado LISTEN.
Plataformas suportadas: Linux, FreeBSD, Solaris, MacOS X.

Parâmetro:

• port - Número da porta TCP

Nos kernels Linux 2.6.14 e superiores, as informações sobre soquetes TCP em escuta são obtidas da interface NETLINK do kernel, se possível. Caso contrário, as informações são recuperadas dos arquivos /proc/net/tcp e /roc/net/tcp6.

Exemplo:

net.tcp.listen[80]

net.tcp.port[<ip>,port]

Verifica se é possível fazer uma conexão TCP com a porta especificada.
Valores de retorno: 0 - não é possível conectar; 1 - é possível conectar.
Consulte plataformas suportadas.

Parâmetros:

• ip - o endereço IP ou o nome DNS (o padrão é 127.0.0.1);
• port - o número da porta.

Comentários:

• Para testes simples de desempenho de TCP, use net.tcp.service.perf[tcp,<ip>,<port>];
• Essas verificações podem resultar em mensagens adicionais nos arquivos de registro do daemon do sistema (geralmente, as sessões SMTP e SSH são registradas).

Exemplo:

net.tcp.port[,80] #esse item pode ser usado para testar a disponibilidade do servidor da Web em execução na porta 80

net.tcp.service[service,<ip>,<port>]

Verifica se um serviço está em execução e aceitando conexões TCP.
Valores de retorno: 0 - o serviço está inativo; 1 - o serviço está em execução.
Consulte plataformas suportadas.

Parâmetros:

• service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https ou telnet (consulte details);
• ip - o endereço IP ou o nome DNS (o padrão é 127.0.0.1);
• porta - o número da porta (por padrão, é usado o número da porta de serviço padrão).

Comentários:

• Essas verificações podem resultar em mensagens adicionais nos arquivos de registro do daemon do sistema (geralmente, as sessões SMTP e SSH são registradas);
• No momento, não há suporte para a verificação de protocolos criptografados (como IMAP na porta 993 ou POP na porta 995). Como solução alternativa, use net.tcp.port[] para verificações como essas.
• A verificação de LDAP e HTTPS no Windows é suportada apenas pelo Zabbix Agent 2;
• A verificação do telnet procura por um prompt de login (':' no final).

Exemplo:

net.tcp.service[ftp,,45] #esse item pode ser usado para testar a disponibilidade do servidor FTP na porta TCP 45

net.tcp.service.perf[service,<ip>,<port>]

Verifica o desempenho de um serviço TCP.
Valores de retorno: Float (0 - o serviço está inativo; segundos - o número de segundos gastos durante a conexão com o serviço).
Consulte plataformas suportadas.

Parâmetros:

• service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https ou telnet (consulte details);
• ip - o endereço IP ou o nome DNS (o padrão é 127.0.0.1);
• porta - o número da porta (por padrão, é usado o número da porta de serviço padrão).

Comentários:

• No momento, não há suporte para a verificação de protocolos criptografados (como IMAP na porta 993 ou POP na porta 995). Como solução alternativa, use net.tcp.service.perf[tcp,<ip>,<port>] para verificações como essas.
• A verificação do telnet procura um prompt de login (':' no final).

Exemplo:

net.tcp.service.perf[ssh] #esse item pode ser usado para testar a velocidade da resposta inicial do servidor SSH

net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Retorna o número de soquetes TCP que correspondem aos parâmetros.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux.

Parâmetros:

• laddr - o endereço IPv4/6 local ou a sub-rede CIDR;
• lport - o número da porta local ou o nome do serviço;
• raddr - o endereço IPv4/6 remoto ou a sub-rede CIDR;
• rport - o número da porta remota ou o nome do serviço;
• state - o estado da conexão (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).

Exemplo:

net.tcp.socket.count[,80,,,established] #o número de conexões com a porta TCP local 80 no estado estabelecido

net.udp.listen[port]

Verifica se essa porta UDP está no estado LISTEN.
Valores de retorno: 0 - não está no estado LISTEN; 1 - está no estado LISTEN.
Plataformas suportadas: Linux, FreeBSD, Solaris, MacOS X.

Parâmetro:

• port - Número da porta UDP

Exemplo:

net.udp.listen[68]

net.udp.service[service,<ip>,<port>]

Verifica se um serviço está em execução e respondendo a solicitações UDP.
Valores de retorno: 0 - o serviço está inativo; 1 - o serviço está em execução.
Consulte plataformas suportadas.

Parâmetros:

• service - ntp (consulte details);
• ip - o endereço IP ou o nome DNS (o padrão é 127.0.0.1);
• porta - o número da porta (por padrão, é usado o número da porta de serviço padrão).

Exemplo:

net.udp.service[ntp,,45] #esse item pode ser usado para testar a disponibilidade do serviço NTP na porta UDP 45

net.udp.service.perf[service,<ip>,<port>]

Verifica o desempenho de um serviço UDP.
Valores de retorno: Float (0 - o serviço está inativo; segundos - o número de segundos gastos aguardando a resposta do serviço).
Consulte plataformas suportadas.

Parâmetros:

• service - ntp (consulte details);
• ip - o endereço IP ou o nome DNS (o padrão é 127.0.0.1);
• porta - o número da porta (por padrão, é usado o número da porta de serviço padrão).

Exemplo:

net.udp.service.perf[ntp] #esse item pode ser usado para testar o tempo de resposta do serviço NTP

net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Retorna o número de soquetes UDP que correspondem aos parâmetros.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux.

Parâmetros:

• laddr - o endereço IPv4/6 local ou a sub-rede CIDR;
• lport - o número da porta local ou o nome do serviço;
• raddr - o endereço IPv4/6 remoto ou a sub-rede CIDR;
• rport - o número da porta remota ou o nome do serviço;
• state - o estado da conexão (estabelecida, desconectada).

Exemplo:

net.udp.socket.count[,,,,established] #retorna o número de soquetes UDP no estado conectado

proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]

A porcentagem de utilização da CPU do processo.
Valor de retorno: Float.
Plataformas suportadas: Linux, Solaris⁶.

Parâmetros:

• name - o nome do processo (o padrão é todos os processos);
• user - o nome do usuário (o padrão é todos os usuários);
• type - o tipo de utilização da CPU: total (padrão), usuário ou sistema;
• cmdline - filtro por linha de comando (é uma [expressão] regular(/manual/regular_expressions#overview));
• mode - o modo de coleta de dados: avg1 (padrão), avg5 ou avg15;
• zone - a zona de destino: current (padrão) ou all. Esse parâmetro é compatível somente com o Solaris.

Comentários:

• O valor retornado é baseado em uma única porcentagem de utilização do núcleo da CPU. Por exemplo, a utilização da CPU de um processo que usa totalmente dois núcleos é de 200%.
• Os dados de utilização da CPU do processo são reunidos por um coletor que suporta o máximo de 1024 consultas exclusivas (por nome, usuário e linha de comando). As consultas não acessadas durante as últimas 24 horas são removidas do coletor.
• Ao definir o parâmetro zone como current (ou padrão), caso o agente tenha sido compilado em um Solaris sem suporte a zonas, mas executado em um Solaris mais recente com suporte a zonas, o agente retornará NOTSUPPORTED (o agente não pode limitar os resultados apenas à zona atual). No entanto, tudo é suportado nesse caso.

Exemplos:

proc.cpu.util[,root] #Utilização da CPU de todos os processos em execução sob o usuário "root
       proc.cpu.util[zabbix_server,zabbix] #Utilização da CPU de todos os processos zabbix_server em execução sob o usuário zabbix

proc.get[<name>,<user>,<cmdline>,<mode>]

A lista de processos do sistema operacional e seus parâmetros. Pode ser usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parâmetros:

• name - o nome do processo (padrão todos os processos);
• user - o nome do usuário (padrão todos os usuários);
• cmdline - filtro por linha de comando (é uma [expressão] regular(/manual/regular_expressions#overview)). Esse parâmetro não é compatível com o Windows; em outras plataformas, ele não é compatível se o modo estiver definido como 'summary'.
• mode - valores possíveis:
  process (padrão), thread (sem suporte para NetBSD), summary. Consulte uma lista de parâmetros de processo retornados para cada modo e sistema operacional.

Comentários:

• Se um valor não puder ser recuperado, por exemplo, devido a um erro (o processo já morreu, falta de permissões, falha na chamada do sistema), será retornado -1;
• Consulte notes sobre a seleção de processos com os parâmetros name e cmdline (específicos do Linux).

Exemplos:

proc.get[zabbix_server,zabbix,,process] #lista de todos os processos do zabbix_server em execução sob o usuário zabbix, retorna uma entrada por PID
       proc.get[java,,,thread] #lista de todos os processos Java, retorna uma entrada por thread
       proc.get[,zabbix,,summary] #dados combinados para processos de cada tipo em execução sob o usuário zabbix, retorna uma entrada por nome de processo

proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]

A memória usada pelo processo em bytes.
Valor de retorno: Integer - com mode como max, min, sum; Float - com mode como avg
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD, NetBSD.

Parâmetros:

• name - o nome do processo (o padrão é todos os processos);
• user - o nome do usuário (o padrão é todos os usuários);
• mode - valores possíveis: avg, max, min ou sum (padrão);
• cmdline - filtro por linha de comando (é uma [expressão] regular(/manual/regular_expressions#overview));
• memtype - o tipo de memória usado pelo processo

Comentários:

• O parâmetro memtype é compatível apenas com Linux, FreeBSD, Solaris⁶, AIX;
• Quando vários processos usam memória compartilhada, a soma da memória usada pelos processos pode resultar em valores grandes e irrealistas.
  
  Consulte notes sobre a seleção de processos com os parâmetros name e cmdline (específicos do Linux).
  
  Quando esse item é invocado a partir da linha de comando e contém um parâmetro de linha de comando (por exemplo, usando o modo de teste do agente: zabbix_agentd -t proc.mem[,,,,apache2]), um processo extra será contado, pois o agente contará a si mesmo.

Exemplos:

proc.mem[,root] #a memória usada por todos os processos em execução sob o usuário "root
       proc.mem[zabbix_server,zabbix] #a memória usada por todos os processos zabbix_server executados sob o usuário zabbix
       proc.mem[,oracle,max,oracleZABBIX] #a memória usada pelo processo que consome mais memória e que está sendo executado sob o Oracle com oracleZABBIX em sua linha de comando

proc.num[<name>,<user>,<state>,<cmdline>,<zone>]

O número de processos.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, Solaris⁶, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Parâmetros:

• name - o nome do processo (o padrão é todos os processos);
• user - o nome do usuário (o padrão é todos os usuários);
• state - valores possíveis:
  all (padrão),
  disk - sono ininterrupto,
  run - em execução,
  sleep - sono ininterrupto,
  trace - parado,
  zomb - zumbi;
• cmdline - filtro por linha de comando (é uma [expressão] regular(/manual/regular_expressions#overview));
• zone - a zona de destino: current (padrão) ou all. Esse parâmetro é compatível apenas com o Solaris.

Comentários:

• Os parâmetros de estado disk e trace têm suporte apenas no Linux, FreeBSD, OpenBSD e NetBSD;
• Quando esse item é chamado a partir da linha de comando e contém um parâmetro de linha de comando (por exemplo, usando o modo de teste do agente: zabbix_agentd -t proc.num[,,,,apache2]), um processo extra será contado, pois o agente contará a si mesmo;
• Ao definir o parâmetro zone como current (ou padrão), caso o agente tenha sido compilado em um Solaris sem suporte a zonas, mas esteja sendo executado em um Solaris mais recente com suporte a zonas, o agente retornará NOTSUPPORTED (o agente não pode limitar os resultados apenas à zona atual). No entanto, tudo é suportado nesse caso.
• Consulte notes sobre a seleção de processos com os parâmetros name e cmdline (específicos do Linux).

Exemplos:

proc.num[,mysql] #o número de processos em execução sob o usuário mysql
       proc.num[apache2,www-data] #o número de processos do apache2 em execução sob o usuário www-data
       proc.num[,oracle,sleep,oracleZABBIX] #o número de processos em estado de suspensão em execução no Oracle com oracleZABBIX em sua linha de comando

sensor[dispositivo,sensor,<mode>]

Leitura do sensor de hardware.
Valor de retorno: Float.
Plataformas suportadas: Linux, OpenBSD.

Parâmetros:

• device - o nome do dispositivo, pode ser uma expressão regular se o modo for omitido;
• sensor - o nome do sensor, pode ser uma expressão regular se o modo for omitido;
• mode - valores possíveis: avg, max ou min (se esse parâmetro for omitido, o dispositivo e o sensor serão tratados literalmente).

Comentários:

• Lê /proc/sys/dev/sensors no Linux 2.4;
• Lê /sys/class/hwmon no Linux 2.6+. Veja uma descrição mais detalhada do item sensor no Linux.
• Lê o MIB hw.sensors no OpenBSD.

Exemplo:

sensor[w83781d-i2c-0-2d,temp1]
       sensor[cpu0,temp0] #a temperatura de uma CPU
       sensor["cpu[0-2]$",temp,avg] #a temperatura média das três primeiras CPUs

system.boottime

O tempo de inicialização do sistema.
Valor de retorno: Inteiro (registro de data e hora Unix).
Plataformas suportadas: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery

A lista de CPUs/núcleos de CPU detectados. Usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON.
Consulte plataformas suportadas.

system.cpu.intr

As interrupções do dispositivo.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.load[<cpu>,<mode>]

A [carga da CPU] (http://en.wikipedia.org/wiki/Load_(computing)).
Valor de retorno: Float.
Consulte supported platforms.

Parâmetros:

• cpu - valores possíveis: all (padrão) ou percpu (a carga total dividida pela contagem de CPUs on-line);
• mode - valores possíveis: avg1 (média de um minuto, padrão), avg5 ou avg15.

O parâmetro percpu não é suportado no Tru64.

Exemplo:

system.cpu.load[,avg5]

system.cpu.num[<type>]

O número de CPUs.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

Parâmetro:

• type - valores possíveis: online (padrão) ou max

O parâmetro de tipo max é compatível apenas com Linux, FreeBSD, Solaris e MacOS X.

Exemplo:

system.cpu.num

system.cpu.switches

A contagem de trocas de contexto.
Valor de retorno: Inteiro.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>]

A porcentagem de utilização da CPU.
Valor de retorno: Float.
Plataformas suportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, Tru64, OpenBSD, NetBSD.

Parâmetros:

• cpu - <CPU number> ou all (padrão);
• type - valores possíveis: user (padrão), idle, nice, system, iowait, interrupt, softirq, steal, guest (nos kernels Linux 2.6.24 e superiores) ou guest_nice (nos kernels Linux 2.6.33 e superiores);
• mode - valores possíveis: avg1 (média de um minuto, padrão), avg5 ou avg15;
• lógico ou físico - valores possíveis: logical (padrão) ou physical. Esse parâmetro é compatível somente com o AIX.

Comentários:

• O parâmetro de tipo nice é compatível somente com Linux, FreeBSD, HP-UX, Tru64, OpenBSD, NetBSD.
• O parâmetro de tipo iowait é compatível apenas com o Linux 2.6 e posterior, Solaris e AIX.
• O parâmetro de tipo interrupt é compatível apenas com o Linux 2.6 e posterior, FreeBSD, OpenBSD.
• Os parâmetros de tipo softirq, steal, guest, guest_nice são compatíveis apenas com o Linux 2.6 e posterior.
• Os parâmetros de modo avg5 e avg15 são compatíveis com Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Exemplo:

system.cpu.util[0,user,avg5]

system.hostname[<type>,<transform>]

O nome do host do sistema.
Valor de retorno: String.
Consulte plataformas suportadas.

Parâmetros:

• type - valores possíveis: netbios (padrão no Windows), host (padrão no Linux) ou shorthost (desde a versão 5.4.7; retorna parte do nome do host antes do primeiro ponto, uma cadeia completa para nomes sem pontos);
• transform - valores possíveis: none (padrão) ou lower (converter para minúsculas).

O valor é obtido retirando-se nodename da saída da API do sistema uname().

Exemplos de valores retornados:

system.hostname → linux-w7x1
       system.hostname → example.com
       system.hostname[shorthost] → exemplo

system.hw.chassis[<info>]

As informações do chassi.
Valor de retorno: String.
Plataformas suportadas: Linux.

Parâmetro:

• info - valores possíveis: full (padrão), model, serial, type ou vendor

Comentários:

• Essa chave de item depende da disponibilidade da tabela SMBIOS;
• Ele tentará ler a tabela DMI do sysfs; se o acesso ao sysfs falhar, tente ler diretamente da memória;
• são necessárias permissões de root porque o valor é adquirido pela leitura do sysfs ou da memória.

Exemplo:

system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXXXX Desktop

system.hw.cpu[<cpu>,<info>]

Informações sobre a CPU.
Valor de retorno: String ou Integer.
Plataformas suportadas: Linux.

Parâmetros:

• cpu - <CPU number> ou all (padrão);
• info - valores possíveis: full (padrão), curfreq, maxfreq, model ou vendor.

Comentários:

• Reúne informações de /proc/cpuinfo e /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq;
• Se um número de CPU e curfreq ou maxfreq forem especificados, um valor numérico será retornado (Hz).

Exemplo:

system.hw.cpu[0,vendor] → AuthenticAMD

system.hw.devices[<type>]

A listagem de dispositivos PCI ou USB.
Valor de retorno: Texto.
Plataformas suportadas: Linux.

Parâmetro:

• type - pci (padrão) ou usb

Retorna a saída do utilitário lspci ou lsusb (executado sem nenhum parâmetro).

Exemplo:

system.hw.devices → 00:00.0 Ponte de host: Ponte de host RS780 da Advanced Micro Devices [AMD]

system.hw.macaddr[<interface>,<format>]

A listagem de endereços MAC.
Valor de retorno: String.
Plataformas suportadas: Linux.

Parâmetros:

• interface - all (padrão) ou uma [expressão] regular(/manual/regular_expressions#overview);
• format - full (padrão) ou short

Comentários:

• Lista os endereços MAC das interfaces cujo nome corresponde à expressão regular interface fornecida(/manual/regular_expressions#overview) (all lista todas as interfaces);
• Se format for especificado como short, os nomes de interface e os endereços MAC idênticos não serão listados.

Exemplo:

system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55

system.localtime[<type>]

A hora do sistema.
Valor de retorno: Integer - com type como utc; String - com type como local.
Consulte plataformas suportadas.

Parâmetros:

• type - valores possíveis: utc - (padrão) a hora desde a época (00:00:00 UTC, 1º de janeiro de 1970), medida em segundos ou local - a hora no formato 'yyyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'

Deve ser usado somente como uma verificação passiva.

Exemplo:

system.localtime[local] #crie um item usando essa chave e, em seguida, use-o para exibir a hora do host no widget do painel *Clock*.

system.run[command,<mode>]

Executa o comando especificado no host.
Valor de retorno: Texto resultado do comando ou 1 - com mode como nowait (independentemente do resultado do comando).
Consulte plataformas suportadas.

Parâmetros:

• command - comando para execução;
  
• mode - valores possíveis: wait - espera o fim da execução (padrão) ou nowait - não espera.

Comentários:

• Esse item está desativado por padrão. Saiba como [habilitá-los] (/manual/config/items/restrict_checks);
• O valor de retorno do item é uma saída padrão junto com um erro padrão produzido pelo comando. A verificação do código de saída não é executada;
• Para ser processado corretamente, o valor de retorno do comando deve ser do tipo de dados text. Um resultado vazio também é permitido;
• O valor de retorno é limitado a 16 MB (incluindo espaços em branco à direita que são truncados); limites do banco de dados também se aplicam;
• Veja também: Command execution.

Exemplo:

system.run[ls -l /] #retorna uma lista detalhada de arquivos do diretório raiz

system.stat[resource,<type>]

As estatísticas do sistema.
Valor de retorno: Inteiro ou float.
Plataformas suportadas: AIX.

Parâmetros:

• ent - o número de unidades de processador que essa partição tem direito a receber (float);
• kthr,<type> - informações sobre os estados das threads do kernel:
  r - número médio de threads do kernel executáveis (float)
  b - número médio de threads do kernel colocadas na fila de espera do Virtual Memory Manager (float)
• Memória,<type> - informações sobre o uso da memória virtual e real:
  avm - páginas virtuais ativas (número inteiro)
  fre - tamanho da lista livre (número inteiro)
• page,<type> - informações sobre falhas de página e atividade de paginação:
  fi - page-ins de arquivo por segundo (float)
  fo - page-outs de arquivo por segundo (float)
  pi - páginas paginadas do espaço de paginação (float)
  po - páginas paginadas para o espaço de paginação (float)
  fr - páginas liberadas (substituição de página) (float)
  sr - páginas verificadas pelo algoritmo de substituição de página (float)
• faults,<type> - trap e taxa de interrupção:
  in - interrupções de dispositivo (float)
  sy - chamadas de sistema (float)
  cs - trocas de contexto de thread do kernel (float)
• cpu,<type> - detalhamento da porcentagem de uso do tempo do processador:
  us - tempo do usuário (ponto flutuante)
  sy - tempo do sistema (ponto flutuante)
  id - tempo ocioso (ponto flutuante)
  wa - tempo ocioso durante o qual o sistema teve solicitações de E/S de disco/NFS pendentes (ponto flutuante)
  pc - número de processadores físicos consumidos (ponto flutuante)
  ec - porcentagem da capacidade autorizada consumida (ponto flutuante) a porcentagem da capacidade autorizada consumida (ponto flutuante)
  lbusy - indica a porcentagem de utilização do(s) processador(es) lógico(s) que ocorreu durante a execução no nível do usuário e do sistema (ponto flutuante)
  app - indica os processadores físicos disponíveis no pool compartilhado (ponto flutuante)
• disk,<type> - estatísticas de disco:
  bps - indica a quantidade de dados transferidos (lidos ou gravados) para a unidade em bytes por segundo (número inteiro)
  tps - indica o número de transferências por segundo que foram emitidas para o disco/fita física (float)

Comentários:

• Observe as seguintes limitações nesses itens:
  system.stat[cpu,app] - suportado somente no AIX LPAR do tipo "Shared"
  system.stat[cpu,ec] - suportado em AIX LPAR do tipo "Shared" e "Dedicated" ("Dedicated" sempre retorna 100 (por cento))
  system.stat[cpu,lbusy] - suportado apenas em AIX LPAR do tipo "Shared"
  system.stat[cpu,pc] - suportado em AIX LPAR do tipo "Shared" e "Dedicated"
  system.stat[ent] - suportado em AIX LPAR do tipo "Compartilhado" e "Dedicado"

system.sw.arch

As informações sobre a arquitetura do software.
Valor de retorno: String.
Consulte plataformas suportadas.

As informações são obtidas com a função uname().

Exemplo:

system.sw.arch → i686

system.sw.os[<info>]

As informações do sistema operacional.
Valor de retorno: String.
Plataformas suportadas: Linux, Windows. Suportado no Windows desde o Zabbix 6.4.

Parâmetro:

• info - valores possíveis: full (padrão), short ou name

As informações são obtidas de (observe que nem todos os arquivos e opções estão presentes em todas as distribuições):

• /proc/version (full) no Linux;
• /proc/version_signature (curto) no Linux;
• o parâmetro PRETTY_NAME do /etc/os-release em sistemas Linux que o suportam ou /etc/issue.net (name);
• a chave de registro HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion no Windows.

Exemplos:

system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
       system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.amd64fre.ni_release.220506-1250 Build 22621.963]

system.sw.os.get

Informações detalhadas sobre o sistema operacional (versão, tipo, nome da distribuição, versão menor e maior, etc.).
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux, Windows. Suportado desde o Zabbix 6.4.

system.sw.packages[<regexp>,<manager>,<format>]

A listagem de pacotes instalados.
Valor de retorno: Texto.
Plataformas suportadas: Linux.

Parâmetros:

• regexp - todos (padrão) ou uma [expressão] regular(/manual/regular_expressions#overview);
• manager - todos (padrão) ou um gerenciador de pacotes;
• format - full (padrão) ou short.

Comentários:

• Lista (em ordem alfabética) os pacotes instalados cujo nome corresponde à [expressão] regular fornecida(/manual/regular_expressions#overview) (all lista todos eles);
• Gerenciadores de pacotes suportados (comando executado):
  dpkg (dpkg --get-selections)
  pkgtool (ls /var/log/packages)
  rpm (rpm -qa)
  pacman (pacman -Q)
• Se format for especificado como full, os pacotes serão agrupados por gerenciadores de pacotes (cada gerenciador em uma linha separada, começando com seu nome entre colchetes);
• Se format for especificado como short, os pacotes não serão agrupados e serão listados em uma única linha.

Exemplo:

system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal

system.sw.packages.get[<regexp>,<manager>]

Uma listagem detalhada dos pacotes instalados.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux. Suportado desde o Zabbix 6.4.

Parâmetros:

• regexp - todos (padrão) ou uma [expressão] regular (/manual/regular_expressions#overview);
• manager - todos (padrão) ou um gerenciador de pacotes (valores possíveis: rpm, dpkg, pkgtool ou pacman).

Comentários:

• Retorna um JSON não formatado com os pacotes instalados cujo nome corresponde à expressão regular fornecida;
• A saída é uma matriz de objetos, cada um contendo as seguintes chaves: name, manager, version, size, architecture, buildtime e installtime (consulte mais detalhes).

system.swap.in[<device>,<type>]

As estatísticas de swap-in (do dispositivo para a memória).
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, OpenBSD.

Parâmetros:

• device - especifica o dispositivo usado para troca (somente Linux) ou todos (padrão);
• type - valores possíveis: count (número de swapins, padrão em plataformas não Linux), sectors (setores trocados) ou pages (páginas trocadas, padrão no Linux).

Comentários:

• A fonte dessas informações é:
  /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Observe que pages só funcionará se o dispositivo não tiver sido especificado;
• O parâmetro de tipo sectors é compatível apenas com o Linux.

Exemplo:

system.swap.in[,pages]

system.swap.out[<device>,<type>]

As estatísticas de swap-out (da memória para o dispositivo).
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, OpenBSD.

Parâmetros:

• device - especifica o dispositivo usado para troca (somente Linux) ou todos (padrão);
• type - valores possíveis: count (número de trocas, padrão em plataformas que não sejam Linux), sectors (setores trocados) ou pages (páginas trocadas, padrão no Linux).

Comentários:

• A fonte dessas informações é:
  /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Observe que pages só funcionará se o dispositivo não tiver sido especificado;
• O parâmetro de tipo sectors é compatível apenas com o Linux.

Exemplo:

system.swap.out[,pages]

system.swap.size[<device>,<type>]

O tamanho do espaço de troca em bytes ou em porcentagem do total.
Valor de retorno: Integer - para bytes; Float - para porcentagem.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD.

Parâmetros:

• device - especifica o dispositivo usado para troca (somente FreeBSD) ou todos (padrão);
• type - valores possíveis: free (espaço de swap livre, padrão), pfree (espaço de swap livre, em porcentagem), pused (espaço de swap usado, em porcentagem), total (espaço de swap total) ou used (espaço de swap usado).

Comentários:

• Observe que pfree, pused não são suportados no Windows se o tamanho do swap for 0;
• Se device não for especificado, o Zabbix Agent levará em conta apenas os dispositivos de swap (arquivos), a memória física será ignorada. Por exemplo, nos sistemas Solaris, o comando swap -s inclui uma parte da memória física e dos dispositivos de troca (ao contrário do swap -l).

Exemplo:

system.swap.size[,pfree] → porcentagem de espaço livre de swap

system.uname

Identificação do sistema.
Valor de retorno: String.
Consulte plataformas suportadas.

Comentários:

• No UNIX, o valor desse item é obtido com a chamada de sistema uname();
• No Windows, o item retorna a arquitetura do sistema operacional, enquanto no UNIX ele retorna a arquitetura da CPU

Exemplo (UNIX):

 system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
        

system.uptime

O tempo de atividade do sistema em segundos.
Valor de retorno: Integer.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. O suporte ao Tru64 é desconhecido.

Na configuração do item, use as unidades s ou uptime para obter valores legíveis

system.users.num

O número de usuários conectados.
Valor de retorno: Inteiro.
Consulte plataformas suportadas.

O comando who é usado no lado do agente para obter o valor.

vfs.dev.discovery

A lista de dispositivos de bloco e seu tipo. Usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux.

vfs.dev.read[<device>,<type>,<mode>]

As estatísticas de leitura do disco.
Valor de retorno: Integer - com type em sectors, operations, bytes; Float - com type em sps, ops, bps.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parâmetros:

• device - dispositivo de disco (o padrão é todos ³);
• type - valores possíveis: sectors, operations, bytes, sps, ops ou bps (sps, ops, bps significam: setores, operações, bytes por segundo, respectivamente);
• mode - valores possíveis: avg1 (média de um minuto, padrão), avg5 ou avg15. Esse parâmetro é suportado somente com type em: sps, ops, bps.

Comentários:

• Se estiver usando um intervalo de atualização de três horas ou mais², esse item sempre retornará '0';
• Os parâmetros de tipo sectors e sps são compatíveis apenas com o Linux;
• O parâmetro de tipo ops é compatível apenas com o Linux e o FreeBSD;
• O parâmetro de tipo bps é compatível apenas com o FreeBSD;
• O parâmetro do tipo bytes é compatível apenas com o FreeBSD, Solaris, AIX e OpenBSD;
• O parâmetro mode é compatível apenas com o Linux e o FreeBSD;
• Você pode usar nomes de dispositivos relativos (por exemplo, sda), bem como um prefixo /dev/ opcional (por exemplo, /dev/sda);
• Há suporte para volumes lógicos LVM;
• Os valores padrão do parâmetro 'type' para diferentes sistemas operacionais:
  AIX - operações
  FreeBSD - bps
  Linux - sps
  OpenBSD - operações
  Solaris - bytes
• sps, ops e bps em plataformas compatíveis são limitados a 1024 dispositivos (1023 individuais e um para todos).

Exemplo:

vfs.dev.read[,operations]

vfs.dev.write[<device>,<type>,<mode>]

As estatísticas de gravação em disco.
Valor de retorno: Integer - com type em sectors, operations, bytes; Float - com type em sps, ops, bps.
Plataformas suportadas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parâmetros:

• device - dispositivo de disco (o padrão é todos ³);
• type - valores possíveis: sectors, operations, bytes, sps, ops ou bps (sps, ops, bps significam: setores, operações, bytes por segundo, respectivamente);
• mode - valores possíveis: avg1 (média de um minuto, padrão), avg5 ou avg15. Esse parâmetro é suportado somente com type em: sps, ops, bps.

Comentários:

• Se estiver usando um intervalo de atualização de três horas ou mais², esse item sempre retornará '0';
• Os parâmetros de tipo sectors e sps são compatíveis apenas com o Linux;
• O parâmetro de tipo ops é compatível apenas com o Linux e o FreeBSD;
• O parâmetro de tipo bps é compatível apenas com o FreeBSD;
• O parâmetro do tipo bytes é compatível apenas com o FreeBSD, Solaris, AIX e OpenBSD;
• O parâmetro mode é compatível apenas com o Linux e o FreeBSD;
• Você pode usar nomes de dispositivos relativos (por exemplo, sda), bem como um prefixo /dev/ opcional (por exemplo, /dev/sda);
• Há suporte para volumes lógicos LVM;
• Os valores padrão do parâmetro 'type' para diferentes sistemas operacionais:
  AIX - operações
  FreeBSD - bps
  Linux - sps
  OpenBSD - operações
  Solaris - bytes
• sps, ops e bps em plataformas compatíveis são limitados a 1024 dispositivos (1023 individuais e um para todos).

Exemplo:

vfs.dev.write[,operations]

vfs.dir.count[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]

A contagem de entradas do diretório.
Valor de retorno: Integer.
Consulte plataformas suportadas.

Parâmetros:

• dir - o caminho absoluto para o diretório;
• regex incl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser incluída; inclua tudo se estiver vazio (valor padrão);
• regex excl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser excluída; não exclua nenhuma se estiver vazia (valor padrão);
• types incl - tipos de entrada de diretório a serem contados, valores possíveis: file - arquivo regular, dir - subdiretório, sym - link simbólico, sock - soquete, bdev - dispositivo de bloco, cdev - dispositivo de caractere, fifo - FIFO, dev - sinônimo de "bdev,cdev", all - todos os tipos (padrão), ou seja, "file,dir,sym,sock,bdev,cdev,fifo". Vários tipos devem ser separados por vírgula e colocados entre aspas.
• types excl - tipos de entrada de diretório (consulte types incl) para NÃO contar. Se algum tipo de entrada estiver em ambos os types incl e types excl, as entradas de diretório desse tipo NÃO serão contadas.
• max depth - a profundidade máxima dos subdiretórios a serem percorridos:
  -1 (padrão) - ilimitado,
  0 - sem descida para subdiretórios.
• min size - o tamanho mínimo (em bytes) do arquivo a ser contado. Arquivos menores não serão contados. Sufixos de memória podem ser usados.
• Tamanho máximo - o tamanho máximo (em bytes) do arquivo a ser contado. Arquivos maiores não serão contados. Sufixos de memória podem ser usados.
• idade mínima - a idade mínima (em segundos) da entrada do diretório a ser contada. Os registros mais recentes não serão contados. Time suffixes pode ser usado.
• max age - a idade máxima (em segundos) da entrada do diretório a ser contada. As entradas tão antigas e mais antigas não serão contadas (tempo de modificação). Sufixos de tempo podem ser usados.
• regex excl dir - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome do diretório a ser excluído. Todo o conteúdo do diretório será excluído (em contraste com regex_excl)

Comentários:

• Não há suporte para variáveis de ambiente, por exemplo, %APP_HOME%, $HOME e %TEMP%;
• Pseudo-diretórios "." e ".." nunca são contados;
• Links simbólicos nunca são seguidos na passagem de diretórios;
• Tanto a regex incl quanto a regex excl estão sendo aplicadas a arquivos e diretórios durante o cálculo da contagem de entradas, mas são ignoradas na escolha dos subdiretórios a serem percorridos (se a regex incl for "(?i)^.+\.zip$" e a max depth não estiver definida, todos os subdiretórios serão percorridos, mas somente os arquivos do tipo zip serão contados).
• O tempo de execução é limitado pelo valor de tempo limite no agente configuration (3 segundos). Como a travessia de diretórios grandes pode demorar mais do que isso, nenhum dado será retornado e o item deixará de ser suportado. A contagem parcial não será retornada.
• Ao filtrar por tamanho, somente os arquivos regulares têm tamanhos significativos. No Linux e no BSD, os diretórios também têm tamanhos diferentes de zero (normalmente alguns Kb). Os dispositivos têm tamanhos zero, por exemplo, o tamanho de /dev/sda1 não reflete o tamanho da respectiva partição. Portanto, ao usar <min_size> e <max_size>, é aconselhável especificar <types_incl> como "file", para evitar surpresas.

Exemplos:

vfs.dir.count[/dev] #monitora o número de dispositivos em /dev (Linux)

vfs.dir.get[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]

A lista de entradas do diretório.
Valor de retorno: Objeto JSON.
Consulte plataformas suportadas.

Parâmetros:

• dir - o caminho absoluto para o diretório;
• regex incl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser incluída; inclua tudo se estiver vazio (valor padrão);
• regex excl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser excluída; não exclua nenhuma se estiver vazia (valor padrão);
• types incl - tipos de entrada de diretório a serem listados, valores possíveis: file - arquivo normal, dir - subdiretório, sym - link simbólico, sock - soquete, bdev - dispositivo de bloco, cdev - dispositivo de caractere, fifo - FIFO, dev - sinônimo de "bdev,cdev", all - todos os tipos (padrão), ou seja, "file,dir,sym,sock,bdev,cdev,fifo". Vários tipos devem ser separados por vírgula e colocados entre aspas.
• types excl - tipos de entrada de diretório (consulte types incl) para NÃO listar. Se algum tipo de entrada estiver em ambos os types incl e types excl, as entradas de diretório desse tipo NÃO serão listadas.
• max depth - a profundidade máxima dos subdiretórios a serem percorridos:
  -1 (padrão) - ilimitado,
  0 - sem descida para subdiretórios.
• min size - o tamanho mínimo (em bytes) do arquivo a ser listado. Arquivos menores não serão listados. Sufixos de memória podem ser usados.
• max size - o tamanho máximo (em bytes) do arquivo a ser listado. Arquivos maiores não serão listados. Sufixos de memória podem ser usados.
• idade mínima - a idade mínima (em segundos) do registro do diretório a ser listado. Os registros mais recentes não serão listados. Time suffixes pode ser usado.
• max age - a idade máxima (em segundos) do registro do diretório a ser listado. As entradas tão antigas ou mais antigas não serão listadas (tempo de modificação). Sufixos de tempo podem ser usados.
• regex excl dir - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome do diretório a ser excluído. Todo o conteúdo do diretório será excluído (em contraste com regex excl)

Comentários:

• Não há suporte para variáveis de ambiente, por exemplo, %APP_HOME%, $HOME e %TEMP%;
• Os pseudo-diretórios "." e ".." nunca são listados;
• Links simbólicos nunca são seguidos na passagem de diretórios;
• Tanto a regex incl quanto a regex excl estão sendo aplicadas a arquivos e diretórios durante a geração da lista de entradas, mas são ignoradas na escolha dos subdiretórios a serem percorridos (se a regex incl for "(?i)^.+\.zip$" e a max depth não estiver definida, todos os subdiretórios serão percorridos, mas apenas os arquivos do tipo zip serão contados).
• O tempo de execução é limitado pelo valor de tempo limite no agente configuration. Como a travessia de diretórios grandes pode demorar mais do que isso, nenhum dado será retornado e o item passará a não ser suportado. A lista parcial não será retornada.
• Ao filtrar por tamanho, somente os arquivos regulares têm tamanhos significativos. No Linux e no BSD, os diretórios também têm tamanhos diferentes de zero (normalmente alguns Kb). Os dispositivos têm tamanhos zero, por exemplo, o tamanho de /dev/sda1 não reflete o tamanho da respectiva partição. Portanto, ao usar min size e max size, é aconselhável especificar types incl como "file", para evitar surpresas.

Exemplos:

vfs.dir.get[/dev] #recupera a lista de dispositivos em /dev (Linux)

vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]

O tamanho do diretório (em bytes).
Valor de retorno: Integer.
Plataformas suportadas: Linux. O item pode funcionar em outras plataformas do tipo UNIX.

Parâmetros:

• dir - o caminho absoluto para o diretório;
• regex incl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser incluída; inclua tudo se estiver vazio (valor padrão);
• regex excl - uma [expressão] regular(/manual/regular_expressions#overview) que descreve o padrão de nome da entidade (arquivo, diretório, link simbólico) a ser excluída; não excluir nenhuma se estiver vazia (valor padrão);
• mode - valores possíveis: apparent (padrão) - obtém os tamanhos aparentes dos arquivos em vez do uso do disco (funciona como du -sb dir), disk - obtém o uso do disco (funciona como du -s -B1 dir). Ao contrário do comando du, o item vfs.dir.size considera os arquivos ocultos ao calcular o tamanho do diretório (atua como du -sb .[^.]* * dentro de dir).
• max depth - a profundidade máxima dos subdiretórios a serem percorridos: -1 (padrão) - ilimitado, 0 - sem descida para subdiretórios.
• regex excl dir - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão de nome do diretório a ser excluído. Todo o conteúdo do diretório será excluído (em contraste com regex excl)

Comentários:

• Somente os diretórios com pelo menos a permissão de leitura para o usuário zabbix são calculados. Para diretórios com permissão de leitura apenas, o tamanho do próprio diretório é calculado. Os diretórios com permissões de leitura e execução são calculados incluindo o conteúdo.
• Com diretórios grandes ou unidades lentas, esse item pode ter um tempo limite devido à configuração de tempo limite nos arquivos de configuração agent e server/proxy. Aumente os valores de tempo limite conforme necessário.
• O limite de tamanho do arquivo depende de large file support.

Exemplos:

vfs.dir.size[/tmp,log] #calcula o tamanho de todos os arquivos em /tmp que contêm "log" em seus nomes
       vfs.dir.size[/tmp,log,^.+\.old$] #calcula o tamanho de todos os arquivos em /tmp que contêm "log" em seus nomes, excluindo os arquivos com nomes que terminam com ".old

vfs.file.cksum[file,<mode>]

A soma de verificação do arquivo, calculada pelo algoritmo cksum do UNIX.
Valor de retorno: Integer - com mode como crc32, String - com mode como md5, sha256.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• mode - crc32 (padrão), md5 ou sha256.

O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.cksum[/etc/passwd]

Exemplo de valores retornados (crc32/md5/sha256, respectivamente):

675436101
       9845acf68b73991eb7fd7ee0ded23c44
       ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc

vfs.file.contents[file,<encoding>]

Recuperação do conteúdo de um arquivo⁷.
Valor de retorno: Texto.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• encoding - a página de código identificador.

Comentários:

• O valor de retorno é limitado a 16 MB (incluindo espaços em branco à direita que são truncados); limites do banco de dados também se aplicam;
• Uma cadeia de caracteres vazia será retornada se o arquivo estiver vazio ou contiver apenas caracteres LF/CR;
• A marca de ordem de bytes (BOM) é excluída da saída.

Exemplo:

vfs.file.contents[/etc/passwd]

vfs.file.exists[file,<types incl>,<types excl>]

Verifica se o arquivo existe.
Valor de retorno: 0 - não encontrado; 1 - existe o arquivo do tipo especificado.
Consulte supported platforms.

Parâmetros:

• file - o caminho completo para o arquivo;
• types incl - a lista de tipos de arquivos a serem incluídos, valores possíveis: file (arquivo normal, padrão (se types_excl não estiver definido)), dir (diretório), sym (link simbólico), sock (soquete), bdev (dispositivo de bloco), cdev (dispositivo de caractere), fifo (FIFO), dev (sinônimo de "bdev,cdev"), all (todos os tipos mencionados, padrão se types_excl estiver definido).
• types excl - a lista de tipos de arquivos a serem excluídos, consulte types_incl para obter os valores possíveis (por padrão, nenhum tipo é excluído)

Comentários:

• Vários tipos devem ser separados por vírgula e o conjunto inteiro deve ser colocado entre aspas "";
• Se o mesmo tipo estiver em <types_incl> e <types_excl>, os arquivos desse tipo serão excluídos;
• O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplos:

vfs.file.exists[/tmp/application.pid]
       vfs.file.exists[/tmp/application.pid, "file,dir,sym"]
       vfs.file.exists[/tmp/application_dir,dir]

vfs.file.get[file]

Retorna informações sobre um arquivo.
Valor de retorno: Objeto JSON.
Consulte plataformas suportadas.

Parâmetro:

• file - o caminho completo para o arquivo

Comentários:

• Tipos de arquivo com suporte em sistemas do tipo UNIX: arquivo regular, diretório, link simbólico, soquete, dispositivo de bloco, dispositivo de caractere, FIFO.
• O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.get[/etc/passwd] #retorna um JSON com informações sobre o arquivo /etc/passwd (tipo, usuário, permissões, SID, uid etc.)

vfs.file.md5sum[file]

A soma de verificação MD5 do arquivo.
Valor de retorno: Cadeia de caracteres (hash MD5 do arquivo).
Consulte plataformas suportadas.

Parâmetro:

• file - o caminho completo para o arquivo

O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Exemplo de valor retornado:

b5052decb577e0fffd622d6ddc017e82

vfs.file.owner[file,<ownertype>,<resulttype>]

Recupera o proprietário de um arquivo.
Valor de retorno: String.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• ownertype - user (padrão) ou group (somente Unix);
• resulttype - name (padrão) ou id; para id - retorna uid/gid no Unix, SID no Windows.

O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.owner[/tmp/zabbix_server.log] #retorna o proprietário do arquivo /tmp/zabbix_server.log
       vfs.file.owner[/tmp/zabbix_server.log,,id] #retorna o ID do proprietário do arquivo /tmp/zabbix_server.log

vfs.file.permissions[file]

Retorna uma cadeia de 4 dígitos contendo o número octal com permissões UNIX.
Valor de retorno: String.
Plataformas suportadas: Linux. O item pode funcionar em outras plataformas do tipo UNIX.

Parâmetros:

• file - o caminho completo para o arquivo

O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.permissions[/etc/passwd] #retorna as permissões de /etc/passwd, por exemplo, '0644'

vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]

Recupera uma cadeia de caracteres no arquivo⁷.
Valor de retorno: A linha que contém a cadeia de caracteres correspondente ou conforme especificado pelo parâmetro opcional output.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• regexp - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão necessário;
• encoding - a página de código identificador;
• start line - o número da primeira linha a ser pesquisada (primeira linha do arquivo por padrão);
• end line - o número da última linha a ser pesquisada (por padrão, a última linha do arquivo);
• output - um modelo opcional de formatação de saída. A sequência de escape \0 é substituída pela parte do texto correspondente (do primeiro caractere em que a correspondência começa até o caractere em que a correspondência termina), enquanto uma sequência de escape \N (em que N=1...9) é substituída pelo enésimo grupo correspondente (ou uma cadeia de caracteres vazia se N exceder o número de grupos capturados).

Comentários:

• O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).
• Somente a primeira linha correspondente é retornada;
• Uma cadeia de caracteres vazia é retornada se nenhuma linha corresponder à expressão;
• A marca de ordem de bytes (BOM) é excluída da saída;
• A extração de conteúdo usando o parâmetro output ocorre no agente.

Exemplos:

vfs.file.regexp[/etc/passwd,zabbix]
       vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
       vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → obtendo o ID do usuário *zabbix*

vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]

Localiza uma cadeia de caracteres no arquivo⁷.
Valores de retorno: 0 - correspondência não encontrada; 1 - encontrada.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• regexp - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão necessário;
• encoding - a página de código identificador;
• start line - o número da primeira linha a ser pesquisada (primeira linha do arquivo por padrão);
• end line - o número da última linha a ser pesquisada (última linha do arquivo por padrão).

Comentários:

• O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).
• A marca de ordem de bytes (BOM) é ignorada.

Exemplo:

vfs.file.regmatch[/var/log/app.log,error]

vfs.file.size[file,<mode>]

O tamanho do arquivo (em bytes).
Valor de retorno: Inteiro.
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• mode - valores possíveis: bytes (padrão) ou lines (linhas vazias também são contadas).

Comentários:

• O arquivo deve ter permissões de leitura para o usuário zabbix;
• O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.size[/var/log/syslog]

vfs.file.time[file,<mode>]

As informações de tempo do arquivo.
Valor de retorno: Integer (carimbo de data/hora Unix).
Consulte plataformas suportadas.

Parâmetros:

• file - o caminho completo para o arquivo;
• mode - valores possíveis:
  modify (padrão) - a última vez que modificou o conteúdo do arquivo,
  access - a última vez que leu o arquivo,
  change - a última vez que alterou as propriedades do arquivo

O limite de tamanho do arquivo depende do [suporte a arquivos grandes] (/manual/appendix/items/large_file_support).

Exemplo:

vfs.file.time[/etc/passwd,modify]

vfs.fs.discovery

A lista de sistemas de arquivos montados com seu tipo e opções de montagem. Usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON.
Plataformas suportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

vfs.fs.get

A lista de sistemas de arquivos montados com seu tipo, espaço em disco disponível, estatísticas de inode e opções de montagem. Pode ser usada para descoberta de baixo nível.
Valor de retorno: Objeto JSON
Plataformas suportadas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.

Comentários:

• Os sistemas de arquivos com a contagem de inodes igual a zero, que pode ser o caso de sistemas de arquivos com inodes dinâmicos (por exemplo, btrfs), também são relatados;
• Veja também: Discovery of mounted filesystems.

vfs.fs.inode[fs,<mode>]

O número ou a porcentagem de inodes.
Valor de retorno: Integer - para número; Float - para porcentagem.
Consulte plataformas suportadas.

Parâmetros:

• fs - o sistema de arquivos;
• mode - valores possíveis: total (padrão), free, used, pfree (livre, porcentagem) ou pused (usado, porcentagem).

Se a contagem de inodes for igual a zero, o que pode ser o caso de sistemas de arquivos com inodes dinâmicos (por exemplo, btrfs), os valores de pfree/pused serão relatados como "100" e "0", respectivamente.

Exemplo:

vfs.fs.inode[/,pfree]

vfs.fs.size[fs,<mode>]

O espaço em disco em bytes ou em porcentagem do total.
Valor de retorno: Integer - para bytes; Float - para porcentagem.
Consulte plataformas suportadas.

Parâmetros:

• fs - o sistema de arquivos;
• mode - valores possíveis: total (padrão), free, used, pfree (livre, porcentagem) ou pused (usado, porcentagem).

Comentários:

• Se o sistema de arquivos não estiver montado, retorna o tamanho de um sistema de arquivos local em que o ponto de montagem está localizado;
• O espaço reservado de um sistema de arquivos é levado em conta e não é incluído quando se usa o modo free.

Exemplo:

vfs.fs.size[/tmp,free]

vm.memory.size[<mode>]

O tamanho da memória em bytes ou em porcentagem do total.
Valor de retorno: Integer - para bytes; Float - para porcentagem.
Consulte plataformas suportadas.

Parâmetro:

• mode - valores possíveis: total (padrão), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (usado, porcentagem), available ou pavailable (disponível, porcentagem).

Comentários:

• Esse item aceita três categorias de parâmetros:
  1) total - quantidade total de memória
  2) tipos de memória específicos da plataforma: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired
  3) estimativas em nível de usuário sobre a quantidade de memória usada e disponível: used, pused, available, pavailable
• O parâmetro de modo active é compatível apenas com o FreeBSD, HP-UX, MacOS X, OpenBSD e NetBSD;
• Os parâmetros de modo anon, exec, file são compatíveis apenas com o NetBSD;
• O parâmetro de modo buffers é compatível apenas com Linux, FreeBSD, OpenBSD, NetBSD;
• O parâmetro de modo cached é compatível apenas com Linux, FreeBSD, AIX, OpenBSD e NetBSD;
• Os parâmetros de modo inactive, wired são suportados somente no FreeBSD, MacOS X, OpenBSD, NetBSD;
• O parâmetro de modo pinned é compatível apenas com o AIX;
• O parâmetro de modo shared é compatível apenas com Linux 2.4, FreeBSD, OpenBSD, NetBSD;
• Consulte também detalhes adicionais para esse item.

Exemplo:

vm.memory.size[pavailable]

web.page.get[host,<path>,<port>]

Obter o conteúdo de uma página da Web.
Valor de retorno: Fonte da página da Web como texto (incluindo cabeçalhos).
Consulte plataformas suportadas.

Parâmetros:

• host - o nome do host ou o URL (como scheme://host:port/path, em que somente host é obrigatório). Esquemas de URL permitidos: http, https⁴. Um esquema ausente será tratado como http. Se um URL for especificado, path e port deverão estar vazios. Especificar o nome de usuário/senha ao se conectar a servidores que exigem autenticação, por exemplo: http://user:[email protected] só é possível com suporte a cURL ⁴. Punycode é suportado em nomes de host.
• path - o caminho para um documento HTML (o padrão é /);
• port - o número da porta (o padrão é 80 para HTTP)

Comentários:

• Este item se tornará incompatível se o recurso especificado em host não existir ou não estiver disponível;
• o host pode ser um nome de host, nome de domínio, endereço IPv4 ou IPv6. Mas para endereços IPv6, o Zabbix Agent deve ser compilado com o suporte a IPv6 ativado.

Exemplo:

web.page.get[www.example.com,index.php,80]
       web.page.get[https://www.example.com]
       página.da.web.get[https://blog.example.com/?s=zabbix]
       web.page.get[localhost:80]
       web.page.get["[::1]/server-status"]

web.page.perf[host,<path>,<port>]

O tempo de carregamento de uma página da Web completa (em segundos).
Valor de retorno: Float.
Consulte plataformas suportadas.

Parâmetros:

• host - o nome do host ou o URL (como scheme://host:port/path, em que apenas host é obrigatório). Esquemas de URL permitidos: http, https⁴. Um esquema ausente será tratado como http. Se um URL for especificado, path e port deverão estar vazios. Especificar nome de usuário/senha ao se conectar a servidores que exigem autenticação, por exemplo: http://user:[email protected] só é possível com suporte a cURL ⁴. O código de pontuação é suportado em nomes de host.
• path - o caminho para um documento HTML (o padrão é /);
• port - o número da porta (o padrão é 80 para HTTP)

Comentários:

• Este item se tornará incompatível se o recurso especificado em host não existir ou não estiver disponível;
• o host pode ser um nome de host, nome de domínio, endereço IPv4 ou IPv6. Mas para endereços IPv6, o Zabbix Agent deve ser compilado com o suporte a IPv6 ativado.

Exemplo:

web.page.perf[www.example.com,index.php,80]
       web.page.perf[https://www.example.com]

web.page.regexp[host,<path>,<port>,regexp,<length>,<output>]

Localiza uma cadeia de caracteres na página da Web.
Valor de retorno: A cadeia de caracteres correspondente ou conforme especificado pelo parâmetro opcional output.
Consulte plataformas suportadas.

Parâmetros:

• host - o nome do host ou o URL (como scheme://host:port/path, em que somente host é obrigatório). Esquemas de URL permitidos: http, https⁴. Um esquema ausente será tratado como http. Se um URL for especificado, path e port deverão estar vazios. Especificar nome de usuário/senha ao se conectar a servidores que exigem autenticação, por exemplo: http://user:[email protected] só é possível com suporte a cURL ⁴. O código de pontuação é compatível com os nomes de host.
• path - o caminho para um documento HTML (o padrão é /);
• port - o número da porta (o padrão é 80 para HTTP)
• regexp - uma [expressão] regular (/manual/regular_expressions#overview) que descreve o padrão necessário;
• length - o número máximo de caracteres a serem retornados;
• output - um modelo opcional de formatação de saída. A sequência de escape \0 é substituída pela parte do texto correspondente (do primeiro caractere em que a correspondência começa até o caractere em que a correspondência termina), enquanto uma sequência de escape \N (em que N=1...9) é substituída pelo enésimo grupo correspondente (ou uma cadeia de caracteres vazia se N exceder o número de grupos capturados).

Comentários:

• Esse item não terá suporte se o recurso especificado em host não existir ou não estiver disponível;
• host pode ser um nome de host, nome de domínio, endereço IPv4 ou IPv6. Mas para endereços IPv6, o Zabbix Agent deve ser compilado com o suporte a IPv6 ativado.
• A extração de conteúdo usando o parâmetro output ocorre no agente.

Exemplo:

web.page.regexp[www.example.com,index.php,80,OK,2]
       web.page.regexp[https://www.example.com,,,OK,2]|

agent.hostmetadata

Os metadados do host do agente.
Valor de retorno: String.
Consulte plataformas suportadas.

Retorna o valor dos parâmetros HostMetadata ou HostMetadataItem, ou uma cadeia de caracteres vazia se nenhum for definido.

agent.hostname

O nome do host do agente.
Valor de retorno: String.
Consulte plataformas suportadas.

Retorna:

• Como verificação passiva - o nome do primeiro host listado no parâmetro Hostname do arquivo de configuração do agente;
• Como verificação ativa - o nome do hostname atual.

agent.ping

A verificação de disponibilidade do agente.
Valor de retorno: Nada - indisponível; 1 - disponível.
Consulte plataformas suportadas.

Use a função de acionamento nodata() para verificar a indisponibilidade do host.

agent.variant

A variante do Zabbix Agent (Zabbix Agent ou Zabbix Agent 2).
Valor de retorno: 1 - Zabbix agent; 2 - Zabbix agent 2.
Consulte plataformas suportadas.

agent.version

A versão do agente Zabbix.
Valor de retorno: String.
Consulte plataformas suportadas.

Exemplo de valor retornado:

6.0.3

zabbix.stats[<ip>,<port>]

Retorna remotamente um conjunto de métricas internas do servidor Zabbix ou do proxy.
Valor de retorno: Objeto JSON.
Consulte plataformas suportadas.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede dos servidores/proxies a serem consultados remotamente (o padrão é 127.0.0.1);
• port - a porta do servidor/proxy a ser consultada remotamente (o padrão é 10051)

Comentários:

• Um conjunto selecionado de métricas internas é retornado por esse item. Para obter detalhes, consulte [Remote monitoring of Zabbix stats] (/manual/appendix/items/remote_stats#exposed_metrics);
• Observe que a solicitação de estatísticas só será aceita a partir dos endereços listados no parâmetro 'StatsAllowedIP' server/proxy na instância de destino.

zabbix.stats[<ip>,<port>,queue,<from>,<to>]

Retorna o número de itens monitorados na fila que estão atrasados no servidor Zabbix ou no proxy remotamente.
Valor de retorno: Objeto JSON.
Consulte plataformas suportadas.

Parâmetros:

• ip - a lista de IP/DNS/máscara de rede dos servidores/proxies a serem consultados remotamente (o padrão é 127.0.0.1);
• porta - a porta do servidor/proxy a ser consultada remotamente (o padrão é 10051)
• queue - constante (para ser usada como está)
• from - com atraso de pelo menos (o padrão é 6 segundos)
• to - com atraso de no máximo (o padrão é infinito)

Observe que a solicitação de estatísticas só será aceita dos endereços listados no parâmetro 'StatsAllowedIP' server/proxy na instância de destino.

Chaves de itens suportados

As chaves de item que você pode usar com o Zabbix Agent estão listadas abaixo.

As chaves de item são listadas sem parâmetros e informações adicionais. Clique na chave de item para ver os detalhes completos.

Notas de rodapé

¹Uma nota específica do Linux. O agente Zabbix deve ter acesso somente leitura ao sistema de arquivos /proc. Os patches do kernel de www.grsecurity.org limitam os direitos de acesso de usuários não privilegiados.

² vfs.dev.read[], vfs.dev.write[]: O agente Zabbix encerrará conexões de dispositivo "obsoletas" se os valores dos itens não forem acessados por mais de mais de 3 horas. Isso pode ocorrer se um sistema tiver dispositivos com caminhos que mudam caminhos que mudam dinamicamente ou se um dispositivo for removido manualmente. Observe também que esses itens, se estiverem usando um intervalo de atualização de 3 horas ou mais, sempre retornarão retornarão "0".

³ vfs.dev.read[], vfs.dev.write[]: Se o padrão all for usado para o primeiro parâmetro, a chave retornará estatísticas resumidas, incluindo todos os dispositivos de bloco como sda, sdb e suas partições (sda1, sda2, sdb3...) e vários dispositivos (MD raid) com base nesses dispositivos de bloco/partições e volumes lógicos de bloco/partições e volumes lógicos (LVM) baseados nesses dispositivos/partições de bloco. Nesses casos, os valores retornados devem ser considerados apenas como valor relativo (dinâmico no tempo), mas não como valores absolutos.

sSL (HTTPS) é suportado somente se o agente for compilado com suporte a cURL suportado. Caso contrário, o item não terá suporte.

⁵ Os valores bytes e errors não são suportados para interfaces de loopback em sistemas Solaris até o Solaris 10 6/06, inclusive, pois as estatísticas de bytes, erros e utilização não são armazenadas e/ou relatadas pelo kernel. No entanto, se você estiver monitorando um sistema Solaris por meio do net-snmp, os valores poderão ser retornados, pois o net-snmp carrega o código legado do cmu-snmp datado de 1997 que, ao não conseguir ler os valores de byte das estatísticas da interface, retorna o contador de pacotes (que existe nas interfaces de loopback) multiplicado por um valor arbitrário de 308. Isso pressupõe que o comprimento médio de um pacote é de 308 octetos, o que é uma estimativa muito aproximada, pois o limite de MTU nos sistemas Solaris para interfaces de loopback é de 8892 bytes. Não se deve presumir que esses valores estejam corretos ou que sejam muito precisos. Eles são estimativas. O agente Zabbix não faz nenhuma estimativa, mas o net-snmp retornará um valor para esses campos.

a linha de comando no Solaris, obtida de /proc/pid/psinfo, é limitada a 80 bytes e contém a linha de comando como estava quando o processo foi iniciado.

⁷ Os itens vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] podem ser usados para recuperar o conteúdo do arquivo. Se quiser restringir o acesso a arquivos específicos com informações confidenciais, execute o Zabbix Agent em um usuário que não tenha permissões de acesso para visualizar esses arquivos.

Uso com utilitários de linha de comando

Observe que, ao testar ou usar chaves de item com zabbix_agentd ou zabbix_get a partir da linha de comando, você também deve considerar a sintaxe do shell.

Por exemplo, se um determinado parâmetro da chave tiver que ser colocado entre aspas duplas você deverá escapar explicitamente das aspas duplas; caso contrário, elas serão cortadas pelo shell como caracteres especiais e não serão passados para o utilitário Zabbix.

Exemplos:

$ zabbix_agentd -t 'vfs.dir.count[/var/log,,, "file,dir",,0]'
       
       $ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]

Configurações de codificação

Para garantir que os dados adquiridos não sejam corrompidos, você pode especificar a codificação correta para processar a verificação (por exemplo, 'vfs.file.contents') no parâmetro encoding. A lista de codificações compatíveis (identificadores de página de código ) pode ser encontrada na documentação de libiconv (Projeto GNU) ou na Documentação do Microsoft Windows SDK para "Code Page Identifiers".

Se nenhuma codificação for especificada no parâmetro encoding, as seguintes estratégias de resolução são aplicadas:

• Se a codificação não for especificada (ou for uma cadeia de caracteres vazia), ela será assumida como UTF-8 e os dados serão processados "como estão";
• Análise de lista técnica - aplicável aos itens 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. É feita uma tentativa de determinar a codificação correta usando a marca de ordem de bytes (BOM) no início do arquivo no início do arquivo. Se a BOM não estiver presente, a resolução padrão (veja acima) será aplicada em seu lugar.

Solução de problemas de itens do agente

• Se usado com o agente passivo, o valor Timeout na configuração do pode precisar ser maior do que o Timeout no arquivo de configuração do agente no arquivo de configuração do agente. Caso contrário, o item poderá não receber nenhum valor porque a solicitação do servidor ao agente expirou primeiro.