Udostępnij za pośrednictwem


Send-ServiceFabricNodeHealthReport

Wysyła raport kondycji w węźle usługi Service Fabric.

Składnia

Send-ServiceFabricNodeHealthReport
    [-NodeName] <String>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Send-ServiceFabricNodeHealthReport wysyła raport kondycji w węźle usługi Service Fabric.

Węzeł musi już istnieć w magazynie kondycji. Aby sprawdzić, czy istnieje, użyj polecenia cmdlet Get-ServiceFabricNodeHealth. Alternatywnie możesz użyć polecenia cmdlet Get-ServiceFabricNode. Jeśli polecenie cmdlet pobiera węzeł, a węzeł ma prawidłowy stan kondycji, węzeł istnieje w magazynie kondycji.

Polecenie cmdlet wysyła raport po interwale określonym przez polecenie cmdlet HealthReportSendIntervalInSec parametru Connect-ServiceFabricCluster. W tym czasie połączenie klastra musi być nadal 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-ServiceFabricNodeHealth i sprawdź, czy raport jest wyświetlany w sekcji HealthEvents.

Aby zarządzać klastrami usługi Service Fabric, uruchom program 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 polecenia cmdlet Get-ServiceFabricClusterConnection.

Przykłady

Przykład 1. Raport dotyczący kondycji błędu z nieskończonym czasem wygaśnięcia

PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "Firewall" -HealthState Error -Description "Firewall rules were not correctly applied"

To polecenie wysyła raport kondycji w węźle o nazwie Node01 ze źródła o nazwie MyWatchdog. Raport kondycji zawiera informacje o właściwości kondycji zapory w stanie kondycji błędu z nieskończonym czasem wygaśnięcia.

Przykład 2: Ostrzeżenie raportu prawidłowe dla określonego czasu wygaśnięcia

PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "CPU" -HealthState Warning -Description "CPU has been more than 90% for the last hour." -TimeToLiveSec 10 -RemoveWhenExpired

To polecenie wysyła raport kondycji w węźle o nazwie Node01 ze źródła o nazwie MyWatchdog. Raport kondycji zawiera informacje o właściwości kondycji procesora CPU w stanie Kondycja ostrzeżenia. Polecenie zawiera również opis ostrzeżenia, ustawia czas wygaśnięcia na 10 sekund i konfiguruje raport do usunięcia po wygaśnięciu.

Parametry

-Description

Określa czytelne informacje o stanie, który wyzwolił raport. Parametry SourceId, HealthPropertyi 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 on automatycznie obcięty. Po obcięciu opis kończy się znacznikiem "[Obcięty]", 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. Raport zastępuje wszystkie poprzednie raporty o tych samych wartościach dla parametrów SourceId i HealthProperty w tej samej jednostce.

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 reprezentujący 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 ma być wysył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 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

-NodeName

Określa nazwę węzła usługi Service Fabric. Polecenie cmdlet wysyła raport kondycji w określonym węźle.

Typ:String
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 jest uznawana za w stanie Błąd, gdy czas wygaśnięcia raportu wygaśnie. Raporty, które są usuwane, gdy wygasły, mogą być używane w przypadku 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

-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 na tej samej sourceId i HealthPropertylub 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 zostanie określony parametr RemoveWhenExpired. W przeciwnym razie jednostka jest oceniana na stronie 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.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