Compartilhar via

Send-ServiceFabricClusterHealthReport

  • Referência
Módulo:
ServiceFabric

Envia um relatório de integridade sobre um cluster do Service Fabric.

Sintaxe

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

Description

O cmdlet Send-ServiceFabricClusterHealthReport envia um relatório de integridade em um cluster do Service Fabric.

O cmdlet envia o relatório após um intervalo especificado pelo parâmetro HealthReportSendIntervalInSec do cmdlet Connect-ServiceFabricCluster . A conexão de cluster deve ser mantida viva durante esse tempo. O comando é avaliado no cliente sem referência à execução no repositório de integridade. O relatório pode não ser aplicado no repositório de integridade, mesmo que o comando retorne êxito. Por exemplo, o repositório de integridade pode rejeitar o relatório devido a um parâmetro inválido, como um número de sequência obsoleto.

Para ver se o relatório foi aplicado no repositório de integridade, use o cmdlet Get-ServiceFabricClusterHealth e verifique se o relatório aparece na seção HealthEvents.

Para gerenciar clusters do Service Fabric, comece Windows PowerShell usando a opção Executar como administrador. 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 e, em seguida, o cmdlet Get-ServiceFabricClusterConnection .

Exemplos

Exemplo 1: relatório de integridade de erro de relatório com TTL infinito

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

Esse comando envia um relatório de integridade no cluster do MyWatchdog de origem. O relatório de integridade contém informações sobre a disponibilidade da propriedade de integridade em um estado de integridade 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

Esse comando envia um relatório de integridade no cluster do MyWatchDog de origem. O relatório de integridade contém informações sobre a propriedade de integridade EnoughNodes em um estado de integridade de aviso. O relatório permanece no repositório de integridade por 10 segundos, após o qual é removido automaticamente. O comando especifica o parâmetro SequenceNumber . O número da sequência deve ser maior do que qualquer número de sequência relatado anteriormente para a mesma SourceId e Property, ou o relatório é rejeitado devido à desatualizaçã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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HealthProperty

Especifica a propriedade do relatório. Junto com o parâmetro SourceId , essa propriedade identifica exclusivamente o relatório. O relatório substitui todos os relatórios anteriores com os mesmos valores para os parâmetros SourceId e HealthProperty na mesma entidade.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HealthState

Especifica um objeto HealthState que representa o estado de integridade relatado.

Tipo:HealthState
Valores aceitos:Invalid, Ok, Warning, Error, Unknown
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 da malha do Powershell define HealthReportSentInterval como 0, portanto, os relatórios são enviados imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 de erro quando o tempo de vida útil 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 Health Store.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SequenceNumber

Especifica o número da 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 no mesmo SourceId e HealthProperty, ou o relatório será rejeitado devido à desatualização.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SourceId

Especifica o identificador da origem que disparou o relatório.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TimeoutSec

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeToLiveSec

Especifica o TTL (Time to Live) do relatório em segundos. Quando o 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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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