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.

# Telegraf open source
<a name="Telegraf"></a>

 Vous pouvez utiliser le plugin Timestream for LiveAnalytics output pour Telegraf afin d'écrire des métriques dans Timestream directement à partir de Telegraf open source. LiveAnalytics

 Cette section explique comment installer Telegraf avec le plugin Timestream for LiveAnalytics output, comment exécuter Telegraf avec le plugin Timestream for LiveAnalytics output et comment Telegraf open source fonctionne avec Timestream for. LiveAnalytics

**Topics**
+ [Installation de Telegraf avec le plugin Timestream for output LiveAnalytics](Telegraf.installing-output-plugin.md)
+ [Exécution de Telegraf avec le plugin Timestream pour la sortie LiveAnalytics](Telegraf.running-output-plugin.title.md)
+ [Mappage Telegraf/InfluxDB des métriques au flux temporel du modèle LiveAnalytics](Telegraf.how-it-works.md)

# Installation de Telegraf avec le plugin Timestream for output LiveAnalytics
<a name="Telegraf.installing-output-plugin"></a>

Depuis la version 1.16, le plugin Timestream for LiveAnalytics output est disponible dans la version officielle de Telegraf. Pour installer le plugin de sortie sur la plupart des principaux systèmes d'exploitation, suivez les étapes décrites dans la documentation [InfluxData Telegraf](https://docs.influxdata.com/telegraf/v1.16/introduction/installation/). Pour effectuer l'installation sur le système d'exploitation Amazon Linux 2, suivez les instructions ci-dessous.

## Installation de Telegraf avec le LiveAnalytics plugin Timestream for output sur Amazon Linux 2
<a name="w2aab7c44c35b9b5"></a>

 Pour installer Telegraf avec le plug-in de sortie Timestream sur Amazon Linux 2, effectuez les étapes suivantes. 

1. Installez Telegraf à l'aide du gestionnaire de `yum` paquets.

   ```
   cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
   [influxdb]
   name = InfluxDB Repository - RHEL \$releasever
   baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
   enabled = 1
   gpgcheck = 1
   gpgkey = https://repos.influxdata.com/influxdb.key
   EOF
   ```

1. Exécutez la commande suivante.

   ```
   sudo sed -i "s/\$releasever/$(rpm -E %{rhel})/g" /etc/yum.repos.d/influxdb.repo
   ```

1. Installez et lancez Telegraf.

   ```
   sudo yum install telegraf
   sudo service telegraf start
   ```

# Exécution de Telegraf avec le plugin Timestream pour la sortie LiveAnalytics
<a name="Telegraf.running-output-plugin.title"></a>

Vous pouvez suivre les instructions ci-dessous pour exécuter Telegraf avec le plugin Timestream for. LiveAnalytics 

1. Générez un exemple de configuration à l'aide de Telegraf.

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

1. Créez une base de données dans Timestream à [l'aide de la console de gestion, de la](console_timestream.md#console_timestream.db.using-console) [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-database.html) ou. [SDKs](getting-started-sdks.md)

1. Dans le `example.config` fichier, ajoutez le nom de votre base de données en modifiant la clé suivante sous la `[[outputs.timestream]] ` section.

   ```
   database_name = "yourDatabaseNameHere"
   ```

1. Par défaut, Telegraf créera une table. Si vous souhaitez créer une table manuellement, définissez `false` et suivez les instructions `create_table_if_not_exists` pour créer une table à [l'aide de la console de gestion](console_timestream.md#console_timestream.table.using-console), de la [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-table.html) ou [SDKs](getting-started-sdks.md).

1. Dans le fichier *exemple.config*, configurez les informations d'identification dans la `[[outputs.timestream]] ` section. Les informations d'identification doivent permettre les opérations suivantes.

   ```
   timestream:DescribeEndpoints
   timestream:WriteRecords
   ```
**Note**  
Si vous laissez ce `create_table_if_not_exists` paramètre défini sur`true`, incluez :  

   ```
   timestream:CreateTable
   ```
**Note**  
Si vous avez défini cette `describe_database_on_start` option`true`, incluez les éléments suivants.  

   ```
   timestream:DescribeDatabase
   ```

1. Vous pouvez modifier le reste de la configuration selon vos préférences.

1. Lorsque vous avez terminé de modifier le fichier de configuration, lancez Telegraf avec ce qui suit.

   ```
   ./telegraf --config example.config
   ```

1. Les métriques devraient apparaître au bout de quelques secondes, en fonction de la configuration de votre agent. Vous devriez également voir les nouvelles tables, *cpu* et *mem*, dans la console Timestream.

# Mappage Telegraf/InfluxDB des métriques au flux temporel du modèle LiveAnalytics
<a name="Telegraf.how-it-works"></a>

 Lorsque vous écrivez des données de Telegraf vers Timestream for LiveAnalytics, les données sont mappées comme suit.
+ L'horodatage est écrit sous forme de champ horaire.
+ Les balises sont écrites sous forme de dimensions.
+ Les champs sont écrits sous forme de mesures.
+ Les mesures sont principalement écrites sous forme de noms de tables (plus d'informations à ce sujet ci-dessous).

Le plugin Timestream for LiveAnalytics output pour Telegraf offre plusieurs options pour organiser et stocker les données dans Timestream for. LiveAnalytics Cela peut être décrit par un exemple qui commence par les données au format de protocole de ligne.

`weather,location=us-midwest,season=summer temperature=82,humidity=71 1465839830100400200 airquality,location=us-west no2=5,pm25=16 1465839830100400200`

Ce qui suit décrit les données.
+ Les noms des mesures sont `weather` et`airquality`.
+ Les tags sont `location` et`season`.
+ Les champs sont `temperature``humidity`,`no2`, et`pm25`.

**Topics**
+ [Stockage des données dans plusieurs tables](#Telegraf.how-it-works.multi-table-single-measure.title)
+ [Stockage des données dans une seule table](#Telegraf.how-it-works.single-table-single-measure.title)

## Stockage des données dans plusieurs tables
<a name="Telegraf.how-it-works.multi-table-single-measure.title"></a>

Vous pouvez choisir de créer un tableau distinct par mesure et de stocker chaque champ dans une ligne distincte par tableau.

La configuration est`mapping_mode = "multi-table"`.
+ L' LiveAnalytics adaptateur Timestream for créera deux tables, à savoir, et`weather`. `airquality`
+ Chaque ligne du tableau ne contiendra qu'un seul champ.

Le Timestream qui en résultera pour LiveAnalytics les tables `weather` et`airquality`, ressemblera à ceci.


**`weather`**  

| time | location | saison | nom\$1mesure | value\$1mesure : :bigint | 
| --- | --- | --- | --- | --- | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  temperature  |  82  | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  humidité  |  71  | 


**`airquality`**  

| time | location | nom\$1mesure | value\$1mesure : :bigint | 
| --- | --- | --- | --- | 
|  13/06/2016 17:43:50  |  Midwest américain  |  n° 2   |  5  | 
|  13/06/2016 17:43:50  |  Midwest américain  |  pm25   |  16  | 

## Stockage des données dans une seule table
<a name="Telegraf.how-it-works.single-table-single-measure.title"></a>

Vous pouvez choisir de stocker toutes les mesures dans un seul tableau et de stocker chaque champ dans une ligne de tableau distincte.

La configuration est`mapping_mode = "single-table"`. Il existe deux configurations supplémentaires lors de l'utilisation`single-table`, `single_table_name` et`single_table_dimension_name_for_telegraf_measurement_name`.
+ Le plugin Timestream for LiveAnalytics output créera une table unique avec un nom *<single\$1table\$1name>* qui inclut une *<single\$1table\$1dimension\$1name\$1for\$1telegraf\$1measurement\$1name>* colonne.
+ La table peut contenir plusieurs champs dans une seule ligne de table.

Le Timestream qui en résultera pour le LiveAnalytics tableau ressemblera à ceci.


**`weather`**  

| time | location | saison | *<single\$1table\$1dimension\$1name\$1 for\$1telegraf\$1measurement\$1name>* | nom\$1mesure | value\$1mesure : :bigint | 
| --- | --- | --- | --- | --- | --- | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  météo  |  temperature  |  82  | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  météo  |  humidité  |  71  | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  qualité de l'air  |  n° 2  |  5  | 
|  13/06/2016 17:43:50  |  Midwest américain  |  été  |  météo  |  pm25  |  16  |