Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 Você pode usar o plug-in Timestream for LiveAnalytics output do Telegraf para gravar métricas no Timestream diretamente do Telegraf de LiveAnalytics código aberto.

 Esta seção fornece uma explicação de como instalar o Telegraf com o Timestream para plug-in de LiveAnalytics saída, como executar o Telegraf com o Timestream para plug-in de LiveAnalytics saída e como o Telegraf de código aberto funciona com o Timestream for. LiveAnalytics

**Topics**
+ [Instalando o Telegraf com o Timestream para plug-in de saída LiveAnalytics](Telegraf.installing-output-plugin.md)
+ [Executando o Telegraf com o Timestream para plug-in de saída LiveAnalytics](Telegraf.running-output-plugin.title.md)
+ [Mapeamento de Telegraf/InfluxDB métricas para o Timestream para o modelo LiveAnalytics](Telegraf.how-it-works.md)

# Instalando o Telegraf com o Timestream para plug-in de saída LiveAnalytics
<a name="Telegraf.installing-output-plugin"></a>

A partir da versão 1.16, o plug-in Timestream for LiveAnalytics output está disponível na versão oficial do Telegraf. Para instalar o plug-in de saída na maioria dos principais sistemas operacionais, siga as etapas descritas na documentação do [InfluxData Telegraf](https://docs.influxdata.com/telegraf/v1.16/introduction/installation/). Para instalar no sistema operacional Amazon Linux 2, siga as instruções abaixo.

## Instalando o Telegraf com o Timestream para LiveAnalytics plug-in de saída no Amazon Linux 2
<a name="w2aab7c44c35b9b5"></a>

 Para instalar o Telegraf com o plug-in Timestream Output no Amazon Linux 2, execute as seguintes etapas. 

1. Instalar o Telegraf usando o gerenciamento de pacote `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. Execute o comando a seguir.

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

1. Instalar e inicializar o Telegraf.

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

# Executando o Telegraf com o Timestream para plug-in de saída LiveAnalytics
<a name="Telegraf.running-output-plugin.title"></a>

Você pode seguir as instruções abaixo para executar o Telegraf com o plug-in Timestream for. LiveAnalytics 

1. Gere um exemplo de configuração usando o Telegraf.

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

1. Crie um banco de dados no Timestream [usando o console de gerenciamento](console_timestream.md#console_timestream.db.using-console), a [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-database.html) ou. [SDKs](getting-started-sdks.md)

1. No arquivo `example.config`, adicione o nome do seu banco de dados editando a chave a seguir na seção `[[outputs.timestream]] `.

   ```
   database_name = "yourDatabaseNameHere"
   ```

1. Por padrão, o Telegraf criará uma tabela. Se você quiser criar uma tabela manualmente, `create_table_if_not_exists` defina `false` e siga as instruções para criar uma tabela [usando o console de gerenciamento](console_timestream.md#console_timestream.table.using-console), a [CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/create-table.html) ou. [SDKs](getting-started-sdks.md)

1. No arquivo *example.config*, configure as credenciais na seção `[[outputs.timestream]] `. As credenciais devem permitir as seguintes operações.

   ```
   timestream:DescribeEndpoints
   timestream:WriteRecords
   ```
**nota**  
Se você incluir `create_table_if_not_exists`, defina-o como `true`, inclua:  

   ```
   timestream:CreateTable
   ```
**nota**  
Se você definir `describe_database_on_start` como`true`, inclua conforme a seguir.  

   ```
   timestream:DescribeDatabase
   ```

1. Você pode editar o resto da configuração de acordo com as suas preferências.

1. Depois de concluir a edição do arquivo de configuração, execute o Telegraf com o seguinte.

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

1. As métricas devem aparecer em alguns segundos, dependendo da configuração do seu agente. Você também deve ver as novas tabelas, *cpu* e *mem*, no console Timestream.

# Mapeamento de Telegraf/InfluxDB métricas para o Timestream para o modelo LiveAnalytics
<a name="Telegraf.how-it-works"></a>

 Ao gravar dados do Telegraf no Timestream for LiveAnalytics, os dados são mapeados da seguinte forma.
+ O registro de data/hora é escrito como o campo de hora.
+ As etiquetas são escritas como dimensões.
+ Os campos são escritos como medidas.
+ As medidas são escritas principalmente como nomes de tabelas (mais sobre isso abaixo).

O plug-in Timestream for LiveAnalytics output para Telegraf oferece várias opções para organizar e armazenar dados no Timestream for. LiveAnalytics Um exemplo que começa com dados no formato de protocolo de linha pode ilustrar isso.

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

A seguir, descrevemos os dados.
+ Os nomes das medidas são `weather` e `airquality`.
+ As etiquetas são `location` e `season`.
+ Esses campos são `temperature`, `humidity`, `no2` e `pm25`.

**Topics**
+ [Armazenamento de dados em várias tabelas](#Telegraf.how-it-works.multi-table-single-measure.title)
+ [Armazenar os dados em uma única tabela](#Telegraf.how-it-works.single-table-single-measure.title)

## Armazenamento de dados em várias tabelas
<a name="Telegraf.how-it-works.multi-table-single-measure.title"></a>

É possível optar por criar uma tabela distinta para cada medida e guardar cada campo em uma linha diferente por tabela.

A configuração é `mapping_mode = "multi-table"`.
+ O Timestream para o LiveAnalytics adaptador criará duas tabelas, a saber, e. `weather` `airquality`
+ Cada linha da tabela conterá somente um único campo.

O Timestream resultante para LiveAnalytics tabelas `weather` e`airquality`, terá a seguinte aparência.


**`weather`**  

| horário | location | temporada | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  temperatura  |  82  | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  umidade  |  71  | 


**`airquality`**  

| horário | location | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  Número 2   |  5  | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  pm25   |  16  | 

## Armazenar os dados em uma única tabela
<a name="Telegraf.how-it-works.single-table-single-measure.title"></a>

É possível escolher registrar todas as medidas em uma única tabela, com cada campo ocupando uma linha distinta.

A configuração é `mapping_mode = "single-table"`. Há duas configurações adicionais ao usar `single-table`, `single_table_name` e `single_table_dimension_name_for_telegraf_measurement_name`.
+ O plug-in Timestream for LiveAnalytics output criará uma única tabela com nome *<single\$1table\$1name>* que inclui uma *<single\$1table\$1dimension\$1name\$1for\$1telegraf\$1measurement\$1name>* coluna.
+ A tabela pode conter vários campos em uma única linha da tabela.

O Timestream resultante para a LiveAnalytics tabela terá a seguinte aparência.


**`weather`**  

| horário | location | temporada | *<single\$1table\$1dimension\$1name\$1 for\$1telegraf\$1measurement\$1name>* | measure\$1name | measure\$1value::bigint | 
| --- | --- | --- | --- | --- | --- | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  clima  |  temperatura  |  82  | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  clima  |  umidade  |  71  | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  qualidade do ar  |  Número 2  |  5  | 
|  2016-06-13 17:43:50  |  centro-oeste dos EUA  |  verão  |  clima  |  pm25  |  16  |