HealthInformation
Representa información de informe de estado común. Se incluye en todos los informes de estado enviados al almacén de estado y en todos los eventos de mantenimiento devueltos por las consultas de estado.
Propiedades
| Nombre | Tipo | Obligatorio |
|---|---|---|
SourceId |
string | Sí |
Property |
string | Sí |
HealthState |
string (enum) | Sí |
TimeToLiveInMilliSeconds |
string (duración) | No |
Description |
string | No |
SequenceNumber |
string | No |
RemoveWhenExpired |
boolean | No |
HealthReportId |
string | No |
SourceId
Tipo: cadena
Obligatoria: sí
El nombre de origen que identifica el componente de cliente/guardián/sistema que genera la información de estado.
Property
Tipo: cadena
Obligatoria: sí
La propiedad de la información de mantenimiento. Una entidad puede tener informes de mantenimiento para diferentes propiedades.
La propiedad es una cadena y no una enumeración fija para permitir al informador la flexibilidad de categorizar la condición de estado que desencadena el informe.
Por ejemplo, un informador con SourceId "LocalWatchdog" puede supervisar el estado del disco disponible en un nodo, por lo que puede informar de la propiedad "AvailableDisk" en ese nodo.
El mismo informador puede supervisar la conectividad del nodo, por lo que puede informar de una propiedad "Connectivity" en el mismo nodo.
En el almacén de estado, estos informes se tratan como eventos de mantenimiento independientes del nodo especificado.
Junto con SourceId, la propiedad identifica la información de mantenimiento de manera única.
HealthState
Tipo: cadena (enumeración)
Obligatoria: sí
Estado de mantenimiento de una entidad de Service Fabric, como Clúster, Nodo, Aplicación, Servicio, Partición, Réplica, etc.
Los valores posibles son:
-
Invalid: indica un estado de mantenimiento no válido. Todas las enumeraciones de Service Fabric tienen el tipo no válido. El valor predeterminado es cero. -
Ok- Indica que el estado de mantenimiento está bien. El valor es 1. -
Warning: indica que el estado de mantenimiento está en un nivel de advertencia. El valor es 2. -
Error: indica que el estado de mantenimiento está en un nivel de error. Se debe investigar el estado de mantenimiento del error, ya que pueden afectar a la funcionalidad correcta del clúster. El valor es 3. -
Unknown: indica un estado de mantenimiento desconocido. El valor es 65535.
TimeToLiveInMilliSeconds
Tipo: cadena (duración)
Obligatoria: no
La duración durante la cual este informe de mantenimiento es válido. Este campo usa el formato ISO8601 para especificar la duración.
Cuando los clientes notifican periódicamente, deben enviar informes con una frecuencia mayor que el período de vida.
Si los clientes notifican en transición, pueden establecer el período de vida en Infinito.
Cuando expira el período de vida, el evento de estado que contiene la información de estado se quita del almacén de estado, si RemoveWhenExpired es true, o se evalúa en el error, si RemoveWhenExpired es false.
Si no se especifica, el período de vida se establece de forma predeterminada en un valor infinito.
Description
Tipo: cadena
Obligatoria: no
La descripción de la información de mantenimiento. Representa el texto libre utilizado para agregar información legible por el ser humano sobre el informe.
La longitud máxima de la cadena de la descripción es de 4096 caracteres.
Si la cadena proporcionada es más larga, se truncará automáticamente.
Cuando está truncado, los últimos caracteres de la descripción contienen un marcador "[Truncado]" y el tamaño total de la cadena es de 4096 caracteres.
La presencia del marcador indica a los usuarios que el truncamiento se ha producido.
Tenga en cuenta que, cuando se trunca, la descripción tiene menos de 4096 caracteres de la cadena original.
SequenceNumber
Tipo: cadena
Obligatoria: no
El número de secuencia para este informe de estado como una cadena numérica.
El número de secuencia del informe se usa por el almacén de estado para detectar informes obsoletos.
Si no se especifica, se genera automáticamente un número de secuencia por el cliente de estado cuando se agrega un informe.
RemoveWhenExpired
Tipo: booleano
Obligatoria: no
Valor que indica si el informe se quita del almacén de estado cuando expire.
Si se establece en true, el informe se quita del almacén de estado una vez que expire.
Si se establece en false, el informe se trata como un error cuando expire. El valor de esta propiedad es false de forma predeterminada.
Cuando los clientes notifican periódicamente, deben establecer RemoveWhenExpired en false (valor predeterminado).
De este modo, si el informador tiene problemas (por ejemplo, interbloqueo) y no puede informar, la entidad se evalúa en error cuando expira el informe de estado.
De este modo, se marca que la entidad está en estado de mantenimiento Error.
HealthReportId
Tipo: cadena
Obligatoria: no
Un identificador de informe de estado que identifica el informe de mantenimiento y se puede usar para encontrar información más detallada sobre un evento de mantenimiento específico en aka.ms/sfhealthid