Amazon SQS

Dashboard SQS

Présentation

La solution Amazon Simple Queue Service (SQS) est un service de file d’attente de messagerie entièrement géré, rapide, fiable et évolutif.

Activez cette intégration pour visualiser dans Datadog toutes vos métriques de SQS.

Configuration

Installation

Si vous ne l’avez pas déjà fait, configurez d’abord l’intégration Amazon Web Services.

Collecte de métriques

  1. Dans le carré d’intégration AWS, assurez-vous que l’option SQS est cochée dans la section concernant la collecte des métriques.

  2. Ajoutez ces autorisations à votre stratégie IAM Datadog afin de recueillir des métriques d’Amazon SQS :

    • sqs:ListQueues : utilisé pour répertorier les files d’attente actives.
    • tag:GetResources : récupère les tags personnalisés appliqués aux files d’attente SQS.

    Pour en savoir plus sur les stratégies SQS, consultez la documentation disponible sur le site d’AWS.

  3. Installez l’intégration Datadog/AWS SQS.

Collecte de logs

Activer la journalisation SQS

Consultez la page Journalisation des appels d’API Amazon SQS à l’aide d’AWS CloudTrail pour configurer votre journal de suivi. Lorsque vous définissez un journal de suivi, sélectionnez un compartiment S3 dans lequel écrire les logs :

Journalisation Cloudtrail

Envoyer des logs à Datadog

  1. Si vous ne l’avez pas déjà fait, configurez la fonction Lambda de collecte de logs AWS avec Datadog.
  2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur sur le compartiment S3 qui contient vos logs d’Amazon SQS dans la console AWS. Dans votre Lambda, cliquez sur S3 dans la liste des déclencheurs :
    Configuration déclencheur S3
    Configurez votre déclencheur en choisissant le compartiment S3 qui contient vos logs SQS et remplacez le type d’événement par Object Created (All). Cliquez ensuite sur le bouton Add.
    Configuration déclencheur Lambda S3

Utilisez ensuite le Log Explorer de Datadog pour visualiser vos logs.

Données collectées

Métriques

aws.sqs.approximate_age_of_oldest_message
(gauge)
The approximate age of the oldest non-deleted message in the queue.
Shown as second
aws.sqs.approximate_number_of_messages_delayed
(gauge)
The number of messages in the queue that are delayed and not available for reading immediately. This can happen when the queue is configured as a delay queue or when a message has been sent with a delay parameter.
Shown as message
aws.sqs.approximate_number_of_messages_not_visible
(gauge)
The number of messages that are in flight. Messages are considered in flight if they have been sent to a client but have not yet been deleted or have not yet reached the end of their visibility window.
Shown as message
aws.sqs.approximate_number_of_messages_visible
(gauge)
The number of messages available for retrieval from the queue.
Shown as message
aws.sqs.number_of_empty_receives
(count)
The number of ReceiveMessage API calls that did not return a message.
Shown as message
aws.sqs.number_of_messages_deleted
(count)
The number of messages deleted from the queue.
Shown as message
aws.sqs.number_of_messages_received
(count)
The number of messages returned by calls to the ReceiveMessage API action.
Shown as message
aws.sqs.number_of_messages_sent
(count)
The number of messages added to a queue.
Shown as message
aws.sqs.sent_message_size
(gauge)
The size of messages added to a queue.
Shown as byte

Chacune des métriques récupérées à partir d’AWS se verra assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s’y limiter, le hostname et les groupes de sécurité.

Événements

L’intégration AWS SQS n’inclut aucun événement.

Checks de service

L’intégration AWS SQS n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

PREVIEWING: may/unit-testing