Send-ServiceFabricReplicaHealthReport
Invia un report sull'integrità in una replica di Service Fabric.
Sintassi
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>] Descrizione
Il cmdlet Send-ServiceFabricReplicaHealthReport invia un report sull'integrità in un'istanza del servizio senza stato di Service Fabric o in una replica del servizio con stato.
L'istanza del servizio senza stato o la replica del servizio con stato deve essere già presente nell'archivio integrità. Per verificare se esiste, usare il cmdlet Get-ServiceFabricReplicaHealth e specificare i parametri PartitionId e ReplicaOrInstanceId . In alternativa, è possibile usare il cmdlet Get-ServiceFabricPartitionHealth con il parametro PartitionId e quindi controllare la sezione ReplicaHealthStates per trovare la replica.
Il cmdlet invia il report dopo un intervallo specificato dal parametro HealthReportSendIntervalInSec del cmdlet Connect-ServiceFabricCluster . La connessione cluster deve essere mantenuta attiva durante questo periodo.
Il cmdlet può restituire l'esito positivo, ma il report viene inviato in modo asincrono, pertanto l'elaborazione potrebbe non riuscire. Per verificare se il report è stato applicato nell'archivio integrità, usare il cmdlet Get-ServiceFabricReplicaHealth e verificare che il report venga visualizzato nella sezione eventi di integrità.
Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .
Esempio
Esempio 1: segnalare un report sull'integrità degli errori in una replica del servizio con stato con durata TTL infinita
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Questo comando invia un report sull'integrità per la partizione specificata per la replica del servizio con stato specificata da MyWatchDog di origine. Il report sull'integrità contiene informazioni sulla proprietà di integrità DiskUsage in uno stato di integrità degli errori, con TTL infinito. Questo comando fornisce anche una descrizione dell'errore.
Esempio 2: segnalare un report sull'integrità degli avvisi in un'istanza del servizio senza stato valida per il TTL specificato e rimuoverlo alla scadenza
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 -RemoveWhenExpiredQuesto comando invia un report sull'integrità per l'istanza del servizio senza stato specificata da MyWatchDog di origine. Il report sull'integrità contiene informazioni sulla proprietà di integrità Risorse in uno stato di integrità avviso da MyWatchdog di origine, con durata (TTL) di 10 secondi. Report contrassegnato per la rimozione alla scadenza.
Parametri
-Description
Specifica informazioni leggibili sulla condizione che ha attivato il report. I parametri SourceId, HealthProperty e HealthState descrivono completamente il report.
La lunghezza massima della stringa per la descrizione è pari a 4096 caratteri. Se la stringa specificata è più lunga, viene troncata automaticamente. Quando viene troncata, la descrizione termina con un marcatore "[Troncato]", per indicare agli utenti che si è verificato il troncamento. La dimensione totale della stringa è di 4096 caratteri, quindi vengono mantenuti meno di 4096 caratteri dalla stringa originale.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-HealthProperty
Specifica la proprietà del report. Insieme al parametro SourceId , questa proprietà identifica in modo univoco il report.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-HealthState
Specifica un oggetto HealthState che rappresenta lo stato di integrità segnalato.
| Tipo: | HealthState |
| Valori accettati: | Invalid, Ok, Warning, Error, Unknown |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Immediate
Specifica se il report deve essere inviato immediatamente all'archivio integrità. Questo è utile per i report critici che devono essere inviati appena possibile. Se non specificato, il report viene inviato in base alle impostazioni del client di integrità. Verrà quindi inviato in batch in base alla configurazione di HealthReportSendInterval. Questa è l'impostazione consigliata perché consente al client di integrità di ottimizzare la segnalazione di messaggi sull'integrità all'archivio integrità e l'elaborazione di report sull'integrità. Per impostazione predefinita, il client di PowerShell Fabric imposta HealthReportSentInterval su 0, quindi i report vengono inviati immediatamente.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InstanceId
Specifica l'ID istanza del servizio senza stato. L'ID istanza è valido solo per i servizi senza stato. Un report per una replica con stato che usa InstanceId anziché ReplicaId viene accettato dal client di integrità, ma viene rifiutato dall'archivio integrità.
| Tipo: | Int64 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PartitionId
Specifica l'ID di una partizione di Service Fabric.
| Tipo: | Guid |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-RemoveWhenExpired
Indica che il report viene rimosso dall'archivio integrità alla scadenza. Se non si specifica questo parametro, l'entità viene considerata nello stato Errore alla scadenza del report. I report rimossi quando scaduti possono essere usati per le condizioni valide solo per un periodo di tempo o per cancellare i report dall'archivio integrità.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ReplicaId
Specifica l'ID di replica del servizio con stato. L'ID replica è valido solo per i servizi con stato. Un report per un'istanza senza stato che usa ReplicaId anziché InstaceId viene accettato dal client di integrità, ma viene rifiutato dall'archivio integrità.
| Tipo: | Int64 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SequenceNumber
Specifica il numero di sequenza associato al report sull'integrità. Se non si specifica un valore per questo parametro, il numero di sequenza viene impostato automaticamente. Se si specifica un numero di sequenza, tale valore deve essere superiore a qualsiasi numero di sequenza precedente impostato sulla stessa entità per lo stesso SourceId e HealthProperty oppure il report viene rifiutato a causa di decadimento.
| Tipo: | Int64 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-SourceId
Specifica l'identificatore dell'origine che ha attivato il report.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TimeoutSec
Specifica il periodo di timeout, espresso in secondi, per l'operazione.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TimeToLiveSec
Specifica la durata (TTL) del report in secondi. Quando la durata (TTL) scade, il report viene rimosso dall'archivio integrità se viene specificato il parametro RemoveWhenExpired . In caso contrario, l'entità viene valutata in Caso di errore a causa del report scaduto. Il valore predefinito è Infinite.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
Input
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]]
Output
System.Object