Send-ServiceFabricClusterHealthReport

  • Referência
Módulo:
ServiceFabric

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

Sintaxe

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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-HealthState

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

Tipo:HealthState
Valores aceites:Invalid, Ok, Warning, Error, Unknown
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SourceId

Especifica o identificador da fonte que desencadeou o relatório.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo de ício, em segundos, para a operação.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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