HealthEvent
Representa informações de estado de funcionamento comunicadas numa entidade de estado de funcionamento, como cluster, aplicação ou nó, com metadados adicionais adicionados pelo Health Manager.
Propriedades
Nome | Tipo | Necessário |
---|---|---|
SourceId |
string | Yes |
Property |
string | Yes |
HealthState |
cadeia (enum) | Yes |
TimeToLiveInMilliSeconds |
cadeia (duração) | No |
Description |
string | No |
SequenceNumber |
string | No |
RemoveWhenExpired |
boolean | No |
HealthReportId |
string | No |
IsExpired |
boolean | No |
SourceUtcTimestamp |
cadeia (data-hora) | No |
LastModifiedUtcTimestamp |
cadeia (data-hora) | No |
LastOkTransitionAt |
cadeia (data-hora) | No |
LastWarningTransitionAt |
cadeia (data-hora) | No |
LastErrorTransitionAt |
cadeia (data-hora) | No |
SourceId
Tipo: cadeia
Obrigatório: Sim
O nome de origem que identifica o componente cliente/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 (enum)
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á bom. 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á ao nível do erro. O estado de funcionamento do erro deve ser investigado, uma vez que podem 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 por erro, se RemoveWhenExpired false.
Se não for especificado, a hora de viver é predefinida para o valor infinito.
Description
Tipo: cadeia
Obrigatório: Não
A descrição das informações de estado de funcionamento. Representa texto gratuito 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 para este relatório de estado de funcionamento como uma cadeia numérica.
O número da 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 definido como verdadeiro, o relatório é removido do arquivo de estado de funcionamento depois de expirar.
Se estiver definido como falso, o relatório será tratado como um erro quando expirado. Por predefinição, o valor desta propriedade é falso.
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
IsExpired
Tipo: booleano
Obrigatório: Não
Devolve verdadeiro se o evento de estado de funcionamento expirar, caso contrário, é falso.
SourceUtcTimestamp
Tipo: cadeia (data-hora)
Obrigatório: Não
A data e hora em que o relatório de estado de funcionamento foi enviado pela origem.
LastModifiedUtcTimestamp
Tipo: cadeia (data-hora)
Obrigatório: Não
A data e hora em que o relatório de estado de funcionamento foi modificado pela última vez pelo arquivo de estado de funcionamento.
LastOkTransitionAt
Tipo: cadeia (data-hora)
Obrigatório: Não
Se o estado de funcionamento atual for "Ok", esta propriedade devolve a hora em que o relatório de estado de funcionamento foi reportado pela primeira vez com "Ok".
Para relatórios periódicos, podem ter sido gerados muitos relatórios com o mesmo estado.
Esta propriedade devolve a data e hora em que o primeiro relatório de estado de funcionamento 'Ok' foi recebido.
Se o estado de funcionamento atual for "Erro" ou "Aviso", devolve a data e hora em que o estado de funcionamento foi o último em 'Ok', antes de transitar para um estado diferente.
Se o estado de funcionamento nunca tiver sido 'Ok', o valor será zero date-time.
LastWarningTransitionAt
Tipo: cadeia (data-hora)
Obrigatório: Não
Se o estado de funcionamento atual for "Aviso", esta propriedade devolve a hora em que o relatório de estado de funcionamento foi reportado pela primeira vez com "Aviso". Para relatórios periódicos, muitos relatórios com o mesmo estado podem ter sido gerados, no entanto, esta propriedade devolve apenas a data e hora no primeiro relatório de estado de funcionamento "Aviso" foi recebido.
Se o estado de funcionamento atual for "Ok" ou "Erro", devolve a data e hora em que o estado de funcionamento foi o último em "Aviso", antes de transitar para um estado diferente.
Se o estado de funcionamento nunca tiver sido "Aviso", o valor será zero date-time.
LastErrorTransitionAt
Tipo: cadeia (data-hora)
Obrigatório: Não
Se o estado de funcionamento atual for "Erro", esta propriedade devolve a hora em que o relatório de estado de funcionamento foi reportado pela primeira vez com "Erro". Para relatórios periódicos, muitos relatórios com o mesmo estado podem ter sido gerados, no entanto, esta propriedade devolve apenas a data e hora no primeiro relatório de estado de funcionamento "Erro" foi recebido.
Se o estado de funcionamento atual for "Ok" ou "Aviso", devolve a data e hora em que o estado de funcionamento foi o último em "Erro", antes de transitar para um estado diferente.
Se o estado de funcionamento nunca tiver sido "Erro", o valor será zero data-hora.