22 Problemas

Descrição

Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget do dashboard permitem configurar o widget Problemas nos métodos dashboard.create e dashboard.update.

As propriedades fields do widget não são validadas durante a criação ou atualização de um dashboard. Isso permite que os usuários modifiquem widgets internos e criem widgets personalizados, mas também introduz o risco de criar ou atualizar widgets incorretamente. Para garantir a criação ou atualização bem-sucedida do widget Problemas, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.

Parâmetros

Os seguintes parâmetros são suportados para o widget Problems.

Parameter type name value
Refresh interval 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.
Show 0 show 1 - (padrão) Problemas recentes;
2 - Histórico;
3 - Problems.
Host groups 2 groupids.0 ID do Host group.

Nota: Para configurar vários host groups, crie um objeto de campo do widget do dashboard para cada host group com um número incrementado no nome da propriedade.

Este parâmetro não é suportado ao configurar o widget em um template dashboard.
Host groups (Widget) 1 groupids._reference Em vez do ID do Host group:
ABCDE._hostgroupids - defina um widget compatível (com o parâmetro Reference definido como "ABCDE") como a fonte de dados para host groups.

Este parâmetro não é suportado ao configurar o widget em um template dashboard.
Exclude host groups 2 exclude_groupids.0 ID do Host group.

Nota: Para excluir vários host groups, crie um objeto de campo do widget do dashboard para cada host group com um número incrementado no nome da propriedade.

Este parâmetro não é suportado ao configurar o widget em um template dashboard.
Hosts 3 hostids.0 ID do Host.

Nota: Para configurar vários hosts, crie um objeto de campo do widget do dashboard para cada host com um número incrementado no nome da propriedade. Para vários hosts, o parâmetro Host groups deve não estar configurado ou estar configurado com pelo menos um host group ao qual os hosts configurados pertençam.

Este parâmetro não é suportado ao configurar o widget em um template dashboard.
Hosts (Widget/Dashboard) 1 hostids._reference Em vez do ID do Host:
DASHBOARD.hostids - defina o seletor Host como a fonte de dados para hosts;
ABCDE._hostids - defina um widget compatível (com o parâmetro Reference definido como "ABCDE") como a fonte de dados para hosts.

Este parâmetro não é suportado ao configurar o widget em um template dashboard.
Problem 1 problem Nome do evento do problema (não diferencia maiúsculas de minúsculas, nome completo ou parte dele).
Severity 0 severities.0 0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.

Padrão: vazio (todos habilitados).

Nota: Para configurar vários valores, crie um objeto de campo do widget do dashboard para cada valor com um número incrementado no nome da propriedade.
Problem tags
Evaluation type 0 evaltype 0 - (padrão) And/Or;
2 - Or.
Tag name 1 tags.0.tag Qualquer valor de string.

Nota: O número no nome da propriedade referencia a ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório se configurar Problem tags
Operator 0 tags.0.operator 0 - Contém;
1 - Igual a;
2 - Não contém;
3 - Não é igual a;
4 - Existe;
5 - Não existe.

Nota: O número no nome da propriedade referencia a ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório se configurar Problem tags
Tag value 1 tags.0.value Qualquer valor de string.

Nota: O número no nome da propriedade referencia a ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório se configurar Problem tags
Show tags 0 show_tags 0 - (padrão) Nenhuma;
1 - 1;
2 - 2;
3 - 3.
Tag name (format) 0 tag_name_format 0 - (padrão) Completo;
1 - Reduzido;
2 - Nenhum.

Comportamento do parâmetro:
- suportado se Show tags estiver definido como "1", "2" ou "3"
Tag display priority 1 tag_priority Lista de tags separadas por vírgula.

Comportamento do parâmetro:
- suportado se Show tags estiver definido como "1", "2" ou "3"
Show operational data 0 show_opdata 0 - (padrão) Nenhum;
1 - Separadamente;
2 - Com o nome do problema.
Show suppressed problems 0 show_suppressed 0 - (padrão) Desativado;
1 - Ativado.
Acknowledgement status 0 acknowledgement_status 0 - (padrão) todos;
1 - Não reconhecido;
2 - Reconhecido.
By me 0 acknowledged_by_me 0 - (padrão) Desativado;
1 - Ativado.
Sort entries by 0 sort_triggers 1 - Severidade (decrescente);
2 - Host (crescente);
3 - Hora (crescente);
4 - (padrão) Hora (decrescente);
13 - Severidade (crescente);
14 - Host (decrescente);
15 - Problem (crescente);
16 - Problem (decrescente).

Para todos os valores, exceto "Hora (decrescente)" e "Hora (crescente)", o parâmetro Show timeline deve estar definido como "Desativado".

Os valores "Host (crescente)" e "Host (decrescente)" não são suportados ao configurar o widget em um template dashboard.
Show timeline 0 show_timeline 0 - Desativado;
1 - (padrão) Ativado.

Comportamento do parâmetro:
- suportado se Sort entries by estiver definido como "Hora (decrescente)" ou "Hora (crescente)"
Highlight whole row 0 highlight_row 0 - (padrão) Desativado;
1 - Ativado.

Este parâmetro não é suportado nos temas de alto contraste.

Esta opção é suportada desde o Zabbix 7.0.19.
Show lines 0 show_lines Os valores possíveis variam de 1 a 100.

Padrão: 25.
Reference 1 reference Qualquer valor de string composto por 5 caracteres (por exemplo, ABCDE ou JBPNL). Esse valor deve ser exclusivo dentro do dashboard ao qual o widget pertence.

Comportamento do parâmetro:
- obrigatório

Exemplos

Os exemplos a seguir têm como objetivo apenas descrever a configuração dos objetos de campo do widget de dashboard para o widget Problemas. Para mais informações sobre como configurar um dashboard, consulte dashboard.create.

Configurando um widget Problemas

Configure um widget Problemas que exiba problemas para o grupo de hosts "4" que satisfaçam as seguintes condições:

  • Problemas que tenham uma tag com o nome "scope" que contenha os valores "performance" ou "availability", ou "capacity".
  • Problemas que tenham as seguintes severidades: "Aviso", "Média", "Alta", "Desastre".

Além disso, configure o widget para mostrar tags e dados operacionais.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "name": "Problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "performance"
                            },
                            {
                                "type": 1,
                                "name": "tags.1.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.1.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.1.value",
                                "value": "availability"
                            },
                            {
                                "type": 1,
                                "name": "tags.2.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.2.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.2.value",
                                "value": "capacity"
                            },
                            {
                                "type": 0,
                                "name": "severities.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "severities.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "severities.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "severities.3",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "show_tags",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show_opdata",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Veja também