Suivi d'Amazon Timestream

Instana surveille de manière exhaustive vos bases de données Amazon Timestream et vous offre une visibilité sur votre environnement grâce au capteur Amazon Timestream.

Une fois l'agent « Instana » installé, le capteur « Amazon Timestream » est automatiquement déployé et installé. Vous pouvez consulter les indicateurs liés aux bases de données Amazon Timestream s dans l'interface utilisateur d' Instana.

À l'heure actuelle, le suivi des commandes Amazon Timestream n'est disponible que pour LiveAnalytics. La surveillance des instances d' InfluxDB s n'est pas prise en charge.

Timestream, proposé par Amazon pour LiveAnalytics, est une base de données de séries chronologiques rapide, évolutive, entièrement gérée et spécialement conçue pour stocker et analyser des milliards de points de données de séries chronologiques chaque jour. Pour plus d'informations sur les autres services pris en charge par l' AWS, consultez la rubrique « AWS ».

Autorisations IAM requis

Le capteur Amazon Timestream nécessite les autorisations IAM d' AWS suivantes pour surveiller vos bases de données Amazon Timestream :

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • timestream:ListDatabases
  • timestream:DescribeEndpoints
  • timestream:DescribeDatabase
  • timestream:ListTagsForResource

Configuration du capteur Amazon Timestream

Une fois l'agent « Instana » installé, le capteur « Amazon Timestream » est activé par défaut. Les métriques des bases de données Amazon Timestream s sont récupérées toutes les 60 secondes. Vous pouvez modifier ce paramètre dans le<agent_install_dir>/etc/instana/configuration.yml déposer:

com.instana.plugin.aws.timestream:
  cloudwatch_period: 60

Activation de la configuration du proxy

Pour permettre au capteur Amazon d' Timestream s d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :

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

Désactivation du capteur « Timestream » d'Amazon

Pour désactiver la surveillance des bases de données Amazon Timestream, utilisez la configuration suivante :

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

Configuration de la surveillance d'Amazon Web Services ( Timestream ) sur plusieurs comptes d' AWS

Pour configurer la surveillance de plusieursAWS comptes avec unAWS agent dans la même région, vous pouvez utiliser deux approches. Pour plus d'informations, voir Surveillance de plusieursAWS comptes .

AWS approche par profils nommés

Pour remplacer les profils qui surveillent Amazon Timestream, utilisez la configuration suivante :

com.instana.plugin.aws.timestream:
  profile_names:
    - 'profile2'
    - 'profile3'
Remarque : si vous définissez des profils au niveau du service, la configuration globale du profil d' AWS s est remplacée.

Approche AWS STS

Pour remplacer les rôles IAM qui surveillent l' Timestream Amazon, utilisez la configuration suivante :

com.instana.plugin.aws.timestream:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
Remarque : si vous définissez des rôles IAM au niveau d'un service, la configuration globale du rôle IAM « AWS » est remplacée.

Filtrer en définissant des balises

Instana surveille par défaut toutes les bases de données d'Amazon Timestream. Vous pouvez également filtrer les bases de données Amazon Timestream surveillées par Instana en définissant des balises dans le fichier configuration.yaml. Si vous ne souhaitez pas filtrer les bases de données, vous n'avez pas besoin de définir les balises.

Pour définir plusieurs balises, séparez-les par des virgules. Définissez les balises sous forme de paire clé-valeur. Pour simplifier la configuration, vous pouvez définir les balises que vous souhaitez inclure dans la découverte ou exclure de la découverte. Si vous définissez une balise dans les deux listes (inclure et exclure), la liste d'exclusion est prioritaire. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Vous pouvez spécifier la fréquence à laquelle les capteurs interrogent leAWS ressources balisées en utilisant letagged-services-poll-rate propriété de configuration. Par défaut, la valeur est300 secondes.

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

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

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

Pour inclure les bases de données Amazon Timestream comportant des balises dans la recherche, utilisez la configuration suivante :

com.instana.plugin.aws.timestream:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Pour exclure de la recherche les bases de données Amazon Timestream comportant des balises, utilisez la configuration suivante :

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

AWS les services sans balises sont surveillés par défaut, mais peuvent être exclus en définissant leinclude_untagged champ àfalse :

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

Affichage des mesures

Pour afficher les métriques, procédez comme suit :

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur une base de données « Amazon Timestream » surveillée spécifique.

Vous pouvez consulter le tableau de bord de la base de données Amazon Timestream, qui présente toutes les métriques collectées.

Données de configuration

Le capteur Amazon Timestream recueille les données de configuration suivantes :

Nom Description
ARN Le nom de ressource Amazon (ARN) de la base de données Timestream.
Nom de base de données Le nom de la base de données « Timestream ».
Heure de création La date et l'heure de création de la base de données.
Type LiveAnalytics est disponible. La surveillance des instances d' InfluxDB s n'est pas prise en charge.

Métriques

Le capteur « Timestream » d'Amazon recueille les données suivantes :

Nom Description
Temps d'attente de demande réussie La latence des requêtes abouties adressées à Timestream pour LiveAnalytics au cours de la période indiquée. Cette métrique est disponible pour les statistiques suivantes :Minimum ,Maximum ,Average , etSampleCount .
Nombre d'enregistrements rejetés par le magasin magnétique Nombre d’enregistrements magnétiques écrits en magasin qui sont rejetés de manière asynchrone.
Partitions actives du magasin magnétique Nombre de partitions de magasin magnétiques qui ingèrent activement des données à un moment donné.
Latence des enregistrements en attente du magasin magnétique Les plus anciens écrivent dans un magasin magnétique qui n'est pas disponible pour les requêtes.
Échecs de transfert utilisateur, rejetés par le magasin magnétique Nombre de rapports d'enregistrements rejetés par le magasin magnétique qui ne sont pas téléchargés en raison d'erreurs de l'utilisateur.
Échecs de transfert système, rejetés par le magasin magnétique Nombre de rapports d'enregistrements rejetés par le magasin magnétique qui ne sont pas téléchargés en raison d'erreurs système.