> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Queue
> Envíe, reciba y confirme mensajes en colas estándar y FIFO.
Queue mantiene mensajes hasta que un consumidor los procese y confirme. Use colas estándar para entrega al menos una vez con orden de mejor esfuerzo o FIFO para procesamiento ordenado dentro de cada grupo.
El servicio es regional. El endpoint de São Paulo es `https://queue.sa-saopaulo-1.basaltic.sh`. Las llamadas usan bearer token y el identificador de la cuenta en `X-Account-Id`; consulte [Autenticación](/es/authentication).
## Recibir es obtener una concesión
Recibir oculta el mensaje durante el timeout de visibilidad y devuelve un recibo. Elimine el mensaje con ese recibo después de procesarlo correctamente. Si la concesión vence antes, el mensaje vuelve a estar disponible. Una nueva recepción genera otro recibo; uno vencido no puede confirmar la concesión de otro consumidor.
Use el endpoint de visibilidad para ampliar o reducir una concesión actual. La inspección es una operación y permiso separados: lee mensajes sin concederlos.
## Contratos de las colas
| Contrato | Comportamiento |
| - | - |
| Estándar | Entrega al menos una vez y orden de mejor esfuerzo. Los consumidores deben tolerar reentregas. |
| FIFO | El nombre termina en `.fifo`; el orden es por `message_group_id`. El tipo se fija al crear. |
| Long polling | `wait_time_seconds` espera hasta 20 segundos por un mensaje. |
| Confirmación | Elimine usando el recibo de la concesión actual. |
| Cifrado | Los cuerpos se cifran en reposo. Una clave KMS propia usa `kms_key`. |
Las respuestas exponen el cifrado administrado por el cliente como referencia `kms_key` con `id`, `crn` y `name`. El cifrado de la plataforma omite el campo. Si los metadatos no están disponibles, la referencia conserva ID y CRN sin nombre. Esto no cambia la cola al cifrado de la plataforma.
`redrive_policy.dead_letter_queue` es una referencia con `id`, `crn` y `name` de la cola de destino. Las solicitudes de creación y actualización aceptan UUID, nombre o CRN como cadena en ese campo. `max_receive_count` controla cuándo se mueve el mensaje.
En las actualizaciones, omitir `kms_key` o `redrive_policy` conserva el valor actual. Envíe `kms_key: null` para restaurar el cifrado de la plataforma en mensajes nuevos o `redrive_policy: null` para eliminar la política de mensajes no entregados. Los mensajes existentes conservan la clave original.
## Métricas
Abra la pestaña **Metrics** de la cola para ver gráficos de profundidad, tráfico, antigüedad del mensaje disponible más antiguo y contenido almacenado. Use el intervalo de tiempo para comparar cambios. Las mismas series están en [Telemetry](/es/telemetry#metrics) y pueden alimentar alertas.
Las series se muestrean cada 30 segundos e incluyen las etiquetas `queue_id` y `region`. Las lecturas exigen `telemetry:ReadMetrics` en la cuenta y región seleccionadas. En FIFO, un mensaje anterior del grupo aún puede bloquear un mensaje contado como disponible.
| Métrica | Tipo | Significado |
| - | - | - |
| `basaltic_queue_messages_available` | Gauge | Mensajes no vencidos cuyo tiempo de visibilidad terminó. |
| `basaltic_queue_messages_in_flight` | Gauge | Mensajes no vencidos con concesión activa. |
| `basaltic_queue_messages_delayed` | Gauge | Mensajes no vencidos cuyo retraso inicial no terminó. |
| `basaltic_queue_stored_bytes` | Gauge | Bytes de contenido en mensajes no vencidos. |
| `basaltic_queue_oldest_available_message_age_seconds` | Gauge | Tiempo desde el envío del mensaje disponible más antiguo; cero cuando está vacía. |
| `basaltic_queue_messages_enqueued_total` | Contador | Mensajes almacenados, incluida redirección; excluye envíos deduplicados. |
| `basaltic_queue_messages_received_total` | Contador | Concesiones de mensajes, incluidas reentregas. |
| `basaltic_queue_messages_removed_total` | Contador | Eliminaciones por confirmación, vencimiento, purga o redirección. |
| `basaltic_queue_bytes_enqueued_total` | Contador | Bytes de contenido aceptados en la cola. |
Use `last` para profundidad actual y `rate` para tráfico por segundo. Los contadores empiezan al desplegar las métricas y persisten tras eliminar mensajes o reiniciar workers. No hay relleno retroactivo. Las colas inactivas emiten gauges cero; las observaciones ausentes dejan huecos, no ceros.
Choose type, timing, encryption, and a dead-letter destination.
Lease messages, extend visibility, and acknowledge processing.
Control ordering and isolate repeated failures.
Separate producers, consumers, and queue administrators.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.