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 и укажите параметры PartitionId и ReplicaOrInstanceId . Кроме того, можно использовать командлет Get-ServiceFabricPartitionHealth с параметром PartitionId , а затем проверить раздел ReplicaHealthStates, чтобы найти реплику.
Командлет отправляет отчет после интервала, указанного параметром HealthReportSendIntervalInSec командлета Connect-ServiceFabricCluster . Подключение к кластеру должно поддерживаться в течение этого времени.
Командлет может возвращать успешное выполнение, но отчет отправляется асинхронно, поэтому его обработка может завершиться ошибкой. Чтобы узнать, применен ли отчет в хранилище работоспособности, используйте командлет Get-ServiceFabricReplicaHealth и убедитесь, что отчет отображается в разделе событий работоспособности.
Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .
Примеры
Пример 1. Отчет о состоянии работоспособности реплики службы с отслеживанием состояния с бесконечным сроком жизни
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Эта команда отправляет отчет о работоспособности для указанной секции для указанной реплики службы с отслеживанием состояния из источника MyWatchDog. Отчет о работоспособности содержит сведения о свойстве работоспособности DiskUsage в состоянии работоспособности ошибки с бесконечным сроком жизни. Эта команда также содержит описание ошибки.
Пример 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. Отчет о работоспособности содержит сведения о ресурсах свойств работоспособности в состоянии работоспособности предупреждения из источника MyWatchdog с сроком жизни 10 секунд. Отчет, помеченный для удаления по истечении срока действия.
Параметры
-Description
Указывает удобочитаемые данные о условии, активировав отчет. Параметры SourceId, HealthProperty и HealthState полностью описывают отчет.
Максимальная длина строки для описания составляет 4096 символов. Если указанная строка длиннее, она автоматически усечена. При усечении описание заканчивается маркером "[Усечено]", чтобы указать пользователям, что усечение произошло. Общий размер строки составляет 4096 символов, поэтому сохраняются менее 4096 символов из исходной строки.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthProperty
Указывает свойство отчета. Вместе с параметром SourceId это свойство однозначно идентифицирует отчет.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthState
Указывает объект HealthState , представляющий сообщаемое состояние работоспособности.
| Type: | HealthState |
| Accepted values: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Immediate
Указывает, следует ли немедленно отправлять отчет в хранилище работоспособности. Это полезно для критически важных отчетов, которые необходимо передать как можно быстрее. Если он не указан, отчет отправляется на основе параметров клиента работоспособности. Это значит, что он будет включен в пакет отчетов в соответствии со значением параметра HealthReportSendInterval. Рекомендуется применять именно такой вариант, так как он позволяет клиенту работоспособности оптимизировать отправку отчетов в хранилище данных о работоспособности, а также обработку отчетов о работоспособности. По умолчанию клиент структуры PowerShell устанавливает для HealthReportSentInterval значение 0, поэтому отчеты отправляются немедленно.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Указывает идентификатор экземпляра службы без отслеживания состояния. Идентификатор экземпляра действителен только для служб без отслеживания состояния. Отчет для реплики с отслеживанием состояния, которая использует InstanceId вместо ReplicaId , принимается клиентом работоспособности, но отклоняется хранилищем работоспособности.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PartitionId
Указывает идентификатор секции Service Fabric.
| Type: | Guid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RemoveWhenExpired
Указывает, что отчет удаляется из хранилища работоспособности по истечении срока его действия. Если этот параметр не указан, сущность считается в состоянии ошибки, когда срок жизни отчета истекает. Отчеты, удаленные при истечении срока действия, можно использовать для условий, действительных только в течение определенного периода времени или для очистки отчетов из хранилища работоспособности.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReplicaId
Указывает идентификатор реплики службы с отслеживанием состояния. Идентификатор реплики действителен только для служб с отслеживанием состояния. Отчет для экземпляра без отслеживания состояния, использующего ReplicaId вместо InstaceId , принимается клиентом работоспособности, но отклоняется хранилищем работоспособности.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SequenceNumber
Указывает порядковый номер, связанный с отчетом о работоспособности. Если значение этого параметра не указано, порядковый номер задается автоматически. Если указать порядковый номер, это значение должно быть выше, чем любой предыдущий порядковый номер, заданный в одной сущности для одного и того же SourceId и HealthProperty, или отчет отклоняется из-за устаревания.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceId
Указывает идентификатор источника, который активировал отчет.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeToLiveSec
Указывает срок жизни отчета (TTL) в секундах. По истечении срока жизни отчет удаляется из хранилища работоспособности, если указан параметр RemoveWhenExpired . В противном случае сущность вычисляется по ошибке из-за просроченного отчета. Значение по умолчанию — Infinite.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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