Surveillance d'Amazon Simple Notification Service (SNS)

Modifier en ligne

Surveillez votre service Amazon SNS à l'aide d' Instana. Vous bénéficierez ainsi d'une visibilité de bout en bout et d'informations en temps réel sur les performances de votre service.

Pour plus d'informations, consultez Amazon SNS.

Pour surveiller Amazon SNS, installez l 'agent Instana dans votre environnement. L'agent installe et active automatiquement le capteur Amazon SNS, qui collecte les métriques liées à Amazon SNS. Vous pouvez consulter ces indicateurs 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.

Ajout des autorisations IAM requises

Modifier en ligne

Ajoutez les autorisations de rôle IAM suivantes à l'hôte exécutant l'agent Instana afin que celui- Instana puisse découvrir et surveiller vos instances AWS SNS :

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • sns:ListTopics
  • sns:ListTagsForResource
  • sns:GetTopicAttributes

Configuration du capteur Amazon SNS

Modifier en ligne

Une fois l'agent « Instana » installé, le capteur Amazon SNS est activé par défaut.

Désactivation du capteur Amazon SNS

Modifier en ligne

Pour désactiver la surveillance des instances Amazon SNS, utilisez la configuration suivante:

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

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

Modifier en ligne

Par défaut, les métriques pour SNS sont extraites toutes les 5 minutes. Pour modifier cette fréquence, éditez la valeur cloudwatch_period dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yml comme illustré dans l'exemple suivant:

com.instana.plugin.aws.sns:
  cloudwatch_period: 300

Configuration des paramètres de proxy

Modifier en ligne

Pour configurer le détecteur Amazon SNS afin qu'il utilise la configuration de proxy, ajoutez les paramètres de configuration d'agent suivants:

com.instana.plugin.aws.sns:
  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

Configuration de la surveillance d'Amazon SNS sur plusieurs comptes d' AWS

Modifier en ligne

Vous pouvez configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région. Pour plus d'informations, voir Surveillance de plusieurs comptes AWS.

Pour configurer l'agent d' Instana s afin de surveiller Amazon SNS sur plusieurs comptes d' AWS, procédez de l'une des manières suivantes :

Approche des profils nommés AWS

Modifier en ligne

Pour remplacer les profils utilisés pour surveiller Amazon SNS, utilisez la configuration suivante:

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

AWS Approche du service de jetons de sécurité (STS)

Modifier en ligne

Pour remplacer les rôles IAM utilisés pour surveiller Amazon SNS, utilisez la configuration suivante:

com.instana.plugin.aws.sns:
  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.

Filtrer les services Amazon SNS en définissant des balises

Modifier en ligne
Remarque : si vous souhaitez surveiller tous les services Amazon SNS sans filtrage, évitez de définir une configuration.

Instana surveille par défaut tous les services Amazon SNS. Toutefois, si vous ne souhaitez pas surveiller tous les services, définissez les balises que vous souhaitez inclure ou exclure de la reconnaissance dans le fichier configuration.yaml de l'agent. Si vous définissez une balise ou un groupe de ressources dans les deux listes (inclusion et exclusion), la liste d'exclusion est prioritaire.

Pour définir plusieurs balises, séparez-les par des virgules. Définissez les balises en tant que paire clé-valeur séparée par un signe deux-points (:). Vous n'avez pas besoin de définir toutes les valeurs pour activer le filtrage.

Pour inclure des services par balises dans la reconnaissance, mettez à jour le fichier configuration.yaml comme illustré dans l'exemple suivant:

com.instana.plugin.aws.sns:
  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, mettez à jour le fichier configuration.yaml comme illustré dans l'exemple suivant:

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

Les services Amazon SNS sans balises sont surveillés par défaut mais peuvent être exclus en définissant la zone include_untagged sur false , comme illustré dans l'exemple suivant:

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

Définition de la fréquence d'interrogation

Modifier en ligne

Vous pouvez spécifier la fréquence à laquelle les détecteurs interrogent les ressources référencées AWS à l'aide de la propriété de configuration tagged-services-poll-rate . Par défaut, 300 secondes.

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

Pour définir la fréquence à laquelle les détecteurs interrogent les ressources balisées, mettez à jour le fichier configuration.yaml comme illustré dans l'exemple suivant:

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

Affichage des mesures

Modifier en ligne

Pour afficher les métriques, 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écifié.

Vous pouvez voir un tableau de bord hôte avec toutes les métriques collectées et les processus surveillés. Les métriques sont extraites toutes les 5 minutes.

Configuration suivie

Modifier en ligne

Le tableau suivant présente les données de configuration que le capteur recueille auprès des instances Amazon SNS :

Détails de la rubrique SNS Description
ARN Nom de ressource Amazon (ARN) non qualifié affecté à la rubrique.
Zone de disponibilité Emplacement de l'instance.
Nom de la rubrique Nom de la rubrique.
Nom d'affichage Nom de rubrique défini par l'utilisateur.
Abonnements confirmés Nombre d'abonnements confirmés.
Nombre de nouvelles tentatives Nombre maximal de nouvelles tentatives de notification.
Délai cible minimal Délai minimal pour l'abonnement cible.
Délai cible maximal Délai maximal de l'abonnement cible.

Métriques

Modifier en ligne

Le tableau suivant présente les indicateurs que le capteur recueille auprès des instances Amazon SNS :

Mesures de rubrique Description
NumberOfMessagesPublished Nombre de messages publiés dans vos rubriques Amazon SNS.
NumberOfNotificationsFailedToRedriveToDlq Nombre de messages qui ne sont pas déplacés dans une file d'attente de rebut.
NumberOfNotificationsDelivered Nombre de messages correctement distribués à partir de vos rubriques Amazon SNS aux noeuds finaux abonnés.
PublishSize Taille des messages publiés.
NumberOfNotificationsRedrivenToDlq Nombre de messages déplacés dans une file d'attente de rebut.
NumberOfNotificationsFailed Nombre de messages qu'Amazon SNS n'a pas pu distribuer.
NumberOfNotificationsFilteredOut Nombre de messages rejetés par les règles de filtre d'abonnement. Une politique de filtrage rejette un message lorsque les attributs de ce dernier ne correspondent pas à ceux de la politique.