Send-ServiceFabricDeployedServicePackageHealthReport
Wysyła raport kondycji dla wdrożonego pakietu usługi Service Fabric.
Składnia
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>]
Opis
Polecenie cmdlet Send-ServiceFabricDeployedServicePackageHealthReport wysyła raport kondycji dla wdrożonego pakietu usługi Service Fabric.
Wdrożony pakiet usługi musi już istnieć w magazynie kondycji. Aby sprawdzić, czy usługa istnieje, użyj polecenia cmdlet Get-ServiceFabricDeployedServicePackageHealth . Określ nazwę aplikacji, nazwę pakietu usługi i nazwę węzła. Alternatywnie możesz użyć polecenia cmdlet Get-ServiceFabricDeployedApplicationHealth . Określ nazwę aplikacji i nazwę węzła, a następnie sprawdź sekcję wdrożonych stanów kondycji pakietu usług, aby znaleźć pakiet usługi.
Polecenie cmdlet wysyła raport po interwale określonym przez parametr HealthReportSendIntervalInSec polecenia cmdlet Connect-ServiceFabricCluster . W tym czasie połączenie klastra musi być aktywne. Polecenie jest oceniane na kliencie bez odwołania do uruchamiania w magazynie kondycji. Raport może nie być stosowany w magazynie kondycji, nawet jeśli polecenie zwróci powodzenie. Na przykład magazyn kondycji może odrzucić raport z powodu nieprawidłowego parametru, takiego jak nieaktualny numer sekwencji.
Aby sprawdzić, czy raport został zastosowany w magazynie kondycji, użyj polecenia cmdlet Get-ServiceFabricDeployedServicePackageHealth i sprawdź, czy raport jest wyświetlany w sekcji HealthEvents .
Aby zarządzać klastrami usługi Service Fabric, uruchom Windows PowerShell przy użyciu opcji Uruchom jako administrator. Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster , a następnie polecenie cmdlet Get-ServiceFabricClusterConnection .
Przykłady
Przykład 1. Raport dotyczący kondycji błędu z nieskończonym czasem wygaśnięcia
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"
To polecenie wysyła raport kondycji dla wdrożonego pakietu usługi dla aplikacji o nazwie fabric:/MyApplication w węźle o nazwie Node01 dla manifestu usługi o nazwie MyServiceManifest. Raport kondycji zawiera informacje o właściwości kondycji Pamięć w stanie kondycji błędu ze źródła MyWatchdog z nieskończonym czasem wygaśnięcia. Opis nie jest podany, a numer sekwencji jest ustawiany automatycznie.
Przykład 2. Ostrzeżenie raportu jest prawidłowe dla określonego czasu wygaśnięcia i usuń je po wygaśnięciu
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
To polecenie wysyła raport kondycji dla wdrożonego pakietu usługi dla aplikacji o nazwie fabric:/MyApplication dla manifestu usługi o nazwie MyServiceManifest w węźle o nazwie Node01. Raport kondycji zawiera informacje o właściwości kondycji CustomSetup w stanie kondycji ostrzeżenia ze źródła MyWatchdog z 10 sekund czasu wygaśnięcia. Po wygaśnięciu raportu zostanie on usunięty ze sklepu kondycji i nie będzie już wpływać na ocenę kondycji. To polecenie zawiera również opis ostrzeżenia.
Parametry
-ApplicationName
Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet wysyła raport kondycji dla aplikacji z określonym identyfikatorem URI.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
Określa czytelne informacje o stanie, który wyzwolił raport. Parametry SourceId, HealthProperty i HealthState w pełni opisują raport.
Maksymalna długość ciągu opisu wynosi 4096 znaków. Jeśli podany ciąg jest dłuższy, zostanie automatycznie obcięty. Po obcięciu opis kończy się znacznikiem "[Truncated]", aby wskazać użytkownikom, że wystąpił obcinanie. Łączny rozmiar ciągu to 4096 znaków, więc przechowywane są mniej niż 4096 znaków z oryginalnego ciągu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthProperty
Określa właściwość raportu. Wraz z parametrem SourceId ta właściwość jednoznacznie identyfikuje raport. Raport zastępuje wszystkie poprzednie raporty o tych samych wartościach dla parametrów SourceId i HealthProperty w tej samej jednostce.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Określa obiekt HealthState , który reprezentuje zgłoszony stan kondycji.
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
Określa, czy raport powinien zostać wysłany do magazynu kondycji natychmiast. Jest to przydatne w przypadku raportów krytycznych, które powinny być wysyłane tak szybko, jak to możliwe. Jeśli nie zostanie określony, raport jest wysyłany na podstawie ustawień klienta kondycji. W związku z tym będzie ona wsadowa zgodnie z konfiguracją HealthReportSendInterval. Jest to zalecane ustawienie, ponieważ umożliwia klientowi kondycji optymalizowanie komunikatów raportowania kondycji do magazynu kondycji, a także przetwarzania raportów o kondycji. Domyślnie klient sieci szkieletowej programu PowerShell ustawia wartość HealthReportSentInterval na 0, dlatego raporty są wysyłane natychmiast.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeName
Określa nazwę węzła usługi Service Fabric. Polecenie cmdlet wysyła raport kondycji pakietu usługi wdrożonego w określonym węźle.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RemoveWhenExpired
Wskazuje, że raport zostanie usunięty z magazynu kondycji po wygaśnięciu. Jeśli nie określisz tego parametru, jednostka zostanie uznana za w stanie Błąd po wygaśnięciu czasu wygaśnięcia raportu. Raporty, które są usuwane, gdy wygasły, mogą być używane dla warunków, które są ważne tylko przez pewien czas lub do czyszczenia raportów ze Sklepu kondycji.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SequenceNumber
Określa numer sekwencji skojarzony z raportem kondycji. Jeśli nie określisz wartości tego parametru, numer sekwencji zostanie ustawiony automatycznie. Jeśli określisz numer sekwencji, ta wartość musi być większa niż poprzedni numer sekwencji ustawiony na tym samym identyfikatorze SourceId i HealthProperty lub raport zostanie odrzucony z powodu nieaktualności.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceManifestName
Określa nazwę manifestu usługi Service Fabric. Wraz z elementami ApplicationName i NodeName ta wartość jednoznacznie identyfikuje wdrożona jednostka kondycji pakietu usługi.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
Identyfikator aktywacji wdrożonego pakietu ServicePackage. Można to uzyskać za pomocą zapytania Get-ServiceFabricDeployedServicePackage.
Jeśli parametr ServicePackageActivationMode określony w momencie utworzenia usługi (przy użyciu New-ServiceFabricService
polecenia ) to SharedProcess (lub jeśli nie zostanie określony, w którym przypadku wartość domyślna to SharedProcess), wartość elementu ServicePackageActivationId jest zawsze pustym ciągiem i nie musi być określona. Aby dowiedzieć się więcej o identyfikatorze aktywacji pakietu usługi, zobacz [Model hostingu usługi Service Fabric][1].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Określa identyfikator źródła, które wyzwoliło raport.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Określa limit czasu dla operacji w sekundach.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeToLiveSec
Określa czas wygaśnięcia raportu (TTL) w sekundach. Po wygaśnięciu czasu wygaśnięcia raport zostanie usunięty z magazynu kondycji, jeśli określono parametr RemoveWhenExpired . W przeciwnym razie jednostka jest oceniana pod adresem Błąd z powodu wygasłego raportu. Wartość domyślna to Nieskończona.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
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]]
Dane wyjściowe
System.Object