Share via

HealthInformation

  • Articolo

Rappresenta informazioni comuni sul report sull'integrità. È incluso in tutti i report sull'integrità inviati all'archivio integrità e in tutti gli eventi di integrità restituiti dalle query di integrità.

Proprietà

Nome Tipo Necessario
SourceId string Sì
Property string Sì
HealthState string (enum) Sì
TimeToLiveInMilliSeconds stringa (durata) No
Description string No
SequenceNumber string No
RemoveWhenExpired boolean No
HealthReportId string No

SourceId

Tipo: string
Obbligatorio: Sì

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

Property

Tipo: string
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: string (enum)
Obbligatorio: Sì

Stato di integrità di un'entità di Service Fabric, ad esempio Cluster, Node, Application, Service, Partition, 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à è corretto. 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, perché può influire sulla funzionalità corretta del cluster. Il valore è 3.
  • Unknown - Indica uno stato di integrità sconosciuto. Il valore è 65535.

TimeToLiveInMilliSeconds

Tipo: string (duration)
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: string
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: string
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 presenta problemi (ad esempio deadlock) e non può segnalare, l'entità viene valutata in caso di errore alla scadenza del report sull'integrità. L'entità viene quindi contrassegnata con lo stato di integrità di errore.

HealthReportId

Tipo: string
Obbligatorio: No

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