# Monitoring

Flowise tiene soporte nativo para Prometheus con Grafana y OpenTelemetry. Sin embargo, solo se rastrean métricas de alto nivel como solicitudes de API, conteos de flujos/predicciones. Consulta [aquí](https://github.com/FlowiseAI/Flowise/blob/main/packages/server/src/Interface.Metrics.ts#L13) para ver la lista de métricas de contador. Para observabilidad detallada nodo por nodo, recomendamos usar [Analítica](/espanol/documentacion-oficial/usar-flowise/analytic.md).

## Prometheus

[Prometheus](https://prometheus.io/) es una solución de monitoreo y alertas de código abierto.

Antes de configurar Prometheus, configura las siguientes variables de entorno en Flowise:

```properties
ENABLE_METRICS=true
METRICS_PROVIDER=prometheus
METRICS_INCLUDE_NODE_METRICS=true
```

### Configuración de Autenticación

El punto final `/api/v1/metrics` requiere autenticación con clave API. Necesitarás:

1. Generar una clave API siguiendo las instrucciones [aquí](https://docs.flowiseai.com/espanol/documentacion-oficial/configuracion/autorizacion/nivel-chatflow#api-key)
2. Guardar la clave API en un archivo accesible por Prometheus (ej., `/etc/prometheus/api_key.txt`)
3. Configurar Prometheus para usar autenticación con token bearer

### Configuración de Prometheus

Después de instalar Prometheus, ejecútalo usando un archivo de configuración. Flowise proporciona un archivo de configuración predeterminado que se puede encontrar [aquí](https://github.com/FlowiseAI/Flowise/blob/main/metrics/prometheus/prometheus.config.yml).

Necesitarás agregar configuración de autenticación a tu archivo de configuración de Prometheus:

```yaml
scrape_configs:
  - job_name: 'flowise'
    static_configs:
      - targets: ['localhost:3000']
    metrics_path: '/api/v1/metrics'
    authorization:
      type: Bearer
      credentials_file: '/etc/prometheus/api_key.txt'
```

Recuerda tener la instancia de Flowise también en ejecución. Puedes abrir el navegador y navegar al puerto 9090. Desde el panel de control, deberías poder ver que el punto final de métricas - `/api/v1/metrics` está activo con autenticación.

<figure><img src="/files/jQBovEf7aMv1hVwzHLtL" alt=""><figcaption></figcaption></figure>

El punto final `/api/v1/metrics` está disponible para que Prometheus extraiga las métricas, pero requiere autenticación con clave API como se configuró anteriormente.

## Grafana

Prometheus recopila métricas detalladas y proporciona un lenguaje de consulta potente; Grafana transforma las métricas en visualizaciones significativas.

Grafana se puede instalar de varias maneras. Consulta la [guía](https://grafana.com/docs/grafana/latest/setup-grafana/installation/).

Grafana por defecto expondrá el puerto 9091:

<figure><img src="/files/crKnCtVpDsbWCCo7AQZo" alt=""><figcaption></figcaption></figure>

En la barra lateral izquierda, haz clic en Agregar nueva conexión y selecciona Prometheus:

<figure><img src="/files/IEqNqugy32tdvt2x0Nsp" alt=""><figcaption></figcaption></figure>

Ya que nuestro Prometheus está sirviendo en el puerto 9090:

<figure><img src="/files/m0oATjqAi9hTa8DqBHYO" alt=""><figcaption></figcaption></figure>

Desplázate hasta el final y prueba la conexión:

<figure><img src="/files/KMYNcq2oQK3V91gpSCAl" alt=""><figcaption></figcaption></figure>

Toma nota del ID de la fuente de datos mostrado en la barra de herramientas, lo necesitaremos para crear paneles:

<figure><img src="/files/3bB2R2oeH8RuVemxFqmn" alt=""><figcaption></figcaption></figure>

Ahora que la conexión se ha agregado exitosamente, podemos comenzar a agregar paneles. Desde la barra lateral izquierda, haz clic en Paneles y Crear Panel.

Flowise proporciona 2 plantillas de paneles:

* [grafana.dashboard.app.json.txt](https://github.com/FlowiseAI/Flowise/blob/main/metrics/grafana/grafana.dashboard.app.json.txt): métricas de API como número de flujos de chat/agentes, conteo de predicciones, herramientas, asistentes, vectores insertados, etc.
* [grafana.dashboard.server.json.txt](https://github.com/FlowiseAI/Flowise/blob/main/metrics/grafana/grafana.dashboard.server.json.txt): métricas de la instancia node.js de Flowise como uso de heap, CPU, RAM

Si estás usando las plantillas anteriores, encuentra y reemplaza todas las ocurrencias de `cds4j1ybfuhogb` con el ID de la fuente de datos que creaste y guardaste anteriormente.

<figure><img src="/files/ezpnkqU3grWd0mV2fnNf" alt=""><figcaption></figcaption></figure>

También puedes elegir importar primero y luego editar el JSON más tarde:

<figure><img src="/files/u6iJk6keaDog9yXHVU3c" alt=""><figcaption></figcaption></figure>

Ahora, intenta realizar algunas acciones en Flowise, deberías poder ver las métricas mostradas:

<figure><img src="/files/rIn8qzbKfhzCGKIuZyyb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Z9O1ZqROLneXLAij8lDO" alt=""><figcaption></figcaption></figure>

## OpenTelemetry

[OpenTelemetry](https://opentelemetry.io/) es un marco de trabajo de código abierto para crear y gestionar datos de telemetría. Para habilitar OTel, configura las siguientes variables de entorno en Flowise:

```properties
ENABLE_METRICS=true
METRICS_PROVIDER=open_telemetry
METRICS_INCLUDE_NODE_METRICS=true
METRICS_OPEN_TELEMETRY_METRIC_ENDPOINT=http://localhost:4318/v1/metrics
METRICS_OPEN_TELEMETRY_PROTOCOL=http # http | grpc | proto (por defecto es http)
METRICS_OPEN_TELEMETRY_DEBUG=true
```

A continuación, necesitamos el Recolector OpenTelemetry para recibir, procesar y exportar datos de telemetría. Flowise proporciona un [archivo docker compose](https://github.com/FlowiseAI/Flowise/blob/main/metrics/otel/compose.yaml) que se puede usar para iniciar el contenedor del recolector.

```bash
cd Flowise
cd metrics && cd otel
docker compose up -d
```

El recolector utilizará el archivo [otel.config.yml](https://github.com/FlowiseAI/Flowise/blob/main/metrics/otel/otel.config.yml) bajo el mismo directorio para las configuraciones. Actualmente solo [Datadog](https://www.datadoghq.com/) y Prometheus son soportados, consulta la documentación de [Open Telemetry](https://opentelemetry.io/) para configurar diferentes herramientas APM como Zipkin, Jeager, New Relic, Splunk y otros.

Asegúrate de reemplazar con la clave API necesaria para los exportadores dentro del archivo yml.


---

# 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://docs.flowiseai.com/espanol/documentacion-oficial/usar-flowise/monitoring.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.