Поделиться через


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