Surveillance d'AWS SQS
Le capteur « AWS SQS » est automatiquement déployé et installé une fois que vous avez installé l'agent « Instana ».
Informations complémentaires
Prise en charge du traçage côté client
Capteur (collecte de données)
Configuration suivie
- Adresse du noeud final
- ARN
- Région
- Heure de création
- Période de conservation des messages
- Taille maximale de message
- Dépassement du délai d'attente de la visibilité
- Horodatage de la dernière modification
Métriques
- Nombre de messages retardés
- Nombre de messages non visibles
- Nombre de messages visibles
- Nombre de messages vides reçus
- Nombre de messages reçus
- Nombre de messages envoyés
- Age du message le plus ancien
- Taille des messages envoyés
Droits requis
cloudwatch:GetMetricStatisticscloudwatch:GetMetricDatasqs:ListQueuessqs:GetQueueAttributessqs:ListQueueTags
Configuration
Les métriques de SQS sont extraites toutes les 5 minutes, ce qui peut être modifié via la configuration d'agent dans <agent_install_dir>/etc/instana/configuration.yml:
com.instana.plugin.aws.sqs:
cloudwatch_period: 300
Pour désactiver la surveillance des instances SQS, utilisez la configuration suivante :
com.instana.plugin.aws.sqs:
enabled: false
Configuration de 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.sqs:
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 de plusieurs comptes AWS
Reportez-vous à la documentation Surveillance de plusieurs comptes AWS pour configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région.
Approche des profils nommés AWS
Pour remplacer les profils à utiliser pour surveiller SQS, utilisez la configuration suivante :
com.instana.plugin.aws.sqs:
profile_names:
- 'profile2'
- 'profile3'
Approche AWS STS
Pour remplacer les profils à utiliser pour surveiller SQS, utilisez la configuration suivante :
com.instana.plugin.aws.sqs:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
Filtrage
Plusieurs balises séparées par des virgules peuvent être définies. Les balises doivent être fournies sous forme de paire clé-valeur séparées par un signe deux-points (:). Pour faciliter la configuration, il est possible de définir les balises que vous souhaitez inclure ou exclure dans la reconnaissance. Dans le cas des balises définies dans les deux listes (inclusion et exclusion), la liste d'exclusion a une priorité plus élevée. S'il n'est pas nécessaire de filtrer les services, la configuration ne doit pas être définie. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.
Les utilisateurs ont la possibilité de spécifier la fréquence à laquelle les capteurs interrogeront les ressources balisées AWS à l'aide de la propriété de configuration tagged-services-poll-rate (300 secondes par défaut).
Pour définir la fréquence d'interrogation des ressources balisées, utilisez la configuration suivante :
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
Pour inclure des services par balises dans la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.aws.sqs:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
Pour exclure des services par balises de la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.aws.sqs:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
Les services AWS sans étiquette seront surveillés par défaut mais peuvent être exclus en définissant la zone include_untagged sur false :
com.instana.plugin.aws.sqs:
include_untagged: false # True value by default
Taux d'interrogation
Les utilisateurs ont la possibilité de spécifier la fréquence à laquelle les capteurs interrogeront les ressources balisées AWS à l'aide de la propriété de configuration tagged-services-poll-rate (300 secondes par défaut).
Pour définir la fréquence d'interrogation des ressources balisées, utilisez la configuration suivante :
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300