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 :
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:GetMetricStatisticscloudwatch:GetMetricDataelasticbeanstalk:DescribeEnvironmentselasticbeanstalk:ListTagsForResourceelasticbeanstalk: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'
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>'
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 ».
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 :
- Dans le menu de navigation de l'interface utilisateur d' Instana, cliquez sur Infrastructure.
- 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