HealthInformation
Representa informações comuns do relatório de estado de funcionamento. Está incluído em todos os relatórios de estado de funcionamento enviados para o arquivo de estado de funcionamento e em todos os eventos de estado de funcionamento devolvidos pelas consultas de estado de funcionamento.
Propriedades
| Nome | Tipo | Necessário |
|---|---|---|
SourceId |
string | Yes |
Property |
string | Yes |
HealthState |
cadeia (enumeração) | Yes |
TimeToLiveInMilliSeconds |
cadeia (duração) | No |
Description |
string | No |
SequenceNumber |
string | No |
RemoveWhenExpired |
boolean | No |
HealthReportId |
string | No |
SourceId
Tipo: cadeia
Obrigatório: Sim
O nome de origem que identifica o cliente/componente watchdog/sistema que gerou as informações de estado de funcionamento.
Property
Tipo: cadeia
Obrigatório: Sim
A propriedade das informações de estado de funcionamento. Uma entidade pode ter relatórios de estado de funcionamento para propriedades diferentes.
A propriedade é uma cadeia e não uma enumeração fixa para permitir que a flexibilidade do repórter categorize a condição de estado que aciona o relatório.
Por exemplo, um repórter com o SourceId "LocalWatchdog" pode monitorizar o estado do disco disponível num nó, para que possa comunicar a propriedade "AvailableDisk" nesse nó.
O mesmo repórter pode monitorizar a conectividade do nó, para que possa comunicar uma propriedade "Conectividade" no mesmo nó.
No arquivo de estado de funcionamento, estes relatórios são tratados como eventos de estado de funcionamento separados para o nó especificado.
Juntamente com o SourceId, a propriedade identifica exclusivamente as informações de estado de funcionamento.
HealthState
Tipo: cadeia (enumeração)
Obrigatório: Sim
O estado de funcionamento de uma entidade do Service Fabric, como Cluster, Nó, Aplicação, Serviço, Partição, Réplica, etc.
Os valores possíveis são:
-
Invalid- Indica um estado de funcionamento inválido. Todas as enumerações do Service Fabric têm o tipo inválido. O valor é zero. -
Ok- Indica que o estado de funcionamento está correto. O valor é 1. -
Warning- Indica que o estado de funcionamento está num nível de aviso. O valor é 2. -
Error- Indica que o estado de funcionamento está num nível de erro. O estado de funcionamento do erro deve ser investigado, uma vez que pode afetar a funcionalidade correta do cluster. O valor é 3. -
Unknown- Indica um estado de funcionamento desconhecido. O valor é 65535.
TimeToLiveInMilliSeconds
Tipo: cadeia (duração)
Obrigatório: Não
A duração para a qual este relatório de estado de funcionamento é válido. Este campo utiliza o formato ISO8601 para especificar a duração.
Quando os clientes comunicam periodicamente, devem enviar relatórios com maior frequência do que o tempo de vida.
Se os clientes comunicarem sobre a transição, podem definir o tempo de vida como infinito.
Quando o tempo de vida expira, o evento de estado de funcionamento que contém as informações de estado de funcionamento é removido do arquivo de estado de funcionamento, se RemoveWhenExpired for verdadeiro ou avaliado com o erro, se RemoveWhenExpired false.
Se não for especificado, a predefinição time to live é infinita.
Description
Tipo: cadeia
Obrigatório: Não
A descrição das informações de estado de funcionamento. Representa texto livre utilizado para adicionar informações legíveis por humanos sobre o relatório.
O comprimento máximo da cadeia para a descrição é de 4096 carateres.
Se a cadeia fornecida for mais longa, será truncada automaticamente.
Quando truncados, os últimos carateres da descrição contêm um marcador "[Truncado]" e o tamanho total da cadeia é de 4096 carateres.
A presença do marcador indica aos utilizadores que ocorreu uma truncagem.
Tenha em atenção que, quando truncada, a descrição tem menos de 4096 carateres da cadeia original.
SequenceNumber
Tipo: cadeia
Obrigatório: Não
O número de sequência deste relatório de estado de funcionamento como uma cadeia numérica.
O número de sequência de relatórios é utilizado pelo arquivo de estado de funcionamento para detetar relatórios obsoletos.
Se não for especificado, um número de sequência é gerado automaticamente pelo cliente de estado de funcionamento quando é adicionado um relatório.
RemoveWhenExpired
Tipo: booleano
Obrigatório: Não
Valor que indica se o relatório é removido do arquivo de estado de funcionamento quando expira.
Se estiver definido como verdadeiro, o relatório é removido do arquivo de estado de funcionamento depois de expirar.
Se estiver definido como falso, o relatório é tratado como um erro quando expirado. O valor desta propriedade é falso por predefinição.
Quando os clientes comunicam periodicamente, devem definir RemoveWhenExpired false (predefinição).
Desta forma, se o repórter tiver problemas (por exemplo, impasse) e não conseguir comunicar, a entidade será avaliada com o erro quando o relatório de estado de funcionamento expirar.
Isto sinaliza a entidade como estando no estado de funcionamento do erro.
HealthReportId
Tipo: cadeia
Obrigatório: Não
Um ID do relatório de estado de funcionamento que identifica o relatório de estado de funcionamento e pode ser utilizado para encontrar informações mais detalhadas sobre um evento de estado de funcionamento específico no aka.ms/sfhealthid