Send-ServiceFabricApplicationHealthReport
Отправляет отчет о работоспособности приложения Service Fabric.
Синтаксис
Send-ServiceFabricApplicationHealthReport
[-ApplicationName] <Uri>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Описание
Командлет send-ServiceFabricApplicationHealthReport отправляет отчет о работоспособности приложения Service Fabric.
Приложение должно уже существовать в хранилище работоспособности. Чтобы проверить, существует ли она, используйте командлет Get-ServiceFabricApplicationHealth .
Командлет отправляет отчет после интервала, указанного параметром HealthReportSendIntervalInSec командлета Connect-ServiceFabricCluster. Подключение к кластеру должно оставаться в живых в течение этого времени. Этот командлет отправляет отчет асинхронно, поэтому этот командлет может отправлять значение успешного выполнения даже при сбое обработки. Например, если сущность удаляется или из-за недопустимого параметра, например устаревший порядковый номер, хранилище работоспособности может отклонить отчет.
Чтобы узнать, был ли отчет применен в хранилище работоспособности, используйте командлет Get-ServiceFabricApplicationHealth и убедитесь, что отчет отображается в разделе HealthEvents.
Чтобы управлять кластерами Service Fabric, запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster, а затем командлет Get-ServiceFabricClusterConnection.
Примеры
Пример 1. Отчет о работоспособности отчета об ошибке с бесконечным сроком жизни
PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState ErrorЭта команда отправляет отчет о работоспособности приложения с именем fabric:/MyApplication из источника MyWatchDog. Отчет о работоспособности содержит сведения о свойстве работоспособности доступности в состоянии работоспособности ошибки с бесконечным TTL.
Пример 2. Предупреждение отчета, допустимое для указанного срока жизни
PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpiredЭта команда отправляет отчет о работоспособности приложения с именем fabric:/MyApplication из источника 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 это свойство однозначно идентифицирует отчет. Отчет переопределяет все предыдущие отчеты с теми же значениями для 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 |
-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
Указывает время жизни отчета в секундах. По истечении срока действия TTL отчет удаляется из хранилища работоспособности, если указан параметр RemoveWhenExpired. В противном случае сущность оценивается по ошибке из-за истечения срока действия отчета. Значение по умолчанию — Infinite.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Входные данные
System.Uri
System.Fabric.Health.HealthState
System.String
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