Condividi tramite

HealthEvent

  • Articolo

Rappresenta le informazioni sull'integrità segnalate in un'entità di integrità, ad esempio cluster, applicazione o nodo, con metadati aggiuntivi aggiunti da Health Manager.

Proprietà

Nome Tipo Necessario
SourceId string Sì
Property string Sì
HealthState stringa (enumerazione) Sì
TimeToLiveInMilliSeconds stringa (durata) No
Description string No
SequenceNumber string No
RemoveWhenExpired boolean No
HealthReportId string No
IsExpired boolean No
SourceUtcTimestamp string (date-time) No
LastModifiedUtcTimestamp string (date-time) No
LastOkTransitionAt string (date-time) No
LastWarningTransitionAt string (date-time) No
LastErrorTransitionAt string (date-time) No

SourceId

Tipo: stringa
Obbligatorio: Sì

Nome di origine che identifica il componente client/watchdog/sistema che ha generato le informazioni sull'integrità.

Property

Tipo: stringa
Obbligatorio: Sì

Proprietà delle informazioni sull'integrità. Un'entità può avere report sull'integrità per proprietà diverse. La proprietà è una stringa e non un'enumerazione fissa, che assicura al reporter la flessibilità necessaria per definire la categoria della condizione di stato che attiva il report. Ad esempio, un reporter con SourceId "LocalWatchdog" può monitorare lo stato del disco disponibile in un nodo e può quindi segnalare la proprietà "AvailableDisk" in tale nodo. Lo stesso reporter può monitorare la connettività del nodo e può quindi segnalare una proprietà "Connectivity" nello stesso nodo. Entrambi questi report vengono considerati come eventi di integrità separati nell'archivio integrità per il nodo specificato.

Insieme a SourceId, la proprietà identifica in modo univoco le informazioni sull'integrità.

HealthState

Tipo: stringa (enum)
Obbligatorio: Sì

Stato di integrità di un'entità di Service Fabric, ad esempio Cluster, Nodo, Applicazione, Servizio, Partizione, Replica e così via.

I valori possibili sono:

  • Invalid - Indica uno stato di integrità non valido. Tutte le enumerazioni di Service Fabric hanno il tipo non valido. Il valore predefinito è zero.
  • Ok - Indica che lo stato di integrità è ok. Il valore è uguale a 1.
  • Warning - Indica che lo stato di integrità è a livello di avviso. Il valore è 2.
  • Error - Indica che lo stato di integrità è a livello di errore. Lo stato di integrità degli errori deve essere analizzato, in quanto può influire sulla funzionalità corretta del cluster. Il valore è 3.
  • Unknown - Indica uno stato di integrità sconosciuto. Il valore è 65535.

TimeToLiveInMilliSeconds

Tipo: stringa (durata)
Obbligatorio: No

Durata in cui questo report sull'integrità è valido. Questo campo usa il formato ISO8601 per specificare la durata. Quando i client creano report periodicamente, devono inviare i report con una frequenza maggiore della durata (TTL). Se i client inviano report in caso di transizione, possono impostare la durata (TTL) come infinita. Quando la durata (TTL) scade, l'evento di integrità che contiene le informazioni sull'integrità viene rimosso dall'archivio integrità, se RemoveWhenExpired è True, o considerato in stato di errore, se RemoveWhenExpired è False.

Se non è specificato, la durata (TTL) viene impostata su un valore infinito.

Description

Tipo: stringa
Obbligatorio: No

Descrizione delle informazioni sull'integrità. Rappresenta il testo libero usato per aggiungere informazioni leggibili sul report. La lunghezza massima della stringa per la descrizione è pari a 4096 caratteri. Se la stringa immessa è più lunga, verrà automaticamente troncata. Quando viene troncata, gli ultimi caratteri della descrizione contengono un marcatore "[Truncated]" e la dimensione totale della stringa è pari a 4096 caratteri. La presenza del marcatore indica agli utenti che si è verificato un troncamento. Si noti che quando viene troncata, la descrizione contiene meno di 4096 caratteri della stringa originale.

SequenceNumber

Tipo: stringa
Obbligatorio: No

Numero di sequenza per questo report sull'integrità come stringa numerica. Il numero di sequenza del report viene usato dall'archivio integrità per rilevare i report non aggiornati. Se non specificato, un numero di sequenza viene generato automaticamente dal client di integrità quando viene aggiunto un report.

RemoveWhenExpired

Tipo: booleano
Obbligatorio: No

Valore che indica se il report viene rimosso dall'archivio integrità quando scade. Se impostato su True, il report viene rimosso dall'archivio integrità dopo la scadenza. Se impostato su False, il report viene considerato come errore quando è scaduto. Il valore di questa proprietà è False per impostazione predefinita. Quando i client creano report periodicamente, RemoveWhenExpired sarà impostato su False (valore predefinito). In questo modo, se il reporter ha problemi (ad esempio deadlock) e non può segnalare, l'entità viene valutata durante la scadenza del report di integrità. L'entità viene quindi contrassegnata con lo stato di integrità di errore.

HealthReportId

Tipo: stringa
Obbligatorio: No

ID report di integrità che identifica il report di integrità e può essere usato per trovare informazioni più dettagliate su un evento di integrità specifico in aka.ms/sfhealthid

IsExpired

Tipo: booleano
Obbligatorio: No

Restituisce true se l'evento di integrità è scaduto; in caso contrario, false.

SourceUtcTimestamp

Tipo: string (data-ora)
Obbligatorio: No

Data e ora in cui il report sull'integrità è stato inviato dall'origine.

LastModifiedUtcTimestamp

Tipo: string (data-ora)
Obbligatorio: No

Data e ora dell'ultima modifica del report sull'integrità dall'archivio integrità.

LastOkTransitionAt

Tipo: string (data-ora)
Obbligatorio: No

Se lo stato di integrità corrente è "Ok", questa proprietà restituisce l'ora in cui il report sull'integrità è stato segnalato per la prima volta con "Ok". Per la creazione di report periodici, è possibile che siano stati generati molti report con lo stesso stato. Questa proprietà restituisce la data e l'ora in cui è stato ricevuto il primo rapporto di integrità "Ok".

Se lo stato di integrità corrente è "Error" o "Warning", restituisce la data e l'ora in cui lo stato di integrità è stato ultimo in "Ok", prima di passare a uno stato diverso.

Se lo stato di integrità non è mai "Ok", il valore sarà di data e ora zero.

LastWarningTransitionAt

Tipo: string (data-ora)
Obbligatorio: No

Se lo stato di integrità corrente è "Avviso", questa proprietà restituisce l'ora in cui il report sull'integrità è stato segnalato per la prima volta con "Avviso". Per la creazione di report periodici, è possibile che siano stati generati molti report con lo stesso stato, tuttavia, questa proprietà restituisce solo la data e l'ora del primo report di integrità "Avviso".

Se lo stato di integrità corrente è "Ok" o "Errore", restituisce la data e l'ora in cui lo stato di integrità è stato ultimo in "Avviso", prima di passare a uno stato diverso.

Se lo stato di integrità non è mai stato "Avviso", il valore sarà di data e ora zero.

LastErrorTransitionAt

Tipo: string (data-ora)
Obbligatorio: No

Se lo stato di integrità corrente è "Error", questa proprietà restituisce l'ora in cui il report sull'integrità è stato segnalato per la prima volta con "Error". Per la creazione di report periodici, è possibile che siano stati generati molti report con lo stesso stato, ma questa proprietà restituisce solo la data e l'ora del primo rapporto di integrità "Errore".

Se lo stato di integrità corrente è "Ok" o "Avviso", restituisce la data e l'ora in cui lo stato di integrità è stato ultimo in "Errore", prima di passare a uno stato diverso.

Se lo stato di integrità non è mai stato "Error", il valore sarà zero date-time.