Supervisar el tamaño de la caché JSON

La caché JSON progresiva crece según la demanda. Cada combinación solicitada de sitio, idioma, contexto de archivo, sección de taxonomía, número de lote y elementos por página puede crear otro archivo.

POM Cache no elimina JSON solo por ser antiguo, por lo que la supervisión del almacenamiento forma parte del plan de mantenimiento de producción.

Leer el resumen integrado

Abre Settings → POM Cache → General → Progressive JSON tools y busca Progressive JSON Cache Contents.

El resumen calcula para el sitio actual:

• el número de archivos .json no vacíos;
• su tamaño combinado.

El análisis se actualiza cuando la página de ajustes genera el resumen y después de la acción de borrado de JSON. Es un informe de almacenamiento del sitio actual, no un panel de analíticas: no muestra aciertos, fallos, antigüedades ni el archivo individual más grande.

Los archivos HTML se contabilizan por separado en Cache tools → Cache Contents.

Qué hace crecer el árbol

Un archivo puede crear varias dimensiones:

locales
× archive contexts
× term sections
× requested pages
× posts-per-page variants

No se genera toda combinación teórica. Solo una solicitud real o deliberada escribe un lote almacenable en caché.

El crecimiento suele deberse a:

• visitantes que llegan a páginas de archivo más profundas;
• más idiomas públicos;
• archivos divididos por términos con muchos grupos;
• cambios en los ajustes de archivo progresivos que crean un nuevo hash de contexto;
• un valor de elementos por página modificado;
• slugs o rutas antiguas que ya no reciben tráfico;
• que los conmutadores de invalidación automática permanezcan desactivados durante cambios estructurales frecuentes.

El tamaño máximo de archivo es una protección por entrada

Maximum JSON file size tiene como valor predeterminado:

1048576

Eso equivale a 1 MiB en bytes. POM Cache aplica al menos 1024 bytes como límite configurado y utiliza el límite tanto para lecturas como para escrituras.

El ajuste no limita todo el directorio de caché. Un límite de 1 MiB sigue permitiendo miles de archivos más pequeños.

No reduzcas el valor por debajo de los tamaños de respuesta reales sin probar. Una respuesta dinámica demasiado grande sigue llegando al visitante, pero POM Cache ni la almacenará ni reutilizará un archivo existente que supere el límite.

Calcular un presupuesto de almacenamiento

Utiliza valores medidos:

expected files × average JSON file size = approximate active storage

Por ejemplo, 2.000 archivos con una media de 45 KiB requieren aproximadamente 88 MiB antes de la sobrecarga del sistema de archivos. La distribución real puede ser desigual, así que inspecciona modos de archivo representativos pequeños y grandes.

Reserva también margen temporal para:

• que se genere un nuevo contexto antes de eliminar los archivos antiguos;
• varios idiomas calentándose a la vez;
• actividad de contenido masiva;
• herramientas de copia de seguridad o despliegue que copian el directorio de caché.

La caché generada normalmente debería excluirse de las copias de seguridad y de los artefactos de publicación según la política de tu alojamiento, porque puede regenerarse.

Establecer una rutina de mantenimiento

1. Registra Progressive JSON Cache Contents después del calentamiento normal;
2. Vuelve a registrarlo después de una semana típica o de un ciclo editorial;
3. Relaciona el crecimiento con nuevos idiomas, contextos o tráfico profundo de archivo;
4. Borra el JSON después de cambios estructurales en plantillas o en el tamaño de lote;
5. Confirma que el recuento baja a cero para el sitio actual;
6. Deja que el tráfico normal reconstruya el conjunto de trabajo activo;
7. Compara el nuevo recuento y tamaño en estado estable.

Un recuento grande no es automáticamente un problema. El crecimiento continuo después de retirar rutas o cambiar configuraciones es una señal para revisar la invalidación.

Operaciones masivas

Durante una importación grande o un lote de traducción, una purga automática activada puede eliminar repetidamente el árbol JSON del sitio actual. Dejar las purgas desactivadas puede conservar archivos obsoletos. Elige un flujo de trabajo controlado:

1. Decide si los editores pueden tolerar lotes progresivos obsoletos durante la operación;
2. Ejecuta el cambio masivo;
3. Realiza un borrado manual de JSON al terminar;
4. Verifica que los archivos importantes se regeneran;
5. Invalida las rutas CDN relacionadas si el edge las almacenó en caché.

Esto evita cambios repetidos en el origen y termina con una caché que se sabe reciente.

Contabilidad en multisitio

El resumen de ajustes muestra el espacio de nombres del sitio actual, no un total de toda la red. Repite la comprobación en cada sitio relevante cuando la red comparte una Cache Location física.

Para borrar de forma específica una subsección, abre el frontend o el panel de ese sitio y usa los controles del sitio actual descritos en Borrar un sitio de forma segura en una red multisitio.

Cuando el tamaño parece incorrecto

Si el recuento sigue en cero, prueba la generación de JSON y los permisos de escritura. Si el recuento es plausible pero el tamaño es inesperadamente alto, inspecciona los tamaños reales de respuesta por lote y busca:

• marcado de elementos renderizados inusualmente grande;
• demasiados elementos por lote;
• muchos hashes de contexto obsoletos;
• expansión de idiomas o taxonomías;
• un tamaño máximo elegido sin medir la carga útil.

Borra y regenera antes de tratar los contextos antiguos abandonados como demanda actual. Para síntomas de ausencia de aciertos o de escritura, continúa con Solucionar problemas del almacenamiento en caché JSON progresivo.