23 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 compatíveis com o widget Problemas.

Parâmetro tipo 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.
Mostrar 0 show 1 - (padrão) Problemas recentes;
2 - Histórico;
3 - Problemas.
Grupos de hosts 2 groupids.0 ID do grupo de hosts.

Observação: para configurar vários grupos de hosts, crie um objeto de campo do widget do dashboard para cada grupo de hosts, usando um número incrementado no nome da propriedade.

Este parâmetro não é compatível quando o widget é configurado em um dashboard de template.
Grupos de hosts (Widget) 1 groupids._reference Em vez do ID do grupo de hosts:
ABCDE._hostgroupids - defina um widget compatível (com o parâmetro Referência definido como "ABCDE") como fonte de dados para os grupos de hosts.

Este parâmetro não é compatível quando o widget é configurado em um dashboard de template.
Excluir grupos de hosts 2 exclude_groupids.0 ID do grupo de hosts.

Observação: para excluir vários grupos de hosts, crie um objeto de campo do widget do dashboard para cada grupo de hosts, usando um número incrementado no nome da propriedade.

Este parâmetro não é compatível quando o widget é configurado em um dashboard de template.
Hosts 3 hostids.0 ID do host.

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

Este parâmetro não é compatível quando o widget é configurado em um dashboard de template.
Hosts (Widget/Dashboard) 1 hostids._reference Em vez do ID do host:
DASHBOARD.hostids - defina o seletor de hosts do dashboard como fonte de dados para os hosts;
ABCDE._hostids - defina um widget compatível (com o parâmetro Referência definido como "ABCDE") como fonte de dados para os hosts.

Este parâmetro não é compatível quando o widget é configurado em um dashboard de template.
Problema 1 problem Nome do evento do problema (não diferencia maiúsculas de minúsculas, nome completo ou parte dele).
Severidade 0 severities.0 0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Média;
4 - Alta;
5 - Desastre.

Padrão: vazio (todas habilitadas).

Observação: para configurar vários valores, crie um objeto de campo do widget do dashboard para cada valor, usando um número incrementado no nome da propriedade.
Tags do problema
Tipo de avaliação 0 evaltype 0 - (padrão) E/OU;
2 - OU.
Nome da tag 1 tags.0.tag Qualquer valor de string.

Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório ao configurar Tags do problema
Operador 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.

Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório ao configurar Tags do problema
Valor da tag 1 tags.0.value Qualquer valor de string.

Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.

Comportamento do parâmetro:
- obrigatório ao configurar Tags do problema
Mostrar tags 0 show_tags 0 - (padrão) Nenhuma;
1 - 1;
2 - 2;
3 - 3.
Nome da tag (formato) 0 tag_name_format 0 - (padrão) Completo;
1 - Abreviado;
2 - Nenhum.

Comportamento do parâmetro:
- compatível se Mostrar tags estiver definido como "1", "2" ou "3"
Prioridade de exibição das tags 1 tag_priority Lista de tags separada por vírgulas.

Comportamento do parâmetro:
- compatível se Mostrar tags estiver definido como "1", "2" ou "3"
Mostrar dados operacionais 0 show_opdata 0 - (padrão) Nenhum;
1 - Separadamente;
2 - Com o nome do problema.
Mostrar problemas suprimidos 0 show_suppressed 0 - (padrão) Desabilitado;
1 - Habilitado.
Status de confirmação 0 acknowledgement_status 0 - (padrão) Todos;
1 - Não confirmados;
2 - Confirmados.
Por mim 0 acknowledged_by_me 0 - (padrão) Desabilitado;
1 - Habilitado.
Ordenar entradas por 0 sort_triggers 1 - Severidade (decrescente);
2 - Host (crescente);
3 - Hora (crescente);
4 - (padrão) Hora (decrescente);
13 - Severidade (crescente);
14 - Host (decrescente);
15 - Problema (crescente);
16 - Problema (decrescente).

Para todos os valores, exceto "Hora (decrescente)" e "Hora (crescente)", o parâmetro Mostrar linha do tempo deve estar definido como "Desabilitado".

Os valores "Host (crescente)" e "Host (decrescente)" não são compatíveis quando o widget é configurado em um dashboard de template.
Mostrar linha do tempo 0 show_timeline 0 - Desabilitado;
1 - (padrão) Habilitado.

Comportamento do parâmetro:
- compatível se Ordenar entradas por estiver definido como "Hora (decrescente)" ou "Hora (crescente)"
Destacar linha inteira 0 highlight_row 0 - (padrão) Desabilitado;
1 - Habilitado.

Este parâmetro não é compatível com os temas de alto contraste.
Mostrar linhas 0 show_lines Os valores possíveis variam de 1 a 100.

Padrão: 25.
Referência 1 reference Qualquer valor de string composto por 5 caracteres (por exemplo, ABCDE ou JBPNL). Esse valor deve ser exclusivo no 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