Compartilhar via

HealthEvent

  • Artigo

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.