Send-ServiceFabricDeployedServicePackageHealthReport
Envia um relatório de saúde sobre um pacote de serviço implantado em Tecido de Serviço.
Syntax
Send-ServiceFabricDeployedServicePackageHealthReport
[-ApplicationName] <Uri>
[-ServiceManifestName] <String>
[-NodeName] <String>
[[-ServicePackageActivationId] <String>]
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
O pacote de serviços Send-ServiceFabricDeployedServicePackageHealthReport envia um relatório de saúde sobre um pacote de serviço implantado em Tecido de Serviço.
O pacote de serviços implantado já deve existir na loja de saúde. Para verificar se o serviço existe, utilize o cmdlet Get-ServiceFabricDeployedServicePackageHealth . Especifique o nome da aplicação, o nome do pacote de serviço e o nome do nó. Em alternativa, pode utilizar o cmdlet Get-ServiceFabricDeployedApplicationHealth . Especifique o nome da aplicação e o nome do nó e verifique a secção de estados de saúde do pacote de serviço implantado para encontrar o pacote 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 get-ServiceFabricDeployedServicePackageHealth cmdlet 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-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"
Este comando envia um relatório de saúde sobre um pacote de serviço implantado para a aplicação chamada tecido:/MyApplication no nó chamado Node01 para o manifesto de serviço chamado MyServiceManifest. O relatório de saúde contém informações sobre a propriedade sanitária Memória em um estado de saúde de Erro da fonte MyWatchdog, com infinita TTL. A descrição não é dada e o número da sequência é definido automaticamente.
Exemplo 2: Aviso de relatório válido para TTL especificado e removê-lo quando expirar
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10
Este comando envia um relatório de saúde sobre um pacote de serviço implantado para a aplicação chamada tecido:/MyApplication para o manifesto de serviço chamado MyServiceManifest no nó chamado Node01. O relatório de saúde contém informações sobre a propriedade de saúde CustomSetup em um estado de saúde de aviso da fonte MyWatchdog, com 10 segundos TTL. Após o termo do relatório, é removido da loja de saúde e deixará de ter impacto na avaliação da saúde. Este comando também dá uma descrição do aviso.
Parâmetros
-ApplicationName
Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet envia um relatório de saúde para a aplicação que tem o URI que você especifica.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Especifica um objeto do Estado da Saúde que representa o estado de saúde reportado.
Type: | HealthState |
Accepted values: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeName
Especifica o nome de um nó de tecido de serviço. O cmdlet envia um relatório de saúde para um pacote de serviço implantado no nó que especifica.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceManifestName
Especifica o nome de um manifesto de serviço de serviço de Tecido de Serviço. Juntamente com o ApplicationName e o NodeName, este valor identifica exclusivamente a entidade de saúde do pacote de serviços implantado.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
O id de ativação do ServicePackage implantado. Isto pode ser obtido utilizando a consulta Get-ServiceFabricDeployedServicePackage.
Se o ServicePackageActivationMode especificado no momento da criação do serviço (utilizando New-ServiceFabricService
) for SharedProcess (ou se não for especificado, caso em que predefini ao SharedProcess), então o valor do ServicePackageActivationId é sempre uma corda vazia e não precisa de ser especificado. Para saber mais sobre o id de ativação do pacote de serviço, consulte [Modelo de Hospedagem de Tecido de Serviço][1].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Especifica o identificador da fonte que desencadeou o relatório.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo de ício, em segundos, para a operação.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
System.Uri
System.String
System.Fabric.Health.HealthState
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