Compartilhar via


Get-ServiceFabricApplicationHealth

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

Sintaxe

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:

  • OKEY. 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 os filtros de retorno

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 de 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.

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

-ConsiderWarningAsError

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

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

-DeployedApplicationsFilter

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

Tipo:HealthStateFilter
Valores aceitos:Default, None, Ok, Warning, Error, All
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeployedApplicationsHealthStateFilter

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 de 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, todas as entradas serão retornadas.

Tipo:HealthStateFilter
Valores aceitos:Default, None, Ok, Warning, Error, All
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EventsHealthStateFilter

Esse parâmetro foi preterido. Especifique o parâmetro EventsFilter em vez disso.

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

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

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

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

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

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

-ServicesFilter

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

Tipo:HealthStateFilter
Valores aceitos:Default, None, Ok, Warning, Error, All
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServicesHealthStateFilter

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

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

Entradas

System.Uri

Saídas

System.Object