Send-ServiceFabricClusterHealthReport
Envía un informe de mantenimiento sobre un clúster de Service Fabric.
Sintaxis
Send-ServiceFabricClusterHealthReport
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
El cmdlet Send-ServiceFabricClusterHealthReport envía un informe de estado en un clúster de Service Fabric.
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 comando se evalúa en el cliente sin referencia a la ejecución en el almacén de estado. Es posible que el informe no se aplique en el almacén de estado incluso si el comando devuelve éxito. Por ejemplo, el almacén de estado puede rechazar el informe debido a un parámetro no válido, como un número de secuencia obsoleto.
Para ver si el informe se aplicó en el almacén de estado, use el cmdlet Get-ServiceFabricClusterHealth 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-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error
Este comando envía un informe de estado en el clúster 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-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344
Este comando envía un informe de estado en el clúster desde el origen MyWatchDog. El informe de mantenimiento contiene información sobre la propiedad de mantenimiento EnoughNodes en un estado de mantenimiento de advertencia. El informe permanece en el almacén de estado durante 10 segundos, después del cual se quita automáticamente. El comando especifica el parámetro SequenceNumber . El número de secuencia debe ser mayor que los números de secuencia notificados anteriormente para el mismo SourceId y Property, o el informe se rechaza debido a obsolescencia.
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.
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 , 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.
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 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.
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 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.
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.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