====== InfluxDB ======

Base de datos para series temporales.

  * https://www.influxdata.com/

===== Instalación =====

==== Docker ====

[[https://hub.docker.com/_/influxdb|Imagen Docker oficial]].

La configuración se puede hacer mediante variables de entorno o utilizando un fichero de configuración. Para el segundo método, se puede crear un fichero de configuración por defecto mediante:

<code>
docker run --rm influxdb:meta influxd-meta config > influxdb-meta.conf
</code>

Se creará un fichero llamado ''influxdb-meta.conf'' que podremos configurar a nuestro gusto y luego pasárselo al contenedor

<WRAP center round todo 60%>
Anotar cómo pasarle ese fichero de configuración al contenedor
</WRAP>

Ejemplo de ''docker-compose.yml'':

<code yaml>
services:
  influxdb:
    image: influxdb:latest
    ports:
      - "8086:8086"
    volumes:
      - ./data:/var/lib/influxdb
    environment:
      - INFLUXDB_DB=telegraf
      - INFLUXDB_USER=telegraf
      - INFLUXDB_USER_PASSWORD=supersecret

      - INFLUXDB_ADMIN_ENABLED=true
      - INFLUXDB_ADMIN_USER=admin
      - INFLUXDB_ADMIN_PASSWORD=supersecret 
</code>

===== InfluxQL =====

**InfluxQL** es un lenguaje tipo SQL para interactuar con la información contenida en una base de datos InfluxDB.

  * https://docs.influxdata.com/influxdb/v1.8/query_language/spec/

La interacción con InfluxDB se hace con ''influx''

<WRAP center round tip 60%>
Si queremos que los valores de tiempo vengan en un formato más amigable, ejecutamos el cliente de esta manera: ''influx -precision rfc3339''. El tiempo vendrá de la forma ''YYYY-MM-DDTHH:MM:SS UTC''. También se le puede indicar la precisión una vez conectados a la base de datos ejecutando ''precision rfc3339''
</WRAP>

Crear base de datos:

<code>
CREATE DATABASE nombre_base_datos
</code>

Eliminar base de datos:

<code>
DROP DATABASE nombre_base_datos
</code>

Mostrar bases de datos:

<code>
SHOW DATABASES
</code>

Seleccionar una base de datos:

<code>
USE nombre_base_datos
</code>

Crear usuario

<code>
CREATE USER "usuario" WITH PASSWORD 'contraseña'
</code>

Mostrar usuarios:

<code>
SHOW USERS
</code>

Mostrar las series de datos:

<code>
SHOW SERIES
</code>

==== Mediciones ====

Describe el tipo de dato almacenado.

Para ver las mediciones (//measurements//) que contiene el sistema:

<code>
SHOW MEASUREMENTS
</code>

Ejemplo de salida:

<code>
name: measurements
name
----
cpu
disk
diskio
kernel
mem
processes
swap
system
</code>

==== Series ====

Agrupación de datos definida por una medición, conjunto de etiquetas o campo compartidos.

Ejemplo de serie:

<code>
# medida, conjunto de etiquetas, clave de campo
h2o_level, location=santa_monica, h2o_feet
</code>

==== Puntos ====

Un punto representa un registro de información y tiene 4 componentes:

  * Medida
  * Conjunto de etiquetas
  * Conjunto de campos
  * Timestamp

<code>
<measurement>[,<tag-key>=<tag-value>...] <field-key>=<field-value>[,<field2-key>=<field2-value>...] [unix-nano-timestamp]
</code>

Ejemplo:

<code>
name: census
-----------------
time                    butterflies honeybees   location    scientist
2015-08-18T00:00:00Z    1           30          1           perpetua
</code>

  * Medida: ''census''
  * Conjunto de etiquetas: location = 1, scientist = perpetua
  * Conjunto de campos: butterflies = 1, honeybees = 30
  * Timestamp: 2015-08-18T00:00:00Z

====== Recursos ======

  * https://docs.influxdata.com/influxdb/v1.8/concepts/key_concepts/
  * https://docs.influxdata.com/influxdb/v1.8/introduction/get-started/
  * https://docs.influxdata.com/influxdb/v1.8/query_language/spec/
  * https://docs.influxdata.com/influxdb/v1.8/query_language/sample-data/
  * https://docs.influxdata.com/influxdb/v1.8/query_language/explore-data/#the-time-zone-clause