Get-ServiceFabricClusterHealthChunk
Obtiene información de mantenimiento de un clúster de Service Fabric y sus elementos secundarios.
Sintaxis
Get-ServiceFabricClusterHealthChunk
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-ApplicationHealthPolicies <ApplicationHealthPolicyMap>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-ApplicationFilters <System.Collections.Generic.List`1[System.Fabric.Health.ApplicationHealthStateFilter]>]
[-NodeFilters <System.Collections.Generic.List`1[System.Fabric.Health.NodeHealthStateFilter]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
El cmdlet Get-ServiceFabricClusterHealthChunk obtiene información de estado de un clúster de Service Fabric y entidades de clúster según se solicite con los filtros de entrada avanzados. De forma predeterminada, no se devuelven entidades secundarias. Si se especifica, todas las entidades que respetan la entrada se devuelven de forma jerárquica.
Service Fabric notifica los siguientes estados de mantenimiento.
- De acuerdo. 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 tiene algunos problemas.
El estado de mantenimiento agregado del clúster tiene en cuenta todos los informes de estado 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. Puede pasar las directivas de mantenimiento para el clúster y para la evaluación de aplicaciones como entrada. Si no se especifica, la evaluación de estado usa las directivas de mantenimiento aplicables del clúster y el manifiesto de aplicación si se especifica el manifiesto o las directivas predeterminadas de lo contrario.
El fragmento de estado del clúster solo incluye elementos secundarios de interés, tal como se especifica en los filtros de entrada. El filtrado se realiza en el lado servidor, por lo que el tamaño del mensaje se minimiza.
Si la salida solicitada no cabe en un mensaje, no se devuelve ningún resultado.
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 con filtros de nodo
PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $NodeFilter1 = New-Object System.Fabric.Health.NodeHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $NodeFilter2 = New-Object System.Fabric.Health.NodeHealthStateFilter -Property @{NodeNameFilter="N0010";HealthStateFilter=$ErrorFilter}
PS C:\> $NodeFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.NodeHealthStateFilter]
PS C:\> $NodeFilters.Add($NodeFilter1)
PS C:\> $NodeFilters.Add($NodeFilter2)
PS C:\> Get-ServiceFabricClusterHealthChunk -NodeFilter $NodeFiltersEste comando consulta el estado del clúster. Especifica filtros para devolver todos los nodos, excepto para el nodo N0010, que solo se debe incluir si se agrega el estado de mantenimiento en Error.
Ejemplo 2: Obtención del estado del clúster con filtros de entidad implementados
PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $DspFilter1 = New-Object System.Fabric.Health.DeployedServicePackageHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $DaFilter1 = New-Object System.Fabric.Health.DeployedApplicationHealthStateFilter -Property @{HealthStateFilter=$AllFilter;NodeNameFilter="N0020"}
PS C:\> $DaFilter1.DeployedServicePackageFilters.Add($DspFilter1)
PS C:\> $AppFilter = New-Object System.Fabric.Health.ApplicationHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $AppFilter.DeployedApplicationFilters.Add($DaFilter1)
PS C:\> $AppFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.ApplicationHealthStateFilter]
PS C:\> $AppFilters.Add($AppFilter)
PS C:\> Get-ServiceFabricClusterHealthChunk -ApplicationFilters $AppFiltersEste comando consulta el estado del clúster. Especifica filtros para devolver todas las aplicaciones y aplicaciones implementadas y paquetes de servicio implementados en un nodo especificado (N0020).
Ejemplo 3: Obtención del estado del clúster con un filtro de aplicación que incluye filtros internos recursivos
PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $ReplicaFilter1 = New-Object System.Fabric.Health.ReplicaHealthStateFilter -Property @{ReplicaOrInstanceIdFilter= 130984777977143495;HealthStateFilter=$ErrorFilter}
PS C:\> $ReplicaFilter2 = New-Object System.Fabric.Health.ReplicaHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $PartitionFilter = New-Object System.Fabric.Health.PartitionHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $PartitionFilter.ReplicaFilters.Add($ReplicaFilter1)
PS C:\> $PartitionFilter.ReplicaFilters.Add($ReplicaFilter2)
PS C:\> $SvcFilter1 = New-Object System.Fabric.Health.ServiceHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $SvcFilter1.PartitionFilters.Add($PartitionFilter)
PS C:\> $AppFilter = New-Object System.Fabric.Health.ApplicationHealthStateFilter -Property @{ApplicationNameFilter="fabric:/app1"}
PS C:\> $AppFilter.ServiceFilters.Add($SvcFilter1)
PS C:\> $AppFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.ApplicationHealthStateFilter]
PS C:\> $AppFilters.Add($AppFilter)
PS C:\> Get-ServiceFabricClusterHealthChunk -ApplicationFilters $AppFiltersEste comando consulta el estado del clúster. Especifica filtros para devolver solo una aplicación. El filtro devuelve todos los servicios de aplicación y, para cada servicio, devuelve todas las particiones. Para cada partición, incluye todas las réplicas, excepto 130984777977143495, que solo se deben devolver si se encuentra en Error.
Parámetros
-ApplicationFilters
Especifica un Systems.Collections.Generic.List de objetos System.Fabric.Health.ApplicationHealthState Filter. Solo se devuelven las aplicaciones que respetan el filtro más específico. Puede especificar los filtros para aplicaciones individuales o para todas las aplicaciones. Solo se permite un filtro general y un filtro por aplicación.
Si no especifica este parámetro, no se devuelve ninguna aplicación.
| Tipo: | System.Collections.Generic.List`1[System.Fabric.Health.ApplicationHealthStateFilter] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ApplicationHealthPolicies
Especifica un System.Fabric.Health.ApplicationHealthPolicyMap que incluye directivas de mantenimiento personalizadas para algunas o todas las aplicaciones. Si no especifica este parámetro o si no incluye una entrada en el mapa de una aplicación, esa aplicación se evalúa con la directiva de mantenimiento de la aplicación definida en el manifiesto de aplicación si existe o la directiva predeterminada de lo contrario.
| Tipo: | ApplicationHealthPolicyMap |
| 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 usando porcentajes específicos en lugar del porcentaje global MaxPercentUnhealthyApplications.
Por ejemplo, si algunas aplicaciones de un tipo son críticas, el administrador del clúster puede agregar una entrada al mapa para ese tipo de aplicación y asignarle un valor de 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 debe tratar un informe de estado de advertencia como un error durante la evaluación de estado. Este valor se usa para la evaluación de nodos e informes de estado del clúster.
Si no se especifica ninguno de los parámetros de la directiva de mantenimiento del clúster, la evaluación de estado usa la directiva de mantenimiento del clúster del manifiesto del clúster, si existe, o la directiva predeterminada que tolera ningún error.
| Tipo: | Boolean |
| 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 estado de error agregado que tolerado, el estado de mantenimiento del clúster es Error.
Si no se especifica ninguno de los parámetros de la directiva de mantenimiento del clúster, la evaluación de estado usa la directiva de mantenimiento del clúster del manifiesto del clúster, si existe, o la directiva predeterminada que tolera ningún error.
| 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 estado de error agregado 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.
Si no se especifica ninguno de los parámetros de la directiva de mantenimiento del clúster, la evaluación de estado usa la directiva de mantenimiento del clúster del manifiesto del clúster, si existe, o la directiva predeterminada que tolera ningún error.
| Tipo: | Byte |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NodeFilters
Especifica un Systems.Collections.Generic.List de objetos System.Fabric.Health.NodeHealthStateFilter. Solo se devuelven los nodos que respetan el filtro más específico. Puede especificar los filtros para nodos individuales o para todos los nodos. Solo se permite un filtro general y un filtro por nodo. Si no especifica este parámetro, no se devuelve ningún nodo.
| Tipo: | System.Collections.Generic.List`1[System.Fabric.Health.NodeHealthStateFilter] |
| 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.
El mapa de directivas de mantenimiento del tipo de nodo se puede usar durante la evaluación del estado del 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 (vea 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