Condividi tramite

Send-ServiceFabricNodeHealthReport

  • Riferimento
Modulo:
ServiceFabric

Invia un report sull'integrità in un nodo di Service Fabric.

Sintassi

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

Descrizione

Il cmdlet Send-ServiceFabricNodeHealthReport invia un report sull'integrità in un nodo di Service Fabric.

Il nodo deve esistere già nell'archivio integrità. Per verificare se esiste, usare il cmdlet Get-ServiceFabricNodeHealth . In alternativa, è possibile usare il cmdlet Get-ServiceFabricNode . Se il cmdlet ottiene il nodo e il nodo ha uno stato di integrità valido, il nodo esiste nell'archivio integrità.

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 comando viene valutato nel client senza riferimento all'esecuzione nell'archivio integrità. Il report potrebbe non essere applicato nell'archivio integrità anche se il comando restituisce esito positivo. Ad esempio, l'archivio integrità può rifiutare il report a causa di un parametro non valido, ad esempio un numero di sequenza non aggiornato.

Per verificare se il report è stato applicato nell'archivio integrità, usare il cmdlet Get-ServiceFabricNodeHealth e verificare che il report venga visualizzato nella sezione HealthEvents.

Per gestire i cluster di Service Fabric, avviare Windows PowerShell usando l'opzione Esegui come amministratore. Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster e quindi il cmdlet get-ServiceFabricClusterConnection .

Esempio

Esempio 1: Segnalare il report di integrità degli errori con durata (TTL) infinito

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

Questo comando invia un report sull'integrità nel nodo denominato Node01 dall'origine denominata MyWatchdog. Il report sull'integrità contiene informazioni sulla proprietà di integrità firewall in uno stato di integrità degli errori, con TTL infinito.

Esempio 2: Avviso di report valido per la durata (TTL) specificata

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

Questo comando invia un report sull'integrità nel nodo denominato Node01 dall'origine denominata MyWatchdog. Il report sull'integrità contiene informazioni sulla proprietà di integrità CPU in uno stato di integrità avviso. Il comando fornisce anche una descrizione per l'avviso, imposta il valore TTL su 10 secondi e configura il report da rimuovere alla scadenza.

Parametri

-Description

Specifica informazioni leggibili sulla condizione che ha attivato il report. I parametriSourceId , HealthPropertye HealthState descrivono completamente il report.

La lunghezza massima della stringa per la descrizione è di 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 il SourceId e HealthProperty parametri 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à. Ciò è utile per i report critici che devono essere inviati il prima possibile. Se non specificato, il report viene inviato in base alle impostazioni del client di integrità. Pertanto, verrà inserito in batch in base alla configurazione HealthReportSendInterval. Questa è l'impostazione consigliata perché consente al client di integrità di ottimizzare i messaggi di report sull'integrità nell'archivio integrità e l'elaborazione dei 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

-NodeName

Specifica il nome di un nodo di Service Fabric. Il cmdlet invia un report sull'integrità nel nodo specificato.

Tipo:String
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 in stato di errore alla scadenza del report. I report rimossi quando sono scaduti possono essere usati per 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 maggiore di qualsiasi numero di sequenza precedente impostato sullo stesso SourceId e HealthPropertyoppure 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 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.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]]

Output

System.Object