Send-ServiceFabricPartitionHealthReport
Invia un report sull'integrità in una partizione del servizio di Service Fabric.
Sintassi
Send-ServiceFabricPartitionHealthReport
[-PartitionId] <Guid>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Descrizione
Il cmdlet Send-ServiceFabricPartitionHealthReport invia un report sull'integrità in una partizione di servizio di Service Fabric.
La partizione deve già esistere nell'archivio integrità. Per verificare se esiste, usare il cmdlet Get-ServiceFabricPartitionHealth e specificare l'ID partizione. In alternativa, è possibile usare il cmdlet Get-ServiceFabricServiceHealth e controllare la sezione stati di integrità della partizione per trovare la partizione.
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-ServiceFabricPartitionHealth e verificare che il report venga visualizzato nella sezione HealthEvents.
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 con durata (TTL) infinita
PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error
Questo comando invia un report sull'integrità sulla partizione specificata dal MyWatchdog di origine. Il report sull'integrità contiene informazioni sulla proprietà di integrità Disponibilità in uno stato di integrità degli errori, con durata TTL infinita.
Esempio 2: Avviso di report valido per la durata (TTL) specificato e rimuoverlo alla scadenza
PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "ReplicaSet" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "The communication between replicas have high latency."
Questo comando invia un report sull'integrità sulla partizione specificata dal MyWatchdog di origine. Il report sull'integrità contiene informazioni sulla proprietà di integrità ReplicaSet in uno stato di integrità avviso con durata (TTL) di 10 secondi. Il report viene 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. Il report esegue l'override di tutti i report precedenti con gli stessi valori per i parametri SourceId e HealthProperty nella stessa entità.
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 |
-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 |
-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 sullo 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