Compartir a través de

Send-ServiceFabricDeployedServicePackageHealthReport

  • Referencia
Módulo:
ServiceFabric

Envía un informe de estado en un paquete de servicio implementado de Service Fabric.

Sintaxis

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

Description

El cmdlet Send-ServiceFabricDeployedServicePackageHealthReport envía un informe de estado en un paquete de servicio implementado de Service Fabric.

El paquete de servicio implementado ya debe existir en el almacén de estado. Para comprobar si el servicio existe, use el cmdlet Get-ServiceFabricDeployedServicePackageHealth. Especifique el nombre de la aplicación, el nombre del paquete de servicio y el nombre del nodo. Como alternativa, puede usar el cmdlet Get-ServiceFabricDeployedApplicationHealth. Especifique el nombre de la aplicación y el nombre del nodo y compruebe la sección estados de mantenimiento del paquete de servicio implementado para buscar el paquete de servicio.

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-ServiceFabricDeployedServicePackageHealth 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-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"

Este comando envía un informe de estado en un paquete de servicio implementado para la aplicación denominada fabric:/MyApplication en el nodo denominado Node01 para el manifiesto de servicio denominado MyServiceManifest. El informe de mantenimiento contiene información sobre la propiedad health Memory en un estado de estado error del origen MyWatchdog, con TTL infinito. La descripción no se proporciona y el número de secuencia se establece automáticamente.

Ejemplo 2: Advertencia de informe válida para el TTL especificado y quitarla cuando expire

PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10

Este comando envía un informe de estado en un paquete de servicio implementado para la aplicación denominada fabric:/MyApplication para el manifiesto de servicio denominado MyServiceManifest en el nodo denominado Node01. El informe de mantenimiento contiene información sobre la propiedad health CustomSetup en un estado de mantenimiento de advertencia del origen MyWatchdog, con 10 segundos de TTL. Una vez expirado el informe, se quita del almacén de estado y ya no afectará a la evaluación del estado. Este comando también proporciona una descripción de la advertencia.

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

-NodeName

Especifica el nombre de un nodo de Service Fabric. El cmdlet envía un informe de estado para un paquete de servicio implementado en el nodo que especifique.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-ServiceManifestName

Especifica el nombre de un manifiesto de servicio de Service Fabric. Junto con applicationName y NodeName, este valor identifica de forma única la entidad de mantenimiento del paquete de servicio implementado.

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

-ServicePackageActivationId

Identificador de activación del ServicePackage implementado. Esto se puede obtener mediante la consulta Get-ServiceFabricDeployedServicePackage.

Si ServicePackageActivationMode especificado en el momento de crear el servicio (mediante New-ServiceFabricService) se sharedProcess (o si no se especifica, en cuyo caso se usa SharedProcess), el valor de ServicePackageActivationId siempre es una cadena vacía y no se debe especificar. Para más información sobre el identificador de activación del paquete de servicio, consulte [Modelo de hospedaje de Service Fabric][1].

Tipo:String
Posición:3
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.String

System.Fabric.Health.HealthState

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