Send-ServiceFabricReplicaHealthReport
Отправляет отчет о работоспособности в реплике Service Fabric.
Синтаксис
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Описание
Командлет send-ServiceFabricReplicaHealthReport отправляет отчет о работоспособности экземпляра службы Service Fabric без отслеживания состояния или реплики службы с отслеживанием состояния.
Экземпляр службы без отслеживания состояния или реплика службы с отслеживанием состояния уже должна существовать в хранилище работоспособности.
Чтобы проверить, существует ли она, используйте командлет Get-ServiceFabricReplicaHealth
Командлет отправляет отчет после интервала, указанного параметром HealthReportSendIntervalInSec командлета Connect-ServiceFabricCluster. Подключение к кластеру должно оставаться в живых в течение этого времени.
Командлет может возвращать успешное выполнение, но отчет отправляется асинхронно, поэтому его обработка может завершиться ошибкой. Чтобы узнать, был ли отчет применен в хранилище работоспособности, используйте командлет Get-ServiceFabricReplicaHealth и убедитесь, что отчет отображается в разделе событий работоспособности.
Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster.
Примеры
Пример 1. Отчет о работоспособности отчета об ошибке в реплике службы с отслеживанием состояния с бесконечным TTL
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Эта команда отправляет отчет о работоспособности указанной секции для указанной реплики службы с отслеживанием состояния из источника MyWatchDog. Отчет о работоспособности содержит сведения о свойстве работоспособности DiskUsage в состоянии работоспособности ошибки с бесконечным TTL. Эта команда также содержит описание ошибки.
Пример 2. Отчет о работоспособности предупреждения о работоспособности отчета в экземпляре службы без отслеживания состояния, допустимом для указанного срока жизни, и удалите его после истечения срока действия.
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpiredЭта команда отправляет отчет о работоспособности для указанного экземпляра службы без отслеживания состояния из источника MyWatchDog. Отчет о работоспособности содержит сведения о свойстве работоспособности Resources в состоянии работоспособности предупреждения из источника MyWatchdog с 10 секунд TTL. Отчет, помеченный для удаления по истечении срока действия.
Параметры
-Description
Указывает удобочитаемую пользователем информацию о условии, которое активировало отчет. SourceId, HealthPropertyи параметры HealthState полностью описывают отчет.
Максимальная длина строки описания — 4096 символов. Если указанная строка длиннее, она автоматически усечена. При усечении описание заканчивается маркером "[Усечено], чтобы указать пользователям, что усечение произошло. Общий размер строки составляет 4096 символов, поэтому хранятся менее 4096 символов из исходной строки.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-HealthProperty
Указывает свойство отчета. Вместе с параметром SourceId SourceId это свойство однозначно идентифицирует отчет.
| Тип: | 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 |
-InstanceId
Указывает идентификатор экземпляра службы без отслеживания состояния. Идентификатор экземпляра действителен только для служб без отслеживания состояния. Отчет для реплики с отслеживанием состояния, которая использует InstanceId вместо ReplicaId принимается клиентом работоспособности, но отклоняется хранилищем работоспособности.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PartitionId
Указывает идентификатор секции Service Fabric.
| Тип: | Guid |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-RemoveWhenExpired
Указывает, что отчет удаляется из хранилища работоспособности при истечении срока его действия. Если этот параметр не указан, сущность считается в состоянии ошибки при истечении срока действия отчета. Отчеты, которые удаляются при истечении срока действия, можно использовать только для условий, допустимых только в течение определенного периода времени или для очистки отчетов из хранилища работоспособности.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ReplicaId
Указывает идентификатор реплики службы с отслеживанием состояния. Идентификатор реплики действителен только для служб с отслеживанием состояния. Отчет для экземпляра без отслеживания состояния, использующего ReplicaId вместо InstaceId, принимается клиентом работоспособности, но отклоняется хранилищем работоспособности.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | 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.Guid
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