HealthEvent

Artigo
08/05/2023

Representa informações de integridade relatadas em uma entidade de integridade, como cluster, aplicativo ou nó, com metadados adicionais adicionados pelo Gerenciador 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
`IsExpired`	booleano	Não
`SourceUtcTimestamp`	cadeia de caracteres (data e hora)	Não
`LastModifiedUtcTimestamp`	cadeia de caracteres (data e hora)	Não
`LastOkTransitionAt`	cadeia de caracteres (data e hora)	Não
`LastWarningTransitionAt`	cadeia de caracteres (data e hora)	Não
`LastErrorTransitionAt`	cadeia de caracteres (data e hora)	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

`IsExpired`

Tipo: booliano
Obrigatório: não

Retornará true se o evento de integridade expirar, caso contrário, false.

`SourceUtcTimestamp`

Tipo: cadeia de caracteres (data e hora)
Obrigatório: não

A data e a hora em que o relatório de integridade foi enviado pela origem.

`LastModifiedUtcTimestamp`

Tipo: cadeia de caracteres (data e hora)
Obrigatório: não

A data e a hora em que o relatório de integridade foi modificado pela última vez pelo repositório de integridade.

`LastOkTransitionAt`

Tipo: cadeia de caracteres (data e hora)
Obrigatório: não

Se o estado de integridade atual for 'Ok', essa propriedade retornará a hora em que o relatório de integridade foi relatado pela primeira vez com 'Ok'. Para relatórios periódicos, muitos relatórios com o mesmo estado podem ter sido gerados. Essa propriedade retorna a data e a hora em que o primeiro relatório de integridade 'Ok' foi recebido.

Se o estado de integridade atual for 'Error' ou 'Warning', retornará a data e a hora em que o estado de integridade foi o último em 'Ok', antes de fazer a transição para um estado diferente.

Se o estado de integridade nunca tiver sido 'Ok', o valor será zero date-time.

`LastWarningTransitionAt`

Tipo: cadeia de caracteres (data e hora)
Obrigatório: não

Se o estado de integridade atual for 'Warning', essa propriedade retornará a hora em que o relatório de integridade foi relatado pela primeira vez com 'Warning'. Para relatórios periódicos, muitos relatórios com o mesmo estado podem ter sido gerados, no entanto, essa propriedade retorna apenas a data e a hora no primeiro relatório de integridade 'Aviso' foi recebido.

Se o estado de integridade atual for 'Ok' ou 'Error', retornará a data e a hora em que o estado de integridade foi o último em 'Aviso', antes de fazer a transição para um estado diferente.

Se o estado de integridade nunca tiver sido 'Aviso', o valor será zero date-time.

`LastErrorTransitionAt`

Tipo: cadeia de caracteres (data e hora)
Obrigatório: não

Se o estado de integridade atual for 'Error', essa propriedade retornará a hora em que o relatório de integridade foi relatado pela primeira vez com 'Error'. Para relatórios periódicos, muitos relatórios com o mesmo estado podem ter sido gerados, no entanto, essa propriedade retorna apenas a data e a hora no primeiro relatório de integridade 'Erro' foi recebido.

Se o estado de integridade atual for 'Ok' ou 'Warning', retornará a data e a hora em que o estado de integridade foi o último em 'Erro', antes de fazer a transição para um estado diferente.

Se o estado de integridade nunca tiver sido 'Error', o valor será zero date-time.

Share via