

Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création et connexion à une instance Timestream pour InfluxDB
<a name="timestream-for-influx-getting-started-creating-db-instance"></a>

Ce didacticiel crée une instance Amazon EC2 et une instance de base de données Amazon Timestream pour InfluxDB. Le didacticiel explique comment écrire des données sur l'instance de base de données à partir de l'instance EC2 à l'aide du client Telegraf. En tant que bonne pratique, ce didacticiel crée une instance de base de données privée dans un cloud privé virtuel (VPC). Dans la plupart des cas, d'autres ressources du même VPC, telles que les instances EC2, peuvent accéder à l'instance de base de données, mais les ressources extérieures au VPC ne peuvent pas y accéder.

Une fois le didacticiel terminé, il y aura un sous-réseau public et un sous-réseau privé dans chaque zone de disponibilité de votre VPC. Dans une zone de disponibilité, l'instance EC2 se trouvera dans le sous-réseau public et l'instance de base de données dans le sous-réseau privé.

**Note**  
La création d'un AWS compte est gratuite. Cependant, en suivant ce didacticiel, les AWS ressources que vous utilisez peuvent vous coûter cher. Vous pouvez supprimer ces ressources après avoir terminé le didacticiel si elles ne sont plus nécessaires.

Le schéma suivant montre la configuration lorsque l'accessibilité est publique.

![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/public.png)


**Avertissement**  
Nous ne recommandons pas d'utiliser 0.0.0.0/0 pour l'accès HTTP, car vous permettriez à toutes les adresses IP d'accéder à votre instance publique InfluxDB via HTTP. Cette approche n'est pas acceptable, même pour une courte période, dans un environnement de test. Autorisez uniquement une adresse IP ou une plage d'adresses spécifique pour accéder à vos instances InfluxDB à l'aide du protocole HTTP pour l'accès à l'interface utilisateur Web ou à l'API.

Ce didacticiel crée une instance de base de données exécutant InfluxDB avec le. AWS Management Console Nous nous concentrerons uniquement sur la taille de l'instance de base de données et sur l'identifiant de l'instance de base de données. Nous utiliserons les paramètres par défaut pour les autres options de configuration. L'instance de base de données créée par cet exemple sera privée.

Les autres paramètres que vous pouvez configurer incluent la disponibilité, la sécurité et la journalisation. Pour créer une instance de base de données publique, vous devez choisir de rendre votre instance **accessible au public** dans la section **Configuration de la connectivité**. Pour plus d'informations sur la création d'instances de base de données, consultez[Création d’une instance de base de données](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db).

Si votre instance n'est pas accessible au public, procédez comme suit :
+ Créez un hôte sur le VPC de l'instance par lequel vous pouvez canaliser le trafic.
+ Configurez le tunneling SSH vers l'instance. Pour plus d'informations, consultez la section [Redirection de port d'instance Amazon EC2](https://aws.amazon.com/blogs/mt/amazon-ec2-instance-port-forwarding-with-aws-systems-manager/) avec. AWS Systems Manager
+ Pour que le certificat fonctionne, ajoutez la ligne suivante au `/etc/hosts` fichier de votre machine cliente :`127.0.0.1`. Il s'agit de l'adresse DNS de votre instance. 
+ <DNS>Connectez-vous à votre instance à l'aide du nom de domaine complet, par exemple *https : //:8086*. 
**Note**  
Localhost n'est pas en mesure de valider le certificat car localhost ne fait pas partie du certificat SAN.

Le schéma suivant montre la configuration lorsque l'accessibilité est privée :

![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/private.png)


## Conditions préalables
<a name="timestream-for-influx-getting-started-creating-db-instance-prereq"></a>

Avant de commencer, suivez les étapes détaillées dans les sections suivantes : 
+  Ouvrez un AWS compte.
+ Créez un utilisateur administratif.

## Étape 1 : créer une instance Amazon EC2
<a name="timestream-for-influx-getting-started-creating-db-instance-step1"></a>

Créez une instance Amazon EC2 que vous utiliserez pour vous connecter à votre base de données.

1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Dans le coin supérieur droit du AWS Management Console, choisissez la AWS région dans laquelle vous souhaitez créer l'instance EC2.

1. Choisissez **EC2 Dashboard**, puis **Launch instance**.

1. Lorsque la page **Lancer une instance** s'ouvre, choisissez les paramètres suivants :

   1. Sous **Nom et tags**, entrez `ec2-database-connect` le champ **Nom**.

   1. Sous **Images d'applications et de systèmes d'exploitation (Amazon Machine Image)**, choisissez **Amazon Linux**, puis sélectionnez **Amazon Linux 2023 AMI**. Conservez les sélections par défaut pour les autres choix.

   1. Sous **Instance type** (Type d’instance), choisissez **t2.micro**.

   1. Sous **Key pair (login)** [Paire de clés (connexion)], choisissez une valeur **Key pair name** (Nom de paire de clés) pour utiliser une paire de clés existante. Pour créer une paire de clés pour l’instance Amazon EC2, choisissez **Create new key pair** (Créer une paire de clés), puis utilisez la fenêtre **Create key pair** (Créer une paire de clés) pour la créer. Pour plus d'informations sur la création d'une nouvelle paire de clés, consultez la section [Créer une paire de clés pour votre instance Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html) dans le guide de l'*utilisateur d'Amazon Elastic Compute Cloud*.

   1. Pour **Autoriser le trafic SSH depuis** les **paramètres réseau**, choisissez la source des connexions SSH à l'instance EC2. Vous pouvez choisir **My IP** (Mon IP) si l’adresse IP affichée est correcte pour les connexions SSH. Sinon, vous pouvez déterminer l’adresse IP à utiliser pour vous connecter aux instances EC2 dans votre VPC en utilisant Secure Shell (SSH). Pour déterminer votre adresse IP publique, dans une autre fenêtre ou un autre onglet du navigateur, vous pouvez utiliser le service à l'adresse [checkip.amazonaws.com/](https://checkip.amazonaws.com). Exemple d’adresse IP : `192.0.2.1/32`. Dans de nombreux cas, votre connexion s’effectue via un fournisseur de services Internet (FSI) ou derrière votre pare-feu sans adresse IP statique. Si tel est le cas, assurez-vous de déterminer la plage d’adresses IP utilisées par les ordinateurs clients.
**Avertissement**  
Nous vous déconseillons d'utiliser 0.0.0.0/0 pour l'accès SSH, car vous permettriez à toutes les adresses IP d'accéder à vos instances EC2 publiques via SSH. Cette approche n'est pas acceptable, même pour une courte période, dans un environnement de test. Autorisez uniquement une adresse IP ou une plage d'adresses spécifiques pour accéder à vos instances EC2 via SSH.

## Étape 2 : créer une instance de base de données InfluxDB
<a name="timestream-for-influx-getting-started-creating-db-instance-step2"></a>

L'élément de base d'Amazon Timestream pour InfluxDB est l'instance de base de données. C'est dans cet environnement que vous exécutez vos bases de données InfluxDB.

Dans cet exemple, vous allez créer une instance de base de données exécutant le moteur de base de données InfluxDB avec une classe d'instance de base de données db.influx.large.

1. [Connectez-vous à la console Amazon Timestream pour InfluxDB AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/timestream/](https://console.aws.amazon.com/timestream/) 

1. Dans le coin supérieur droit de la console Amazon Timestream pour InfluxDB, choisissez la région dans laquelle vous souhaitez créer AWS l'instance de base de données.

1. Dans le volet de navigation, choisissez **InfluxDB** Databases.

1. Choisissez **Créer une base de données InfluxDB.**  
![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/CreateInfluxDatabase.png)

1. Dans la section **Paramètres de déploiement**, sélectionnez **Cluster avec répliques de lecture**. Choisissez **Afficher les options d'abonnement** pour démarrer un abonnement au module complémentaire Read Replica. Pour de plus amples informations, veuillez consulter [Consultez les licences de répliques via AWS MarketplaceLire la terminologie relative aux licences de répliques](timestream-for-influx-rr-licensing.md).

1. Dans la section **Informations d'identification de la base** de données, entrez KronosTest -1 pour le **nom du cluster** de base de données.

1. **Fournissez les paramètres de configuration de base d'InfluxDB : **nom d'utilisateur initial**, nom de **l'organisation initiale, nom du** **bucket initial et mot de passe**.**
**Important**  
Vous ne pourrez plus consulter le mot de passe utilisateur. Vous ne pourrez pas accéder à votre instance et obtenir un jeton d'opérateur sans votre mot de passe. Si vous ne l’enregistrez pas, il sera peut-être nécessaire de le modifier. Consultez [Création d'un nouveau jeton d'opérateur pour votre instance InfluxDB](timestream-for-influx-getting-started-operator-token.md).  
Si vous devez modifier le mot de passe utilisateur une fois que l'instance de base de données est disponible, vous pouvez modifier l'instance de base de données pour le faire. Pour plus d’informations sur la modification d’une instance de base de données, consultez [Mise à jour des instances de base de données](timestream-for-influx-managing-modifying-db.md).  

![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/CreateInfluxDatabaseDetails.png)


1. Dans la section **Configuration de l'instance**, sélectionnez la classe d'instance de base de **données db.influx.large**.

1. Dans la section **Configuration du stockage**, sélectionnez **Influx IO Included (3K)** pour le **type de stockage**.

1. Dans la section **Configuration de la connectivité**, sélectionnez **IPv4**le **type de réseau**. Assurez-vous que votre instance InfluxDB se trouve dans le même sous-réseau que votre instance EC2 nouvellement créée. Sous **Accès public**, sélectionnez **Non accessible au public** pour rendre votre instance de base de données privée.  
![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/ConnectivityConfiguration.png)

1. Dans les sections Paramètres de **basculement et Paramètres** **du groupe de paramètres**, conservez les valeurs par défaut.

1. Configurez vos **journaux dans les paramètres de livraison** des journaux et créez des balises (facultatif). Pour de plus amples informations sur les journaux, veuillez consulter [Configuration pour afficher les journaux InfluxDB sur les instances Timestream Influxdb](timestream-for-influx-managing-view-influx-logs.md). Pour plus de détails sur l'ajout de balises, consultez[Ajout d'identifications et d'étiquettes aux ressources](tagging-keyspaces-influxdb.md).

1. Choisissez **Créer une base de données InfluxDB.**

1. Dans la liste des **bases** de données, choisissez le nom de votre nouvelle instance InfluxDB pour afficher ses détails. L'instance de base de données a le statut **Création en cours** jusqu'à ce qu'elle soit prête à l'emploi.

Vous pouvez vous connecter à l'instance de base de données lorsque le statut passe à **Disponible**. En fonction de la quantité de stockage et de la classe d’instance de base de données, la mise à disposition de la nouvelle instance peut prendre jusqu’à 20 minutes.

**Important**  
Pour le moment, vous ne pouvez pas modifier les configurations de calcul (types d'instances) et de stockage (types de stockage) des instances existantes.

## Étape 3 : Accédez à l'interface utilisateur d'InfluxDB
<a name="timestream-for-influx-getting-started-creating-db-instance-step-3"></a>

Pour accéder à l'interface utilisateur InfluxDB à partir d'une instance privée Timestream for InfluxDB, vous devez vous connecter au sein du même sous-réseau et du même groupe de sécurité. L'un des moyens de faciliter cette connexion consiste à créer un hôte bastion dans le sous-réseau privé.

Un hôte bastion est un serveur spécialisé qui agit comme un point d'entrée sécurisé vers les systèmes critiques, protégeant ainsi votre réseau des accès externes. Il sert de passerelle entre votre réseau interne sécurisé et le monde extérieur.

**Note**  
Pour accéder au public à Timestream pour les instances de base de données InfluxDB, vous pouvez accéder à l'interface utilisateur InfluxDB via le bouton d'interface utilisateur **InfluxDB sur la page** des détails de l'instance de la console. Notez que ce bouton sera désactivé pour les instances qui ne sont pas accessibles au public.  
Si vous avez une instance de base de données publique, connectez-vous à l'interface utilisateur d'InfluxDB via la console et passez à. [Étape 4 : Envoyer des données Telegraf à votre instance InfluxDB](#timestream-for-influx-getting-started-creating-db-instance-step4)

![Interface récapitulative montrant les détails d'une base de données privée InfluxDB. Le bouton de l'interface utilisateur InfluxDB est désactivé.](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/InfluxDB-database-summary.png)


Pour créer et configurer votre hôte bastion, procédez comme suit : 

1. **Création d'un hôte bastion :** pour créer un hôte bastion, vous pouvez lancer une nouvelle instance EC2 ou utiliser une instance existante. Assurez-vous que l'instance dispose de la configuration réseau nécessaire pour accéder au groupe de sécurité que vous avez utilisé pour créer le Timestream privé pour l'instance InfluxDB à laquelle vous essayez d'accéder.

1. **Connectez-vous à l'interface utilisateur d'InfluxDB :** une fois que vous avez créé un hôte bastion, vous pouvez utiliser le point de terminaison affiché dans la console pour vous connecter à l'interface utilisateur d'InfluxDB. Le format du point de terminaison est `<db-identifier>-<*>.timestream-influxdb.<region>.on.aws`. En Chine, ce sera le cas`<db-identifier>-<*>.timestream-influxdb.<region>.on.amazonwebservices.com.rproxy.govskope.ca.cn`.

1. **Configurez votre hôte Bastion pour le transfert local :** pour configurer le transfert local, utilisez le gestionnaire de session AWS Systems Manager (SSM). Exécutez la commande suivante, en {{bastion-ec2-instance-id}} remplaçant par l'ID de votre instance hôte Bastion, {{endpoint}} par le point de terminaison affiché dans la console ci-dessus et {{port-number}} par le numéro de port que vous souhaitez utiliser :

   ```
   aws ssm start-session --target {{bastion-ec2-instance-id}} \
   --document-name AWS-StartPortForwardingSessionToRemoteHost \
   --parameters '{"host":["{{endpoint}}"], "portNumber":["{{port-number}}"], "localPortNumber":["{{port-number}}"]}'
   ```

   Vous serez peut-être invité à installer le SessionManagerPlugin. Pour plus de détails, voir [Installer le plug-in Session Manager pour le AWS CLI](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html).

1. **Accédez à l'interface utilisateur InfluxDB :** Après avoir effectué les étapes ci-dessus, vous pouvez accéder à l'interface utilisateur InfluxDB à l'adresse http://localhost :. {{port-number}} Vous devrez accuser réception du message « non sécurisé ».

1. **Activer la validation du nom de domaine :** pour activer la validation du nom de domaine, ajoutez la ligne suivante à votre `/etc/hosts` fichier `/private/etc/hosts` (Linux), (Mac) ou `C:\Windows\System32\drivers\etc` (Windows).

   ```
   127.0.0.1    {{endpoint}}
   ```

1. Vous pouvez désormais accéder à l'interface utilisateur d'InfluxDB en utilisant https ://{{endpoint}}:. {{port-number}}

## Étape 4 : Envoyer des données Telegraf à votre instance InfluxDB
<a name="timestream-for-influx-getting-started-creating-db-instance-step4"></a>

Vous pouvez maintenant commencer à envoyer des données de télémétrie à votre instance de base de données InfluxDB à l'aide de l'agent Telegraf. Dans cet exemple, vous allez installer et configurer un agent Telegraf pour envoyer des mesures de performance à votre instance de base de données InfluxDB.

1. Une fois connecté à l'interface utilisateur d'InfluxDB, vous devriez voir une nouvelle fenêtre de navigateur avec une invite de connexion. Entrez les informations d'identification que vous avez utilisées précédemment pour créer votre instance de base de données InfluxDB.

1. Dans le volet de navigation de gauche, cliquez sur l'icône en forme de flèche et sélectionnez **API Tokens**.

1. Pour ce test, choisissez **Generate API Token**. Sélectionnez **All Access API Token** dans la liste déroulante.
**Note**  
Pour les scénarios de production, nous vous recommandons de créer des jetons avec un accès spécifique aux compartiments requis conçus pour les besoins spécifiques de Telegraf.  
![](http://docs.aws.amazon.com/fr_fr/timestream/latest/developerguide/images/kronos/AllAccessAPIToken.png)

1. Votre jeton apparaîtra à l'écran.
**Important**  
Assurez-vous de copier et d'enregistrer le jeton, car il ne sera plus affiché.

1. Connectez-vous à l'instance EC2 que vous avez créée précédemment en suivant les étapes décrites dans [Connect to your Linux instance using SSH](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-to-linux-instance.html) dans le manuel *Amazon Elastic Compute Cloud User Guide*.

   Nous vous recommandons de vous connecter à votre instance EC2 en utilisant SSH. Si l’utilitaire client SSH est installé sur Windows, Linux ou Mac, vous pouvez vous connecter à l’instance à l’aide du format de commande suivant :

   ```
   ssh -i location_of_pem_file ec2-user@ec2-instance-public-dns-name
   ```

   Supposons, par exemple, que `ec2-database-connect-key-pair.pem` soit stocké dans `/dir1` sur Linux et que le DNS IPv4 public de votre instance EC2 soit `ec2-12-345-678-90.compute-1.amazonaws.com`. Votre commande SSH se présenterait comme suit :

   ```
   ssh -i /dir1/ec2-database-connect-key-pair.pem ec2-user@ec2-12-345-678-90.compute-1.amazonaws.com
   ```

1. Installez la dernière version de Telegraf sur votre instance. Pour ce faire, utilisez la commande suivante :

   ```
   cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
   [influxdata]
   name = InfluxData Repository - Stable
   baseurl = https://repos.influxdata.com/stable/\$basearch/main
   enabled = 1
   gpgcheck = 1
   gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
   EOF
   
   sudo yum install telegraf
   ```

1. Configurez votre instance Telegraf.
**Note**  
Si telegraf.conf n'existe pas ou ne contient pas de `timestream` section, vous pouvez en générer une avec :  

   ```
   telegraf —section-filter agent:inputs:outputs —input-filter cpu:mem —output-filter timestream config > telegraf.conf
   ```

   1. Modifiez le fichier de configuration généralement situé à l'adresse`/etc/telegraf`.

      ```
      sudo nano /etc/telegraf/telegraf.conf
      ```

   1. Configurez les plug-ins d'entrée pour CPUs les métriques de mémoire et l'utilisation du disque.

      ```
      [[inputs.cpu]]
        percpu = true
        totalcpu = true
        collect_cpu_time = false
        report_active = false
      
      [[inputs.mem]]
      
      [[inputs.disk]]
        ignore_fs = ["tmpfs", "devtmpfs", "devfs"]
      ```

   1. Configurez le plugin de sortie pour envoyer des données à votre instance de base de données InfluxDB et enregistrer vos modifications.

      ```
      [[outputs.influxdb_v2]]
         urls = ["https://us-west-2-1.aws.cloud2.influxdata.com"]
         token = "<your_telegraf_token"
         organization = "your_org"
         bucket = "your_bucket"
         timeout = "5s"
      ```

   1. Configurez la cible Timestream.

      ```
      # Configuration for sending metrics to Amazon Timestream.
      [[outputs.timestream]]
      
        ## Amazon Region and credentials
        region = "us-east-1"
        access_key = "<AWS key here>"
        secret_key = "<AWS secret key here>"
        database_name = "<timestream database name>" # needs to exist
      
        ## Specifies if the plugin should describe on start.
        describe_database_on_start = false
        mapping_mode = "multi-table" # allows multiple tables for each input metrics
      
        create_table_if_not_exists = true
        create_table_magnetic_store_retention_period_in_days = 365
        create_table_memory_store_retention_period_in_hours = 24
      
        use_multi_measure_records = true # Important to use multi-measure records
        measure_name_for_multi_measure_records = "telegraf_measure"
        max_write_go_routines = 25
      ```

1. Activez et démarrez le service Telegraf.

   ```
   $ sudo systemctl enable telegraf
   $ sudo systemctl start telegraf
   ```

## Étape 5 : Supprimer l'instance Amazon EC2 et l'instance de base de données InfluxDB
<a name="timestream-for-influx-getting-started-creating-db-instance-step5"></a>

Après avoir exploré les données générées par Telegraff à l'aide de votre instance de base de données InfluxDB avec l'interface utilisateur d'InfluxDB, supprimez à la fois vos instances de base de données EC2 et InfluxDB afin qu'elles ne vous soient plus facturées.

**Pour supprimer l'instance EC2 :**

1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Dans le panneau de navigation, choisissez **Instances**.

1. Cochez la case à côté du nom de l'instance EC2, puis sélectionnez État de l'**instance**. Choisissez **Terminer (supprimer) l'instance**.

1. Lorsque vous êtes invité à confirmer votre choix, sélectionnez **Résilier (supprimer)**.

Pour plus d'informations sur la suppression d'une instance EC2, consultez [Résilier les instances Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html) dans le guide de l'utilisateur d'*Amazon Elastic Compute Cloud*.

**Pour supprimer l'instance de base de données sans capture d'écran de base de données finale :**

1.  [Connectez-vous à la console Amazon Timestream pour InfluxDB AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/timestream/](https://console.aws.amazon.com/timestream/) 

1. Dans le volet de navigation, choisissez les bases de données **InfluxDB.**

1. Sélectionnez l'instance de base de données que vous souhaitez supprimer. Choisissez **Delete** (Supprimer)

1. Confirmez la suppression et choisissez **Supprimer**.