Documentation
Table of Contents
1 Criando um item
Vis?o geral
Para criar um item na interface web do Áú»¢¶Ä²©, execute os passos a seguir:
- Acesse: Configura??o ¡ú Hosts
- Clique no link Itens na linha do host desejado
- Clique no bot?o Criar item no canto superior direito da tela
- Informe os par?metros de cria??o do item no formul¨¢rio
Configura??o
Atributos do item:
| Par?metro | Descri??o |
|---|---|
| Nome | Nome do item. ? poss¨ªvel utilizar as macros posicionais para se referir a algum par?metro utilizado na chave por ele coletada: $1, $2...$9 - se referindo respectivamente ao primeiro, segundo.... nono par?metro na chave Por exemplo: "Free disk space on $1" Se a chave do item for "vfs.fs.size[/,free]", a descri??o do item ser¨¢ automaticamente atualizada para "Free disk space on /" |
| Tipo | Tipo do item. Veja a sess?o de tipos de item. |
| Chave | Chave do item. A lista de chaves de item poder¨¢ ser de grande valia. A chave precisa ser ¨²nica no host. Se o tipo do item for 'Agente Áú»¢¶Ä²©', 'Agente Áú»¢¶Ä²© (ativo)', 'Verifica??o simples' ou 'Áú»¢¶Ä²© agregado', o vlor da chave precisa ser suportado pelo Áú»¢¶Ä²© Agent ou Áú»¢¶Ä²© Server. Consulte teamb¨¦m: o formato das chaves. |
| Interface do Host | Selecione a interface do host. Este campo est¨¢ dispon¨ªvel somente quando o item ¨¦ editado em n¨ªvel de host. |
| Tipo da informa??o | Como ser¨¢ armazenado o dado no banco de dado ap¨®s convertido, se for necess¨¢ria a convers?o. Num¨¦rico (inteiro) - inteiro de 64bits Num¨¦rico (fracion¨¢rio) - n¨²mero com ponto flutuante (decimais) Valores negativos podem ser armazenados. Range v¨¢lido (para MySQL): de -999999999999.9999 a 999999999999.9999 (double(16,4)). A partir da vers?o 2.2 do Áú»¢¶Ä²© tamb¨¦m ¨¦ suportado o recebimento de valores em nota??es cient¨ªficas. Ex. 1e+70, 1e-70. Caractere - texto curto, limitado a 255 bytes Log - arquivo de log. Ser¨¢ necess¨¢ria a configura??o como log para chaves de 'eventlog' (a n?o ser que voc¨º planeje extrair outro tipo de dado deste item, com o par?metro output).Texto - texto sem limite de tamanho |
| Tipo de dado | Ser¨¢ utilizado o tipo inteiro para para itens com os tipos de dado: L¨®gico ou booleano - a representa??o textual ¨¦ traduzida em 0 ou 1. Onde, 'TRUE' (verdadeiro) ¨¦ armazenado com o valor 1 e 'FALSE' com o valor 0. A convers?o n?o ¨¦ sens¨ªvel ao caso. Ent?o valores como: TRUE - true, t, sim, s, on, up, rodando, habilitado, dispon¨ªvel FALSE - false, f, n?o, n, off, down, n?o utilizado, desabilitado, indispon¨ªvel Adicionalmente, qualquer numero diferente de zero ¨¦ considerado como VERDADEIRO e zero ¨¦ considerado FALSO. Octal - dado em nota??o octal Decimal - dado em formato decimal Hexadecimal - dado em formato hexadecimal O zabbix far¨¢ automaticamente a convers?o para o formato num¨¦rico. A convers?o ser¨¢ feita pelo Áú»¢¶Ä²© Server (mesmo quando o host ¨¦ monitorado atrav¨¦s de um Áú»¢¶Ä²© Proxy). |
| Unidades | Se for informado um s¨ªmbolo para a unidade, o Áú»¢¶Ä²© ir¨¢ processar o valor recebido e ir¨¢ apresenta-lo com o correto sufixo. Por padr?o, se o valor for superior a 1000, ele ser¨¢ dividido por 1000 e apresentado de forma apropriada. Por exemplo, se voc¨º configurar a unidade como sendo bps e receber o valor 881764, o mesmo ser¨¢ exibido como 881.76 Kbps. Ocorre um processamento especial para as unidades B (byte), Bps (bytes por segundo), nestes casos a divis?o ser¨¢ por 1024. Desta forma, se a unidade for definida como B ou Bps o Áú»¢¶Ä²© ir¨¢ apresentar: 1 como 1B/1Bps 1024 como 1KB/1KBps 1536 como 1.5KB/1.5KBps Ocorrer¨¢ processamento especial para as unidades de tempo: unixtime - traduzida para "yyyy.mm.dd hh:mm:ss". Para traduzir corretamente o valor recebido dever¨¢ ser do tipo N¨²mero (inteiro). uptime - traduzido para "hh:mm:ss" ou "N dias, hh:mm:ss" Por exemplo, se voc¨º receber o valor 881764 (segundos), ele ser¨¢ apresentado como "10 dias, 04:56:04" s - traduzido para "yyy mmm ddd hhh mmm sss ms"; o par?metro ¨¦ tratado como uma quantidade de segundos. Por exemplo, se voc¨º receber o valor 881764 (segundos), ele ser¨¢ apresentado como "10d 4h 56m" Apenas as tr¨ºs maiores unidades ser?o apresentadas. Ex. "1m 15d 5h" ou "2h 4m 46s". Se n?o existirem dias a apresentar, somente duas unidades ser?o apresentadas - "1m 5h" (sem informa??o de horas, segundos ou milisegundos). Se o valor for inferior a 0.001 o mesmo ser¨¢ traduzido para "< 1 ms". Veja mais sobre o tema em unidades. |
| Usar multiplicador customizado | Se voc¨º ativar esta op??o, todos os valores recebidos ser?o multiplicados pelo valor informado. Use esta op??o para converter valores recebidos no formato de KB, MBps, etc em B, Bps. De outra forma o Áú»¢¶Ä²© n?o conseguir¨¢ apresentar corretamente os sufixos (K, M, G etc). A partir do Áú»¢¶Ä²© 2.2, o uso de nota??o cient¨ªfica tamb¨¦m passou a ser suportado. |
| Intervalo atualiza??o (em segundos) | Atualiza o dado a cada N segundos. Nota: Se for configurado para '0', a coleta do item n?o ser¨¢ monitorada. Entretanto, se for informado um intervalo personalizado (flex¨ªvel ou agendamento) e este campo estiver com valor diferente de '0' ele ser¨¢ monitorado com intervalo definido, durante a dura??o do intervalo personalizado. |
| Intervalos personalizados | Voc¨º pode criar regras personalizadas para a coleta do item: ¹ó±ô±ð³æ¨ª±¹±ð±ô - cria uma exce??o ao Intervalo de atualiza??o (um intervalo com frequ¨ºncia diferente em um momento espec¨ªfico) Agendamento - cria um agendamento de coleta. Para informa??es detalhadas veja intervalos personalizados. O agendamento ¨¦ suportado desde o Áú»¢¶Ä²© 3.0.0. Nota: esta funcionalidade n?o est¨¢ dispon¨ªvel para itens ativos. |
| Per¨ªodo de reten??o de hist¨®rico (em dias) | Quantidade de dias a manter o hist¨®rico detalhado de coletas no banco de dados. Dados mais antigos do que o aqui definido ser?o removidos pelo processo de 'housekeeper' (limpeza de dados). A partir do Áú»¢¶Ä²© 2.2, este valor pode ser sobrescrito pela configura??o global dispon¨ªvel em Administra??o ¡ú Geral ¡ú Limpeza de dados. Se a configura??o global existir, uma mensagem de alerta ser¨¢ apresentada:  ? recomend¨¢vel manter os dados no banco pelo menor tempo poss¨ªvel para reduzir a quantidade de registros de hist¨®rico. Ao inv¨¦s de guardar o hist¨®rico, prefira guardar as m¨¦dias. Veja tamb¨¦m Hist¨®rico e m¨¦dias. |
| Per¨ªodo de reten??o de m¨¦dias (em dias) | A cada hora as m¨¦dias ir?o guardar de forma agregada o resultado das fun??es 'min, max, avg e count' sobre os dados coletados no per¨ªodo). A partir do Áú»¢¶Ä²© 2.2, este valor pode ser sobrescrito pela configura??o global dispon¨ªvel em Administra??o ¡ú Geral ¡ú Limpeza de dados. Se a configura??o global existir, ser¨¢ apresentada uma mensagem de alerta:  Nota: O armazenamento de m¨¦dias n?o est¨¢ dispon¨ªvel para itens n?o num¨¦rico, como os caracteres, log e texto. Veja tamb¨¦m Hist¨®rico e m¨¦dias. |
| Armazenar valor | Sem alterar - n?o ocorre nenhum pr¨¦-processamento Delta (altera??es por segundo) - ocorre pr¨¦-processamento atrav¨¦s da f¨®rmula: (value-prev_value)/(time-prev_time), onde value - valor atua value_prev - valor anterior time - momento atual prev_time - momento da coleta do valor anterior Esta configura??o ¨¦ muito ¨²til para velocidade por segundo em uma sequ¨ºncia de valores. Nota: Se o valor atual for menor do que o anterior, o Áú»¢¶Ä²© ir¨¢ descartar a diferen?a (n?o salva nada) e ir¨¢ aguardar outro valor. Este ajuda a funcionar corretamente com, por exemplo, um estouro de um contador SNMP de 32 bits. Delta (altera??es simples) - ocorre pr¨¦-processamento atrav¨¦s da f¨®rmula (value-prev_value), onde value - valor atual value_prev - valor anterior |
| Mostrar valor | Aplica um mapeamento de valores ao item. O mapeamento de valores n?o modifica o dado recebido, ocorre apenas um processamento no momento de apresentar a informa??o. Este recurso funciona apenas com n¨²meros inteiros. Por exemplo, "Estado de servi?os do windows". |
| Formato de hora em Log | Dispon¨ªvel para itens do tipo Log apenas. Marcadores suportados: * y: Ano (0001-9999) * M: M¨ºs (01-12) * d: Dia (01-31) * h: Hora (00-23) * m: Minuto (00-59) * s: Segundo (00-59) Se estiver em branco n?o ser¨¢ processado. Por exemplo, considere a seguinte linha de um log do Áú»¢¶Ä²© Agent: " 23480:20100328:154718.045 Áú»¢¶Ä²© agent started. Áú»¢¶Ä²© 1.8.2 (revision 11211)." Ela come?a com seis caracteres relativos ao PID, seguido pela data, hora e o resto da linha. O formato de hora do log poderia ser "pppppp:yyyyMMdd:hhmmss". Note que os caracteres "p" e ":" s?o espa?os diferentes de "yMdhms". |
| Nova aplica??o | Informe o nome de uma nova aplica??o para o item. |
| Aplica??es | Associe o item a um ou mais aplica??es j¨¢ existentes. |
| Popular o campo do ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç | Voc¨º pode selecionar um campo do ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç que ser¨¢ preenchido automaticamente a medida que chegarem novos valores para este item. Observe que para ele funcionar o modo de ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç no host dever¨¢ estar como ´¡³Ü³Ù´Ç³¾¨¢³Ù¾±³¦´Ç. O manual do recurso de ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç apresenta mais detalhes. |
| Descri??o | Informe uma descri??o para o item. |
| Ativo | Selecione o checkbox para habilita-lo para ser processado. |
Voc¨º tamb¨¦m pode criar um item ao clicar para editar um outro item e pressionar o bot?o Clonar, alterar os par?metros e salvar com uma chave diferente.
Quando se tenta editar no n¨ªvel do host um item que ¨¦ da associa??o com um template, v¨¢rios campos estar?o habilitados apenas para leitura. No alto do formul¨¢rio de edi??o do item tem um link para acesso r¨¢pido ao item no n¨ªvel de template, onde voc¨º poder¨¢ modificar todos os campos.
Exce??es a convers?o de unidade
Por padr?o, ao especificar uma unidade em um item o resultado ser¨¢ que um multiplicador ser¨¢ adicionado junto com o sufixo, por exemplo, o valor 2048 com a unidade B ser¨¢ apresentado como 2KB. Para um conjunto pr¨¦-definido e travado diretamente no c¨®digo esta convers?o n?o ser¨¢ feita:
- ms
- RPM
- rpm
- %
Itens n?o suportados
Um item passar ao estado "n?o suportado" caso n?o consiga receber o dado no hor¨¢rio previsto por algum motivo. A tentativa de coleta de dado destes itens ser¨¢ refeita em um intervalo fixo, configur¨¢vel na sess?o de administra??o.