Objeto de serviço

Os seguintes objetos estão diretamente relacionados à API de service.

Serviço

O objeto service possui as seguintes propriedades.

Property Type Description
serviceid ID ID do service.

Property behavior:
- read-only
- required for update operations
algorithm integer Regra de cálculo do status. Aplicável somente se existirem serviços filhos.

Valores possíveis:
0 - define o status como OK;
1 - mais crítico se todos os filhos tiverem problemas;
2 - mais crítico entre os serviços filhos.

Property behavior:
- required for create operations
name string Nome do service.

Property behavior:
- required for create operations
sortorder integer Posição do service usada para ordenação.

Valores possíveis: 0-999.

Property behavior:
- required for create operations
weight integer Peso do service.

Valores possíveis: 0-1000000.

Padrão: 0.
propagation_rule integer Regra de propagação do status.

Valores possíveis:
0 - (default) propaga o status do service como está - sem alterações;
1 - aumenta o status propagado por um determinado propagation_value (em 1 a 5 severidades);
2 - diminui o status propagado por um determinado propagation_value (em 1 a 5 severidades);
3 - ignora este service - o status não é propagado ao service pai;
4 - define um status fixo do service usando um determinado propagation_value.

Property behavior:
- required se propagation_value estiver definido
propagation_value integer Valor de propagação do status.

Valores possíveis se propagation_rule estiver definido como "0" ou "3":
0 - Não classificado.

Valores possíveis se propagation_rule estiver definido como "1" ou "2":
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.

Valores possíveis se propagation_rule estiver definido como "4":
-1 - OK;
0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.

Property behavior:
- required se propagation_rule estiver definido
status integer Indica se o service está em estado OK ou com problema.

Se o service estiver em estado de problema, status será igual à severidade do problema mais crítico ou ao status mais alto de um service filho em estado de problema.

Se o service estiver em estado OK, status será igual a: -1.

Property behavior:
- read-only
description string Descrição do service.
uuid string Identificador universal exclusivo, usado para vincular services importados a services já existentes. Gerado automaticamente, se não for informado.
created_at integer Timestamp Unix em que o service foi criado.
readonly integer Acesso ao service.

Valores possíveis:
0 - leitura e gravação;
1 - somente leitura.

Property behavior:
- read-only

Regra de status

O objeto de regra de status possui as seguintes propriedades.

Propriedade Tipo Descrição
type integer Condição para definir o status (Novo status).

Valores possíveis:
0 - se pelo menos (N) serviços filhos tiverem status (Status) ou superior;
1 - se pelo menos (N%) dos serviços filhos tiverem status (Status) ou superior;
2 - se menos de (N) serviços filhos tiverem status (Status) ou inferior;
3 - se menos de (N%) dos serviços filhos tiverem status (Status) ou inferior;
4 - se o peso dos serviços filhos com status (Status) ou superior for pelo menos (W);
5 - se o peso dos serviços filhos com status (Status) ou superior for pelo menos (N%);
6 - se o peso dos serviços filhos com status (Status) ou inferior for menor que (W);
7 - se o peso dos serviços filhos com status (Status) ou inferior for menor que (N%).

Onde:
- N (W) é limit_value;
- (Status) é limit_status;
- (Novo status) é new_status.

Comportamento da propriedade:
- obrigatório
limit_value integer Valor limite.

Valores possíveis:
- para N e W: 1-100000;
- para N%: 1-100.

Comportamento da propriedade:
- obrigatório
limit_status integer Status limite.

Valores possíveis:
-1 - OK;
0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.

Comportamento da propriedade:
- obrigatório
new_status integer Novo valor de status.

Valores possíveis:
0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.

Comportamento da propriedade:
- obrigatório

Tag de serviço

O objeto de tag de serviço possui as seguintes propriedades.

Propriedade Tipo Descrição
tag string Nome da tag de serviço.

Comportamento da propriedade:
- obrigatório
value string Valor da tag de serviço.

Alarme de serviço

Alarmes de serviço não podem ser criados, atualizados ou excluídos diretamente via API do Zabbix.

Os objetos de alarme de serviço representam uma mudança de estado de um serviço. Eles têm as seguintes propriedades.

Property Type Description
clock timestamp Momento em que a mudança de estado do serviço ocorreu.
value integer Status do serviço.

Consulte a propriedade status do service para uma lista de valores possíveis.

Tag de problema

As tags de problema permitem vincular serviços a eventos de problema. O objeto de tag de problema tem as seguintes propriedades.

Property Type Description
tag string Nome da tag de problema.

Property behavior:
- required
operator integer Operador da condição de mapeamento operator.

Valores possíveis:
0 - (default) Igual a;
2 - Contém.
value string Valor da tag de problema.