> ## 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 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.

## Habilita y exporta la telemetría

***

Configura estas variables de entorno en el despliegue de Flowker:

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

Con la telemetría habilitada, Flowker inicializa sus instrumentos de telemetría y exporta mediante el endpoint OTLP configurado. No agregas instrumentación a workflows individuales, pero el despliegue debe proporcionar un collector accesible. Usa un endpoint `https://` para un collector remoto; reserva un endpoint `http://` en texto plano para un collector local al host o accesible solo por una red aislada. Flowker no aprovisiona dashboards de Grafana, retención ni reglas de alerta; esas decisiones pertenecen a tu plataforma de observabilidad.

## Comprueba la salud del servicio

***

Flowker expone sondas compatibles con Kubernetes. `GET /health` es una comprobación de liveness: después de que pase su autocomprobación de inicio, devuelve `200 healthy` y deliberadamente no llama a la base de datos, la caché ni servicios externos. `GET /readyz` es la comprobación de readiness para dependencias y el endpoint que debes usar cuando necesitas saber si Flowker puede atender solicitudes ahora.

## Usa tu plataforma de observabilidad

***

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

Para una ejecución individual de workflow, usa [Obtener resultados de ejecución](/es/reference/flowker/get-execution-results) para consultar su estado, los resultados de los pasos y la salida final cuando esté presente. Un paso fallido puede incluir un `errorMessage`; esta respuesta no tiene un campo de detalles de error de nivel superior.

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

***

Cada ejecución de workflow en Flowker tiene un estado que te indica en qué punto se encuentra.

| Estado      | Significado                                                                                                                                                                                | Qué hacer                                                                                                                         |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `pending`   | La ejecución fue creada, pero aún no se ha iniciado. En la ejecución normal, Flowker la cambia a `running` de forma síncrona antes de responder; no la trates como una cola del scheduler. | —                                                                                                                                 |
| `running`   | La ejecución está en progreso                                                                                                                                                              | Normal — monitorear hasta que se complete                                                                                         |
| `completed` | Todos los pasos finalizaron exitosamente                                                                                                                                                   | No se requiere acción                                                                                                             |
| `failed`    | La ejecución finalizó con un error                                                                                                                                                         | Revisa `stepResults` en busca de un paso fallido. Un error antes de ejecutar un paso no tiene un error de paso en esta respuesta. |

<Tip>
  Si ves una cantidad significativa de ejecuciones `failed` en un período corto, recopila sus ids de ejecución y detalles de error antes de escalar. Un patrón es más accionable que una falla aislada.
</Tip>

## Cuándo involucrar a ingeniería

***

Escala a ingeniería cuando:

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

Comparte los ids de ejecución, el período en UTC, los payloads de error de la API relevantes y la respuesta de `/readyz`. Si la telemetría está habilitada, incluye el enlace al collector o dashboard como evidencia complementaria.