Share via

HealthInformation

  • Artigo

Representa informações comuns de relatório de integridade. Ele está incluído em todos os relatórios de integridade enviados ao repositório de integridade e em todos os eventos de integridade retornados por consultas de integridade.

Propriedades

Nome Tipo Obrigatório
SourceId string Sim
Property string Sim
HealthState cadeia de caracteres (enumeração) Sim
TimeToLiveInMilliSeconds cadeia de caracteres (duração) Não
Description string Não
SequenceNumber string Não
RemoveWhenExpired booleano Não
HealthReportId string Não

SourceId

Tipo: string
Obrigatório: sim

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

Property

Tipo: string
Obrigató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: cadeia de caracteres (enumeração)
Obrigatório: sim

O estado de integridade de uma entidade do Service Fabric, como Cluster, Nó, Aplicativo, Serviço, Partição, Réplica etc.

Os valores possíveis são:

  • Invalid - Indica um estado de integridade inválido. Todas as enumerações do Service Fabric têm o tipo inválido. O valor é zero.
  • Ok - Indica que o estado de integridade está bem. O valor é 1.
  • Warning - Indica que o estado de integridade está em um nível de aviso. O valor é 2.
  • Error - Indica que o estado de integridade está no nível de erro. O estado de integridade do erro deve ser investigado, pois eles podem afetar a funcionalidade correta do cluster. O valor é 3.
  • Unknown- Indica uma status de integridade desconhecida. O valor é 65535.

TimeToLiveInMilliSeconds

Tipo: cadeia de caracteres (duração)
Obrigató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
Obrigató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
Obrigató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: booliano
Obrigató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, deadlock) e não puder relatar, a entidade será avaliada com erro quando o relatório de integridade expirar. Isso sinaliza a entidade como em um estado de integridade de Erro.

HealthReportId

Tipo: string
Obrigatório: não

Uma ID de relatório de integridade que identifica o relatório de integridade e pode ser usada para encontrar informações mais detalhadas sobre um evento de integridade específico em aka.ms/sfhealthid