Get-ServiceFabricClusterHealth
Obtiene información de mantenimiento de un clúster de Service Fabric.
Sintaxis
Get-ServiceFabricClusterHealth
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-EventsHealthStateFilter <Int64>]
[-EventsFilter <HealthStateFilter>]
[-ApplicationsHealthStateFilter <Int64>]
[-ApplicationsFilter <HealthStateFilter>]
[-NodesHealthStateFilter <Int64>]
[-NodesFilter <HealthStateFilter>]
[-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-IncludeSystemApplicationHealthStatistics]
[-TimeoutSec <Int32>]
[<CommonParameters>] Get-ServiceFabricClusterHealth
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-EventsHealthStateFilter <Int64>]
[-EventsFilter <HealthStateFilter>]
[-ApplicationsHealthStateFilter <Int64>]
[-ApplicationsFilter <HealthStateFilter>]
[-NodesHealthStateFilter <Int64>]
[-NodesFilter <HealthStateFilter>]
[-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-ExcludeHealthStatistics]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
El cmdlet Get-ServiceFabricClusterHealth obtiene información de mantenimiento de un clúster de Service Fabric. Service Fabric notifica los siguientes estados de mantenimiento:
- Aceptar. La entidad cumple las directrices de mantenimiento.
- Error. La entidad no cumple las directrices de mantenimiento.
- Advertencia. La entidad cumple las directrices de mantenimiento, pero ha experimentado algún problema.
El estado de mantenimiento agregado del clúster tiene en cuenta todos los informes de mantenimiento del clúster, así como el estado de mantenimiento agregado de todos los elementos secundarios, de forma recursiva. La evaluación de estado usa la directiva de mantenimiento del clúster y la directiva de mantenimiento de la aplicación de cada aplicación del clúster.
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: Obtención del estado del clúster y filtro devueltos por elementos secundarios
PS C:\> Get-ServiceFabricClusterHealth -NodesFilter Error -ApplicationsFilter 'Warning,Error'Este comando consulta el estado del clúster. Especifica filtros para devolver solo nodos con estado de mantenimiento Error y aplicaciones con estado de mantenimiento Advertencia o Error.
Ejemplo 2: Obtención del estado del clúster mediante directivas de mantenimiento personalizadas
PS C:\> $defaultServiceTypeHealthPolicy = new-object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
$defaultServiceTypeHealthPolicy.MaxPercentUnhealthyPartitionsPerService = 20
$defaultServiceTypeHealthPolicy.MaxPercentUnhealthyServices = 10
$appHealthPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
$appHealthPolicy.ConsiderWarningAsError = $True
$appHealthPolicy.MaxPercentUnhealthyDeployedApplications = 20
$appHealthPolicy.DefaultServiceTypeHealthPolicy = $defaultServiceTypeHealthPolicy
$appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
$appUri1 = New-Object -TypeName System.Uri -ArgumentList "fabric:/app1"
$appHealthPolicyMap.Add($appUri1, $appHealthPolicy)
Get-ServiceFabricClusterHealth -ConsiderWarningAsError $True -MaxPercentUnhealthyNodes 10 -ApplicationHealthPolicyMap $appHealthPolicyMapEste comando consulta el estado del clúster y pasa directivas personalizadas.
Ejemplo 3: Obtención del estado del clúster mediante una asignación de directiva de mantenimiento de tipo de aplicación
PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Get-ServiceFabricClusterHealth -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -MaxPercentUnhealthyApplications 20Este comando consulta el estado del clúster y pasa una asignación de directiva de estado de tipo de aplicación. El tipo de aplicación CriticalAppType no tolera ningún error. Las aplicaciones restantes se evalúan con un 20 % de porcentaje máximo incorrecto.
Ejemplo 4: Obtención del estado del clúster sin eventos de mantenimiento y sin estadísticas de estado
PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -ExcludeHealthStatisticsEste comando consulta el estado del clúster. Especifica filtros para excluir los eventos de mantenimiento y las estadísticas de mantenimiento.
Ejemplo 5: Obtención del estado del clúster con las estadísticas de la aplicación fabric:/System incluidas
PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -IncludeSystemApplicationHealthStatisticsEste comando consulta el estado del clúster. Las estadísticas de estado devueltas como parte del estado del clúster contienen las estadísticas de la aplicación fabric:/System, además de las estadísticas de las aplicaciones de usuario.
Parámetros
-ApplicationHealthPolicyMap
Especifica el objeto ApplicationHealthPolicyMap que incluye directivas de mantenimiento personalizadas para algunas o todas las aplicaciones. Si no especifica este parámetro, la evaluación de estado usa las directivas de mantenimiento de la aplicación definidas en el manifiesto de aplicación o la directiva de mantenimiento predeterminada.
| Tipo: | ApplicationHealthPolicyMap |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ApplicationsFilter
Especifica el filtro para los elementos secundarios ApplicationHealthState en función del estado de mantenimiento. El valor se puede obtener de miembros o operaciones bit a bit en miembros de HealthStateFilter. Solo se devuelven los elementos secundarios que coinciden con el filtro. Todos los elementos secundarios se usan para evaluar el estado de mantenimiento agregado de la entidad. Si no se especifica, se devuelven todas las entradas.
| Tipo: | HealthStateFilter |
| Valores aceptados: | Default, None, Ok, Warning, Error, All |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ApplicationsHealthStateFilter
Este parámetro ha quedado en desuso. Especifique el parámetro ApplicationsFilter en su lugar.
| Tipo: | Int64 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ApplicationTypeHealthPolicyMap
Especifica el mapa que define el porcentaje máximo de aplicaciones incorrectas permitidas por tipo de aplicación. Los tipos de aplicación de este mapa se evalúan con porcentajes específicos en lugar del porcentaje global MaxPercentUnhealthyApplications .
Por ejemplo, si algunas aplicaciones de un tipo son vitales, el administrador de clústeres puede agregar una entrada a la asignación para ese tipo de aplicación y asignarle un valor del 0 % (es decir, no tolerar errores). Todas las demás aplicaciones se pueden evaluar con MaxPercentUnhealthyApplications establecido en 20 % para tolerar algunos errores de las miles de instancias de aplicación.
La asignación de directivas de mantenimiento del tipo de aplicación solo se usa si el manifiesto del clúster habilita la evaluación del estado del tipo de aplicación mediante la entrada de configuración de HealthManager/EnableApplicationTypeHealthEvaluation.
| Tipo: | ApplicationTypeHealthPolicyMap |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConsiderWarningAsError
Indica si se trata un informe de mantenimiento de advertencia como error durante la evaluación de estado. Este valor se usa para la evaluación de nodos e informes de estado del clúster.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EventsFilter
Especifica el filtro de la colección de HealthEvents notificado en el clúster en función del estado de mantenimiento. El valor se puede obtener de miembros o operaciones bit a bit en miembros de HealthStateFilter. Se devuelven únicamente los eventos que coinciden con el filtro. Todos los eventos se usan para evaluar el estado de mantenimiento agregado del clúster. Si no se especifica, se devuelven todas las entradas.
| Tipo: | HealthStateFilter |
| Valores aceptados: | Default, None, Ok, Warning, Error, All |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EventsHealthStateFilter
Este parámetro ha quedado en desuso. Especifique el parámetro EventsFilter en su lugar.
| Tipo: | Int64 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ExcludeHealthStatistics
Indica si las estadísticas de mantenimiento deben incluirse en el resultado de la consulta. Si se especifica, las estadísticas de estado no se devuelven como parte del resultado de la consulta. De lo contrario, el resultado de la consulta incluye las estadísticas de mantenimiento del clúster, que contienen información sobre el número de entidades que se encuentran en los estados Ok, Warning y Error.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IncludeSystemApplicationHealthStatistics
Indica si las estadísticas de estado deben incluir información para la aplicación fabric:/System. Si se especifica, la aplicación, el servicio, la partición, la réplica, la aplicación implementada y los recuentos de paquetes de servicio implementados incluyen las entidades del sistema. Si no se especifica, las estadísticas de mantenimiento devuelven recuentos de estado de mantenimiento solo para las aplicaciones de usuario.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MaxPercentUnhealthyApplications
Especifica el porcentaje máximo tolerado de aplicaciones incorrectas. Si hay más aplicaciones con el estado de mantenimiento agregado de error que tolerado, el estado de mantenimiento del clúster es un error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto del clúster.
| Tipo: | Byte |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MaxPercentUnhealthyNodes
Especifica el porcentaje máximo tolerado de nodos incorrectos. Si hay más nodos con el estado de mantenimiento agregado de error que tolerado, el clúster se evalúa como error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto del clúster.
| Tipo: | Byte |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NodesFilter
Especifica el filtro para los elementos secundarios NodeHealthState en función del estado de mantenimiento. El valor se puede obtener de miembros o operaciones bit a bit en miembros de HealthStateFilter. Solo se devuelven los elementos secundarios que coinciden con el filtro. Todos los elementos secundarios se usan para evaluar el estado de mantenimiento agregado de la entidad. Si no se especifica, se devuelven todas las entradas.
| Tipo: | HealthStateFilter |
| Valores aceptados: | Default, None, Ok, Warning, Error, All |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NodesHealthStateFilter
Este parámetro ha quedado en desuso. Especifique el parámetro NodesFilter en su lugar.
| Tipo: | Int64 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NodeTypeHealthPolicyMap
Define un mapa con porcentajes máximos de nodos incorrectos para tipos de nodo específicos.
La asignación de directiva de mantenimiento de tipo de nodo se puede usar durante la evaluación del mantenimiento de clúster para describir tipos de nodo especiales. Los tipos de nodo incluidos en el mapa se evalúan con respecto al porcentaje incluido en el mapa y también con el global (consulte System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Los nodos de los tipos de nodo especificados en el mapa también se cuentan en el grupo global de nodos; son comprobaciones independientes.
| Tipo: | NodeTypeHealthPolicyMap |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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 |
Entradas
None
Salidas
System.Object