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:

  • OK. A entidade atende às orientações sanitárias.
  • Erro. A entidade não atende às orientações sanitárias.
  • Atenção. A entidade atende às orientações sanitárias, mas passou por 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

Este comando consulta a integridade do aplicativo nomeado.

Exemplo 2: Obter a integridade de um aplicativo usando a política de integridade personalizada e filtros de retorno

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

Este comando consulta a integridade do aplicativo nomeado. O comando especifica valores para a diretiva de integridade e usa filtros para retornar somente eventos Error e crianças com estados de integridade Error ou Warning.

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

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

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

-ConsiderWarningAsError

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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. Apenas as crianças que correspondem ao filtro são devolvidas. Todas as crianças são usadas para avaliar o estado de saúde agregado da aplicação. Se não for especificado, todas as entradas serão retornadas.

Tipo:HealthStateFilter
Valores aceites:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeployedApplicationsHealthStateFilter

Este parâmetro foi preterido. Em vez disso, especifique o parâmetro DeployedApplicationsFilter.

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 bitwise 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, todas as entradas serão retornadas.

Tipo:HealthStateFilter
Valores aceites:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EventsHealthStateFilter

Este parâmetro foi preterido. Em vez disso, especifique o parâmetro EventsFilter.

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

-MaxPercentUnhealthyDeployedApplications

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

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

-MaxPercentUnhealthyPartitionsPerService

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

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

-MaxPercentUnhealthyReplicasPerPartition

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

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

-MaxPercentUnhealthyServices

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

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

-ServicesFilter

Especifica o filtro para ServiceHealthState crianças com base no estado de integridade. O valor pode ser obtido de membros ou operações bitwise em membros do HealthStateFilter. Apenas as crianças que correspondem ao filtro são devolvidas. Todas as crianças são usadas para avaliar o estado de saúde agregado da aplicação. Se não for especificado, todas as entradas serão retornadas.

Tipo:HealthStateFilter
Valores aceites:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicesHealthStateFilter

Este parâmetro foi preterido. Em vez disso, especifique o parâmetro ServicesFilter.

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

-TimeoutSec

Especifica o período de tempo limite, 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

Entradas

System.Uri

Saídas

System.Object