La página Video Transcoding de my.cubepath.com lista todos los trabajos con su origen, sus salidas, su destino, su estado y la fecha de creación. Mientras haya algo en marcha, la lista se refresca sola cada pocos segundos, así que puedes dejarla abierta y ver cómo se vacía la cola.
El ciclo de vida
| Estado | Qué está pasando |
|---|---|
| Queued | Aceptado, esperando worker. Es normal cuando hay carga |
| Analyzing | Estamos leyendo el origen para averiguar su duración, sus pistas y cómo segmentarlo |
| Encoding | Se están produciendo las versiones, en paralelo entre segmentos. Aquí es donde se va el tiempo |
| Finalizing | Los segmentos se unen, se empaquetan y se suben a tu bucket |
| Completed | Todas las salidas están escritas en el destino |
| Failed | Algo lo paró. El error queda en el trabajo |
| Canceled | Lo cancelaste antes de que terminara |
Los cuatro primeros son transitorios; los tres últimos son finales. Un trabajo en estado final ya no vuelve a cambiar.
Progreso y segmentos
Un trabajo en marcha lleva un progreso de 0 a 100 y, en cuanto pasa el análisis, un contador de segmentos completados / totales. En ficheros largos el contador de segmentos es el más honesto de los dos: te dice qué parte del origen se ha codificado de verdad, y avanza a saltos visibles.
Usa el filtro de estado sobre la lista para quedarte con lo que te importa — normalmente failed cuando algo va mal, o encoding cuando quieres saber qué está ocupando la capacidad ahora mismo.
Recoger las salidas
Cuando un trabajo termina, View outputs lista todos los ficheros que ha escrito, con su bucket y su clave. Es la forma más rápida de confirmar que las rutas son las que esperabas antes de apuntar una aplicación a ellas; los ficheros en sí están en tu propio bucket, así que los descargas de ahí.
Si un trabajo completado no lista nada, es que las salidas no produjeron artefactos — lo habitual es una salida HLS sin peldaños. Míralo en Salidas.
Webhooks
Define una URL de webhook al crear el trabajo y te hacemos un POST cuando llega a un estado final. Esa es la forma correcta de mover una tubería: sin bucle de sondeo y sin esperas.
NotaLa entrega del webhook es de mejor esfuerzo y no se reintenta. Trátalo como un aviso, no como una garantía — cuando la notificación es lo que dispara la publicación, ten un barrido que reconcilie contra el estado del trabajo todo lo que siga marcado como en curso, y así no perderás ningún vídeo por una petición caída.
Cancelar y borrar
Cancelar detiene el trabajo que aún no se ha hecho y elimina sus tareas pendientes. Uno ya completado o fallido no se puede cancelar: no queda nada que parar. Cancelar no borra lo que ya se haya escrito en tu bucket; si el trabajo llegó a subir ficheros, ahí siguen y la limpieza es tuya.
Borrar quita el trabajo de la lista. Tampoco toca tu bucket.
Diagnóstico
| Síntoma | Causa probable |
|---|---|
| Atascado en queued | Normal bajo carga; la codificación arranca según se libera capacidad. Si no se mueve nunca, comprueba si estás en el tope de trabajos activos de Lotes y límites |
| Failed enseguida | El origen no se pudo leer: una URL que da 404, una clave de objeto que no existe, o credenciales sin permiso de lectura |
| Failed al final | El destino rechazó la escritura: endpoint incorrecto, región incorrecta o una clave sin permiso de escritura en el prefijo |
| Completado sin salidas | Una salida HLS sin peldaños, o una lista de salidas que no produjo artefactos |
| El progreso avanza y se estanca | Un fichero enorme o una escalera cara — 4K y h265/av1 codifican despacio. Mira el contador de segmentos: si sigue subiendo, está trabajando |
| No llegó el webhook | La entrega no se reintenta. Confirma que el endpoint es alcanzable y responde rápido, y reconcilia contra el estado del trabajo |
ConsejoView error en un trabajo fallido muestra el mensaje que produjo el codificador. Léelo antes de cambiar nada — nombra la fase que falló, y casi siempre eso basta para distinguir un problema de origen de uno de destino.