Share via


Get-ServiceFabricApplicationHealth

Obtém a integridade de um aplicativo do Service Fabric.

Syntax

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

O cmdlet Get-ServiceFabricApplicationHealth obtém o estado de integridade de um aplicativo do Service Fabric. O Service Fabric relata os seguintes estados de integridade:

  • OK. A entidade atende às diretrizes de integridade.
  • Erro. A entidade não atende às diretrizes de integridade.
  • Aviso. A entidade atende às diretrizes de integridade, mas teve algum problema.

Se a entidade não for encontrada no repositório de integridade, esse cmdlet retornará um erro.

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: Obter a integridade de um aplicativo

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

Esse comando consulta a integridade do aplicativo nomeado.

Exemplo 2: obter a integridade de um aplicativo usando a política de integridade personalizada e retornar filtros

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

Esse comando consulta a integridade do aplicativo nomeado. O comando especifica valores para a política de integridade e usa filtros para retornar somente eventos de erro e filhos com estados de integridade erro ou aviso.

Exemplo 3: obter a integridade de um aplicativo e excluir as estatísticas de integridade

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

Esse comando consulta a integridade do aplicativo nomeado. A integridade do aplicativo retornado não inclui as estatísticas de integridade.

Parâmetros

-ApplicationName

Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet obtém informações de integridade para o aplicativo que tem o URI especificado.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConsiderWarningAsError

Indica se esse cmdlet considera um relatório de integridade de aviso como um erro durante a avaliação de integridade.

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

-DeployedApplicationsFilter

Especifica o filtro para crianças DeployedApplicationHealthState com base no estado de integridade. O valor é obtido de membros ou operações bit a bit em membros do HealthStateFilter. Somente os filhos que correspondem ao filtro são retornados. Todas as crianças são usadas para avaliar o estado de integridade agregado do aplicativo. Se não for especificado, retorna todas as entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployedApplicationsHealthStateFilter

Esse parâmetro foi preterido. Especifique o parâmetro DeployedApplicationsFilter .

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

-EventsFilter

Especifica o filtro para a coleção de objetos HealthEvent relatados no aplicativo com base no estado de integridade. O valor pode ser obtido de membros ou operações bit a bit em membros do HealthStateFilter. Somente os eventos que correspondem ao filtro são retornados. Todos os eventos são usados para avaliar o estado de integridade agregado do aplicativo. Se não for especificado, retorna todas as entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsHealthStateFilter

Esse parâmetro foi preterido. Especifique o parâmetro EventsFilter .

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

-ExcludeHealthStatistics

Indica se as estatísticas de integridade devem ser incluídas no resultado da consulta. Se especificado, as estatísticas de integridade não serão retornadas como parte do resultado da consulta. Caso contrário, o resultado da consulta inclui as estatísticas de integridade do aplicativo, que contêm informações sobre quantos serviços, partições e réplicas desse aplicativo estão nos estados Ok, Aviso e Erro.

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

-MaxPercentUnhealthyDeployedApplications

Especifica o percentual máximo tolerado de instâncias de aplicativo não íntegras implantadas nos nós no cluster. Se houver mais aplicativos implantados com erro de estado de integridade do que tolerado, o estado de integridade do aplicativo será um erro. Se você não especificar esse parâmetro, a avaliação de integridade usará o valor fornecido no manifesto do aplicativo.

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

-MaxPercentUnhealthyPartitionsPerService

Especifica o percentual máximo tolerado de partições de serviço não íntegras. Se houver mais partições com erro de estado de integridade do que tolerado, o estado de integridade dos serviços será um erro. Se você não especificar esse parâmetro, a avaliação de integridade usará o valor fornecido no manifesto do aplicativo.

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

-MaxPercentUnhealthyReplicasPerPartition

Especifica o percentual máximo tolerado de réplicas de partição não íntegras. Se houver mais réplicas com erro de estado de integridade do que tolerado, o estado de integridade da partição será um erro. Se você não especificar esse parâmetro, a avaliação de integridade usará o valor fornecido no manifesto do aplicativo.

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

-MaxPercentUnhealthyServices

Especifica o percentual máximo tolerado de serviços não íntegros em um aplicativo. Se houver mais serviços com erro de estado de integridade do que tolerado, o estado de integridade do aplicativo será um erro. Se você não especificar esse parâmetro, a avaliação de integridade usará o valor fornecido no manifesto do aplicativo.

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

-ServicesFilter

Especifica o filtro para crianças ServiceHealthState com base no estado de integridade. O valor pode ser obtido de membros ou operações bit a bit em membros do HealthStateFilter. Somente os filhos que correspondem ao filtro são retornados. Todos os filhos são usados para avaliar o estado de integridade agregado do aplicativo. Se não for especificado, retorna todas as entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicesHealthStateFilter

Esse parâmetro foi preterido. Especifique o parâmetro ServicesFilter .

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

Entradas

System.Uri

Saídas

System.Object