Surveillance d'AWS DynamoDB

Le capteur « AWS DynamoDB » 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 la documentation sur l' AWS.

Collecte des métriques

Pour consulter les métriques, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte surveillé spécifique, puis vous verrez s'afficher un tableau de bord de l'hôte contenant toutes les métriques collectées et les processus surveillés.

Données de configuration

  • ARN de table
  • Nom de table
  • Statut de table
  • Nombre d'éléments dans la table
  • Table créée à
  • Taille de la table (octets)
  • ARN de flux de table
  • Libellé de flux de table
  • Zone de regroupement (région)

Métriques de performance

Nom
Capacité de lecture consommée
Capacité de lecture mise à disposition
Capacité d'écriture consommée
Capacité d'écriture mise à disposition
Demandes de lecture régulées (Get, Scan, Query, Batch Get)
Demandes d'écriture régulées (Put, Update, Delete, Batch Write)
Durée de vie - Eléments supprimés
Echec de la vérification conditionnelle
Erreurs utilisateur
Erreurs système lues (Get, Scan, Query, Batch get)
Erreurs système d'écriture (Put, Update, Delete, Batch write)
Nombre d'éléments de requête renvoyés (Minimum, Maximum, Average, Sum)
Nombre d'éléments d'analyse renvoyés (Minimum, Maximum, Average, Sum)
Temps d'attente d'obtention du lot (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente d'écriture de lot (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente de suppression (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente d'obtention (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente d'insertion (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente de requête (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente d'analyse (Minimum, Maximum, Average, Sum, Request count)
Temps d'attente de mise à jour (Minimum, Maximum, Moyenne, Sum, Request count)

Pour plus d'informations, consultez la section « Indicateurs et dimensions » sur Amazon DynamoDB.

Signatures d'intégrité

Pour chaque détecteur, il existe une base de connaissances organisée de signatures de santé qui sont évaluées en continu par rapport aux métriques entrantes et qui sont utilisées pour signaler des problèmes ou des incidents qui dépendent de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures de santé défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.

Pour plus d'informations sur les événements intégrés du capteur « AWS DynamoDB », consul tez la référence des événements intégrés.

Droits requis

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • dynamodb:ListTables
  • dynamodb:DescribeTable
  • dynamodb:ListTagsOfResource

Configuration

Les instances Beanstalk sont actualisées toutes les 5 minutes. En raison d'une nature asynchrone de détection, les métriques d'instance peuvent être en retard. Ce délai dépend du taux d'interrogation spécifié (cloudwatch_period) et, par défaut, il ne dépasse pas une minute avant qu'ils n'apparaissent sur le tableau de bord. Les métriques de DynamoDB sont extraites toutes les 5 minutes et peuvent être modifiées via la configuration d'agent dans /opt/instana/agent/etc/instana/configuration.yml:

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

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

com.instana.plugin.aws.dynamodb:
  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.dynamodb:
  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 définir les profils pouvant être utilisés pour surveiller DynamoDB,, utilisez la configuration suivante :

com.instana.plugin.aws.dynamodb:
  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 définir quels rôles IAM peuvent être utilisés pour surveiller DynamoDB,, utilisez la configuration suivante :

com.instana.plugin.aws.dynamodb:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_3_name>'
Remarque : la définition de rôles IAM au niveau du service remplace la configuration globale des rôles IAM sur AWS.

Filtrage

Plusieurs balises séparées par des virgules peuvent être définies. Les balises sont fournies sous la forme d'une paire clé-valeur séparée par un caractère : . Pour améliorer la configuration, il est possible de définir les balises à inclure dans la reconnaissance ou à exclure de la reconnaissance. Si des balises sont 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, il n'est pas nécessaire de définir la configuration. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Les utilisateurs peuvent spécifier la fréquence à laquelle les détecteurs interrogent les ressources étiquetées AWS qui utilisent la propriété de configuration tagged-services-poll-rate (valeur 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, 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.dynamodb:
  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.dynamodb:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Les services AWS sans balises sont surveillés par défaut mais peuvent être exclus en définissant la zone include_untagged sur false:

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

Taux d'interrogation

Pour définir la fréquence à laquelle les détecteurs interrogent les ressources balisées, utilisez la configuration suivante:

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