# Logs

La auditoría de logs en InfluxDB es fundamental para monitorizar la actividad del sistema, detectar incidencias, analizar consultas y cumplir con requisitos de seguridad y cumplimiento.

InfluxDB 1.x y 2.x ofrecen varias opciones para gestionar y auditar logs.

{% hint style="info" %}
InfluxDB no dispone de un bucket ni base de datos interna específica donde puedas consultar directamente las consultas lentas o "slow queries".
{% endhint %}

## **Ubicación y gestión de logs**

* **Ejecución directa:**\
  Por defecto, InfluxDB escribe los logs en `stderr`. Puedes redirigir la salida a un archivo para su análisis posterior:

**Linux & MacOs**

```bash
influxd 2> $HOME/influxdb.log
```

**Windows**

```bash
influxd 2> <PAHT>\influxdb.log
```

* **Como servicio:**
  * En sistemas con systemd, los logs se almacenan en el journal del sistema:

    ```bash
    sudo journalctl -u influxdb.service
    ```
  * En sistemas sin systemd, los logs se escriben en `/var/log/influxdb/influxdb.log`.\
    Puedes personalizar la ubicación con la variable de entorno `STDERR` en `/etc/default/influxdb`.
* **Formato y nivel de logs:**\
  Puedes elegir entre formatos como `auto`, `logfmt` y `json`, y ajustar el nivel (`error`, `warn`, `info`, `debug`) en el archivo de configuración (`[logging]`).

## **Configuración para registrar consultas lentas**

#### **Resumen comparativo**

<table><thead><tr><th width="130">Versión</th><th width="101">¿Soporta registro nativo de consultas lentas?</th><th width="204">Parámetro clave</th><th>Observaciones</th></tr></thead><tbody><tr><td>InfluxDB 1.x</td><td>Sí</td><td><code>log-queries-after</code></td><td>Registro directo en logs del sistema</td></tr><tr><td>InfluxDB 2.x</td><td>No</td><td><code>--flux-log-enabled</code></td><td>Solo log detallado, no filtro por lentitud</td></tr><tr><td>InfluxDB 3.x</td><td>No</td><td><code>--query-log-size</code>, <code>--log-filter</code></td><td>Solo logs generales, no filtro por lentitud</td></tr></tbody></table>

* **Parámetros clave en&#x20;**<kbd>**influxdb.conf**</kbd>**:**

  * `query-log-enabled = true`: Habilita el registro de todas las consultas.
  * `log-queries-after = "1s"`: (1.x) Registra solo las consultas que excedan el umbral definido (por ejemplo, 1 segundo).

  Ejemplo:

  ```
  [coordinator]
    query-log-enabled = true
    log-queries-after = "1s"
  ```

  *Nota:* Es necesario que `query-log-enabled` esté en `true` para registrar consultas lentas.
* **Dónde aparecen las consultas lentas:**\
  Las consultas que superen el umbral definido aparecerán en los logs principales de InfluxDB, junto con la duración y el texto de la consulta.

### **Acceso y análisis de logs**

* **Revisión manual:**\
  Busca entradas con mensajes como `Detected slow query` en el archivo de logs o en el journal del sistema.
* **Integración con herramientas externas:**\
  Los formatos estructurados (`logfmt`, `json`) permiten integrar los logs fácilmente con sistemas como Splunk, Elasticsearch o Papertrail para análisis y alertas centralizadas

{% hint style="info" %}
No existe un bucket o tabla interna para consultas lentas: toda la información relevante se encuentra en los logs del sistema, que pueden ser procesados manualmente o integrados con herramientas externas para una auditoría avanzada
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://darioaplicano.gitbook.io/influxdb2.x/sesion-6/guion-de-la-sesion/documentacion/logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.