Surveillance d'AWS SQS

Le capteur « AWS SQS » est automatiquement déployé et installé une fois que vous avez installé l'agent « Instana ».

Remarque : pour en savoir plus sur les autres services pris en charge par l' AWS, consultez notre documentation sur l' AWS.

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:GetMetricStatistics
  • cloudwatch:GetMetricData
  • sqs:ListQueues
  • sqs:GetQueueAttributes
  • sqs: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'
 
Remarque : la définition de profils au niveau du service remplace la configuration globale des profils d' AWS.

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>'
 
Remarque : la définition de rôles IAM au niveau du service remplace la configuration globale des rôles IAM de AWS.

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).

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

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