Table of Contents
12 Valor do item
Descrição
Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo de widget de painel permitem configurar o widget Item value nos métodos dashboard.create e dashboard.update .
As propriedades do campo Widget fields não são validadas durante a criação ou atualização de um dashboard. Isso permite que os usuários configurem widgets integradosbuilt-in widgets e criem widgets personalizados custom widgets, mas também introduz o risco de criar ou atualizar widgets de forma incorreta. Para garantir a criação ou atualização bem-sucedida do widget Valor do item, consulte os requisitos dos parâmetros descritos nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Valor do Item.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Intervalo de Atualização | 0 | rf_rate | 0 - Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - (padrão) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
| Item (obrigatório) |
4 | itemid | Item ID. |
| Show | 0 | Show | 1 - Descrição; 2 - Valor; 3 - Tempo; 4 - Indicador de mudança. Padrão: 1, 2, 3, 4 (todos habilitados). Note: Para configurar múltiplos valores, crie um objeto de campo de widget de painel para cada valor. |
| Item Dinâmico | 0 | dynamic | 0 - (padrão) Desativado; 1 - Habilitado. |
| Configuração avançada | 0 | adv_conf | 0 - (padrão) Desativado; 1 - Habilitado. |
Configuração avançada
Os seguintes parâmetros são suportados se a Configuração avançada estiver definida como "Habilitada".
| Parâmetro | type | nome | valor | |
|---|---|---|---|---|
| Cor de fundo | 1 | bg_color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: "" (vazio). |
|
Descrição
Os seguintes parâmetros são suportados se a Configuração Avançada estiver definida como "Habilitada", e Mostrar estiver definido como "Description".
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Description | 1 | description | Qualquer valor de string, incluindo macros. Macros suportados: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Macros de usuário. Padrão: {ITEM.NAME}. |
| Posição Horizontal | 0 | desc_h_pos | 0 - Esquerda; 1 - (padrão Center; 2 - Direita. Dois ou mais elementos (Description, Valor, Tempo) não podem compartilhar a mesma Posição Horizontal e Posição Vertical. |
| *Posição Vertical | 0 | desc_v_pos | 0 - Superior; 1 - Meio; 2 - (Padrão) Inferior. Dois ou mais elementos (Description, Valor, Tempo) não podem compartilhar a mesma Posição Horizontal e Posição Vertical. |
| Tamanho | 0 | desc_size | Valores válidos variam de 1-100. Padrão: 15. |
| Negrito | 0 | desc_bold | 0 - (padrão) Desativado; 1 - Habilitado. |
| Cor | 1 | desc_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
Valor
Os seguintes parâmetros são suportados se a Configuração Avançada estiver definida como "Habilitada", e Mostrar estiver definido como "Valor".
| Parâmetro | type | nome | valor | |
|---|---|---|---|---|
| Casas Decimais | ||||
| Casas Decimais | 0 | decimal_places | Valores válidos variam de 1-10. Padrão: 2. |
|
| Tamanho | 0 | decimal_size | Valores válidos variam de 1-100. Padrão: 35. |
|
| Posição | ||||
| Posição Horizontal | 0 | value_h_pos | 0 - Esquerda; 1 - (padrão) Centro; 2 - Direita. Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma Posição horizontal e Posição vertical. |
|
| Posição Vertical | 0 | value_v_pos | 0 - Superior; 1 - (padrão) Meio; 2 - Inferior. Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma Posição horizontal e Posição vertical. |
|
| Tamanho | 0 | value_size | Valores válidos variam de 1-100. Padrão: 45. |
|
| Negrito | 0 | value_bold | 0 - Desativado; 1 - (padrão) Habilitado. |
|
| Cor | 1 | value_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
|
| Unidades | ||||
| Unidades (checkbox) | 0 | units_show | 0 - Desativado; 1 - (padrão) Habilitado. |
|
| Unidades (valor) | 1 | units | Qualquer valor de string. | |
| Posição | 0 | units_pos | 0 - Antes do valor; 1 - Acima do valor; 2 - (padrão) Após o valor; 3 - Abaixo do valor. |
|
| Tamanho | 0 | units_size | Valores válidos variam de 1-100. Padrão: 35. |
|
| Negrito | 0 | units_bold | 0 - Desativado; 1 - (padrão) Habilitado. |
|
| Cor | 1 | units_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
|
Tempo
Os seguintes parâmetros são suportados se a Configuração avançada estiver definida como "Ativada" e Mostrar estiver definido como "Tempo".
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Posição Horizontal | 0 | time_h_pos | 0 - Esquerda; 1 - (padrão) Centro; 2 - Direita. Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma Posição horizontal e Posição vertical. |
| Posição Vertical | 0 | time_v_pos | 0 - (padrão) Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma Posição horizontal e Posição vertical |
| Tamanho | 0 | time_size | Valores válidos variam de 1-100. Padrão: 15. |
| Negrito | 0 | time_bold | 0 - (padrão) Desativado; 1 - Habilitado. |
| Cor | 1 | time_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
Indicador de mudança
Os seguintes parâmetros são suportados se a Configuração avançada estiver definida como "Ativada" e Mostrar estiver definido como "Indicador de Mudança".
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Cor da seta de aumento ↑ | 1 | up_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
| Cor da seta de redução ↓ | 1 | down_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (vazio). |
| Change indicator ↕ color | 1 | updown_color | Código de cor hexadecimal (Por exemplo, FF0000).Padrão: "" (empty). |
Exemplos
Os seguintes exemplos têm como objetivo descrever apenas a configuração dos objetos de campo do widget de Valor do item para o painel de controle. Para mais informações sobre como configurar um dashboard, consulte dashboard.create.
Configuranda um widget de Valor do item
Configure um widget de Valor do item que exiba o valor do item para o item "42266" (Disponibilidade do agente Zabbix). Além disso, ajuste visualmente o widget com várias opções avançadas.
Solicitação:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid",
"value": 42266
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 1,
"name": "bg_color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta: