HealthInformation
Représente les informations courantes du rapport d’intégrité. Il est inclus dans tous les rapports d’intégrité envoyés au magasin d’intégrité et dans tous les événements d’intégrité retournés par les requêtes d’intégrité.
Propriétés
| Nom | Type | Obligatoire |
|---|---|---|
SourceId |
string | Oui |
Property |
string | Oui |
HealthState |
string (enum) | Oui |
TimeToLiveInMilliSeconds |
chaîne (durée) | Non |
Description |
string | Non |
SequenceNumber |
string | Non |
RemoveWhenExpired |
boolean | Non |
HealthReportId |
string | Non |
SourceId
Type : chaîne
Obligatoire : Oui
Nom source qui identifie le composant client/espion/système qui a généré les informations d’intégrité.
Property
Type : chaîne
Obligatoire : Oui
Propriété des informations d’intégrité. Une entité peut avoir des rapports d’intégrité pour différentes propriétés.
La propriété est une chaîne et non une énumération fixe pour offrir au rapporteur la possibilité de catégoriser la condition d’état qui déclenche le rapport.
Par exemple, un rapporteur avec l’ID source (SourceId) « LocalWatchdog » peut surveiller l’état du disque disponible sur un nœud. Il peut donc signaler la propriété « AvailableDisk » sur ce nœud.
Le même rapporteur peut surveiller la connectivité du nœud. Il peut donc signaler une propriété « Connectivity » sur le même nœud.
Dans le magasin d’intégrité, ces rapports sont traités comme des événements d’intégrité distincts pour le nœud spécifié.
Avec l’ID source (SourceId), la propriété identifie de façon unique les informations d’intégrité.
HealthState
Type : chaîne (énumération)
Obligatoire : Oui
État d’intégrité d’une entité Service Fabric telle que Cluster, Nœud, Application, Service, Partition, Réplica, etc.
Les valeurs possibles sont les suivantes :
-
Invalid- Indique un état d’intégrité non valide. Toutes les énumérations Service Fabric ont le type non valide. La valeur est égale à zéro. -
Ok- Indique que l’état d’intégrité est correct. La valeur est égale à 1. -
Warning- Indique que l’état d’intégrité est au niveau d’avertissement. La valeur est égale à 2. -
Error- Indique que l’état d’intégrité est au niveau d’erreur. L’état d’intégrité des erreurs doit être examiné, car elles peuvent avoir un impact sur les fonctionnalités correctes du cluster. La valeur est 3. -
Unknown- Indique un status d’intégrité inconnu. La valeur est égale à 65535.
TimeToLiveInMilliSeconds
Type : chaîne (durée)
Obligatoire : Non
Durée pendant laquelle ce rapport d’intégrité est valide. Ce champ utilise le format ISO8601 pour spécifier la durée.
Quand les clients créent régulièrement des rapports, ils doivent les envoyer avec une fréquence supérieure à la durée de vie.
Si les clients créent des rapports lors d’une transition, ils peuvent définir la durée de vie sur Infinite (illimitée).
Quand la durée de vie expire, l’événement d’intégrité qui contient les informations d’intégrité est supprimé du magasin d’intégrité si RemoveWhenExpired est true, ou évalué comme erreur si RemoveWhenExpired est false.
Si cet argument n’est pas spécifié, la valeur de durée de vie est par défaut Infinite (illimitée).
Description
Type : chaîne
Obligatoire : Non
Description des informations d’intégrité. Il s’agit de texte libre utilisé pour ajouter des informations sur le rapport lisibles par l’homme.
La longueur de chaîne maximale de la description est de 4 096 caractères.
Si la chaîne fournie est plus longue, elle est automatiquement tronquée.
Si elle est tronquée, les derniers caractères de la description contiennent un marqueur « [Tronqué] », et la taille totale de la chaîne est de 4 096 caractères.
La présence du marqueur indique aux utilisateurs qu’une troncation a été effectuée.
Notez que si elle est tronquée, la description a moins que les 4 096 caractères de la chaîne d’origine.
SequenceNumber
Type : chaîne
Obligatoire : Non
Numéro de séquence de ce rapport d’intégrité sous forme de chaîne numérique.
Le numéro de séquence de rapport est utilisé par le magasin d’intégrité pour détecter les rapports obsolètes.
S’il n’est pas spécifié, un numéro de séquence est généré automatiquement par le client d’intégrité quand un rapport est ajouté.
RemoveWhenExpired
Type : booléen
Obligatoire : Non
Valeur qui indique si le rapport est supprimé du magasin d’intégrité quand il expire.
Si la valeur définie est true, le rapport est supprimé du magasin d’intégrité après son expiration.
Si la valeur définie est false, le rapport est traité comme une erreur quand il expire. La valeur de cette propriété est false par défaut.
Quand les clients créent un rapport régulièrement, ils doivent définir RemoveWhenExpired sur false (valeur par défaut).
De cette façon, si le rapporteur rencontre des problèmes (par exemple, un blocage) et ne peut pas signaler, l’entité est évaluée en cas d’erreur lorsque le rapport d’intégrité expire.
L’entité est marquée comme étant dans l’état d’intégrité Erreur.
HealthReportId
Type : chaîne
Obligatoire : Non
UN ID de rapport d’intégrité qui identifie le rapport d’intégrité et peut être utilisé pour trouver des informations plus détaillées sur un événement d’intégrité spécifique à aka.ms/sfhealthid