Send-ServiceFabricReplicaHealthReport
Envia um relatório de integridade em uma réplica do Service Fabric.
Syntax
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>] Description
O cmdlet Send-ServiceFabricReplicaHealthReport envia um relatório de integridade em uma instância de serviço sem estado do Service Fabric ou em uma réplica de serviço com estado.
A instância de serviço sem estado ou a réplica de serviço com estado já devem existir no repositório de integridade. Para verificar se ele existe, use o cmdlet Get-ServiceFabricReplicaHealth e especifique os parâmetros PartitionId e ReplicaOrInstanceId . Como alternativa, você pode usar o cmdlet Get-ServiceFabricPartitionHealth com o parâmetro PartitionId e, em seguida, verificar a seção ReplicaHealthStates para localizar a réplica.
O cmdlet envia o relatório após um intervalo especificado pelo parâmetro HealthReportSendIntervalInSec do cmdlet Connect-ServiceFabricCluster . A conexão do cluster deve ser mantida ativa durante esse tempo.
O cmdlet pode retornar êxito, mas o relatório é enviado de forma assíncrona, portanto, seu processamento pode falhar. Para ver se o relatório foi aplicado no repositório de integridade, use o cmdlet Get-ServiceFabricReplicaHealth e verifique se o relatório aparece na seção de eventos de integridade.
Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster .
Exemplos
Exemplo 1: relatório de integridade de erro de relatório em uma réplica de serviço com estado com TTL infinito
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Esse comando envia um relatório de integridade para a partição especificada para a réplica de serviço com estado especificada do MyWatchDog de origem. O relatório de integridade contém informações sobre a propriedade de integridade DiskUsage em um estado de integridade de erro, com TTL infinito. Esse comando também fornece uma descrição do erro.
Exemplo 2: relatório de integridade de aviso de relatório em uma instância de serviço sem estado válida para o TTL especificado e remova-o quando expirar
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 -RemoveWhenExpiredEsse comando envia um relatório de integridade para a instância de serviço sem estado especificada do MyWatchDog de origem. O relatório de integridade contém informações sobre a propriedade de integridade Recursos em um estado de integridade de aviso do MyWatchdog de origem, com TTL de 10 segundos. O relatório marcado para remoção na expiração.
Parâmetros
-Description
Especifica informações legíveis humanas sobre a condição que disparou o relatório. Os parâmetros SourceId, HealthProperty e HealthState descrevem totalmente o relatório.
O tamanho máximo da cadeia de caracteres da descrição é de 4.096 caracteres. Se a cadeia de caracteres fornecida for mais longa, ela será truncada automaticamente. Quando truncada, a descrição termina com um marcador "[Truncado]", para indicar aos usuários que ocorreu truncamento. O tamanho total da cadeia de caracteres é de 4.096 caracteres, portanto, menos de 4.096 caracteres da cadeia de caracteres original são mantidos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthProperty
Especifica a propriedade do relatório. Junto com o parâmetro SourceId , essa propriedade identifica exclusivamente o relatório.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthState
Especifica um objeto HealthState que representa o estado de integridade relatado.
| 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
Especifica se o relatório deve ser enviado imediatamente ao repositório de integridade. Isso é útil para relatórios importantes que precisam ser enviados assim que possível. Se não for especificado, o relatório será enviado com base nas configurações do cliente de integridade. Portanto, ele será agrupado de acordo com a configuração de HealthReportSendInterval. Esta é a configuração recomendada, pois ela permite que o cliente de integridade otimize a integridade relatando mensagens para o repositório de integridade, bem como para o processamento de relatório de integridade. Por padrão, o cliente de malha do Powershell define HealthReportSentInterval como 0, portanto, os relatórios são enviados imediatamente.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Especifica a ID da instância de serviço sem estado. A ID da instância só é válida para serviços sem estado. Um relatório para uma réplica com estado que usa InstanceId em vez de ReplicaId é aceito pelo cliente de integridade, mas é rejeitado pelo repositório de integridade.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PartitionId
Especifica a ID de uma partição do Service Fabric.
| Type: | Guid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RemoveWhenExpired
Indica que o relatório é removido do repositório de integridade quando expira. Se você não especificar esse parâmetro, a entidade será considerada no estado erro quando a hora de vida do relatório expirar. Os relatórios que são removidos quando expirados podem ser usados para condições válidas apenas por um período de tempo ou para limpar relatórios do Repositório de Integridade.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReplicaId
Especifica a ID da réplica de serviço com estado. A ID da réplica só é válida para serviços com estado. Um relatório para uma instância sem estado que usa ReplicaId em vez de InstaceId é aceito pelo cliente de integridade, mas é rejeitado pelo repositório de integridade.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SequenceNumber
Especifica o número de sequência associado ao relatório de integridade. Se você não especificar um valor para esse parâmetro, o número da sequência será definido automaticamente. Se você especificar um número de sequência, esse valor deverá ser maior do que qualquer número de sequência anterior definido na mesma entidade para o mesmo SourceId e HealthProperty, ou o relatório será rejeitado devido à desatualização.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceId
Especifica o identificador da origem que disparou o relatório.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeToLiveSec
Especifica a TTL (Vida Útil) do relatório em segundos. Quando a TTL expira, o relatório é removido do repositório de integridade se o parâmetro RemoveWhenExpired for especificado. Caso contrário, a entidade será avaliada em Erro devido ao relatório expirado. O valor padrão é Infinite.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
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]]
Saídas
System.Object