Compartir a través de

Send-ServiceFabricApplicationHealthReport

  • Referencia
Módulo:
ServiceFabric

Envía un informe de estado en una aplicación de Service Fabric.

Sintaxis

Send-ServiceFabricApplicationHealthReport
    [-ApplicationName] <Uri>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

El cmdlet Send-ServiceFabricApplicationHealthReport envía un informe de estado en una aplicación de Service Fabric.

La aplicación ya debe existir en el almacén de estado. Para comprobar si existe, use el cmdlet Get-ServiceFabricApplicationHealth.

El cmdlet envía el informe después de un intervalo especificado por el parámetro HealthReportSendIntervalInSec del cmdlet Connect-ServiceFabricCluster. La conexión del clúster debe mantenerse activa durante este tiempo. Este cmdlet envía un informe de forma asincrónica, por lo que este cmdlet podría enviar un valor de éxito incluso a través del error de procesamiento. Por ejemplo, si se elimina una entidad o debido a un parámetro no válido como un número de secuencia obsoleto, el almacén de estado puede rechazar el informe.

Para ver si el informe se aplicó en el almacén de estado, use el cmdlet Get-ServiceFabricApplicationHealth y compruebe que el informe aparece en la sección HealthEvents.

Para administrar clústeres de Service Fabric, inicie Windows PowerShell mediante la opción Ejecutar como administrador. Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster y, a continuación, el cmdlet Get-ServiceFabricClusterConnection.

Ejemplos

Ejemplo 1: Notificar informe de estado de errores con TTL infinito

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Este comando envía un informe de estado en la aplicación denominada fabric:/MyApplication desde el origen MyWatchDog. El informe de mantenimiento contiene información sobre la propiedad health Availability en un estado de mantenimiento error, con TTL infinito.

Ejemplo 2: Advertencia de informe válida para el TTL especificado

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired

Este comando envía un informe de estado en la aplicación denominada fabric:/MyApplication desde el origen MyWatchDog. El informe de mantenimiento contiene información sobre la propiedad health Availability en un estado de mantenimiento de advertencia. El informe permanecerá en el almacén de estado durante 10 segundos, después de lo cual se quitará automáticamente.

Parámetros

-ApplicationName

Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric. El cmdlet envía un informe de estado sobre la aplicación que tiene el URI que especifique.

Tipo:Uri
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Description

Especifica información legible sobre la condición que desencadenó el informe. Los parámetros SourceId, HealthPropertyy HealthState describen completamente el informe.

La longitud máxima de cadena de la descripción es de 4096 caracteres. Si la cadena proporcionada es más larga, se trunca automáticamente. Cuando se trunca, la descripción termina con un marcador , "[Truncated]", para indicar a los usuarios que se han producido el truncamiento. El tamaño total de la cadena es de 4096 caracteres, por lo que se conservan menos de 4096 caracteres de la cadena original.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HealthProperty

Especifica la propiedad del informe. Junto con el parámetro sourceId de , esta propiedad identifica de forma única el informe. El informe invalida los informes anteriores con los mismos valores para el SourceId y HealthProperty parámetros en la misma entidad.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HealthState

Especifica un objeto healthState que representa el estado de mantenimiento notificado.

Tipo:HealthState
Valores aceptados:Invalid, Ok, Warning, Error, Unknown
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Immediate

Especifica si el informe se debe enviar inmediatamente al almacén de estado. Esto resulta útil para informes críticos que se deben enviar lo antes posible. Si no se especifica, el informe se envía en función de la configuración del cliente de mantenimiento. Por lo tanto, se procesará por lotes según la configuración healthReportSendInterval. Esta es la configuración recomendada porque permite al cliente de mantenimiento optimizar los mensajes de informes de mantenimiento en el almacén de estado, así como el procesamiento de informes de estado. De forma predeterminada, el cliente de tejido de PowerShell establece HealthReportSentInterval en 0, por lo que los informes se envían inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveWhenExpired

Indica que el informe se quita del almacén de estado cuando expira. Si no especifica este parámetro, la entidad se considera en estado Error cuando expira el período de vida del informe. Los informes que se quitan cuando han expirado se pueden usar para condiciones que solo son válidas durante un período de tiempo o para borrar informes del Almacén de estado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SequenceNumber

Especifica el número de secuencia asociado al informe de mantenimiento. Si no especifica un valor para este parámetro, el número de secuencia se establece automáticamente. Si especifica un número de secuencia, ese valor debe ser mayor que cualquier número de secuencia anterior establecido en el mismo SourceId y HealthProperty, o el informe se rechaza debido a obsolescencia.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SourceId

Especifica el identificador del origen que desencadenó el informe.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimeToLiveSec

Especifica el período de vida (TTL) del informe en segundos. Cuando expira el TTL, el informe se quita del almacén de estado si se especifica el parámetro removeWhenExpired . De lo contrario, la entidad se evalúa en Error debido al informe expirado. El valor predeterminado es Infinite.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

System.Uri

System.Fabric.Health.HealthState

System.String

System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

System.Object