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. Получение работоспособности кластера с помощью структуры:/Статистика системного приложения включена
PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -IncludeSystemApplicationHealthStatistics
Эта команда запрашивает работоспособность кластера. Статистика работоспособности, возвращаемая в рамках работоспособности кластера, содержит статистику структуры:/System application в дополнение к статистике пользовательских приложений.
Параметры
-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