Documentation
Table of Contents
18 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
- Gráfico de linha para valores do período de tempo especificado
O widget pode exibir valores numéricos e de texto. A exibição de valores binários não é suportada. Valores de texto 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 texto.
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 para 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 os itens. |
| Mostrar | Marque a caixa de seleção para exibir o respectivo elemento: descrição, valor, hora, indicador de alteração, sparkline. 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 apenas para os elementos que estão selecionados no campo Mostrar (veja acima).
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.
Parâmetros genéricos do widget
Esses parâmetros determinam a cor de fundo (estática ou dinâmica) para todo o widget e uma função de agregação para exibir valores.
| Cor de fundo | Selecione a cor de fundo para todo o widget no seletor de cores.D significa 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. Assim que 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 ser salva. Observe que a cor de fundo dinâmica será exibida corretamente apenas para items numéricos. |
| Função de agregação | Especifique qual função de agregação usar: min - exibe o menor valor; max - exibe o maior valor; avg - exibe o valor médio; count - exibe a contagem de valores; sum - exibe a soma dos valores; first - exibe o primeiro valor; last - exibe o último valor; não usado - exibe o valor mais recente (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. Apenas 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 de tempo | Especifique o período de tempo a ser usado para agregar valores: Dashboard - usa o período de tempo do dashboard; Widget - usa o período de tempo do widget especificado; Personalizado - usa um período de tempo personalizado. Este parâmetro não será exibido se a Função de agregação estiver definida como "não usado". |
| Widget | Selecione o widget. Este parâmetro só será exibido se o Período de tempo estiver definido como "Widget". |
| De | Selecione o período de tempo inicial (valor padrão now-1h). Veja sintaxe de tempo relativo.Este parâmetro só será exibido se o Período de tempo estiver definido como "Personalizado". |
| Até | Selecione o período de tempo final (valor padrão now). Veja sintaxe de tempo relativo.Este parâmetro só será exibido se o Período de tempo estiver definido como "Personalizado". |
| Dados do histórico | Obtenha dados do histórico ou das tendências: Auto - seleção automática; Histórico - obtém dados do histórico; Tendências - obtém dados das tendências. Essa configuração se aplica apenas a dados numéricos. Dados não numéricos sempre serão obtidos do histórico. |
Descrição
Esses parâmetros determinam como a descrição do item deve ser exibida.
| Descrição | Insira a descrição do item. Esta descrição pode substituir o nome padrão do item. Descrições multilinha são suportadas. Uma combinação de texto e macros suportadas é possível. {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 centralizada. |
| Posição vertical | Selecione a posição vertical da descrição do item - superior, inferior ou centralizada. |
| Tamanho | Insira a altura do tamanho da fonte para a descrição do item (em porcentagem relativa à 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 significa 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
Esses parâmetros determinam como o valor do item deve ser exibido.
| Casas decimais | Selecione quantas casas decimais serão exibidas com o valor. Esse valor afetará apenas itens do tipo float. Para itens com unidades definidas como "s", se esse valor for maior que 0 (o padrão é 2), o widget arredonda a unidade de tempo mais significativa e exibe 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 para uma string de tempo legível (por exemplo, "4h 56m 30s"). |
| Tamanho | Informe o tamanho da fonte para as casas decimais (em porcentagem relativa à 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 - topo, inferior ou meio. |
| Tamanho | Informe o tamanho da fonte para o valor do item (em porcentagem relativa à altura total do widget). Observe que o tamanho do valor do item tem prioridade; outros elementos precisam ceder espaço para o valor. Com o indicador de alteração, se o valor for muito grande, ele será truncado para mostrar 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 significa 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 | Informe o tamanho da fonte para a unidade do item (em porcentagem relativa à 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 significa 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
Esses parâmetros determinam como a hora (valor do relógio do histórico do item) deve ser exibida.
| Posição horizontal | Selecione a posição horizontal da hora - esquerda, direita ou centralizada. |
| Posição vertical | Selecione a posição vertical da hora - superior, inferior ou centralizada. |
| Tamanho | Insira a altura do tamanho da fonte para a hora (em porcentagem relativa à 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 significa 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
Esta seção permite selecionar 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 texto e itens com mapeamento de valor)
D significa 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.
Sparkline
Esses parâmetros determinam como o gráfico sparkline deve ser exibido.
| Largura | Defina a espessura da linha do gráfico usando o controle deslizante ou inserindo manualmente um valor no intervalo de 0 a 10. |
| Cor | Selecione a cor da linha e do preenchimento. |
| Preenchimento | Defina o nível de transparência da cor de preenchimento usando o controle deslizante ou inserindo manualmente um valor no intervalo de 0 a 10. |
| Período de tempo | Especifique o período de tempo para os valores a serem incluídos no gráfico sparkline: Dashboard - usar o período de tempo do dashboard; Widget - usar o período de tempo do widget especificado; Personalizado - usar um período de tempo personalizado. |
| Widget | Selecione o widget. Este parâmetro só será exibido se o Período de tempo estiver definido como "Widget". |
| De | Selecione o período de tempo inicial (valor padrão now-1h). Veja sintaxe de tempo relativo.Este parâmetro só será exibido se o Período de tempo estiver definido como "Personalizado". |
| Até | Selecione o período de tempo final (valor padrão now). Veja sintaxe de tempo relativo.Este parâmetro só será exibido se o Período de tempo estiver definido como "Personalizado". |
| Dados de histórico | Obtenha dados do histórico ou de tendências: Auto - seleção automática; Histórico - obter dados do histórico; Tendências - obter dados de tendências. |