FabricClient.HealthClient.GetApplicationHealthAsync Método

Definición

Espacio de nombres:

System.Fabric

Ensamblado:

System.Fabric.dll

Paquete:

Microsoft.ServiceFabric v9.1.1833

Sobrecargas

GetApplicationHealthAsync(ApplicationHealthQueryDescription)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante la descripción de consulta especificada.
GetApplicationHealthAsync(Uri)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada.
GetApplicationHealthAsync(Uri, ApplicationHealthPolicy)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el URI de la aplicación y la directiva de mantenimiento.
GetApplicationHealthAsync(ApplicationHealthQueryDescription, TimeSpan, CancellationToken)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante la entrada de consulta, el tiempo de espera y el token de cancelación especificados.
GetApplicationHealthAsync(Uri, TimeSpan, CancellationToken)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el URI de la aplicación, el tiempo de espera y el token de cancelación especificados.
GetApplicationHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)	Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el token de cancelación y el tiempo de espera especificados.

GetApplicationHealthAsync(ApplicationHealthQueryDescription)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante la descripción de consulta especificada.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (System.Fabric.Description.ApplicationHealthQueryDescription queryDescription);

member this.GetApplicationHealthAsync : System.Fabric.Description.ApplicationHealthQueryDescription -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (queryDescription As ApplicationHealthQueryDescription) As Task(Of ApplicationHealth)

Parámetros

queryDescription

ApplicationHealthQueryDescription

Instancia ApplicationHealthQueryDescription de que se describe la consulta para obtener el estado de la aplicación.

Devoluciones

Task<ApplicationHealth>

El estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando ApplicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

GetApplicationHealthAsync(Uri)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName);

member this.GetApplicationHealthAsync : Uri -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri) As Task(Of ApplicationHealth)

Parámetros

applicationName

Uri

URI de la aplicación de Service Fabric.

Devoluciones

Task<ApplicationHealth>

El estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

Comentarios

En el ejemplo siguiente se obtiene el estado de una aplicación.

public static bool GetApplicationHealth(string clusterConnection)
            {
                ApplicationHealth applicationHealth;
                Uri applicationName = new Uri("fabric:/myapp/todo");

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

                // Get the application health.
                try
                {
                    applicationHealth = fabricClient.HealthManager.GetApplicationHealthAsync(applicationName).Result;
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);

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

                    return false;
                }

                // Display the application health information.
                Console.WriteLine("Get Application Health:");
                Console.WriteLine("  Application {0}: {1}", applicationHealth.ApplicationName, applicationHealth.AggregatedHealthState);

                // List the deployed application health states.
                Console.WriteLine("    Deployed applications:");
                IList<DeployedApplicationHealthState> deployedAppHealthStateList = applicationHealth.DeployedApplicationHealthStates;
                foreach (DeployedApplicationHealthState deployedAppHealthState in deployedAppHealthStateList)
                {
                    Console.WriteLine("      Application: " + deployedAppHealthState.ApplicationName);
                    Console.WriteLine("        Aggregated Health State: " + deployedAppHealthState.AggregatedHealthState);
                    Console.WriteLine("        Node Name: " + deployedAppHealthState.NodeName);
                }

                // List the deployed services health states.
                Console.WriteLine("    Service Health States:");
                IList<ServiceHealthState> deployedSvcsHealthStateList = applicationHealth.ServiceHealthStates;
                foreach (ServiceHealthState serviceHealthState in deployedSvcsHealthStateList)
                {
                    Console.WriteLine("      Service {0}: {1}", serviceHealthState.ServiceName, serviceHealthState.AggregatedHealthState);
                }

                // List the health events.
                Console.WriteLine("    Health Events:");
                IList<HealthEvent> healthEvents = applicationHealth.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);
                }

                Console.WriteLine();
                return true;
            }

GetApplicationHealthAsync(Uri, ApplicationHealthPolicy)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el URI de la aplicación y la directiva de mantenimiento.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy);

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

Public Function GetApplicationHealthAsync (applicationName As Uri, healthPolicy As ApplicationHealthPolicy) As Task(Of ApplicationHealth)

Parámetros

applicationName

Uri

URI de la aplicación de Service Fabric.

healthPolicy

ApplicationHealthPolicy

Instancia ApplicationHealthPolicy usada para evaluar la aplicación.

Devoluciones

Task<ApplicationHealth>

Los informes de estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el tiempo especificado en completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

GetApplicationHealthAsync(ApplicationHealthQueryDescription, TimeSpan, CancellationToken)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante la entrada de consulta, el tiempo de espera y el token de cancelación especificados.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (System.Fabric.Description.ApplicationHealthQueryDescription queryDescription, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetApplicationHealthAsync : System.Fabric.Description.ApplicationHealthQueryDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (queryDescription As ApplicationHealthQueryDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parámetros

queryDescription

ApplicationHealthQueryDescription

Instancia ApplicationHealthQueryDescription de que se describe la consulta para obtener el estado de la aplicación.

timeout

TimeSpan

La cantidad máxima de tiempo que Service Fabric permitirá que esta operación continúe antes de devolver .TimeoutException

cancellationToken

CancellationToken

Token de cancelación que observa la operación. Se puede usar para enviar una notificación de que se debe cancelar la operación. Tenga en cuenta que la cancelación es un aviso y que la operación todavía puede completarse aunque se cancele.

Devoluciones

Task<ApplicationHealth>

Los informes de estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el usuario proporcionado timeout para completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando ApplicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

GetApplicationHealthAsync(Uri, TimeSpan, CancellationToken)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el URI de la aplicación, el tiempo de espera y el token de cancelación especificados.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

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

Public Function GetApplicationHealthAsync (applicationName As Uri, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parámetros

applicationName

Uri

URI de la aplicación de Service Fabric.

timeout

TimeSpan

La cantidad máxima de tiempo que Service Fabric permitirá que esta operación continúe antes de devolver .TimeoutException

cancellationToken

CancellationToken

Token de cancelación que observa la operación. Se puede usar para enviar una notificación de que se debe cancelar la operación. Tenga en cuenta que la cancelación es un aviso y que la operación todavía puede completarse aunque se cancele.

Devoluciones

Task<ApplicationHealth>

Los informes de estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el usuario proporcionado timeout para completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.

GetApplicationHealthAsync(Uri, ApplicationHealthPolicy, TimeSpan, CancellationToken)

Obtiene de forma asincrónica el estado de la aplicación de Service Fabric especificada mediante el token de cancelación y el tiempo de espera especificados.

public System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth> GetApplicationHealthAsync (Uri applicationName, System.Fabric.Health.ApplicationHealthPolicy healthPolicy, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.GetApplicationHealthAsync : Uri * System.Fabric.Health.ApplicationHealthPolicy * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Fabric.Health.ApplicationHealth>

Public Function GetApplicationHealthAsync (applicationName As Uri, healthPolicy As ApplicationHealthPolicy, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ApplicationHealth)

Parámetros

applicationName

Uri

URI de la aplicación de Service Fabric.

healthPolicy

ApplicationHealthPolicy

La directiva de estado de la aplicación que se usa para evaluar el estado de la aplicación.

timeout

TimeSpan

La cantidad máxima de tiempo que Service Fabric permitirá que esta operación continúe antes de devolver .TimeoutException

cancellationToken

CancellationToken

Token de cancelación que observa la operación. Se puede usar para enviar una notificación de que se debe cancelar la operación. Tenga en cuenta que la cancelación es un aviso y que la operación todavía puede completarse aunque se cancele.

Devoluciones

Task<ApplicationHealth>

Los informes de estado de la aplicación de Service Fabric especificada.

Excepciones

FabricObjectClosedException

El FabricClient objeto está en un estado cerrado. Elimine el FabricClient objeto que está usando y cree una instancia de un nuevo FabricClient objeto.

ArgumentNullException

Se devuelve cuando se pasa una referencia nula a un método que no lo acepta como argumento válido.

ArgumentException

Causado por una de las siguientes causas:

E_INVALIDARG se devuelve cuando uno o varios argumentos no son válidos.

TimeoutException

Causado por una de las siguientes causas:

OperationTimedOut se devuelve cuando la operación tarda más que el usuario proporcionado timeout para completarse.

FabricException

Causado por una de las siguientes causas:

FabricHealthEntityNotFound.

InvalidNameUri se devuelve cuando applicationName no es un nombre de Service Fabric válido.

CommunicationError se devuelve cuando se produce un error de comunicación por el que se produce un error en la operación.

InvalidCredentialType.

InvalidX509FindType.

InvalidX509StoreLocation.

InvalidX509StoreName.

InvalidX509Thumbprint.

InvalidProtectionLevel.

InvalidX509Store.

InvalidSubjectName.

InvalidAllowedCommonNameList.

FabricTransientException

Causado por una de las siguientes causas:

ServiceTooBusy se devuelve cuando el servicio está demasiado ocupado para procesar la operación.

UnauthorizedAccessException

Causado por una de las siguientes causas:

E_ACCESSDENIED se devuelve cuando se ha producido un error en la comprobación de acceso para esta operación.