Fabric Client. Health Client. Get Service Health Async Méthode

InvalidNameUri est retourné lorsque ServiceName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetServiceHealthAsync(Uri)

Obtient de manière asynchrone l’intégrité d’un service Service Fabric.

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName);

member this.GetServiceHealthAsync : Uri -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (serviceName As Uri) As Task(Of ServiceHealth)

Paramètres

serviceName: Uri

Nom du service Service Fabric.

Retours

Task<ServiceHealth>

Intégrité d’un service Service Fabric.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que le temps spécifié.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque serviceName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

Remarques

L’exemple suivant obtient l’intégrité d’un service.

public static bool GetServiceHealth(string clusterConnection)
            {
                ServiceHealth serviceHealth;
                Uri serviceName = new Uri("fabric:/myapp/todo/svc1");

                // Connect to the cluster.
                FabricClient fabricClient = new FabricClient(clusterConnection);

                // Get the service health.
                try
                {
                    serviceHealth = fabricClient.HealthManager.GetServiceHealthAsync(serviceName).Result;
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);

                    if (e.InnerException != null)
            Console.WriteLine("  Inner Exception: " + e.InnerException.Message);

                    return false;
                }

                Console.WriteLine("Service Health:");
                Console.WriteLine("  Service {0}: {1}", serviceHealth.ServiceName, serviceHealth.AggregatedHealthState);

                // List the health states.
                Console.WriteLine("    Partition Health States:");
                IList<PartitionHealthState> partitionHealthStates = serviceHealth.PartitionHealthStates;
                foreach (PartitionHealthState partitionHealthState in partitionHealthStates)
                {
                    Console.WriteLine("      Aggregated Health State: " + partitionHealthState.AggregatedHealthState);
                    Console.WriteLine("      Partition ID: " + partitionHealthState.PartitionId);
                }

                // List the health events.
                Console.WriteLine("    Health Events:");
                IList<HealthEvent> healthEvents = serviceHealth.HealthEvents;
                foreach (HealthEvent healthEvent in healthEvents)
                {
                    Console.WriteLine("      Health Event:");
                    Console.WriteLine("        Last Modified: " + healthEvent.LastModifiedUtcTimestamp);
                    Console.WriteLine("        Source UTC Timestamp: " + healthEvent.SourceUtcTimestamp);
                    Console.WriteLine("        Is Expired: " + healthEvent.IsExpired);
                    Console.WriteLine("        Health Information:");
                    Console.WriteLine("          Description: " + healthEvent.HealthInformation.Description);
                    Console.WriteLine("          Source ID: " + healthEvent.HealthInformation.SourceId);
                    Console.WriteLine("          Health State: " + healthEvent.HealthInformation.HealthState);
                    Console.WriteLine("          Property: " + healthEvent.HealthInformation.Property);
                    Console.WriteLine("          Remove When Expired: " + healthEvent.HealthInformation.RemoveWhenExpired);
                    Console.WriteLine("          Sequence Number: " + healthEvent.HealthInformation.SequenceNumber);
                    Console.WriteLine("          Time to Live: " + healthEvent.HealthInformation.TimeToLive);
                }

                // List the unhealthy evaluations.
                Console.WriteLine("    Unhealthy Evaluations:");
                IList<HealthEvaluation> healthEvaluationList = serviceHealth.UnhealthyEvaluations;
                foreach (HealthEvaluation healthEvaluation in healthEvaluationList)
                {
                    Console.WriteLine("      Kind: " + healthEvaluation.Kind);
                    Console.WriteLine("        Aggregated Health State: " + healthEvaluation.AggregatedHealthState);
                    Console.WriteLine("        Description: " + healthEvaluation.Description);
                }

                Console.WriteLine();
                return true;
            }

S’applique à

GetServiceHealthAsync(Uri, ApplicationHealthPolicy)

Obtient de manière asynchrone l’intégrité d’un service Service Fabric.

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy);

member this.GetServiceHealthAsync : Uri * System.Fabric.Health.ApplicationHealthPolicy -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (serviceName As Uri, healthPolicy As ApplicationHealthPolicy) As Task(Of ServiceHealth)

Paramètres

serviceName: Uri

Nom du service Service Fabric.

healthPolicy: ApplicationHealthPolicy

Stratégie d’intégrité de l’application utilisée pour évaluer l’intégrité du service.

Retours

Task<ServiceHealth>

Intégrité d’un service Service Fabric.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que le temps spécifié.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque serviceName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetServiceHealthAsync(ServiceHealthQueryDescription, TimeSpan, CancellationToken)

Obtient de manière asynchrone l’intégrité d’un service Service Fabric à l’aide du délai d’expiration et du jeton d’annulation spécifiés.

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (System.Fabric.Description.ServiceHealthQueryDescription queryDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetServiceHealthAsync : System.Fabric.Description.ServiceHealthQueryDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (queryDescription As ServiceHealthQueryDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ServiceHealth)

Paramètres

queryDescription: ServiceHealthQueryDescription

Description de la requête.

timeout: TimeSpan

La durée maximale pendant laquelle Service Fabric autorise cette opération à se poursuivre avant de retourner un TimeoutException.

cancellationToken: CancellationToken

Jeton d’annulation facultatif que l’opération observe. Il peut être utilisé pour envoyer une notification indiquant que l’opération doit être annulée. Notez que l’annulation est un avis et que l’opération peut toujours être terminée même si elle est annulée.

Retours

Task<ServiceHealth>

Intégrité d’un service Service Fabric.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que celui fourni timeout par l’utilisateur.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque ServiceName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.

FabricTransientException

Causé par l’un des éléments suivants :

ServiceTooBusy est retourné lorsque le service est trop occupé pour traiter l’opération.

UnauthorizedAccessException

Causé par l’un des éléments suivants :

E_ACCESSDENIED est retourné lorsque le case activée d’accès a échoué pour cette opération.

S’applique à

GetServiceHealthAsync(Uri, TimeSpan, CancellationToken)

Obtient de manière asynchrone l’intégrité d’un service Service Fabric à l’aide du jeton de délai d’expiration et d’annulation spécifiés.

public System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth> GetServiceHealthAsync (Uri serviceName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetServiceHealthAsync : Uri * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ServiceHealth>

Public Function GetServiceHealthAsync (serviceName As Uri, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ServiceHealth)

Paramètres

serviceName: Uri

Nom du service Service Fabric.

timeout: TimeSpan

La durée maximale de Service Fabric permet à cette opération de se poursuivre avant de retourner un TimeoutException.

cancellationToken: CancellationToken

Jeton d’annulation facultatif que l’opération observe. Il peut être utilisé pour envoyer une notification indiquant que l’opération doit être annulée. Notez que l’annulation est un avertissement et que l’opération peut toujours être terminée même si elle est annulée.

Retours

Task<ServiceHealth>

Intégrité d’un service Service Fabric.

Exceptions

FabricObjectClosedException

L’objet FabricClient est dans un état fermé. Supprimer l’objet que FabricClient vous utilisez et instancier un nouvel FabricClient objet.

ArgumentNullException

Retourné lorsqu’une référence null est passée à une méthode qui ne l’accepte pas comme argument valide.

ArgumentException

Causé par l’un des éléments suivants :

E_INVALIDARG est retourné lorsqu’un ou plusieurs arguments ne sont pas valides.

TimeoutException

Causé par l’un des éléments suivants :

OperationTimedOut est retourné lorsque l’opération prend plus de temps que celui fourni timeout par l’utilisateur.

FabricException

Causé par l’un des éléments suivants :

InvalidNameUri est retourné lorsque serviceName n’est pas un nom Service Fabric valide.

CommunicationError est retourné lorsqu’une erreur de communication a provoqué l’échec de l’opération.