Share via

Send-ServiceFabricClusterHealthReport

  • Referência
Módulo:
ServiceFabric

Envia um relatório de saúde sobre um aglomerado de tecidos de serviço.

Syntax

Send-ServiceFabricClusterHealthReport
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

O Departamento de Saúde Do Grupo de Correios enviará um relatório de saúde sobre um cluster de tecido de serviço.

O cmdlet envia o relatório após um intervalo especificado pelo parâmetro HealthReportSendIntervalInSec do cmdlet Connect-ServiceFabricCluster . A ligação do aglomerado deve ser mantida viva durante este tempo. O comando é avaliado no cliente sem referência a correr na loja de saúde. O relatório não pode ser aplicado na loja de saúde mesmo que o comando retorne o sucesso. Por exemplo, a loja de saúde pode rejeitar o relatório devido a um parâmetro inválido, como um número de sequência velha.

Para ver se o relatório foi aplicado na loja de saúde, utilize o cmdlet Get-ServiceFabricClusterHealth e verifique se o relatório aparece na secção HealthEvents.

Para gerir os clusters de Tecido de Serviço, comece Windows PowerShell utilizando a opção Executar como administrador. Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster e, em seguida, o cmdlet Get-ServiceFabricClusterConnection .

Exemplos

Exemplo 1: Relatório de saúde de erro de relatório com TTL infinito

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Este comando envia um relatório de saúde sobre o cluster da fonte MyWatchdog. O relatório de saúde contém informações sobre a propriedade sanitária Disponibilidade em estado de saúde Erro, com TTL infinito.

Exemplo 2: Aviso de relatório válido para TTL especificado

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344

Este comando envia um relatório de saúde sobre o cluster a partir da fonte MyWatchDog. O relatório de saúde contém informações sobre a propriedade sanitária EnoughNodes em um estado de saúde de aviso. O relatório permanece na loja de saúde durante 10 segundos, após o qual é automaticamente removido. O comando especifica o parâmetro SequenceNumber . O número de sequência deve ser superior a qualquer número de sequências previamente reportado para o mesmo SourceId e Property, ou o relatório é rejeitado devido à estagnação.

Parâmetros

-Description

Especifica informações legíveis humanas sobre a condição que desencadeou o relatório. Os parâmetros SourceId, HealthProperty e HealthState descrevem totalmente o relatório.

O comprimento máximo da corda para a descrição é de 4096 caracteres. Se a corda fornecida for maior, é automaticamente truncada. Quando truncada, a descrição termina com um marcador, "[Truncated]", para indicar aos utilizadores que a truncação ocorreu. O tamanho total da corda é de 4096 caracteres, pelo que são mantidos menos de 4096 caracteres da corda original.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HealthProperty

Especifica a propriedade do relatório. Juntamente com o parâmetro SourceId , esta propriedade identifica exclusivamente o relatório. O relatório sobrepõe-se a quaisquer relatórios anteriores com os mesmos valores para os parâmetros SourceId e HealthProperty sobre a mesma entidade.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HealthState

Especifica um objeto do Estado da Saúde que representa o estado de saúde reportado.

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 para a loja de saúde. Isto é útil para relatórios críticos que devem ser enviados o mais rapidamente possível. Se não for especificado, o relatório é enviado com base nas definições do cliente de saúde. Portanto, será loteado de acordo com a configuração HealthReportSendInterval. Esta é a configuração recomendada porque permite ao cliente de saúde otimizar as mensagens de relato de saúde para a loja de saúde, bem como o processamento de relatórios de saúde. Por predefinição, o cliente de tecido Powershell define HealthReportSentInterval a 0, pelo que os relatórios são enviados imediatamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveWhenExpired

Indica que o relatório é removido da loja de saúde quando expira. Se não especificar este parâmetro, a entidade é considerada no Estado de Erro quando a hora de entrada em vigor expirar. Os relatórios que são removidos quando expirados podem ser utilizados para condições que só são válidas por um período de tempo ou para limpar relatórios da Health Store.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SequenceNumber

Especifica o número de sequência associado ao relatório de saúde. Se não especificar um valor para este parâmetro, o número de sequência é definido automaticamente. Se especificar um número de sequência, esse valor deve ser superior a qualquer número de sequência anterior definido na mesma FonteId e HealthProperty, ou o relatório é rejeitado devido à estagnação.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceId

Especifica o identificador da fonte que desencadeou 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 de ício, 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 Hora de Viver (TTL) do relatório em segundos. Quando o TTL expira, o relatório é removido da loja de saúde se o parâmetro RemoveWhenExpired for especificado. Caso contrário, a entidade é avaliada no Error por causa do relatório caducado. O valor predefinido é Infinito.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

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