Obtenir des informations sur vos load balancers

Vous pouvez obtenir des informations sur vos load balancers en utilisant AWS CLI.

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur Throttling est renvoyé.

Cette procédure utilise uniquement AWS CLI. Des informations sur ces ressources sont également disponibles dans Cockpit. Pour en savoir plus, voir Interface utilisateur des load balancers (pour Cockpit v1) ou le dashboard Load Balancers (pour Cockpit v2-beta).

Obtenir des informations générales sur vos load balancers

Pour obtenir des informations sur vos load balancers, utilisez la commande describe-load-balancer suivant cette syntaxe :

Exemple de requête
$ aws elb describe-load-balancers \
    --profile YOUR_PROFILE \
    --load-balancer-names my-load-balancer \
    --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 Utiliser et configurer AWS CLI.

  • (optionnel) load-balancer-names : Le nom d’un ou plusieurs load balancers.

    Si vous ne spécifiez aucun nom de load balancer, la requête renvoie une description de l’ensemble de vos load balancers.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-load-balancers renvoie les éléments suivants :

  • LoadBalancerDescriptions : Informations à propos d’un ou plusieurs load balancers. Cet élément contient les informations suivantes pour chaque load balancer :

    • Subnets : L’ID du subnet dans lequel le load balancer a été créé, si celui-ci est dans un VPC.

    • ListenerDescriptions : Informations à propos d’un ou plusieurs listeners ajoutés au load balancer. Cet élément contient les informations suivantes pour chaque listener :

      • Listener : Informations à propos d’un listener :

        • InstancePort : Le port sur lequel les instances back-ends écoutent.

        • LoadBalancerPort : Le port sur lequel le load balancer écoute.

        • Protocol : Le protocole de routage du load balancer ( HTTP, HTTPS, TCP ou SSL ).

        • InstanceProtocol : Le protocole utilisé pour router le trafic vers les instances back-ends ( HTTP ou TCP ).

      • PolicyNames : Le nom des politiques mises en places pour le load balancer, s’il y en a.

    • HealthCheck : Informations à propos de la configuration du health check pour le load balancer. Cet élément contient les informations suivantes :

      • HealthyThreshold : Le nombre de pings réussis consécutifs nécessaires pour considérer l’instance comme saine.

      • Interval : Le nombre de secondes entre deux pings.

      • Target : Le port et le protocole pour les instances back-ends ciblées par les health checks (et le chemin à vérifier pour le protocole HTTP).

      • Timeout : Le temps d’attente maximum d’une réponse avant de considérer le ping comme non réussi, en secondes.

      • UnhealthyThreshold : Le nombre de pings non réussis consécutifs pour considérer l’instance comme non saine.

    • VPCId : L’ID du VPC pour le load balancer, s’il y en a un.

    • BackendServerDescriptions : Informations à propos des instances back-ends. Cet élément contient les informations suivantes pour chaque instance back-end :

      • InstancePort : Le port sur lequel les instances back-ends écoutent.

      • PolicyNames : Le nom des politiques activées pour les instances back-ends, s’il y en a.

    • Instances : Informations à propos d’une ou plusieurs instances back-ends. Cet élément contient l’information suivante pour chaque instance back-end :

      • InstanceId : L’ID de l’instance back-end.

    • DNSName : Le nom DNS du load balancer.

    • SecurityGroups : Les security groups pour le load balancer, si celui-ci est dans un VPC.

    • Policies : Informations à propos des politiques pour le load balancer, s’il y en a :

      • LBCookieStickinessPolicies : Le nom de la politique utilisée pour les permanences de sessions basées sur la durée.

      • AppCookieStickinessPolicies : Le nom de la politique pour les permanences de sessions contrôlées par application.

      • OtherPolicies : Le nom de politiques autres que les politiques de permanences de sessions.

    • LoadBalancerName : Le nom du load balancer.

    • CreatedTime : La date et l’heure de création du load balancer.

    • AvailabilityZones : L’ID de l’Availability Zone dans laquelle le load balancer a été créé.

    • Scheme : Le type de load balancer. Pour en savoir plus, voir À propos des load balancers > Types de load balancers.

Exemple de résultat
{
  "LoadBalancerDescriptions": [
    {
      "Subnets": [
          "subnet-12345678"
      ],
      "ListenerDescriptions": [
          {
              "Listener": {
                  "InstancePort": 80,
                  "LoadBalancerPort": 80,
                  "Protocol": "HTTP",
                  "InstanceProtocol": "HTTP"
              },
              "PolicyNames": []
          },
      ],
      "HealthCheck": {
          "HealthyThreshold": 3,
          "Interval": 15,
          "Target": "HTTP:80/index.html",
          "Timeout": 3,
          "UnhealthyThreshold": 3
      },
      "VPCId": "vpc-87654321",
      "BackendServerDescriptions": [
          {
              "InstancePort": 80,
              "PolicyNames": []
          }
      ],
      "Instances": [
          {
              "InstanceId": "i-56781234"
          },
          {
              "InstanceId": "i-43218765"
          }
      ],
      "DNSName": "my-load-balancer-1234567890.lbu.eu-west-2.outscale.com",
      "SecurityGroups": [
          "sg-18273465"
      ],
      "Policies": {
          "LBCookieStickinessPolicies": [],
          "AppCookieStickinessPolicies": [],
          "OtherPolicies": []
      },
      "LoadBalancerName": "my-load-balancer",
      "CreatedTime": "2016-05-12T05:22:08.364Z",
      "AvailabilityZones": [
          "eu-west-2a"
      ],
      "Scheme": "internet-facing",
      "SourceSecurityGroup": {
          "OwnerAlias": "123456789012",
          "GroupName": "my-lb-sg"
      }
    }
  ]
}

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.