Get-ServiceFabricClusterHealth

Ссылка

Модуль:: ServiceFabric

Возвращает сведения о работоспособности для кластера Service Fabric.

Синтаксис

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

Описание

Командлет Get-ServiceFabricClusterHealth получает сведения о работоспособности кластера Service Fabric. Service Fabric сообщает о следующих состояниях работоспособности:

Все в порядке. Сущность соответствует рекомендациям по работоспособности.
Ошибка. Сущность не соответствует рекомендациям по работоспособности.
Внимание! Сущность соответствует рекомендациям по работоспособности, но возникла некоторая проблема.

Агрегированное состояние работоспособности кластера учитывает все отчеты о работоспособности в кластере, а также агрегированное состояние работоспособности всех дочерних элементов, рекурсивно. Оценка работоспособности использует политику работоспособности кластера и политику работоспособности приложений каждого приложения в кластере.

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Получение работоспособности кластера и возвращаемых дочерних элементов фильтра

PS C:\> Get-ServiceFabricClusterHealth -NodesFilter Error -ApplicationsFilter 'Warning,Error'

Эта команда запрашивает работоспособность кластера. Он указывает фильтры для возврата только узлов с ошибкой состояния работоспособности и приложениями с предупреждением о состоянии работоспособности или ошибкой.

Пример 2. Получение работоспособности кластера с помощью настраиваемых политик работоспособности

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 $appHealthPolicyMap

Эта команда запрашивает работоспособность кластера и передает пользовательские политики.

Пример 3. Получение работоспособности кластера с помощью карты политики работоспособности типа приложения

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Get-ServiceFabricClusterHealth -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -MaxPercentUnhealthyApplications 20

Эта команда запрашивает работоспособность кластера и передает карту политики работоспособности типа приложения. Тип приложения CriticalAppType не допускает сбоев. Остальные приложения оцениваются с использованием 20 % максимальной неработоспособности.

Пример 4. Получение работоспособности кластера без событий работоспособности и без статистики работоспособности

PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -ExcludeHealthStatistics

Эта команда запрашивает работоспособность кластера. Он задает фильтры для исключения любых событий работоспособности и статистики работоспособности.

Пример 5. Получение работоспособности кластера с включенной статистикой приложения fabric:/System application

PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -IncludeSystemApplicationHealthStatistics

Эта команда запрашивает работоспособность кластера. Статистика работоспособности, возвращаемая как часть работоспособности кластера, содержит статистику приложения fabric:/System, в дополнение к статистике пользовательских приложений.

Параметры

-ApplicationHealthPolicyMap

Указывает объект ApplicationHealthPolicyMap , включающий пользовательские политики работоспособности для некоторых или всех приложений. Если этот параметр не указан, оценка работоспособности использует политики работоспособности приложения, определенные в манифесте приложения или политике работоспособности по умолчанию.

Type:	ApplicationHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationsFilter

Указывает фильтр для дочерних элементов ApplicationHealthState на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только дочерние элементы, соответствующие фильтру. Все дочерние элементы используются для оценки агрегированного состояния работоспособности сущности. Если фильтр не указан, возвращаются все записи.

Type:	HealthStateFilter
Accepted values:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationsHealthStateFilter

Этот параметр устарел. Укажите вместо него параметр ApplicationsFilter .

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeHealthPolicyMap

Указывает карту, определяющую максимальный процент неработоспособных приложений, разрешенных для каждого типа приложения. Типы приложений на этой карте оцениваются с использованием определенных процентных значений, а не глобального процента MaxPercentUnhealthyApplications .

Например, если некоторые приложения принадлежат к типу "критический", администратор кластера может добавить в сопоставление запись для этого типа и присвоить ему значение 0 % (т. е. не допускать каких-либо ошибок). Все остальные приложения можно оценить с помощью MaxPercentUnhealthyApplications равным 20 %, чтобы допускать некоторые сбои из тысяч экземпляров приложения.

Сопоставление политики работоспособности типа приложения используется только в том случае, если манифест кластера включает оценку работоспособности типа приложения с помощью записи конфигурации для HealthManager/EnableApplicationTypeHealthEvaluation.

Type:	ApplicationTypeHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsiderWarningAsError

Указывает, следует ли обрабатывать отчет о работоспособности предупреждения как ошибку во время оценки работоспособности. Это значение используется для оценки узлов и отчетов о работоспособности кластера.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EventsFilter

Указывает фильтр для коллекции HealthEvents, сообщаемой в кластере на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только те события, которые соответствуют заданному фильтру. Все события используются для оценки агрегированного состояния работоспособности кластера. Если фильтр не указан, возвращаются все записи.

Type:	HealthStateFilter
Accepted values:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EventsHealthStateFilter

Этот параметр устарел. Укажите вместо него параметр EventsFilter .

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeHealthStatistics

Указывает, должна ли статистика работоспособности быть включена в результат запроса. Если этот параметр указан, статистика работоспособности не возвращается как часть результата запроса. В противном случае результат запроса содержит статистику работоспособности кластера, содержащую сведения о количестве сущностей в состояниях "ОК", "Предупреждение" и "Ошибка".

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeSystemApplicationHealthStatistics

Указывает, должна ли статистика работоспособности включать сведения для приложения fabric:/System. Если этот параметр задан, число пакетов службы, службы, секции, реплики, развернутых приложений и развернутых пакетов служб включают системные сущности. Если значение не указано, статистика работоспособности возвращает количество состояний работоспособности только для пользовательских приложений.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentUnhealthyApplications

Указывает максимальный допустимый процент неработоспособных приложений. Если есть больше приложений с агрегированным состоянием работоспособности ошибки, чем допустимо, состояние работоспособности кластера будет ошибкой. Если этот параметр не указан, оценка работоспособности использует значение, указанное в манифесте кластера.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentUnhealthyNodes

Указывает максимальный допустимый процент неработоспособных узлов. Если имеется больше узлов с агрегированным состоянием работоспособности ошибки, чем допустимо, кластер оценивается как ошибка. Если этот параметр не указан, оценка работоспособности использует значение, указанное в манифесте кластера.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodesFilter

Указывает фильтр для дочерних элементов NodeHealthState на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только дочерние элементы, соответствующие фильтру. Все дочерние элементы используются для оценки агрегированного состояния работоспособности сущности. Если фильтр не указан, возвращаются все записи.

Type:	HealthStateFilter
Accepted values:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodesHealthStateFilter

Этот параметр устарел. Укажите вместо него параметр NodesFilter .

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeTypeHealthPolicyMap

Определяет карту с максимальным процентом неработоспособных узлов для определенных типов узлов.

Сопоставление политики работоспособности для типа узла используется при оценке работоспособности кластера для описания особых типов узлов. Типы узлов, включенные в карту, оцениваются в процентах, включенных в карту, а также с глобальными (см. system.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Узлы типов узлов, указанных на карте, также учитываются в глобальном пуле узлов; они являются независимыми проверками.

Type:	NodeTypeHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

None

Выходные данные

System.Object