Send-ServiceFabricApplicationHealthReport
Envía un informe de estado en una aplicación de Service Fabric.
Syntax
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 procesamiento con errores. 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: Informe de estado de errores con TTL infinito
PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState ErrorEste 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 de mantenimiento Disponibilidad en un estado de mantenimiento de 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 -RemoveWhenExpiredEste 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 de mantenimiento Disponibilidad en un estado de mantenimiento de advertencia. El informe permanecerá en el almacén de estado durante 10 segundos, después del 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.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Especifica información legible sobre la condición que desencadenó el informe. Los parámetros SourceId, HealthProperty y HealthState describen completamente 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 trunca automáticamente. Cuando se trunca, la descripción termina con un marcador "[Truncado]", 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthProperty
Especifica la propiedad del informe. Junto con el parámetro SourceId , esta propiedad identifica de forma única el informe. El informe invalida los informes anteriores con los mismos valores para los parámetros SourceId y HealthProperty en la misma entidad.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthState
Especifica un objeto HealthState que representa el estado de mantenimiento notificado.
| Type: | HealthState |
| Accepted values: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Immediate
Especifica si el informe se debe enviar inmediatamente al almacén de estado. Esto es útil para los informes críticos que deben enviarse tan pronto como sea 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 de acuerdo con la configuración de HealthReportSendInterval. Esta es la configuración recomendada porque permite que el cliente de mantenimiento optimice los mensajes de notificación de estado destinados al almacén de estado, así como el procesamiento de informes de mantenimiento. De forma predeterminada, el cliente de tejido de PowerShell establece HealthReportSentInterval en 0, por lo que los informes se envían inmediatamente.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SequenceNumber
Especifica el número de secuencia asociado al informe de estado. 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.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceId
Especifica el identificador del origen que desencadenó el informe.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeoutSec
Especifica el período de tiempo de espera, en segundos, para la operación.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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