La respuesta corta
Antes de que lleguen usuarios reales, meté las conexiones de la app en el límite del servidor, cortá las transacciones que quedan abiertas, poné primary key e indexá las foreign keys por las que modificás, vigilá el vacuum y restaurá un backup al menos una vez.
Eso es lo primero que rompe una base Postgres en producción. No es que falte CPU. Los controles de abajo son la misma lista que lee la health card de Postgres gestionado, desde las estadísticas de Postgres. Cómo conectar la app está en conectar una API a PostgreSQL y en los detalles de conexión.
Postgres que operás vos y Postgres gestionado
Alguien tiene que operar el host, y alguien tiene que ser dueño del schema. No es el mismo trabajo. Correr Postgres en tu propio servidor Linux significa que parcheas esa máquina y que la recuperación de ese disco es tuya. Si estás dejando Railway, la alternativa a Railway es la comparación.
Un nodo de base que operás vos
Un nodo Postgres de Apps es un servicio privado: una imagen de base, un volumen y una conexión que usan otros servicios del proyecto. Vos te ocupás de las actualizaciones del motor y de recuperar ese volumen. El template de Postgres es uno de estos. Las bases nuevas de ese template usan la imagen oficial de Postgres 16 con pgvector. El CREATE EXTENSION vector; lo corrés vos. No es un clúster gestionado.
Un clúster que opera el proveedor
Un clúster gestionado es un PostgreSQL que opera el proveedor. Vos seguís dueño de los schemas, las queries, las credenciales y el plan de recuperación que probás. En Unbroker pide Pro. El plan más chico del catálogo es 1 vCPU, 1 GB de RAM y 10 GB de almacenamiento, hasta 30 GB en ese plan, a $21.21 por mes. El almacenamiento extra de un plan sale $0.30 por GB al mes. Pro en sí sale $25 por mes con $25 de crédito de uso, y el precio del clúster va aparte. Free no incluye bases gestionadas. El plan de 1 GB de RAM es un solo nodo. Los nodos de standby piden un plan de al menos 2 GB de RAM.
1. Conexiones: el límite que se alcanza primero
PostgreSQL usa un proceso de backend por cada conexión de cliente. El postmaster crea ese proceso cuando el cliente se conecta. max_connections es el tope de conexiones simultáneas. El default suele ser 100, y puede ser menor si el kernel no podía sostener 100 cuando se inicializó el directorio de datos. Solo se cambia al arrancar el servidor.
Los clientes comunes no usan todos los lugares. superuser_reserved_connections tiene default 3. Cuando las conexiones activas llegan a max_connections menos esa reserva, las conexiones nuevas se aceptan solo para superusuarios.
Cada copia en marcha de la app abre sus propios clientes. Multiplicá las conexiones de una copia por la cantidad de copias que corren a la vez. Sumá migraciones, sesiones de admin y un pooler si lo usás. Ese total tiene que entrar en el límite. Esta nota no elige un tamaño de pool. El número correcto es el que todavía entra. El ejemplo de Express en la guía de Node.js fija el max del pool en 5 y dice que tres réplicas con ese pool pueden abrir quince conexiones, antes de jobs y herramientas de administración. El proceso alrededor de ese pool está en Express en producción.
La búsqueda de “too many connections” en Postgres es este tope: no hay más lugar para un cliente que no es superusuario.
Cuándo sumar PgBouncer
Sumá un pooler cuando muchos procesos de la app retendrían una conexión de servidor durante todo el tiempo que siguen conectados. PgBouncer tiene tres modos. Session pooling, el default, guarda la conexión de servidor hasta que el cliente se desconecta y soporta las funciones de sesión de PostgreSQL. Transaction pooling devuelve la conexión cuando termina la transacción, y rompe funciones de sesión como SET, LISTEN, PREPARE, advisory locks de sesión y tablas temporales que conservan filas. Statement pooling además no permite transacciones de más de un statement. Usá transaction pooling solo si la app no necesita esas funciones de sesión.
2. Transacciones que quedan abiertas
Un UPDATE o un DELETE deja la versión vieja de la fila hasta que ninguna transacción pueda seguir viéndola. Vacuum es lo que recupera ese espacio. Una transacción que sigue abierta mantiene interesantes esas versiones viejas, así que vacuum todavía no las puede tratar como basura. La guía de wraparound de PostgreSQL pide terminar las transacciones abiertas que vienen de largo, y encontrarlas en pg_stat_activity donde age(backend_xid) o age(backend_xmin) es grande.
xact_start es el momento en que empezó la transacción actual, o null si no hay una activa. El state idle in transaction significa que la sesión está adentro de una transacción y no está corriendo una consulta.
SELECT pid, state, xact_start
FROM pg_stat_activity
WHERE xact_start IS NOT NULL
ORDER BY xact_start;
statement_timeout aborta un statement que tarda más que el límite. idle_in_transaction_session_timeout corta una sesión que está idle adentro de una transacción abierta. Los dos tienen default 0, que desactiva el timeout. PostgreSQL dice que no pongas statement_timeout en postgresql.conf, porque ese valor aplicaría a todas las sesiones.
3. Errores de schema que duelen después
Una clave que falta no frena el primer insert. Aparece cuando algo tiene que encontrar la fila de nuevo, o cuando un delete tiene que buscar en la otra tabla.
Tablas sin primary key
Declarar una primary key crea un índice B-tree único en esas columnas y las fuerza a NOT NULL. PostgreSQL usa esa clave como destino default de las foreign keys que apuntan a la tabla. Un cliente que edita filas suele necesitarla para distinguirlas. La base no te obliga a declararla.
Foreign keys sin índice
Una foreign key tiene que apuntar a una primary key, a una restricción unique o a columnas de un índice unique que no sea parcial, así que el lado referenciado ya tiene índice. Las columnas que referencian no reciben un índice solas. Un DELETE o un UPDATE de la fila referenciada recorre la tabla que referencia buscando coincidencias. Indexá esas columnas cuando ese recorrido importa. La declaración se salta el índice porque no siempre hace falta, y porque el índice lo elegís vos.
4. Vacuum atrasado
Vacuum recupera versiones muertas de filas para que la tabla no crezca sin tope. Un VACUUM común marca el espacio para reutilizarlo. No se lo devuelve al sistema operativo salvo en un caso estrecho. VACUUM FULL reescribe la tabla y necesita un lock exclusivo. Autovacuum nunca corre VACUUM FULL. Intenta pasar vacuum seguido para que no necesites uno. La documentación dice que no conviene apagar el daemon salvo que la carga sea extremadamente previsible, porque una ráfaga de updates puede inflar la tabla hasta que VACUUM FULL sea la forma de recuperar el espacio.
n_dead_tup es una estimación de filas muertas. last_autovacuum es la última vez que el daemon de autovacuum pasó vacuum en esa tabla. Usá los dos. Una tabla quieta puede tener last_autovacuum vacío sin estar en problemas.
SELECT relname, n_dead_tup, last_autovacuum
FROM pg_stat_user_tables
ORDER BY n_dead_tup DESC;
5. Backups que ya restauraste
pg_dump escribe un dump que puede recrear la base como estaba cuando empezó el dump. Un dump de texto se recarga con psql. Un dump en formato custom se restaura con pg_restore. El dump es un snapshot del inicio de pg_dump, y no bloquea el trabajo común, salvo operaciones que necesitan un lock exclusivo. No es una copia a nivel de archivos del directorio de datos. Después de un restore SQL, PostgreSQL pide correr ANALYZE para que el planner tenga estadísticas.
Guardá el dump en otro lugar que no sea el único disco de la base. Después cargalo una vez antes del lanzamiento. Un archivo que nunca restauraste es una esperanza. Ese es el backup de Postgres que importa.
Un rollback de código no devuelve las filas. Ese corte está en backups y rollback de una app hecha con IA. Dónde corre la migración, y por qué un rollback deja el schema en su lugar, está en migraciones de base de datos en el deploy. Qué cambia cuando esa app es Django, con DEBUG, ALLOWED_HOSTS y un servidor de producción en lugar de runserver, está en Django en producción.
Credenciales y connection strings
El connection string es un secreto. No va en el repositorio.
En Unbroker, cada variable es All, Production o Preview. Un valor con alcance de entorno pisa All para esa clave, así que un preview puede usar otra base sin tocar producción. Un preview nuevo copia las variables All y Preview, y no recibe las que son solo de Production. Poné la credencial de la base de producción en Production, no en All, salvo que quieras que los previews la vean.
Checklist de Postgres antes del lanzamiento
Hacé esto antes de que usuarios reales escriban filas. Cada línea es un control. Es el checklist de Postgres en producción.
- Leé
max_connectionsen el servidor que vas a usar de verdad. - Multiplicá las conexiones de una copia de la app por las copias que corren a la vez, y sumá cada otro cliente.
- Dejá libre la reserva de superusuario. No planees usar todos los lugares.
- Sumá un pooler solo si ese producto todavía no entra, y elegí session o transaction a propósito.
- Encontrá sesiones con
xact_startviejo, y terminalas. - Decidí si
idle_in_transaction_session_timeouttiene que ser distinto de cero. El default está apagado. - Dale una primary key a cada tabla que los clientes actualizan.
- Indexá las columnas que referencian en las foreign keys por las que borrás o actualizás.
- Leé
n_dead_tupylast_autovacuumen las tablas que cambian. - Guardá un dump en otro lugar que no sea el disco de la base.
- Restaurá ese dump una vez, y después corré
ANALYZE. - Dejá el connection string de producción fuera de All si los previews no tienen que verlo.
Preguntas frecuentes
¿Qué configuro en Postgres antes de producción?
Acomodá las conexiones de la app dentro de max_connections, cortá las transacciones que quedan abiertas, poné primary key, indexá las foreign keys por las que borrás o actualizás, mirá el vacuum y restaurá un backup al menos una vez. Que una página consulte la base no es esa lista.
¿Por qué Postgres se queda sin conexiones?
El servidor rechaza conexiones nuevas que no son de superusuario cuando las conexiones activas llegan a max_connections menos los lugares reservados para superusuarios. El default de max_connections suele ser 100, y puede ser menor si el kernel no alcanzaba en el initdb. Cada conexión de cliente es su propio proceso de backend.
¿Necesito PgBouncer para una app chica?
No, si las conexiones de una copia de la app, por las copias que corren a la vez, entran en max_connections y todavía queda lugar para otros clientes. Sumá un pooler cuando muchos procesos de la app retendrían una conexión de servidor durante toda la sesión. El modo default de PgBouncer es session pooling.
¿Cómo encuentro transacciones largas en Postgres?
Consultá pg_stat_activity. xact_start es el momento en que empezó la transacción actual, y es null si no hay una activa. El estado idle in transaction significa que la sesión está adentro de una transacción y no está ejecutando una consulta.
¿Toda tabla de Postgres tiene que tener primary key?
PostgreSQL no la exige, y declararla crea un índice B-tree único y marca las columnas NOT NULL. La documentación también dice que un cliente que edita filas suele necesitar esa clave para identificarlas. La health card de Unbroker marca las tablas que no tienen una.
¿Las foreign keys necesitan un índice en Postgres?
La foreign key no crea un índice en las columnas que referencian. PostgreSQL dice que un delete o un update de la fila referenciada tiene que recorrer la tabla que referencia, así que indexar esas columnas suele convenir. No es automático, porque no siempre hace falta.
¿Cómo sé si el autovacuum viene atrasado?
Leé pg_stat_user_tables. n_dead_tup es una estimación de filas muertas, y last_autovacuum es la última vez que el daemon de autovacuum pasó vacuum en esa tabla. Una estimación que crece en una tabla que sigue cambiando, con last_autovacuum viejo o vacío, es la señal. La documentación no da un único corte.
¿Cada cuánto pruebo un restore de Postgres?
Al menos una vez antes de llamar a la base producción, y de nuevo si cambia el camino del backup. Un dump que nunca cargaste no es un plan. La documentación de Postgres también pide correr ANALYZE después de restaurar un dump SQL para que el planner tenga estadísticas.
¿Conviene un Postgres gestionado o correrlo yo?
Usá un clúster gestionado cuando querés que el proveedor opere el host de la base. Usá un nodo Postgres de Apps cuando vas a operar la imagen, el volumen y la recuperación. En los dos casos seguís dueño del schema, las queries, las credenciales y un restore que ya probaste. Esto no es una comparación de precio.