17 Valor do item

Visão geral

Este widget é útil para exibir o valor de um único item de forma destacada. Pode ser o valor mais recente, bem como um valor agregado para algum período no passado.

Além do valor em si, elementos adicionais podem ser exibidos, se desejado:

  • Hora da métrica
  • Descrição do item
  • Indicador de alteração para o valor
  • Cor de fundo para o valor
  • Unidade do item

O widget pode exibir valores numéricos e de string. A exibição de valores binários não é suportada. Valores de string são exibidos em uma única linha e truncados, se necessário. "Sem dados" é exibido se não houver valor para o item.

O indicador de alteração sempre compara com o mesmo período no passado. Assim, por exemplo, o valor mais recente será comparado com o valor anterior, enquanto o último mês será comparado com o mês anterior. Observe que o período anterior para agregações é calculado como um período de tempo do mesmo comprimento que o original, com o horário de término diretamente antes do horário de início do período original.

Clicar no valor leva a um gráfico ad-hoc para itens numéricos ou aos dados mais recentes para itens de string.

O widget e todos os elementos nele podem ser ajustados visualmente usando as opções de configuração avançada, permitindo criar uma grande variedade de estilos visuais:

Configuração

Para configurar, selecione Valor do item como o tipo de widget:

Além dos parâmetros que são comuns a todos os widgets, você pode definir as seguintes opções específicas:
Item Selecione o item.
Como alternativa, selecione um widget compatível como fonte de dados para o item.
Mostrar Marque a caixa de seleção para exibir o respectivo elemento (descrição, valor, hora, indicador de alteração). Desmarque para ocultar. Pelo menos um elemento deve ser selecionado.
Substituir host Selecione um widget compatível ou o dashboard como fonte de dados para hosts.
Este parâmetro não está disponível ao configurar o widget em um dashboard de template.
Configuração avançada Clique no rótulo Configuração avançada para exibir as opções de configuração avançada.

Configuração avançada

As opções de configuração avançada estão disponíveis na seção recolhível Configuração avançada, e somente para os elementos selecionados no campo Mostrar (veja acima).

Além disso, a configuração avançada permite alterar a cor de fundo (estática ou dinâmica) de todo o widget.
Descrição
Descrição Insira a descrição do item. Esta descrição pode substituir o nome padrão do item. Descrições em várias linhas são suportadas. É possível usar uma combinação de texto e macros suportadas.
{HOST.*}, {ITEM.*}, {INVENTORY.*} e macros de usuário são suportadas.
Posição horizontal Selecione a posição horizontal da descrição do item - esquerda, direita ou centro.
Posição vertical Selecione a posição vertical da descrição do item - superior, inferior ou meio.
Tamanho Insira a altura do tamanho da fonte para a descrição do item (em porcentagem em relação à altura total do widget).
Negrito Marque a caixa de seleção para exibir a descrição do item em negrito.
Cor Selecione a cor da descrição do item no seletor de cores.
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
Valor
Casas decimais Selecione quantas casas decimais serão exibidas com o valor. Este valor afetará apenas itens do tipo float. Para itens com unidades definidas como "s", se este valor for maior que 0 (o padrão é 2), o widget arredondará a unidade de tempo mais significativa e exibirá um valor numérico (por exemplo, "10.43m") em vez de converter o valor em uma string de tempo completa. Quando definido como 0, os segundos são convertidos em uma string de tempo legível por humanos (por exemplo, "4h 56m 30s").
Tamanho Insira a altura do tamanho da fonte para as casas decimais (em porcentagem em relação à altura total do widget).
Posição horizontal Selecione a posição horizontal do valor do item - esquerda, direita ou centro.
Posição vertical Selecione a posição vertical do valor do item - superior, inferior ou meio.
Tamanho Insira a altura do tamanho da fonte para o valor do item (em porcentagem em relação à altura total do widget).
Observe que o tamanho do valor do item tem prioridade; os outros elementos precisam ceder espaço para o valor. No entanto, com o indicador de alteração, se o valor for muito grande, ele será truncado para exibir o indicador de alteração.
Negrito Marque a caixa de seleção para exibir o valor do item em negrito.
Cor Selecione a cor do valor do item no seletor de cores.
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
Unidades
Unidades Marque a caixa de seleção para exibir as unidades com o valor do item. Se você inserir um nome de unidade, ele substituirá a unidade da configuração do item.
Posição Selecione a posição da unidade do item - acima, abaixo, antes ou depois do valor.
Tamanho Insira a altura do tamanho da fonte para a unidade do item (em porcentagem em relação à altura total do widget).
Negrito Marque a caixa de seleção para exibir a unidade do item em negrito.
Cor Selecione a cor da unidade do item no seletor de cores.
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
Hora (valor de relógio do histórico do item)
Posição horizontal Selecione a posição horizontal da hora - esquerda, direita ou centro.
Posição vertical Selecione a posição vertical da hora - superior, inferior ou meio.
Tamanho Insira a altura do tamanho da fonte para a hora (em porcentagem em relação à altura total do widget).
Negrito Marque a caixa de seleção para exibir a hora em negrito.
Cor Selecione a cor da hora no seletor de cores.
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
Indicador de alteração Selecione a cor dos indicadores de alteração no seletor de cores. Os indicadores de alteração são os seguintes:
↑ - o valor do item aumentou (para itens numéricos)
↓ - o valor do item diminuiu (para itens numéricos)
↕ - o valor do item foi alterado (para itens de string e itens com mapeamento de valor)
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
O tamanho vertical do indicador de alteração é igual ao tamanho do valor (parte inteira do valor para itens numéricos).
Observe que os indicadores de aumento e diminuição não são exibidos com apenas um valor.
Cor de fundo Selecione a cor de fundo de todo o widget no seletor de cores.
D representa a cor padrão (depende do tema do frontend). Para retornar ao valor padrão, clique no botão Usar padrão no seletor de cores.
Limiares Configure a cor de fundo dinâmica para todo o widget. Clique em Adicionar para adicionar um limiar, selecione a cor de fundo no seletor de cores e especifique um valor numérico. Quando o valor do item for igual ou maior que o valor do limiar, a cor de fundo mudará.
A lista será classificada em ordem crescente ao salvar.
Observe que a cor de fundo dinâmica será exibida corretamente apenas para itens numéricos.
Função de agregação Especifique qual função de agregação usar dentro do Período selecionado:
min - exibir o menor valor;
max - exibir o maior valor;
avg - exibir o valor médio;
count - exibir a contagem de valores;
sum - exibir a soma dos valores;
first - exibir o primeiro valor;
last - exibir o último valor.
Se not used for selecionado, o valor mais recente será exibido (sem agregação).

A agregação permite exibir um valor agregado para o intervalo escolhido (5 minutos, uma hora, um dia), em vez do valor mais recente.
Somente dados numéricos podem ser exibidos para min, max, avg e sum. Para count, dados não numéricos serão convertidos em numéricos.
Período Especifique o período a ser usado para agregar valores:
Dashboard - usar o período do dashboard;
Widget - usar o período do widget especificado;
Custom - usar um período personalizado.
Este parâmetro fica oculto quando Função de agregação está definida como "not used".
Widget Selecione o widget.
Este parâmetro será exibido somente se Período estiver definido como "Widget".
De Selecione o início do período (valor padrão now-1h). Consulte sintaxe de tempo relativo.
Este parâmetro será exibido somente se Período estiver definido como "Custom".
Até Selecione o fim do período (valor padrão now). Consulte sintaxe de tempo relativo.
Este parâmetro será exibido somente se Período estiver definido como "Custom".
Dados do histórico Obtenha dados do histórico ou de tendências:
Auto - seleção automática;
History - obter dados do histórico;
Trends - obter dados de tendências.

Esta configuração se aplica apenas a dados numéricos. Dados não numéricos sempre serão obtidos do histórico.

Observe que vários elementos não podem ocupar o mesmo espaço; se forem colocados no mesmo espaço, uma mensagem de erro será exibida.