Send-ServiceFabricDeployedServicePackageHealthReport
Envia um relatório de integridade em um pacote de serviço implantado pelo Service Fabric.
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 cmdlet Send-ServiceFabricDeployedServicePackageHealthReport envia um relatório de integridade em um pacote de serviço implantado pelo Service Fabric.
O pacote de serviço implantado já deve existir no repositório de integridade. Para verificar se o serviço existe, use o cmdlet Get-ServiceFabricDeployedServicePackageHealth . Especifique o nome do aplicativo, o nome do pacote de serviço e o nome do nó. Como alternativa, você pode usar o cmdlet Get-ServiceFabricDeployedApplicationHealth . Especifique o nome do aplicativo e o nome do nó e verifique a seção de estados de integridade do pacote de serviço implantado para localizar 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 conexão do cluster deve ser mantida ativa 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-ServiceFabricDeployedServicePackageHealth 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-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"
Esse comando envia um relatório de integridade em um pacote de serviço implantado para o aplicativo chamado fabric:/MyApplication no nó chamado Node01 para o manifesto do serviço chamado MyServiceManifest. O relatório de integridade contém informações sobre a propriedade de integridade Memória em um estado de integridade de erro do MyWatchdog de origem, com TTL infinito. A descrição não é fornecida 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
Esse comando envia um relatório de integridade em um pacote de serviço implantado para o aplicativo chamado fabric:/MyApplication para o manifesto de serviço chamado MyServiceManifest no nó chamado Node01. O relatório de integridade contém informações sobre a propriedade de integridade CustomSetup em um estado de integridade de aviso do MyWatchdog de origem, com TTL de 10 segundos. Depois que o relatório expirar, ele será removido do repositório de integridade e não afetará mais a avaliação de integridade. Esse comando também fornece uma descrição do aviso.
Parâmetros
-ApplicationName
Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet envia um relatório 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 |
-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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Especifica um objeto HealthState que representa o estado de integridade relatado.
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 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 de malha do Powershell define HealthReportSentInterval como 0, portanto, 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ó do Service Fabric. O cmdlet envia um relatório de integridade para um pacote de serviço implantado no nó especificado.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 erro quando a hora de vida 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 Repositório de Integridade.
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 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.
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 do Service Fabric. Junto com ApplicationName e NodeName, esse valor identifica exclusivamente a entidade de integridade do pacote de serviço implantada.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
A ID de ativação do ServicePackage implantado. Isso pode ser obtido usando a consulta Get-ServiceFabricDeployedServicePackage.
Se ServicePackageActivationMode especificado no momento da criação do serviço (usando New-ServiceFabricService
) for SharedProcess (ou se ele não for especificado, nesse caso, o padrão é SharedProcess), então o valor de ServicePackageActivationId é sempre uma cadeia de caracteres vazia e não precisa ser especificado. Para saber mais sobre a ID de ativação do pacote de serviço, consulte [Modelo de Hospedagem do Service Fabric][1].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Especifica o identificador da origem que disparou 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 limite, 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 TTL (Vida Útil) do relatório em segundos. Quando a 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.
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