HealthEvent

  • Artículo

Representa la información de mantenimiento notificada en una entidad de mantenimiento, como el clúster, la aplicación o el nodo, con metadatos adicionales agregados por el Administrador de mantenimiento.

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
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: 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

IsExpired

Tipo: booleano
Obligatoria: no

Devuelve true si el evento de mantenimiento ha expirado; de lo contrario, false.

SourceUtcTimestamp

Tipo: cadena (fecha y hora)
Obligatoria: no

Fecha y hora en que el origen envió el informe de mantenimiento.

LastModifiedUtcTimestamp

Tipo: cadena (fecha y hora)
Obligatoria: no

Fecha y hora en que el almacén de estado modificó por última vez el informe de mantenimiento.

LastOkTransitionAt

Tipo: cadena (fecha y hora)
Obligatoria: no

Si el estado de mantenimiento actual es "Ok", esta propiedad devuelve la hora en la que el informe de mantenimiento se informó por primera vez con "Ok". En el caso de los informes periódicos, es posible que se hayan generado muchos informes con el mismo estado. Esta propiedad devuelve la fecha y hora en que se recibió el primer informe de mantenimiento "Correcto".

Si el estado de mantenimiento actual es "Error" o "Advertencia", devuelve la fecha y hora en que el estado de mantenimiento fue el último en "Ok", antes de realizar la transición a otro estado.

Si el estado de mantenimiento nunca era "Ok", el valor será cero fecha y hora.

LastWarningTransitionAt

Tipo: cadena (fecha y hora)
Obligatoria: no

Si el estado de mantenimiento actual es "Warning", esta propiedad devuelve la hora en la que el informe de mantenimiento se informó por primera vez con "Warning". En el caso de los informes periódicos, es posible que se hayan generado muchos informes con el mismo estado, sin embargo, esta propiedad devuelve solo la fecha y hora en que se recibió el primer informe de mantenimiento "Advertencia".

Si el estado de mantenimiento actual es "Ok" o "Error", devuelve la fecha y hora en que el estado de mantenimiento fue el último en "Advertencia", antes de pasar a otro estado.

Si el estado de mantenimiento nunca era "Advertencia", el valor será cero fecha y hora.

LastErrorTransitionAt

Tipo: cadena (fecha y hora)
Obligatoria: no

Si el estado de mantenimiento actual es "Error", esta propiedad devuelve la hora en la que el informe de mantenimiento se informó por primera vez con "Error". En el caso de los informes periódicos, es posible que se hayan generado muchos informes con el mismo estado, sin embargo, esta propiedad devuelve solo la fecha y la hora en que se recibió el primer informe de mantenimiento "Error".

Si el estado de mantenimiento actual es "Ok" o "Warning", devuelve la fecha y hora en que el estado de mantenimiento fue el último en "Error", antes de pasar a otro estado.

Si el estado de mantenimiento nunca era "Error", el valor será cero fecha y hora.