# 5. Telegraf

Telegraf es un agente open source desarrollado por InfluxData, diseñado para la recolección, procesamiento y envío de métricas y eventos desde una amplia variedad de fuentes hacia bases de datos de series temporales como InfluxDB, así como otros destinos. Es una pieza fundamental en arquitecturas de monitoreo industrial, IT y entornos SCADA, especialmente cuando se utiliza junto a InfluxDB 2.x.

### ¿Por qué usar Telegraf? <a href="#por-qu-usar-telegraf" id="por-qu-usar-telegraf"></a>

* **Ligero y eficiente:** Requiere pocos recursos y no tiene dependencias externas, lo que permite su despliegue en servidores, dispositivos IoT o gateways industriales.
* **Extensible:** Ofrece más de 300 plugins para recolectar datos desde sistemas operativos, aplicaciones, sensores industriales (Modbus, OPC-UA, MQTT, etc.), servicios cloud y más.
* **Integración nativa con InfluxDB:** Es la herramienta recomendada para alimentar InfluxDB 2.x con datos en tiempo real, facilitando la integración en arquitecturas SCADA modernas.
* **Procesamiento previo:** Permite filtrar, transformar y agregar datos antes de enviarlos, optimizando el almacenamiento y el análisis posterior.
* **Alta confiabilidad:** Puede almacenar temporalmente los datos en memoria si el destino está momentáneamente inaccesible, evitando pérdidas de información.

### Arquitectura y funcionamiento <a href="#arquitectura-y-funcionamiento" id="arquitectura-y-funcionamiento"></a>

Telegraf se basa en un sistema modular de plugins:

* **Inputs:** Recolectan datos de fuentes como sistemas operativos, bases de datos, protocolos industriales, APIs, etc.
* **Processors:** Permiten modificar, filtrar o enriquecer los datos recolectados.
* **Aggregators:** Realizan operaciones de resumen (promedios, conteos, etc.) sobre los datos antes de enviarlos.
* **Outputs:** Definen el destino de los datos, siendo InfluxDB el más común en entornos de series temporales.

Esta arquitectura permite adaptar Telegraf a cualquier entorno, desde monitoreo de infraestructura IT hasta adquisición de datos industriales en tiempo real.

### Ejemplo de flujo de datos en un entorno SCADA <a href="#ejemplo-de-flujo-de-datos-en-un-entorno-scada" id="ejemplo-de-flujo-de-datos-en-un-entorno-scada"></a>

* **Entrada:** Telegraf recoge datos de sensores industriales mediante plugins como `inputs.modbus` o `inputs.opcua`.
* **Procesamiento:** Se filtran valores anómalos y se agregan promedios cada minuto.
* **Salida:** Los datos procesados se envían a InfluxDB 2.x, donde quedan disponibles para visualización, análisis y generación de alertas.

### Casos de uso destacados <a href="#casos-de-uso-destacados" id="casos-de-uso-destacados"></a>

* **Monitoreo de infraestructura:** Recolección de métricas de CPU, memoria, red y almacenamiento en servidores y dispositivos industriales.
* **Integración industrial:** Adquisición de datos de PLCs y sensores mediante protocolos estándar y envío a InfluxDB para análisis en tiempo real.
* **Optimización de procesos:** Empresas manufactureras han reducido tiempos de inactividad y mejorado el mantenimiento predictivo gracias a la integración de Telegraf con InfluxDB.


---

# 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/instalacion-y-configuracion-inicial/5.-telegraf.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.