Get-ServiceFabricClusterHealth
Возвращает сведения о работоспособности для кластера 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 , включающий пользовательские политики работоспособности для некоторых или всех приложений. Если этот параметр не указан, оценка работоспособности использует политики работоспособности приложения, определенные в манифесте приложения или политике работоспособности по умолчанию.
Тип: | ApplicationHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApplicationsFilter
Указывает фильтр для дочерних элементов ApplicationHealthState на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только дочерние элементы, соответствующие фильтру. Все дочерние элементы используются для оценки агрегированного состояния работоспособности сущности. Если фильтр не указан, возвращаются все записи.
Тип: | HealthStateFilter |
Допустимые значения: | Default, None, Ok, Warning, Error, All |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApplicationsHealthStateFilter
Этот параметр устарел. Укажите вместо него параметр ApplicationsFilter .
Тип: | Int64 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApplicationTypeHealthPolicyMap
Указывает карту, определяющую максимальный процент неработоспособных приложений, разрешенных для каждого типа приложения. Типы приложений на этой карте оцениваются с использованием определенных процентных значений, а не глобального процента MaxPercentUnhealthyApplications .
Например, если некоторые приложения принадлежат к типу "критический", администратор кластера может добавить в сопоставление запись для этого типа и присвоить ему значение 0 % (т. е. не допускать каких-либо ошибок). Все остальные приложения можно оценить с помощью MaxPercentUnhealthyApplications равным 20 %, чтобы допускать некоторые сбои из тысяч экземпляров приложения.
Сопоставление политики работоспособности типа приложения используется только в том случае, если манифест кластера включает оценку работоспособности типа приложения с помощью записи конфигурации для HealthManager/EnableApplicationTypeHealthEvaluation.
Тип: | ApplicationTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ConsiderWarningAsError
Указывает, следует ли обрабатывать отчет о работоспособности предупреждения как ошибку во время оценки работоспособности. Это значение используется для оценки узлов и отчетов о работоспособности кластера.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EventsFilter
Указывает фильтр для коллекции HealthEvents, сообщаемой в кластере на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только те события, которые соответствуют заданному фильтру. Все события используются для оценки агрегированного состояния работоспособности кластера. Если фильтр не указан, возвращаются все записи.
Тип: | HealthStateFilter |
Допустимые значения: | Default, None, Ok, Warning, Error, All |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EventsHealthStateFilter
Этот параметр устарел. Укажите вместо него параметр EventsFilter .
Тип: | Int64 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ExcludeHealthStatistics
Указывает, должна ли статистика работоспособности быть включена в результат запроса. Если этот параметр указан, статистика работоспособности не возвращается как часть результата запроса. В противном случае результат запроса содержит статистику работоспособности кластера, содержащую сведения о количестве сущностей в состояниях "ОК", "Предупреждение" и "Ошибка".
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-IncludeSystemApplicationHealthStatistics
Указывает, должна ли статистика работоспособности включать сведения для приложения fabric:/System. Если этот параметр задан, число пакетов службы, службы, секции, реплики, развернутых приложений и развернутых пакетов служб включают системные сущности. Если значение не указано, статистика работоспособности возвращает количество состояний работоспособности только для пользовательских приложений.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentUnhealthyApplications
Указывает максимальный допустимый процент неработоспособных приложений. Если есть больше приложений с агрегированным состоянием работоспособности ошибки, чем допустимо, состояние работоспособности кластера будет ошибкой. Если этот параметр не указан, оценка работоспособности использует значение, указанное в манифесте кластера.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentUnhealthyNodes
Указывает максимальный допустимый процент неработоспособных узлов. Если имеется больше узлов с агрегированным состоянием работоспособности ошибки, чем допустимо, кластер оценивается как ошибка. Если этот параметр не указан, оценка работоспособности использует значение, указанное в манифесте кластера.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NodesFilter
Указывает фильтр для дочерних элементов NodeHealthState на основе состояния работоспособности. Значение можно получить из членов или побитовых операций с элементами HealthStateFilter. Возвращаются только дочерние элементы, соответствующие фильтру. Все дочерние элементы используются для оценки агрегированного состояния работоспособности сущности. Если фильтр не указан, возвращаются все записи.
Тип: | HealthStateFilter |
Допустимые значения: | Default, None, Ok, Warning, Error, All |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NodesHealthStateFilter
Этот параметр устарел. Укажите вместо него параметр NodesFilter .
Тип: | Int64 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NodeTypeHealthPolicyMap
Определяет карту с максимальным процентом неработоспособных узлов для определенных типов узлов.
Сопоставление политики работоспособности для типа узла используется при оценке работоспособности кластера для описания особых типов узлов. Типы узлов, включенные в карту, оцениваются в процентах, включенных в карту, а также с глобальными (см. system.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Узлы типов узлов, указанных на карте, также учитываются в глобальном пуле узлов; они являются независимыми проверками.
Тип: | NodeTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
System.Object