> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Observabilidad en Flowker

> Configura la telemetría de Flowker y usa sus endpoints de salud y sus registros de ejecución para operar workflows.

Flowker puede emitir datos de OpenTelemetry para sus operaciones HTTP y de servicio. La telemetría es opcional: habilítala en el despliegue, envíala a tu collector y usa la API de ejecuciones para el estado y los resultados específicos de cada workflow.

## Habilitar y exportar la telemetría

***

Define estas variables de entorno en el despliegue de Flowker:

```bash theme={null}
ENABLE_TELEMETRY=true
OTEL_EXPORTER_OTLP_ENDPOINT=https://your-otlp-collector.example:4317
```

Con la telemetría habilitada, Flowker inicializa sus instrumentos de telemetría y exporta a través del endpoint OTLP configurado. No agregas instrumentación a workflows individuales, pero el despliegue debe proveer un collector alcanzable. Usa un endpoint `https://` para un collector remoto. Reserva un endpoint `http://` en texto plano para un collector que sea local al host o alcanzable solo por una red aislada. Flowker no aprovisiona dashboards de Grafana, retención ni reglas de alerta. Esas son decisiones de tu plataforma de observabilidad.

## Verificar la salud del servicio

***

Flowker expone sondas compatibles con Kubernetes. El endpoint `GET /health` es una verificación de liveness. Después de que pasa su autosonda de arranque, devuelve `200 healthy` y deliberadamente no llama a la base de datos, al cache ni a servicios downstream. El endpoint `GET /readyz` es la verificación de readiness de las dependencias. Úsalo cuando necesites saber si Flowker puede atender solicitudes ahora.

## Usar tu plataforma de observabilidad

***

Enruta el stream OTLP al backend que opera tu plataforma, como Grafana, y construye ahí los dashboards y las alertas. Mantén esos dashboards separados de la investigación de ejecuciones: la telemetría de solicitudes de API no reemplaza el registro de ejecución.

Para una ejecución individual de un workflow, usa [Get execution results](/es/reference/products/flowker/get-execution-results) para ver su estado, sus resultados de paso y su salida final cuando esté presente. Un paso fallido puede incluir un `errorMessage`. Esta respuesta no tiene un campo de detalles de error en el nivel superior.

## Cómo interpretar el estado de una ejecución

***

Cada ejecución de workflow en Flowker tiene un estado que te dice en qué punto está.

| Estado      | Significado                                                                                                                                                                            | Qué hacer                                                                                                                                        |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `pending`   | La ejecución se creó pero no ha empezado. En la ruta de ejecución normal, Flowker la cambia a `running` de forma síncrona antes de responder; no la trates como una cola de scheduler. | —                                                                                                                                                |
| `running`   | La ejecución está en curso                                                                                                                                                             | Normal — monitorea hasta que termine                                                                                                             |
| `completed` | Todos los pasos terminaron correctamente                                                                                                                                               | No se necesita ninguna acción                                                                                                                    |
| `failed`    | La ejecución terminó con un error                                                                                                                                                      | Revisa `stepResults` para encontrar un paso fallido. Un fallo que ocurre antes de que corra algún paso no tiene error de paso en esta respuesta. |

<Tip>
  Si ves un número significativo de ejecuciones `failed` en un periodo corto, recopila sus ids de ejecución y sus detalles de error antes de escalar.
</Tip>

## Cuándo involucrar a ingeniería

***

Escala a ingeniería cuando:

* `GET /readyz` reporta una dependencia caída
* el collector OTLP no es alcanzable o rechaza el stream de telemetría
* las ejecuciones `failed` superan el umbral de alerta que define tu despliegue y la causa no está clara
* Flowker no procesa nuevas ejecuciones mientras el readiness es exitoso

Comparte los ids de ejecución, el intervalo de tiempo en UTC, los payloads de error relevantes de la API y la respuesta de `/readyz`. Con la telemetría habilitada, incluye el enlace al collector o al dashboard como evidencia de respaldo.