Áú»¢¶Ä²©

1 Criando um item

Vis?o geral

Para criar um item no frontend do Áú»¢¶Ä²©, fa?a o seguinte:

• ¡¤ V¨¢ para: Configura??o ¡ú Hosts
• ¡¤ Clique em Items na linha do host
• ¡¤ Clique em Create item no canto superior direito da tela
• ¡¤ Insira os par?metros do item no formul¨¢rio

Voc¨º tamb¨¦m pode criar um item abrindo um existente, pressionando o bot?o Clone e, em seguida, salvando com um nome diferente.

Configura??o

A aba Item cont¨¦m atributos gen¨¦ricos do item.

Todo os campos de entrada mandat¨®rios s?o demarcados com um asterico vermelho.

Par?metro	Descri??o
Nome	Nome do item.
Tipo	Tipo do item. Veja sess?es individuais de item type.
Chave	Chave to item (at¨¦ 2048 caracteres). As item keys suportadas podem ser encontradas em se??es de tipo de item individual. A chave deve ser ¨²nica em um host. Se a chave for do tipo 'Áú»¢¶Ä²© agent', 'Áú»¢¶Ä²© agent (active)' ou 'Simple check', o valor da chave deve ser suportado pelo Áú»¢¶Ä²© agent ou Áú»¢¶Ä²© server. Veja tamb¨¦m: o key format correto.
Tipo da informa??o	Tipo do dadoarmazenado em uma base de dados ap¨®s a realiza??o de convers?es, se houver. Num¨¦rico (sem sinal) - inteiro sem sinal de 64 bits Num¨¦rico (ponto flutuante) - n¨²mero de ponto flutuante de 64 bits Este tipo permitir¨¢ a precis?o de aproxidamente 15 d¨ªgitos em uma faixa de aproximadamente -1.79E+308 to 1.79E+308 (com a exce??o do PostgreSQL 11 and earlier versions). Receber valores em nota??o cient¨ªfica tamb¨¦m ¨¦ suportado. Ex.: 1.23E+7, 1e308, 1.1E-4. Caracter - dados de texto curto Log - dados de texto longo com propriedades relacionadas ao log opcionais (timestamp, source, severidade, logeventid) Texto - dados de texto longo.Veja tamb¨¦m text data limits. Para chaves de itens que retornam dados em apenas um formato espec¨ªficou, o tipo da informa??o ¨¦ selecionada de forma autom¨¢tica.
Intreface do host	Selecione a interface do host. Este campo est¨¢ dispon¨ªvel quando estiver editiando um item no host.
Unidades	Se o s¨ªmbolo da unidade for definido, o Áú»¢¶Ä²© o adicionar ap¨®s o processamento do valor recebido e o exibir¨¢ com o prefixo de unidade definido. Por padr?o, se o valor original exceder 1000, ele ser¨¢ dividido por 1000 e exibido de acordo. Por exemplo, se voc¨º configurar bps e receber o valor 881764, ele ser¨¢ exibido como 881.76 Kbps. O padr?o de mem¨®ria ¨¦ utilizado para o processar as unidades B (byte), Bps (bytes por segundo), as quais s?o divididas por 1024. Deste modo, se a unidade for configurada como B ou Bps o Áú»¢¶Ä²© exibir¨¢: 1 como 1B/1Bps 1024 como 1KB/1KBps 1536 como 1.5KB/1.5KBps O processamento especial ¨¦ utilizado se as seguintes unidas relacionadas a tempo forem utilizadas: unixtime - traduzido para "aaaa.mm.dd hh:mm:ss". Para traduzir corretamente, o valor recebido deve ser do tipo num¨¦rico (sem sinal). uptime - traduzido para "hh:mm:ss" or "N dias, hh:mm:ss" Por exemplo, se voc¨º receber um valor como 881764 (segundos), ele ser¨¢ exibido como "10 dias, 04:56:04" s - traduzido para "aaa mmm ddd hhh mmm sss ms"; o par¨ºmtro ¨¦ tratado como o n¨²mero de segundos. Por exemplo, se voc¨º receber um valor como 881764 (seconds), ele ser¨¢ exibido como "10d 4h 56m" Apenas 3 unidades principais s?o mostradas, como por exemplo "1m 15d 5h" ou "2h 4m 46s". Caso n?o tenha dias para serem exibidos, apenas dois n¨ªveis ser?o exibidos - "1m 5h" (minutos, segundos ou milisegundos n?o s?o exibidos). Ser¨¢ traduzido para "< 1 ms" se o valor for inferior a 0.001. Observa??o se o prefixo da unidade for configurado com !, ent?o o prefixo da unidade e/ou o processamento n?o ser?o aplicados aos valores do item. Veja unit conversion.
Intervalo de atualiza??o	Coleta um novo valor para este item a cada N segundos. O intervalo m¨¢ximo de atualiza??o permitido ¨¦ de 86.400 segundos (1 dia). Time suffixes s?o suportados, ex.: 30s, 1m, 2h, 1d. User macros s?o suportadas. Uma ¨²nica macro deve preencher todo o campo. N?o h¨¢ suporte para v¨¢rias macros em um campo ou macros misturadas com texto. Observa??o: o intervalo de atualiza??o pode ser configurado para '0' se os intervalos customizados existirem com um valor diferente de zero. Se for configurado para '0' e o intervalo customizado (flex¨ªvel ou agendado) existir com um valor diferente de zero, o item ser¨¢ coletado durante a dura??o do intervalo customizado. Observa??o: a primeira pesquisa de item ap¨®s o item se tornar ativo ou ap¨®s a altera??o do intervalo de atualiza??o pode ocorrer antes do valor configurado. Um item passivo existente pode ser coletado para valores imediatamente pressionando o Execute now button.
Intervalos customizados	Voc¨º pode criar regras customizadas para a checagem de itens: ¹ó±ô±ð³æ¨ª±¹±ð±ô - cria uma exce??o para o intervalo de atualiza??o (intervalo com frequ¨ºncia distintai) Agendada - cria um esquema de coleta customizado. Para informa??es maisdetalhadas veja Custom intervals. Time suffixes s?o suportados no campo Intervalo, ex.: 30s, 1m, 2h, 1d. User macros s?o suportados. Uma ¨²nica macro deve preencher todo o campo. N?o h¨¢ suporte para v¨¢rias macros em um campo ou macros misturadas com texto. O agendamento ¨¦ suportado desde a o Áú»¢¶Ä²© 3.0.0. Observa??o: n?o dispon¨ªvel para itens do tipo agente Áú»¢¶Ä²© ativo.
Per¨ªodo de armazenamento de hist¨®rico	Selecione: N?o manter hist¨®rico - o hist¨®rico do item n?o ser¨¢ armazenado. ?til para itens do tipo mestre se apenas os itens dependentes devem manter o hist¨®rico. Esta configura??o n?o pode ser sobreescrita pelo por settings globais do housekeeper. Per¨ªodo de armazenamentoS - especifica a dura??o de manter hist¨®rico detalhado na base de dados (1 hora a 25 anos). Dados mais antigos ser?o removidos pelo housekeeper. Armazenado em segundos. Time suffixes s?o suportados, ex.: 2h, 1d. User macros s?o suportadas. O valor do Per¨ªodo de armazenamento pode ser sobreescrito globalmente em Administra??o ¡ú Geral ¡ú Housekeeper. Se existir uma configura??o de sobreescrita global,um ¨ªcone verde ser¨¢ exibido . Se voc¨º posicionar o seu cursor sob o ¨ªcone, uma mensagem ser¨¢ exebida, ex.: Sobrescrito por configura??es globais de limpeza de dados (1d). ? recomendado manter os dados coletados pelo menor tempo poss¨ªvel para reduzir o tamanho dos dados hist¨®ricos na base de dados. Em vez de manter um longo hist¨®rico de valores, voc¨º pode manter dados mais longos de estat¨ªsticas. Veja tamb¨¦m History and trends.
Per¨ªodo de armazenamento de estat¨ªsticas	Selecione: N?o manter dados estat¨ªsticos - as estat¨ªsticas n?o ser?o armazenadas. Esta configura??o n?o poder¨¢ ser sobreescrita pela settings global do housekeeper. Per¨ªodo de armazenamento - especifica a dura??o para manter dados hist¨®ricos agregados (hourly min, max, avg, count) na base de dados (1 dia a 25 anos). Dados antigos ser?o removidos pelo housekeeper. Armazenado em segundos. Time suffixes s?o suportados, ex.: 24h, 1d. User macros s?o suportados. O valor do Per¨ªodo de armazenamento pode ser sobreescrito globalmente em Administra??o ¡ú Geral ¡ú Housekeeper. Se existir uma configura??o de sobreescrita global,um ¨ªcone verde ser¨¢ exibido . Se voc¨º posicionar o seu cursor sob o ¨ªcone, uma mensagem ser¨¢ exebida, ex.: Sobrescrito por configura??es globais de limpeza de dados (7d). Observa??o: Manter estat¨ªsticas de dados n?o num¨¦ricos - caracter, log e texto - n?o est¨¢ dispon¨ªvel. Veja tamb¨¦m History and trends.
Mapeamento de valores	Aplica mapeamento de valores para o item. Value mapping n?o altera os valores recebidos, ¨¦ apenas para a exibi??o de dados. Funciona com itens dos tipo Num¨¦rico(sem sinal), Num¨¦rico(ponto flutuante) e Caracter. Por exemplo, "Windows service states".
Formato do log de tempo	Dispon¨ªvel somente para itens do tipo Log. Placeholders suportados: * y: Ano (1970-2038) * M: M¨ºs (01-12) * d: Dia (01-31) * h: Hora (00-23) * m: Minuto (00-59) * s: Segundo (00-59) Se deixado em branco n?o haver¨¢ o processamento do timestamp. Por exemplo, considere a seguinte linha do arquivo de log do agente Áú»¢¶Ä²©: " 23480:20100328:154718.045 Áú»¢¶Ä²© agent started. Áú»¢¶Ä²© 1.8.2 (revision 11211)." Ela come?a com seis posi??es de caracteres para PID, seguidas por data, hora e o restante da linha. O formato de hora de log para esta linha seria "pppppp:aaaaMMdd:hhmmss". Observe que " p" e ":" s?o apenas placeholders e podem ser qualquer coisa menos "yMdhms".
Popular campos de invet¨¢rio do host	Voc¨º pode selecionar o campo de invent¨¢rio do host que aquele valor deve popular. Isso funcionar¨¢ se o preenchimento autom¨¢tico do inventory estiver configurado para o host. Este campo n?o est¨¢ dispon¨ªvel se o Tipo da informa??o for configurada para 'Log'.
Descri??o	Forne?a uma descri??o do item.
Habilitado	Marque a caixa de sele??o para habilitar o item para que seja processado.
Dados recentes	Clique no link para ver os dados mais recentes do item. Este link s¨® est¨¢ dispon¨ªvel ao editar um item j¨¢ existente.

A aba de Tags permite a defini??o de tags de itens.

±Ê°ù¨¦-±è°ù´Ç³¦±ð²õ²õ²¹³¾±ð²Ô³Ù´Ç do valor do item

A aba ±Ê°ù¨¦-±è°ù´Ç³¦±ð²õ²õ²¹³¾±ð²Ô³Ù´Ç permite definir transformation rules para os valores recebidos.

Testando

? poss¨ªvel testar um item e, se configurado corretamente, obter um valor de retorno verdadeiro. O teste pode ocorrer antes mesmo do item ser salvo.

O teste ¨¦ dispon¨ªvel para itens em hosts e templates, prot¨®tipos de itens e regras de descoberta. O teste n?o est¨¢ dispon¨ªvel para itens do tipo ativo.

O teste de itens est¨¢ dispon¨ªvel para os seguintes itens do tipo passivo:

• Agent Áú»¢¶Ä²©
• Agente SNMP (v1, v2, v3)
• Agente IPMI
• Checagem via SSH
• Checagem via Telnet
• Agente JMX
• Checagem simples (exceto itens icmpping*, vmware.*)
• Checagem interna do Áú»¢¶Ä²©
• Itens calculados
• Checagem external
• Monitor de base da dados
• Agente HTTP
• Script

Para testar um item, clique no bot?o Teste na configura??o do item. Note que o bot?o Teste estar¨¢ desabilitado se n?o for poss¨ªvel testar o item (tais como checagens ativas, desconsiderando checagens simples).

O formul¨¢rio para testar o item possui campos os par?metros de host necess¨¢rios (endere?o do host, porta, nome do proxy ou sem proxy) e detalhes espec¨ªficos do item (tais como a comunidade do SNMPv2 ou as credenciais de seguran?a para o SNMPv3). Esses campos s?o cientes do contexto:

• Os valores s?o pr¨¦-preenchidos quando poss¨ªvel, ou seja, para itens que requerem agente, pegando as informa??es da interface do agente selecionado do host
• Os valores devem ser preenchidos manualmente para itens de modelo
• Os valores de macro de texto simples s?o resolvidos
• Campos onde o valor (ou parte do valor) ¨¦ um segredo ou Vault macro est?o vazias e devem ser inseridas manualmente. Se algum item par?metro cont¨¦m um valor de macro secreta, o seguinte aviso mensagem ¨¦ exibida: "O item cont¨¦m macros definidas pelo usu¨¢rio com segredo valores. Os valores dessas macros devem ser inseridos manualmente."
• Os campos s?o desabilitados quando n?o s?o necess¨¢rios no contexto do item tipo (por exemplo, o campo de endere?o do host e o campo de proxy est?o desabilitados para itens calculados)

Para tester um item, clique em Obter valor. Se o valor for recebido com sucesso, o campo Valor ser¨¢ preenchido, movendo o valor atual (caso exista) para o campo Valor anterior enquanto calcula o campo Tempo anterior, ex.: a diferen?a de tempo entre os dois valores e tentando detectar uma sequ¨ºncia de final de arquivo e trocar para CRLF se detectar "\n\r" no valor recebido.

Se a configura??o estiver incorreta, uma mensagem de erro ¨¦ exibida descrevendo a poss¨ªvel causa.

A coleta bem sucedida do valor de um host pode ser utilizada para testar os preprocessing steps.

Bot?es de formul¨¢rio

Os bot?es na parte inferior do formul¨¢rio permitem a realiza??o de diversas opera??es.

	Adicione um item. Este bot?o est¨¢ dispon¨ªvel apenas para novos itens.
	Atualiza as propriedades de um item.
	Cria um outro item baseado nas propriedades do item atual.
	Executa uma checagem imediata para um novo valor do item. Suportado somente em checagens passivas (veja more details). Observa??o o verificar um valor imediatamente, o cache de configura??o n?o ¨¦ atualizado, portanto, o valor n?o refletir¨¢ altera??es muito recentes na configura??o do item.
	Teste se a configura??o do item est¨¢ correta obtendo um valor
	Deleta o hist¨®rico e estat¨ªsticas de um item.
	Deleta o item.
	Cancela a edi??o das propriedades do item.

Convers?o de unidade

Por padr?o, especificar uma unidade para um item resulta em um prefixo multiplicador sendo adicionado - por exemplo, um valor de entrada '2048' com unidade 'B' ser exibido como '2 KB'.

Para evitar a convers?o de uma unidade, use o prefixo !, por exemplo, !B. Para entender melhor como funciona a convers?o com e sem o ponto de exclama??o, veja os seguintes exemplos de valores e unidades:

1024 !B ¡ú 1024 B
       1024 B ¡ú 1 KB
       61 !s ¡ú 61 s
       61 s ¡ú 1m 1s
       0 !uptime ¡ú 0 uptime
       0 uptime ¡ú 00:00:00
       0 !! ¡ú 0 !
       0 ! ¡ú 0

Limite de dados de texto

O limite de dados de texto depend na base de dados utilizada no backend. Antes de armazenar o texto valores no banco de dados eles s?o truncados para corresponder ao valor do banco de dados limite de tipo:

Limite de script personalizado

O comprimento do script personalizado dispon¨ªvel depende do banco de dados usado:

Itens n?o suportados

Um item pode se tornar n?o suportado se n?o for poss¨ªvel coletar o seu valor por algum motivo. Esses itens ainda s?o verificados novamente em seu Update interval padr?o.

Itens n?o suportados s?o reportados como tendo um estado N?O SUPORTADO.