Obtenir des informations sur la santé d’une VM backend

Vous pouvez obtenir des informations à propos de la santé de n’importe quelle machine virtuelle (VM) enregistrée auprès du load balancer et qui n’est pas terminée. Si une VM est considérée comme non saine, la raison de cet état est également renvoyée.

Obtenir des informations sur la santé d’une VM backend avec Cockpit v2

Dans le dashboard Load Balancers, cliquez sur le nom du load balancer dont vous souhaitez obtenir des informations sur la VM backend.
Le volet des load balancers apparaît.
Cliquez sur l’onglet VM backend pour accéder aux informations de la VM backend.

Obtenir des informations sur la santé d’une VM backend avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The ReadVmsHealth command lists the state of one or more backend virtual machines (VMs) registered with a specified load balancer.

Request sample

$ osc-cli api ReadVmsHealth --profile "default" \
    --LoadBalancerName "example-lbu" \
    --BackendVmIds '["i-12345678", "i-87654321"]'

This command contains the following attributes that you need to specify:

BackendVmIds: (optional) One or more IDs of backend VMs.
DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
LoadBalancerName: The name of the load balancer.

The ReadVmsHealth command returns the following elements:

BackendVmHealth: Information about the health of one or more backend VMs.
- Description: The description of the state of the backend VM.
- State: The state of the backend VM (InService | OutOfService | Unknown).
- StateReason: Information about the cause of OutOfService VMs.
  Specifically, whether the cause is Elastic Load Balancing or the VM (ELB | Instance | N/A).
- VmId: The ID of the backend VM.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "BackendVmHealth": [
    {
      "VmId": "i-12345678",
      "State": "UP"
    },
    {
      "VmId": "i-87654321",
      "StateReason": "ELB",
      "State": "DOWN",
      "Description": "Instance registration is pending"
    }
  ]
}

Obtenir des informations sur la santé d’une VM backend avec oapi-cli

À ce jour, cette section est disponible en anglais uniquement.

The ReadVmsHealth command lists the state of one or more backend virtual machines (VMs) registered with a specified load balancer.

Request sample

$ oapi-cli --profile "default" ReadVmsHealth \
    --LoadBalancerName "example-lbu" \
    --BackendVmIds '["i-12345678", "i-87654321"]'

This command contains the following attributes that you need to specify:

BackendVmIds: (optional) One or more IDs of backend VMs.
DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
LoadBalancerName: The name of the load balancer.

The ReadVmsHealth command returns the following elements:

BackendVmHealth: Information about the health of one or more backend VMs.
- Description: The description of the state of the backend VM.
- State: The state of the backend VM (InService | OutOfService | Unknown).
- StateReason: Information about the cause of OutOfService VMs.
  Specifically, whether the cause is Elastic Load Balancing or the VM (ELB | Instance | N/A).
- VmId: The ID of the backend VM.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "BackendVmHealth": [
    {
      "VmId": "i-12345678",
      "State": "UP"
    },
    {
      "VmId": "i-87654321",
      "StateReason": "ELB",
      "State": "DOWN",
      "Description": "Instance registration is pending"
    }
  ]
}

Obtenir des informations sur la santé d’une instance backend avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour obtenir des informations sur la santé d’une ou plusieurs instances backend d’un load balancer, utilisez la commande describe-instance-health en suivant cette syntaxe :

Exemple de requête

$ aws elb describe-instance-health \
    --profile YOUR_PROFILE \
    --load-balancer-name my-load-balancer \
    --instances i-01234567 \
    --endpoint https://lbu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
load-balancer-name : Le nom du load balancer.

(optionnel) instances : Un ou plusieurs ID d’instances.

Si vous ne spécifiez aucun ID d’instance, la requête renvoie une description de toutes les instances backend du load balancer que vous avez spécifié.
Si vous spécifiez l’ID d’une instance qui n’est plus enregistrée auprès du load balancer que vous avez spécifié, la requête renvoie une description de cette instance malgré tout.

endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande describe-instance-health renvoie les éléments suivants :

InstanceStates : Informations à propos de l’état d’une ou plusieurs instances. Cet élément contient les informations suivantes pour chaque instance :
InstanceId : L’ID de l’instance.
ReasonCode : Indique si l’instance est OutOfService à cause du load balancer ou de l’instance elle-même, le cas échéant.
State : L’état de l’instance.
Description : La description de l’état de l’instance.

Exemple de résultat

{
  "InstanceStates": [
      {
          "InstanceId": "i-01234567",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      }
  ]
}

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.