Surveillance d'AWS Beanstalk

Vous pouvez surveiller votre service AWS Beanstalk avec le capteur AWS Instana pour obtenir des informations sur les performances et l'état de vos applications web.

Une fois l 'agent Instana AWS installé, le capteur AWS Beanstalk est automatiquement déployé et installé. Pour surveiller les instances Beanstalk, activez la surveillance avancée dans la console d' AWS, puis sélectionnez les métriques souhaitées dans la configuration de l'environnement. Vous pouvez ensuite consulter les métriques Beanstalk dans l'interface utilisateur d' Instana.

Pour plus d'informations sur les autres services pris en charge par l' AWS, consultez la documentation de l' AWS.

Conditions préalables à la surveillance

Assurez-vous que les prérequis suivants sont respectés :

  • L'agent Instana AWS est installé. Pour plus d'informations, consultez la section « Installation de l'agent d' AWS ».
  • La surveillance avancée est activée dans la console d' AWS.
  • Les indicateurs souhaités sont sélectionnés dans la configuration de l'environnement.

Configuration de la surveillance

Une fois l'agent « AWS » installé, le capteur « AWS Beanstalk » est automatiquement déployé et installé. Pour surveiller les instances d' AWS Beanstalk, vous devez suivre les étapes suivantes :

  1. Ajouter les autorisations IAM requises
  2. Facultatif : configurer le capteur « AWS Beanstalk »

Une fois ces étapes terminées, vous pouvez consulter les indicateurs dans l'interface utilisateur d' Instana. Pour plus d'informations, consultez la section « Affichage des indicateurs ».

Ajout des autorisations IAM requises

Pour surveiller les environnements d' AWS Beanstalk, ajoutez les autorisations suivantes aux configurations des rôles IAM. Pour plus d'informations, consultez la configuration IAM d'Amazon Web Services.

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • elasticbeanstalk:DescribeEnvironments
  • elasticbeanstalk:ListTagsForResource
  • elasticbeanstalk:DescribeInstancesHealth

Grâce à ces autorisations, l'agent Instana AWS peut détecter et surveiller vos ressources AWS.

Facultatif : Configuration du capteur « AWS Beanstalk »

Une fois l'agent « Instana » installé et les autorisations requises accordées, le capteur « AWS Beanstalk » est activé par défaut. Le capteur commence à collecter des métriques à partir des environnements et des instances d' AWS Beanstalk. Vous pouvez modifier les paramètres de configuration suivants pour améliorer la surveillance :

Définition de l'intervalle de collecte des métriques

Les instances Beanstalk sont actualisées toutes les 60 secondes. En raison de la nature asynchrone de la détection, l'affichage des métriques des instances dans l'interface utilisateur d' Instana peut être retardé. Ce délai dépend de la fréquence d'interrogation (cloudwatch_period) spécifiée dans le fichier de configuration de l'agent.

Par défaut, le capteur « AWS Beanstalk » récupère et affiche les métriques de l'instance sur le tableau de bord « Instana » toutes les 60 secondes. Pour modifier ce paramètre, modifiez la valeur du cloudwatch_period paramètre de configuration dans le fichier YAML de /opt/instana/agent/etc/instana/configuration.ymlconfiguration de l'agent :

com.instana.plugin.aws.beanstalk:
  cloudwatch_period: 60

Configuration du proxy

Pour configurer le capteur AWS spécifique, afin d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :

com.instana.plugin.aws.beanstalk:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Surveillance des environnements d' AWS Beanstalk s sur plusieurs comptes d' AWS

Vous devez définir les profils ou les rôles à utiliser pour surveiller les environnements Beanstalk sur plusieurs comptes d' AWS.

Pour plus d'informations sur la configuration de la surveillance de plusieurs comptes AWS à l'aide d'un seul agent AWS dans la même région, consultez la section « Surveillance de plusieurs comptes AWS ».

Approche des profils nommés AWS

Pour définir les profils à utiliser pour la surveillance de Beanstalk, ajoutez les profils supplémentaires que l'agent AWS doit utiliser :

com.instana.plugin.aws.beanstalk:
  profile_names:
    - 'profile2'
    - 'profile3'
Remarque : la définition de profils au niveau du service remplace la configuration globale des profils d' AWS.
Approche AWS STS

Pour définir manuellement les rôles IAM à utiliser pour la surveillance de Beanstalk, indiquez les ARN des rôles IAM de tous les comptes AWS supplémentaires :

com.instana.plugin.aws.beanstalk:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_3_name>'
Remarque : la définition de rôles IAM au niveau du service remplace la configuration globale des rôles IAM de AWS.

Filtrage des instances d' AWS Beanstalk s à des fins de surveillance

Une fois le capteur « AWS Beanstalk » activé, il surveille par défaut toutes les instances d' AWS Beanstalk. Vous pouvez toutefois filtrer les instances d' AWS Beanstalk s que le capteur doit détecter et surveiller en fonction des balises d' AWS. Pour configurer le filtrage, modifiez le fichier de configuration de l'agent /opt/instana/agent/etc/instana/configuration.yaml AWS.

Plusieurs balises séparées par des virgules peuvent être définies. Les balises doivent être fournies sous forme de paires clé-valeur séparées par deux points (:). Pour faciliter la configuration, vous pouvez définir les balises à inclure ou à exclure de la détection. Si vous définissez une balise dans les deux listes (inclusion et exclusion), la liste d'exclusion a la priorité. Si vous n'avez pas besoin de services de filtrage, ne définissez pas la configuration. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Vous pouvez définir la fréquence à laquelle les capteurs interrogent les ressources marquées d' AWS s qui utilisent la propriété tagged-services-poll-rate de configuration (par défaut : 300 secondes). Pour plus d'informations, consultez la section « Modification de la fréquence d'interrogation ».

Remarque : les balises ne sont disponibles qu'avec l 'agent « AWS ».

Pour inclure les instances Beanstalk portant les balises spécifiées dans la découverte, ajoutez leurs balises à la configuration suivante :

com.instana.plugin.aws.beanstalk:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Pour exclure de la détection les instances Beanstalk associées aux balises spécifiées, ajoutez ces balises à la configuration suivante :

com.instana.plugin.aws.beanstalk:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Les instances Beanstalk sans balises sont surveillées par défaut, mais peuvent être exclues en définissant le include_untagged champ sur false:

com.instana.plugin.aws.beanstalk:
  include_untagged: false # True value by default

Modification de la fréquence d'interrogation

Pour définir la fréquence à laquelle les capteurs interrogent les ressources balisées, modifiez le tagged-services-poll-rate dans la configuration suivante :

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

Affichage des indicateurs et des données de configuration

Pour consulter les indicateurs, procédez comme suit :

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, cliquez sur Infrastructure.
  2. Cliquez sur un hôte spécifique.

Vous pouvez consulter un tableau de bord de l'hôte qui présente toutes les métriques collectées et les processus surveillés.

Données de configuration suivies

Le capteur « AWS Beanstalk » recueille les données de configuration suivantes :

Détails de l'environnement

Le capteur surveille les paramètres environnementaux suivants :

  • Nom de l'application
  • ID d'environnement
  • Nom de l'environnement
  • Description de l'environnement
  • ARN de l'environnement
  • Statut de l'environnement
  • Date de création
  • Libellé de version
  • Pile de solutions
  • URL de l'environnement
  • Nom de l'application
  • Nom de l'application
  • Nom de l'application
  • Zone de regroupement (région)

Détails de l'instance

Le capteur suit les détails suivants relatifs à l'instance :

  • ID d'instance
  • Statut de l'instance
  • Type d'instance
  • Date de début de l'instance

Métriques

Le capteur « AWS Beanstalk » recueille les indicateurs suivants :

Métriques d'environnement

Le tableau suivant présente les indicateurs d'environnement collectés par le capteur :

Nom Description
EnvironmentHealth Intégrité de l'environnement représenté par l'un des sept statuts possibles
InstancesOk Nombre d'instances dans l'environnement avec le statut Ok
InstancesInfo Nombre d'instances dans l'environnement avec le statut des informations
InstancesUnknown Nombre d'instances dans l'environnement avec le statut Unknown
InstancesNoData Nombre d'instances dans l'environnement avec le statut NoData
InstancesWarning Nombre d'instances dans l'environnement avec le statut Avertissement
InstancesDegraded Nombre d'instances dans l'environnement avec le statut Degraded
InstancesSevere Nombre d'instances dans l'environnement avec le statut Severe

Métriques d'instance

Le tableau suivant présente les métriques d'instance collectées par le capteur :

Nom Description
InstanceHealth Etat d'intégrité actuel de l'instance
CPUIrq Pourcentage de temps que l'UC a passé à l'état irq
CPUIdle Pourcentage de temps que l'UC a passé à l'état inactif
CPUUser Pourcentage de temps passé par l'UC à l'état utilisateur
CPUSystem Pourcentage de temps passé par l'UC à l'état système
CPUSoftirq Pourcentage de temps passé par l'UC à l'état softirq
CPUIowait Pourcentage de temps que l'UC a passé à l'état iowait
CPUNice Pourcentage de temps passé par l'UC à l'état nice
LoadAverage1min Charge UC de l'instance au cours de la dernière minute
RootFilesystemUtil Pourcentage d'espace disque utilisé par l'instance

Métriques de l'environnement et des instances

Le tableau suivant présente les indicateurs d'environnement et d'instance collectés par le capteur :

Nom Description
ApplicationLatencyP10 Temps nécessaire pour exécuter le plus rapidement 10 % des demandes
ApplicationLatencyP50 Temps nécessaire pour exécuter le plus rapidement 50 % des demandes
ApplicationLatencyP75 Temps nécessaire pour exécuter le plus rapidement 75 % des demandes
ApplicationLatencyP85 Temps nécessaire pour exécuter le plus rapidement 85 % des demandes
ApplicationLatencyP90 Temps nécessaire pour exécuter le plus rapidement 90 % des demandes
ApplicationLatencyP95 Temps nécessaire pour exécuter le plus rapidement 95 % des demandes
ApplicationLatencyP99 Temps nécessaire pour exécuter le plus rapidement 99 % des demandes
ApplicationLatencyP99.9 Temps nécessaire pour exécuter le plus rapidement 99,9 % des demandes
ApplicationRequests2xx Nombre de demandes ayant abouti avec le code d'état 2xx
ApplicationRequests3xx Nombre de demandes ayant abouti avec le code d'état 3xx
ApplicationRequests4xx Nombre de demandes ayant abouti avec le code d'état 4xx
ApplicationRequests5xx Nombre de demandes ayant abouti avec le code d'état 5xx
ApplicationRequestsTotal Nombre total de demandes

Désactivation de la surveillance

Pour désactiver la surveillance des instances Beanstalk, modifiez les paramètres suivants dans le fichier de configuration de l'agent :

com.instana.plugin.aws.beanstalk:
  enabled: false