Send-ServiceFabricReplicaHealthReport
Skickar en hälsorapport på en Service Fabric-replik.
Syntax
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>]
Description
Cmdleten Send-ServiceFabricReplicaHealthReport skickar en hälsorapport på en tillståndslös Service Fabric-tjänstinstans eller en tillståndskänslig tjänstreplik.
Den tillståndslösa tjänstinstansen eller den tillståndskänsliga tjänstrepliken måste redan finnas i hälsoarkivet. Om du vill kontrollera om den finns använder du cmdleten Get-ServiceFabricReplicaHealth och anger parametrarna PartitionId och ReplicaOrInstanceId . Du kan också använda cmdleten Get-ServiceFabricPartitionHealth med parametern PartitionId och sedan kontrollera avsnittet ReplicaHealthStates för att hitta repliken.
Cmdleten skickar rapporten efter ett intervall som anges av parametern HealthReportSendIntervalInSec i cmdleten Connect-ServiceFabricCluster . Klusteranslutningen måste hållas vid liv under den här tiden.
Cmdleten kan returnera framgång, men rapporten skickas asynkront, så bearbetningen kan misslyckas. Om du vill se om rapporten har tillämpats i hälsoarkivet använder du cmdleten Get-ServiceFabricReplicaHealth och kontrollerar att rapporten visas i avsnittet hälsohändelser.
Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .
Exempel
Exempel 1: Rapportera felhälsorapport på en tillståndskänslig tjänstreplik med oändlig TTL
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"
Det här kommandot skickar en hälsorapport för den angivna partitionen för den angivna tillståndskänsliga tjänstrepliken från källan MyWatchDog. Hälsorapporten innehåller information om hälsoegenskapen DiskUsage i ett feltillstånd med oändlig TTL. Det här kommandot ger också en beskrivning av felet.
Exempel 2: Rapportvarningshälsorapport för en tillståndslös tjänstinstans som är giltig för den angivna TTL:n och ta bort den när den upphör att gälla
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
Det här kommandot skickar en hälsorapport för den angivna tillståndslösa tjänstinstansen från källan MyWatchDog. Hälsorapporten innehåller information om hälsoegenskapen Resurser i ett hälsotillstånd för varning från källan MyWatchdog, med 10 sekunders TTL. Rapporten markerad för borttagning vid förfallodatum.
Parametrar
-Description
Anger läsbar information om det villkor som utlöste rapporten. Parametrarna SourceId, HealthProperty och HealthState beskriver rapporten fullständigt.
Den maximala stränglängden för beskrivningen är 4 096 tecken. Om den angivna strängen är längre trunkeras den automatiskt. När beskrivningen trunkeras avslutas den med en markör, "[Trunkerad]", för att indikera för användarna att trunkeringen inträffade. Den totala strängstorleken är 4 096 tecken, så mindre än 4 096 tecken från den ursprungliga strängen behålls.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-HealthProperty
Anger rapportens egenskap. Tillsammans med parametern SourceId identifierar den här egenskapen rapporten unikt.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-HealthState
Anger ett HealthState-objekt som representerar det rapporterade hälsotillståndet.
Typ: | HealthState |
Godkända värden: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Immediate
Anger om rapporten ska skickas till hälsoarkivet omedelbart. Detta är användbart för kritiska rapporter som ska skickas så snart som möjligt. Om det inte anges skickas rapporten baserat på hälsoklientinställningarna. Därför batchas den enligt konfigurationen HealthReportSendInterval. Det här är den rekommenderade inställningen eftersom den gör det möjligt för hälsoklienten att optimera hälsorapporteringsmeddelanden till hälsoarkivet samt bearbetning av hälsorapporter. Som standard anger Powershell Fabric-klienten HealthReportSentInterval till 0, så rapporter skickas omedelbart.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-InstanceId
Anger det tillståndslösa tjänstinstans-ID:t. Instans-ID:t är endast giltigt för tillståndslösa tjänster. En rapport för en tillståndskänslig replik som använder InstanceId i stället för ReplicaId godkänns av hälsoklienten, men avvisas av hälsoarkivet.
Typ: | Int64 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PartitionId
Anger ID för en Service Fabric-partition.
Typ: | Guid |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-RemoveWhenExpired
Anger att rapporten tas bort från hälsoarkivet när den upphör att gälla. Om du inte anger den här parametern anses entiteten vara i feltillstånd när rapporttiden upphör att gälla. De rapporter som tas bort när de har upphört att gälla kan användas för villkor som endast är giltiga under en tidsperiod eller för att rensa rapporter från Hälsoarkivet.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-ReplicaId
Anger tillståndskänsligt tjänstreplik-ID. Replik-ID:t är bara giltigt för tillståndskänsliga tjänster. En rapport för en tillståndslös instans som använder ReplicaId i stället för InstaceId godkänns av hälsoklienten, men avvisas av hälsoarkivet.
Typ: | Int64 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-SequenceNumber
Anger det sekvensnummer som är associerat med hälsorapporten. Om du inte anger något värde för den här parametern anges sekvensnumret automatiskt. Om du anger ett sekvensnummer måste det värdet vara högre än något tidigare sekvensnummer som angetts på samma entitet för samma SourceId och HealthProperty, eller så avvisas rapporten på grund av inaktuellhet.
Typ: | Int64 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-SourceId
Anger identifieraren för källan som utlöste rapporten.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-TimeoutSec
Anger tidsgränsen i sekunder för åtgärden.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-TimeToLiveSec
Anger TTL (Time to Live) för rapporten i sekunder. När TTL upphör att gälla tas rapporten bort från hälsoarkivet om parametern RemoveWhenExpired har angetts . Annars utvärderas entiteten vid Fel på grund av den utgångna rapporten. Standardvärdet är Infinite.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
Indata
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]]
Utdata
System.Object