Send-ServiceFabricReplicaHealthReport
Wysyła raport kondycji repliki usługi Service Fabric.
Składnia
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Opis
Polecenie cmdlet Send-ServiceFabricReplicaHealthReport wysyła raport o kondycji wystąpienia usługi bezstanowej usługi Service Fabric lub repliki usługi stanowej.
Wystąpienie usługi bezstanowej lub replika usługi stanowej musi już istnieć w magazynie kondycji. Aby sprawdzić, czy istnieje, użyj polecenia cmdlet Get-ServiceFabricReplicaHealth i określ parametry PartitionId i ReplicaOrInstanceId . Alternatywnie możesz użyć polecenia cmdlet Get-ServiceFabricPartitionHealth z parametrem PartitionId , a następnie sprawdzić sekcję ReplicaHealthStates, aby znaleźć replikę.
Polecenie cmdlet wysyła raport po interwale określonym przez parametr HealthReportSendIntervalInSec polecenia cmdlet Connect-ServiceFabricCluster . Połączenie klastra musi być utrzymywane przy życiu w tym czasie.
Polecenie cmdlet może zwrócić powodzenie, ale raport jest wysyłany asynchronicznie, więc przetwarzanie może zakończyć się niepowodzeniem. Aby sprawdzić, czy raport został zastosowany w magazynie kondycji, użyj polecenia cmdlet Get-ServiceFabricReplicaHealth i sprawdź, czy raport jest wyświetlany w sekcji Zdarzenia kondycji.
Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric nawiąż połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .
Przykłady
Przykład 1. Zgłaszanie raportu o kondycji błędu w repliki usługi stanowej z nieskończonym limitem czasu wygaśnięcia
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"
To polecenie wysyła raport kondycji dla określonej partycji dla określonej repliki usługi stanowej ze źródła MyWatchDog. Raport kondycji zawiera informacje o właściwości kondycji DiskUsage w stanie kondycji Błąd z nieskończonym czasem wygaśnięcia. To polecenie zawiera również opis błędu.
Przykład 2. Raport dotyczący kondycji ostrzeżenia dotyczącego wystąpienia usługi bezstanowej ważnego dla określonego czasu wygaśnięcia i usunięcia go po wygaśnięciu
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpired
To polecenie wysyła raport kondycji dla określonego wystąpienia usługi bezstanowej ze źródła MyWatchDog. Raport kondycji zawiera informacje o właściwości kondycji Zasoby w stanie Kondycja ostrzeżenia ze źródła MyWatchdog z 10-sekundowym czasem wygaśnięcia. Raport oznaczony do usunięcia po wygaśnięciu.
Parametry
-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.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-HealthProperty
Określa właściwość raportu. Wraz z parametrem SourceId ta właściwość jednoznacznie identyfikuje raport.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-HealthState
Określa obiekt HealthState , który reprezentuje zgłoszony stan kondycji.
Typ: | HealthState |
Dopuszczalne wartości: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Immediate
Określa, czy raport powinien być wysyłany do magazynu kondycji natychmiast. Jest to przydatne w przypadku krytycznych raportów, które powinny być wysyłane tak szybko, jak to możliwe. Jeśli nie zostanie określony, raport zostanie wysłany na podstawie ustawień klienta kondycji. W związku z tym zostanie ona wsadowa zgodnie z konfiguracją HealthReportSendInterval. Jest to zalecane ustawienie, ponieważ umożliwia klientowi kondycji optymalizowanie komunikatów raportowania kondycji do magazynu kondycji oraz przetwarzania raportów o kondycji. Domyślnie klient sieci szkieletowej programu PowerShell ustawia wartość HealthReportSentInterval na wartość 0, więc raporty są wysyłane natychmiast.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InstanceId
Określa identyfikator wystąpienia usługi bezstanowej. Identyfikator wystąpienia jest prawidłowy tylko dla usług bezstanowych. Raport repliki stanowej używającej identyfikatora InstanceId zamiast ReplicaId jest akceptowany przez klienta kondycji, ale jest odrzucany przez magazyn kondycji.
Typ: | Int64 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PartitionId
Określa identyfikator partycji usługi Service Fabric.
Typ: | Guid |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-RemoveWhenExpired
Wskazuje, że raport jest usuwany 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 z magazynu kondycji.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ReplicaId
Określa stanowy identyfikator repliki usługi. Identyfikator repliki jest prawidłowy tylko dla usług stanowych. Raport dla wystąpienia bezstanowego, który używa identyfikatora ReplicaId zamiast InstaceId , jest akceptowany przez klienta kondycji, ale jest odrzucany przez magazyn kondycji.
Typ: | Int64 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SequenceNumber
Określa numer sekwencji skojarzony z raportem kondycji. Jeśli nie określisz wartości dla tego parametru, numer sekwencji zostanie ustawiony automatycznie. Jeśli określisz numer sekwencji, ta wartość musi być wyższa niż poprzedni numer sekwencji ustawiony dla tej samej jednostki dla tej samej jednostki SourceId i HealthProperty lub raport zostanie odrzucony z powodu nieaktualności.
Typ: | Int64 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-SourceId
Określa identyfikator źródła, które wyzwoliło raport.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-TimeoutSec
Określa limit czasu dla operacji w sekundach.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-TimeToLiveSec
Określa czas wygaśnięcia (TTL) raportu 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.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
System.Guid
System.Fabric.Health.HealthState
System.String
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