Send-ServiceFabricDeployedApplicationHealthReport
Отправляет отчет о работоспособности приложения Service Fabric, развернутого на узле.
Синтаксис
Send-ServiceFabricDeployedApplicationHealthReport
[-ApplicationName] <Uri>
[-NodeName] <String>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Описание
Командлет Send-ServiceFabricDeployedApplicationHealthReport отправляет отчет о работоспособности для события работоспособности в приложении Service Fabric, развернутом на узле.
Развернутое приложение уже должно существовать в хранилище работоспособности. Чтобы проверить, существует ли приложение на узле, используйте командлет Get-ServiceFabricDeployedApplicationHealth . Кроме того, можно использовать командлет Get-ServiceFabricApplicationHealth и проверить раздел DeployedApplicationHealthStates, чтобы найти узел.
Командлет отправляет отчет через интервал, указанный параметром HealthReportSendIntervalInSec командлета Connect-ServiceFabricCluster . Подключение к кластеру должно оставаться в активном режиме в течение этого времени. Команда вычисляется на клиенте без ссылки на выполнение в хранилище работоспособности. Отчет может не применяться в хранилище работоспособности, даже если команда возвращает успешное выполнение. Например, хранилище данных о работоспособности может отклонить отчет из-за недопустимого параметра, например устаревшего порядкового номера.
Чтобы узнать, применен ли отчет в хранилище работоспособности, используйте командлет Get-ServiceFabricDeployedApplicationHealth и убедитесь, что отчет отображается в разделе HealthEvents.
Чтобы управлять кластерами Service Fabric, запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster , а затем командлет Get-ServiceFabricClusterConnection .
Примеры
Пример 1. Отчет о работоспособности отчета об ошибках с бесконечным сроком жизни
PS C:\> Send-ServiceFabricDeployedApplicationHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -HealthProperty "Availability" -HealthState Error -SourceId "MyWatchdog"Эта команда отправляет отчет о работоспособности приложения с именем fabric:/MyApplication на узле с именем Node01 из источника MyWatchdog. Отчет о работоспособности содержит сведения о доступности свойства работоспособности в состоянии работоспособности с бесконечным сроком жизни.
Пример 2. Предупреждение отчета, допустимое для указанного срока жизни
PS C:\> Send-ServiceFabricDeployedApplicationHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01"-HealthProperty "Availability" -HealthState Warning -SourceId "MyWatchdog" -RemoveWhenExpired -TimeToLiveSec 10Эта команда отправляет отчет о работоспособности приложения с именем fabric:/MyApplication на узле с именем Node01 из источника MyWatchdog. Отчет о работоспособности содержит сведения о доступности свойства работоспособности в состоянии "Предупреждение" с сроком жизни 10 секунд. Отчет удаляется по истечении срока действия.
Параметры
-ApplicationName
Указывает универсальный код ресурса (URI) приложения Service Fabric. Командлет отправляет отчет о работоспособности для приложения с указанным URI.
| Тип: | Uri |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Description
Указывает доступные для чтения данные о условии, активировав отчет. Параметры SourceId, HealthProperty и HealthState полностью описывают отчет.
Максимальная длина строки для описания составляет 4096 символов. Если указанная строка длиннее, она автоматически усечена. При усечении описание заканчивается маркером "[Усечено]", чтобы указать пользователям, что усечение произошло. Общий размер строки составляет 4096 символов, поэтому сохраняются менее 4096 символов из исходной строки.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-HealthProperty
Указывает свойство отчета. Вместе с параметром SourceId это свойство однозначно идентифицирует отчет. Отчет переопределяет все предыдущие отчеты с теми же значениями для параметров SourceId и HealthProperty в той же сущности.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-HealthState
Указывает объект HealthState , представляющий сообщаемое состояние работоспособности.
| Тип: | HealthState |
| Допустимые значения: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Immediate
Указывает, следует ли немедленно отправлять отчет в хранилище работоспособности. Это полезно для критически важных отчетов, которые необходимо передать как можно быстрее. Если этот параметр не указан, отчет отправляется на основе параметров клиента работоспособности. Это значит, что он будет включен в пакет отчетов в соответствии со значением параметра HealthReportSendInterval. Рекомендуется применять именно такой вариант, так как он позволяет клиенту работоспособности оптимизировать отправку отчетов в хранилище данных о работоспособности, а также обработку отчетов о работоспособности. По умолчанию клиент структуры PowerShell устанавливает для HealthReportSentInterval значение 0, поэтому отчеты отправляются немедленно.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NodeName
Указывает имя узла Service Fabric. Командлет отправляет отчет о работоспособности приложения на заданном узле.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-RemoveWhenExpired
Указывает, что отчет удаляется из хранилища работоспособности по истечении срока действия. Если этот параметр не указан, сущность считается в состоянии ошибки, когда истекает срок жизни отчета. Отчеты, которые удаляются при истечении срока действия, можно использовать для условий, которые действительны только в течение определенного периода времени или для очистки отчетов из хранилища работоспособности.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SequenceNumber
Указывает порядковый номер, связанный с отчетом о работоспособности. Если значение для этого параметра не указано, порядковый номер задается автоматически. Если указать порядковый номер, это значение должно быть больше, чем любой предыдущий порядковый номер, заданный для одного и того же SourceId и HealthProperty, или отчет отклоняется из-за устаревания.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SourceId
Указывает идентификатор источника, который активировал отчет.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TimeToLiveSec
Указывает срок жизни отчета в секундах. По истечении срока жизни отчет удаляется из хранилища работоспособности, если указан параметр RemoveWhenExpired . В противном случае сущность вычисляется по ошибке из-за истечения срока действия отчета. Значение по умолчанию — Infinite.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Входные данные
System.Uri
System.String
System.Fabric.Health.HealthState
System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Management.Automation.SwitchParameter
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Выходные данные
System.Object