Événement d’intégrité

  • Article

Représente les informations d’intégrité signalées sur une entité d’intégrité, comme un cluster, une application ou un nœud, avec des métadonnées supplémentaires ajoutées par le Gestionnaire d’intégrité.

Propriétés

Nom Type Obligatoire
SourceId string Oui
Property string Oui
HealthState string (énumération) Oui
TimeToLiveInMilliSeconds chaîne (durée) Non
Description string Non
SequenceNumber string Non
RemoveWhenExpired boolean Non
HealthReportId string Non
IsExpired boolean Non
SourceUtcTimestamp chaîne (date-heure) Non
LastModifiedUtcTimestamp chaîne (date-heure) Non
LastOkTransitionAt chaîne (date-heure) Non
LastWarningTransitionAt chaîne (date-heure) Non
LastErrorTransitionAt chaîne (date-heure) 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é de l’erreur doit être examiné, car il peut avoir un impact sur les fonctionnalités correctes du cluster. La valeur est 3.
  • Unknown- Indique une status d’intégrité inconnue. 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 reporter 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

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 sur aka.ms/sfhealthid

IsExpired

Type : booléen
Obligatoire : Non

Retourne true si l’événement d’intégrité a expiré, sinon false.

SourceUtcTimestamp

Type : chaîne (date-heure)
Obligatoire : Non

Date et heure d’envoi du rapport d’intégrité par la source.

LastModifiedUtcTimestamp

Type : chaîne (date-heure)
Obligatoire : Non

Date et heure de la dernière modification du rapport d’intégrité par le magasin d’intégrité.

LastOkTransitionAt

Type : chaîne (date-heure)
Obligatoire : Non

Si l’état d’intégrité actuel est « Ok », cette propriété retourne l’heure à laquelle le rapport d’intégrité a été signalé pour la première fois avec « OK ». Pour les rapports périodiques, de nombreux rapports avec le même état peuvent avoir été générés. Cette propriété retourne la date et l’heure de réception du premier rapport d’intégrité « Ok ».

Si l’état d’intégrité actuel est « Erreur » ou « Avertissement », retourne la date et l’heure auxquelles l’état d’intégrité était le dernier dans « Ok », avant la transition vers un autre état.

Si l’état d’intégrité n’a jamais été « OK », la valeur est zéro date-heure.

LastWarningTransitionAt

Type : chaîne (date-heure)
Obligatoire : Non

Si l’état d’intégrité actuel est « Avertissement », cette propriété retourne l’heure à laquelle le rapport d’intégrité a été signalé pour la première fois avec « Avertissement ». Pour les rapports périodiques, de nombreux rapports avec le même état peuvent avoir été générés. Toutefois, cette propriété retourne uniquement la date et l’heure de réception du premier rapport d’intégrité « Avertissement ».

Si l’état d’intégrité actuel est « Ok » ou « Erreur », retourne la date et l’heure auxquelles l’état d’intégrité était le dernier dans « Avertissement », avant la transition vers un autre état.

Si l’état d’intégrité n’a jamais été « Avertissement », la valeur est zéro date-heure.

LastErrorTransitionAt

Type : chaîne (date-heure)
Obligatoire : Non

Si l’état d’intégrité actuel est « Error », cette propriété retourne l’heure à laquelle le rapport d’intégrité a été signalé pour la première fois avec « Error ». Pour les rapports périodiques, de nombreux rapports avec le même état peuvent avoir été générés, mais cette propriété retourne uniquement la date et l’heure de réception du premier rapport d’intégrité « Erreur ».

Si l’état d’intégrité actuel est « Ok » ou « Avertissement », retourne la date et l’heure auxquelles l’état d’intégrité était le dernier dans « Erreur », avant la transition vers un autre état.

Si l’état d’intégrité n’a jamais été « Erreur », la valeur est zéro date-heure.