Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

> Objeto de serviço

Os objetos a seguir estão diretamente relacionados à API service.

Serviço

O objeto de serviço tem as seguintes propriedades.

Propriedade Tipo Descrição
serviceid string (somente leitura) ID do serviço.
algorithm
(requerido)
integer Regra de cálculo de status. Aplicável apenas se existirem serviços filhos.

Valores possíveis:
0 - definir o status como OK;
1 - mais crítico se todos os serviços filhos tiverem problemas;
2 - mais crítico dos serviços filho.
name
(requerido)
string Nome do serviço.
sortorder
(requerido)
integer Posição do serviço usado para classificação.

Valores possíveis: 0-999.
weight integer Peso do serviço.

Valores possíveis: 0-1000000.

Padrão: 0.
propagation_rule integer Regra de propagação de status. Deve ser definido junto com propagation_value.

Valores possíveis:
0 - (padrão) propagar o status do serviço como está - sem alterações;
1 - aumentar o status propagado em um determinado propagation_value (por 1 a 5 gravidades);
2 - diminuir o status propagado por um determinado propagation_value (por 1 a 5 gravidades);
3 - ignorar este serviço - o status não é propagado para o serviço pai;
4 - defina o status do serviço fixo usando um determinado propagation_value.
propagation_value integer Valor de propagação de status. Deve ser definido junto com propagation_rule.

Valores possíveis para propagation_rule com valores 0 e 3: 0.

Valores possíveis para propagation_rule com valores 1 e 2: 1-5.

Possíveis valores para propagation_rule com valor 4:
-1 - OK;
0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Médio;
4 - Alto;
5 - Desastre.
status integer (somente leitura) Se o serviço está OK ou com problema.

Se o serviço estiver com problema, status é igual a:
- a gravidade do problema mais crítico;<br >- o status mais alto de um serviço filho em estado de problema.

Se o serviço estiver em estado OK, status será igual a -1.
description string Descrição do serviço.
uuid string Identificador único universal. Para operações de atualização, este campo é somente leitura.
created_at integer Timestamp Unix quando o serviço foi criado.
readonly boolean (readonly) Acesso ao serviço.

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

Regra de status

O objeto de regra de status tem as seguintes propriedades.

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

Valores possíveis:
0 - se pelo menos (N) serviços filho tiverem status (Status) ou superior;
1 - se pelo menos (N%) dos serviços de apoio à criança têm estatuto (Status) ou superior;
2 - se menos de (N) serviços infantis tiverem status (Status) ou inferior;
3 - se menos de (N%) dos serviços à criança tiverem status (Status) ou inferior;
4 - se o peso dos serviços infantis com status (Status) ou superior for no mínimo (W);
5 - se o peso dos serviços infantis com status (Status) ou superior for pelo menos (N%);
6 - se o peso dos serviços infantis com status (Status) ou inferior for menor que (W);
7 - se o peso dos serviços filho com status (Status) ou abaixo for menor que (N%).

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

Valores possíveis:
- para N e W: 1-100000;
- para N%: 1-100.
limit_status
(requerido)
integer Status do limite.

Valores possíveis:
-1 - OK;
0 - Não classificado;
1 - Informação;
2 - Aviso;
3 - Média;
4 - Alta;
5 - Desastre.
new_status
(requerido)
integer Novo valor de status.

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

Etiqueta de serviço

O objeto de etiqueta de serviço tem as seguintes propriedades.

Propriedade Tipo Descrição
tag
(required)
string Nome da etiqueta de serviço.
value string Valor da etiqueta de serviço.

Alarme de serviço

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

Os objetos de alarme de serviço representam a mudança de estado de um serviço. Tem as seguintes propriedades.

Propriedade Tipo Descrição
clock timestamp Hora em que a mudança de estado do serviço aconteceu.
value integer Status do serviço.

Consulte a propriedade do status do serviço para obter uma lista de valores possíveis.

Etiqueta do problema

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

Propriedade Tipo Descrição
tag
(requerido)
string Nome da etiqueta do problema.
operator integer Operador de condição de mapeamento.

Valores possíveis:
0 - (padrão) é igual;
2 - igual.
value string Valor da etiqueta do problema.