Send-ServiceFabricReplicaHealthReport
Envía un informe de estado en una réplica de Service Fabric.
Syntax
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
El cmdlet Send-ServiceFabricReplicaHealthReport envía un informe de estado en una instancia de servicio sin estado de Service Fabric o en una réplica de servicio con estado.
La instancia de servicio sin estado o la réplica de servicio con estado ya deben existir en el almacén de estado. Para comprobar si existe, use el cmdlet Get-ServiceFabricReplicaHealth y especifique los parámetros PartitionId y ReplicaOrInstanceId . Como alternativa, puede usar el cmdlet Get-ServiceFabricPartitionHealth con el parámetro PartitionId y, a continuación, comprobar la sección ReplicaHealthStates para buscar la réplica.
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.
El cmdlet puede devolver éxito, pero el informe se envía de forma asincrónica, por lo que su procesamiento puede producir un error. Para ver si el informe se aplicó en el almacén de estado, use el cmdlet Get-ServiceFabricReplicaHealth y compruebe que el informe aparece en la sección de eventos de mantenimiento.
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 .
Ejemplos
Ejemplo 1: Informe de estado de error en una réplica de servicio con estado con TTL infinito
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"
Este comando envía un informe de estado para la partición especificada para la réplica de servicio con estado especificada desde el origen MyWatchDog. El informe de mantenimiento contiene información sobre la propiedad de mantenimiento DiskUsage en un estado de mantenimiento de error, con TTL infinito. Este comando también proporciona una descripción del error.
Ejemplo 2: Informe de estado de advertencia en una instancia de servicio sin estado válida para el TTL especificado y quítelo cuando expire
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpired
Este comando envía un informe de estado para la instancia de servicio sin estado especificada desde el origen MyWatchDog. El informe de mantenimiento contiene información sobre la propiedad de mantenimiento Resources en un estado de mantenimiento de advertencia del origen MyWatchdog, con TTL de 10 segundos. El informe marcado para su eliminación al expirar.
Parámetros
-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.
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 |
-InstanceId
Especifica el identificador de instancia de servicio sin estado. El identificador de instancia solo es válido para los servicios sin estado. El cliente de mantenimiento acepta un informe de una réplica con estado que usa InstanceId en lugar de ReplicaId , pero que el almacén de estado rechaza.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionId
Especifica el identificador de una partición de Service Fabric.
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-ReplicaId
Especifica el identificador de réplica de servicio con estado. El identificador de réplica solo es válido para los servicios con estado. El cliente de mantenimiento acepta un informe para una instancia sin estado que usa ReplicaId en lugar de InstaceId , pero el almacén de estado lo rechaza.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
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 la misma entidad para 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.Guid
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