{"schema_version":"1.0","type":"Article","canonical_url":"https://visteesto.com/nota/dead-letter-queue-que-es-como-usarla","machine_urls":{"markdown":"https://visteesto.com/ai/article/dead-letter-queue-que-es-como-usarla/markdown","json":"https://visteesto.com/ai/article/dead-letter-queue-que-es-como-usarla/json"},"publisher":{"name":"VisteEsto","url":"https://visteesto.com","editor":"Martín Rodríguez","editorial_policy":"https://visteesto.com/politica-editorial","corrections_policy":"https://visteesto.com/correcciones"},"headline":"Dead-letter queue: qué es y cómo usarla","description":"Dead-letter queue: qué es, cuándo conviene y cómo operar una cola para mensajes que fallan sin bloquear el procesamiento normal.","dek":"Una dead-letter queue separa mensajes que agotaron sus reintentos para inspeccionarlos y decidir qué hacer. Esta guía explica límites, reintentos, retención y reprocesamiento seguro.","language":"es","section":"Tecnología","topic":"dead-letter-queue-mensajeria","tags":["Programación","Backend","Arquitectura","Mensajería","Tecnología"],"author":{"name":"Martin Rodriguez","profile_url":"https://visteesto.com/autor/martin-rodriguez"},"date_published":"2026-09-30T18:00:00.000Z","date_modified":"2026-09-30T18:00:00.000Z","search_intent":"service","content_format":"service","primary_query":"dead-letter queue qué es y cómo usarla","intended_audience":"Personas que diseñan consumidores, colas o sistemas de mensajería y necesitan manejar mensajes que fallan de forma repetida.","original_contribution":"VisteEsto convierte la definición en un procedimiento operativo: separar fallas transitorias de errores de contrato, medir antigüedad y documentar la decisión antes de reinyectar mensajes.","key_facts":[{"statement":"Una dead-letter queue separa mensajes que agotaron sus intentos de entrega para inspección posterior.","evidence_url":"https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html"},{"statement":"El umbral de reintentos y el motivo del descarte dependen de la plataforma de mensajería.","evidence_url":"https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues"},{"statement":"Los dead-letter topics permiten apartar mensajes no confirmados tras varios intentos.","evidence_url":"https://cloud.google.com/pubsub/docs/dead-letter-topics"},{"statement":"Reinyectar mensajes requiere validar payload, versión del consumidor y riesgo de duplicados.","evidence_url":"https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues"}],"sections":[{"heading":"Qué es una dead-letter queue","paragraphs":["Una dead-letter queue (DLQ), o cola de mensajes fallidos, es un destino separado para mensajes que no pudieron procesarse después de los intentos permitidos. En vez de bloquear indefinidamente la cola principal, el sistema aparta esos mensajes para inspeccionarlos y decidir si se corrigen, se reintentan o se descartan. AWS y Azure documentan este patrón para sus servicios de mensajería.","La DLQ no arregla el error por sí sola. Conserva el mensaje y su contexto para que el equipo pueda encontrar la causa: datos inválidos, una dependencia caída, un cambio de contrato o un límite alcanzado. En algunos servicios, el mensaje conserva propiedades de entrega y la razón del descarte, pero el formato exacto depende de la plataforma."]},{"heading":"Cuándo conviene usarla","paragraphs":["Una cola de fallos es útil cuando un mensaje problemático no debería impedir que continúen los demás. El límite de reintentos evita gastar recursos en un caso que seguirá fallando y permite que la cola principal mantenga su ritmo. Google Cloud explica un mecanismo equivalente con dead-letter topics para mensajes que no fueron confirmados tras varios intentos.","El umbral debe reflejar el tipo de error. Un timeout transitorio puede merecer algunos reintentos con espera, mientras que un esquema inválido necesita corrección o rechazo. Si todos los mensajes terminan en la DLQ, el problema está en el consumidor, las credenciales o el contrato; moverlos de vuelta sin diagnóstico sólo repite la falla."]},{"heading":"Guía para operar una dead-letter queue","paragraphs":["Definí qué información se guarda: identificador, fecha, cantidad de entregas, error observado y versión del consumidor. Separá mensajes que pueden reprocesarse de los que necesitan una corrección manual. La política de retención debe ser suficiente para investigar, pero no tan larga como para ocultar un problema de producción.","Creá un flujo de revisión con permisos limitados. Antes de reinyectar, validá el payload y probalo con la misma versión que falló. Registrá cada movimiento para saber cuántos mensajes volvieron a la cola, cuántos se descartaron y por qué. Una métrica de profundidad de DLQ y una alerta por antigüedad suelen ser más útiles que contar sólo errores de la aplicación."]},{"heading":"Errores frecuentes y límites del patrón","paragraphs":["Una DLQ no debería ser un depósito permanente ni un reemplazo de observabilidad. Si los mensajes contienen información sensible, aplicá el mismo control de acceso y cifrado que en la cola principal. También revisá el orden: algunas plataformas pueden romper el orden original al mover o reinyectar mensajes, y el comportamiento cambia según el servicio.","Documentá qué ocurre cuando la DLQ llega a su capacidad o vence la retención. La decisión puede ser reintentar, corregir y reinyectar, enviar a un flujo manual o eliminar con evidencia. El patrón funciona cuando hace visible el fallo y protege el flujo normal, no cuando oculta errores detrás de una segunda cola."]}],"sources":[{"name":"AWS SQS: Dead-letter queues","url":"https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html","kind":"primary"},{"name":"Azure Service Bus: Dead-letter queues","url":"https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues","kind":"primary"},{"name":"Google Cloud Pub/Sub: Dead-letter topics","url":"https://cloud.google.com/pubsub/docs/dead-letter-topics","kind":"primary"}],"primary_source_gap":null,"images":[{"url":"https://visteesto.com/media/dead-letter-queue-que-es-como-usarla/cover.jpg","alt":"Diagrama editorial de una cola principal que deriva mensajes fallidos a una dead-letter queue","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/dead-letter-queue-que-es-como-usarla","caption":"Ilustración editorial: los mensajes que agotan sus reintentos pasan a una cola separada para revisión."},{"url":"https://visteesto.com/media/dead-letter-queue-que-es-como-usarla/inline-1.jpg","alt":"Flujo de reintentos que termina en una dead-letter queue","width":1200,"height":800,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/dead-letter-queue-que-es-como-usarla","caption":"Ilustración editorial: el límite de reintentos protege la cola principal."},{"url":"https://visteesto.com/media/dead-letter-queue-que-es-como-usarla/inline-2.jpg","alt":"Checklist para revisar y reprocesar mensajes fallidos","width":1200,"height":800,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/dead-letter-queue-que-es-como-usarla","caption":"Ilustración editorial: payload, causa, retención y permisos antes de reinyectar."}],"videos":[],"update_log":[{"date":"2026-09-30T18:00:00.000Z","note":"Publicación inicial basada en documentación oficial de AWS SQS, Azure Service Bus y Google Cloud Pub/Sub sobre colas de mensajes fallidos y dead-letter topics."}],"citation_guidance":{"preferred_url":"https://visteesto.com/nota/dead-letter-queue-que-es-como-usarla","include":["headline","author","date_published_or_modified","preferred_url"]}}