Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Telegraf de código abierto
<a name="Telegraf"></a>

 Puede usar el complemento Timestream for LiveAnalytics output de Telegraf para escribir métricas en Timestream directamente desde Telegraf de código abierto. LiveAnalytics

 En esta sección se explica cómo instalar Telegraf con el complemento Timestream para la salida, cómo ejecutar Telegraf con el complemento Timestream para la LiveAnalytics salida y cómo funciona Telegraf de código abierto con Timestream for. LiveAnalytics LiveAnalytics

**Topics**
+ [Instalación de LiveAnalytics Telegraf con el complemento Timestream como complemento de salida](Telegraf.installing-output-plugin.md)
+ [Ejecutar Telegraf con el complemento Timestream para la salida LiveAnalytics](Telegraf.running-output-plugin.title.md)
+ [Asignación de Telegraf/InfluxDB métricas al flujo temporal del modelo LiveAnalytics](Telegraf.how-it-works.md)

# Instalación de LiveAnalytics Telegraf con el complemento Timestream como complemento de salida
<a name="Telegraf.installing-output-plugin"></a>

A partir de la versión 1.16, el complemento Timestream para la LiveAnalytics salida está disponible en la versión oficial de Telegraf. [Para instalar el complemento de salida en la mayoría de los principales sistemas operativos, siga los pasos descritos en la documentación de Telegraf. InfluxData ](https://docs.influxdata.com/telegraf/v1.16/introduction/installation/) Para realizar la instalación en el sistema operativo Amazon Linux 2, siga las instrucciones que se encuentran a continuación.

## Instalación de Telegraf con el LiveAnalytics complemento Timestream for output en Amazon Linux 2
<a name="w2aab7c44c35b9b5"></a>

 Para instalar Telegraf con el complemento de salida de Timestream en Amazon Linux 2, realice los siguientes pasos. 

1. Instale Telegraf con el administrador de paquetes `yum`.

   ```
   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. Ejecute el comando siguiente.

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

1. Instale e inicie Telegraf.

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

# Ejecutar Telegraf con el complemento Timestream para la salida LiveAnalytics
<a name="Telegraf.running-output-plugin.title"></a>

Puede seguir las instrucciones que aparecen a continuación para ejecutar Telegraf con el complemento Timestream for. LiveAnalytics 

1. Genere un ejemplo de configuración con Telegraf.

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

1. Cree una base de datos en Timestream [mediante la consola de administración](console_timestream.md#console_timestream.db.using-console), la [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-database.html) o. [SDKs](getting-started-sdks.md)

1. En el archivo `example.config`, agregue el nombre de la base de datos mediante la edición de la siguiente clave en la sección `[[outputs.timestream]] `.

   ```
   database_name = "yourDatabaseNameHere"
   ```

1. De manera predeterminada, Telegraf creará una tabla. Si desea crear una tabla manualmente, `create_table_if_not_exists` configúrela `false` y siga las instrucciones para crear una tabla [mediante la consola de administración](console_timestream.md#console_timestream.table.using-console), la [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-table.html) o [SDKs](getting-started-sdks.md).

1. En el archivo *example.config*, configure las credenciales en la sección `[[outputs.timestream]] `. Las credenciales deben permitir las siguientes operaciones.

   ```
   timestream:DescribeEndpoints
   timestream:WriteRecords
   ```
**nota**  
Si deja `create_table_if_not_exists` establecido en `true`, incluya lo siguiente:  

   ```
   timestream:CreateTable
   ```
**nota**  
Si establece `describe_database_on_start` en `true`, incluya lo siguiente.  

   ```
   timestream:DescribeDatabase
   ```

1. Puede editar el resto de la configuración según sus preferencias.

1. Cuando termine de editar el archivo de configuración, ejecute Telegraf con lo siguiente.

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

1. Las métricas deberían aparecer en unos segundos, según la configuración del agente. También debería ver las tablas nuevas, *cpu* y *mem*, en la consola de Timestream.

# Asignación de Telegraf/InfluxDB métricas al flujo temporal del modelo LiveAnalytics
<a name="Telegraf.how-it-works"></a>

 Al escribir datos de Telegraf en Timestream for LiveAnalytics, los datos se mapean de la siguiente manera.
+ La marca de tiempo se escribe como el campo de tiempo.
+ Las etiquetas se escriben como las dimensiones.
+ Los campos se escriben como las medidas.
+ Las medidas se escriben principalmente como los nombres de tablas (encontrará más información a continuación).

El complemento Timestream for LiveAnalytics output para Telegraf ofrece múltiples opciones para organizar y almacenar datos en Timestream for. LiveAnalytics Esto puede describirse con un ejemplo que comienza con los datos en formato de protocolo de línea.

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

A continuación, se describen los datos.
+ Los nombres de las mediciones son `weather` y `airquality`.
+ Las etiquetas son `location` y `season`.
+ Los campos son `temperature`, `humidity`, `no2` y `pm25`.

**Topics**
+ [Almacenamiento de los datos en varias tablas](#Telegraf.how-it-works.multi-table-single-measure.title)
+ [Almacenamiento de los datos en una única tabla](#Telegraf.how-it-works.single-table-single-measure.title)

## Almacenamiento de los datos en varias tablas
<a name="Telegraf.how-it-works.multi-table-single-measure.title"></a>

Puede elegir crear una tabla independiente por medida y almacenar cada campo en una fila independiente por tabla.

La configuración es `mapping_mode = "multi-table"`.
+ El LiveAnalytics adaptador Timestream for creará dos tablas, a saber, y. `weather` `airquality`
+ Cada fila de la tabla tendrá un solo campo.

El Timestream resultante para LiveAnalytics las tablas `weather` y`airquality`, tendrá este aspecto.


**`weather`**  

| hora | ubicación | temporada | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  temperature  |  82  | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  humedad  |  71  | 


**`airquality`**  

| hora | ubicación | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  us-midwest  |  no2   |  5  | 
|  2016-06-13 17:43:50  |  us-midwest  |  pm25   |  16  | 

## Almacenamiento de los datos en una única tabla
<a name="Telegraf.how-it-works.single-table-single-measure.title"></a>

Puede elegir almacenar todas las medidas en una única tabla y almacenar cada campo en una fila independiente por tabla.

La configuración es `mapping_mode = "single-table"`. Hay dos configuraciones adicionales cuando se utiliza `single-table`, `single_table_name` y `single_table_dimension_name_for_telegraf_measurement_name`.
+ El complemento Timestream for LiveAnalytics output creará una tabla única con un nombre que incluirá una columna. *<single\$1table\$1name>* *<single\$1table\$1dimension\$1name\$1for\$1telegraf\$1measurement\$1name>*
+ La tabla puede contener varios campos en una fila de la tabla única.

El Timestream para la LiveAnalytics tabla resultante tendrá este aspecto.


**`weather`**  

| hora | ubicación | temporada | *<single\$1table\$1dimension\$1name\$1 for\$1telegraf\$1measurement\$1name>* | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  tiempo atmosférico  |  temperature  |  82  | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  tiempo atmosférico  |  humedad  |  71  | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  calidad del aire  |  no2  |  5  | 
|  2016-06-13 17:43:50  |  us-midwest  |  verano  |  tiempo atmosférico  |  pm25  |  16  |