Condividi tramite

Send-ServiceFabricApplicationHealthReport

  • Riferimento
Modulo:
ServiceFabric

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

Sintassi

Send-ServiceFabricApplicationHealthReport
    [-ApplicationName] <Uri>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Descrizione

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

L'applicazione deve essere già presente nell'archivio integrità. Per verificare se esiste, usare il cmdlet Get-ServiceFabricApplicationHealth .

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. Questo cmdlet invia un report in modo asincrono, pertanto questo cmdlet potrebbe inviare un valore di esito positivo anche tramite l'elaborazione non riesce. Ad esempio, se un'entità viene eliminata o a causa di un parametro non valido, ad esempio un numero di sequenza non aggiornato, l'archivio integrità può rifiutare il report.

Per verificare se il report è stato applicato nell'archivio integrità, usare il cmdlet Get-ServiceFabricApplicationHealth 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 un report sull'integrità degli errori con durata (TTL) infinita

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Questo comando invia un report sull'integrità nell'applicazione denominata fabric:/MyApplication dall'origine MyWatchDog. 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 del report valido per la durata (TTL) specificata

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired

Questo comando invia un report sull'integrità nell'applicazione denominata fabric:/MyApplication dall'origine MyWatchDog. Il report sull'integrità contiene informazioni sulla proprietà di integrità Disponibilità in uno stato di integrità avviso. Il report rimarrà nell'archivio integrità per 10 secondi, dopo il quale viene rimosso automaticamente.

Parametri

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet invia un report sull'integrità sull'applicazione con l'URI specificato.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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à.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HealthState

Specifica un oggetto HealthState che rappresenta lo stato di integrità segnalato.

Type:HealthState
Accepted values:Invalid, Ok, Warning, Error, Unknown
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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à.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceId

Specifica l'identificatore dell'origine che ha attivato il report.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

System.Uri

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