Informações sobre saúde

Representa informações comuns de relatórios de saúde. Está incluído em todos os relatórios de saúde enviados à loja de saúde e em todos os eventos de saúde devolvidos por consultas de saúde.

Propriedades

Nome Type Obrigatório
SourceId string Sim
Property string Sim
HealthState string (enum) Sim
TimeToLiveInMilliSeconds string (duração) Não
Description string Não
SequenceNumber string Não
RemoveWhenExpired booleano Não

SourceId

Tipo: string
Necessário: Sim

O nome de origem que identifica o componente do cliente/watchdog/sistema que gerou as informações de integridade.


Property

Tipo: string
Necessário: Sim

A propriedade das informações de integridade. Uma entidade pode ter relatórios de integridade para propriedades diferentes. A propriedade é uma cadeia de caracteres e não uma enumeração fixa para permitir ao relator flexibilidade para categorizar a condição de estado que dispara o relatório. Por exemplo, um relator com SourceId "LocalWatchdog" pode monitorar o estado do disco disponível em um nó, para poder relatar a propriedade "AvailableDisk" nesse nó. O mesmo relator pode monitorar a conectividade do nó, para que ele possa relatar a "Conectividade" de uma propriedade no mesmo nó. No repositório de integridade, esses relatórios são tratados como eventos de integridade distintos para o nó especificado.

Junto com a SourceId, a propriedade identifica exclusivamente as informações de integridade.


HealthState

Tipo: string (enum)
Necessário: Sim

O estado de saúde de uma entidade de Malha de Serviço, como Cluster, Nó, Aplicativo, Serviço, Partição, Réplica etc.

Os valores possíveis são:

  • Invalid- Indica um estado de saúde inválido. Todas as enumerações do service fabric têm o tipo inválido. O valor é zero.
  • Ok- Indica que o estado de saúde está bom. O valor é 1.
  • Warning- Indica que o estado de saúde está em nível de alerta. O valor é 2.
  • Error- Indica que o estado de saúde está em um nível de erro. O estado de saúde de erro deve ser investigado, pois pode impactar a funcionalidade correta do cluster. O valor é 3.
  • Unknown- Indica um estado de saúde desconhecido. O valor é 65535.

TimeToLiveInMilliSeconds

Tipo: string (duração)
Necessário: Não

A duração da validade deste relatório de integridade. Este campo usa o formato ISO8601 para especificar a duração. Quando clientes geram relatórios periodicamente, eles devem enviar relatórios com uma frequência maior do que o tempo de vida. Se os clientes gerarem relatórios sobre a transição, poderão definir o tempo de vida como infinito. Quando o tempo de vida expira, o evento de integridade que contém as informações de integridade é removido do repositório de integridade, se RemoveWhenExpired for true, ou recebe uma avaliação de erro, se RemoveWhenExpired for false.

Se não for especificado, o tempo de vida terá como padrão o valor infinito.


Description

Tipo: string
Necessário: Não

A descrição de informações de integridade. Ele representa texto livre usado para adicionar informações legíveis humanas sobre o relatório. O tamanho máximo da cadeia de caracteres da descrição é de 4.096 caracteres. Se a cadeia de caracteres fornecida for maior, será truncada automaticamente. Quando truncada, os últimos caracteres da descrição contêm um marcador "[Truncated]", e o tamanho total da cadeia de caracteres é de 4.096 caracteres. A presença do marcador indica aos usuários que o truncamento ocorreu. Observe que, quando truncada, a descrição tem menos de 4.096 caracteres da cadeia de caracteres original.


SequenceNumber

Tipo: string
Necessário: Não

O número da sequência para este relatório de integridade como uma cadeia de caracteres numérica. O número de sequência de relatório é usado pelo repositório de integridade para detectar relatórios obsoletos. Se não for especificado, um número de sequência será gerado automaticamente pelo cliente de integridade quando um relatório for adicionado.


RemoveWhenExpired

Tipo: booleano
Necessário: Não

Valor que indica se o relatório é removido do repositório de integridade quando expirar. Se definido como "true", o relatório é removido do repositório de integridade depois de expirar. Se definido como "false", o relatório é tratado como um erro quando expirado. O valor dessa propriedade é "false" por padrão. Quando os clientes enviam relatórios periodicamente, devem definir RemoveWhenExpired como "false" (padrão). Dessa forma, se o repórter tiver problemas (por exemplo, impasse) e não puder relatar, a entidade é avaliada por engano quando o relatório de saúde expira. Isso sinaliza a entidade como em um estado de integridade de Erro.