Para optimizar el rendimiento de los filtros de GraphQL, debe ejecutar un procedimiento para actualizar los fragmentos de contenido.
Después de actualizar los fragmentos de contenido, puede seguir las recomendaciones de Optimización de consultas de GraphQL.
Hay requisitos previos para esta tarea:
Asegúrese de que tiene mínimo la versión 2023.1.0 de AEM as a Cloud Service.
Asegúrese de que el usuario que realiza la tarea tiene los permisos necesarios:
Deployment Manager
Se requiere la función en Cloud Manager.Para ejecutar el procedimiento, siga estos pasos:
Habilite la actualización estableciendo las siguientes variables para su instancia mediante la IU de Cloud Manager:
Las variables disponibles son las siguientes:
Nombre | Value | Valor predeterminado | Servicio | Aplicado | Tipo | Notas | |
---|---|---|---|---|---|---|---|
1 | `CF_MIGRATION_ENABLED` | `1` | `0` | Todos | Variable | Habilita (!=0) o deshabilita (0) la activación del trabajo de migración de fragmentos de contenido. | |
2 | `CF_MIGRATION_ENFORCE` | `1` | `0` | Todos | Variable | Aplica (!=0) la remigración de fragmentos de contenido. Si este indicador se establece en 0, se hará una migración incremental de los fragmentos de contenido. Esto significa que, si el trabajo finaliza por cualquier motivo, la siguiente ejecución iniciará la migración desde el punto en el que se paró. Tenga en cuenta que se recomienda aplicar la primera migración (valor=1). |
|
3 | `CF_MIGRATION_BATCH` | `50` | `50` | Todos | Variable | Tamaño del lote para guardar el número de fragmentos de contenido después de la migración. Esto es relevante para ver cuántos fragmentos de contenido se guardarán en el repositorio en un lote y se puede usar para optimizar el número de escrituras en el repositorio. |
|
4 | `CF_MIGRATION_LIMIT` | `1000` | `1000` | Todos | Variable | Número máximo de fragmentos de contenido para procesar a la vez. Consulte también las notas de `CF_MIGRATION_INTERVAL`. |
|
5 | `CF_MIGRATION_INTERVAL` | `60` | `600` | Todos | Variable | Intervalo (segundos) para procesar los fragmentos de contenido restantes hasta el siguiente límite Este intervalo también se considera como un tiempo de espera antes de iniciar el trabajo, así como un retraso entre el procesamiento de cada número de CF_MIGRATION_LIMIT de fragmentos de contenido subsiguientes. (*) |
(*)
El valor de CF_MIGRATION_INTERVAL
también puede ayudar a aproximar el tiempo total de ejecución del trabajo de migración.
Por ejemplo:
También debe tener en cuenta que esto es solo el tiempo mínimo necesario para completar el trabajo y no incluye el tiempo de E/S. El tiempo real empleado podría ser significativamente mayor que esta estimación.
Monitorice el progreso y la finalización de la actualización.
Para ello, monitorice los registros de creación y publicación maestra desde aquí:
com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob
Registros de creación; por ejemplo:
23.01.2023 13:13:45.926 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<dd9ffdc1-0c28-4d04-9a96-5d4d223e457e> is the leader, will schedule the upgrade schedule job.
...
23.01.2023 13:13:45.941 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, enforce: true, limit: 1000, batch: 50, interval: 60s
23.01.2023 13:20:40.960 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 6m, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
Registros de publicación maestra; por ejemplo:
23.01.2023 12:35:05.150 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<ad1b399e-77be-408e-bc3f-57097498fddb> is the leader, will schedule the upgrade schedule job.
23.01.2023 12:35:05.161 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, enforce: true, limit: 1000, batch: 50, interval: 60s
...
23.01.2023 12:40:45.180 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 5m, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
Los clientes que han habilitado el acceso a los registros de entorno mediante Splunk, pueden utilizar la consulta de ejemplo siguiente para monitorizar el proceso de actualización. Para obtener más información sobre cómo habilitar el registro de Splunk, consulte Depuración de producción y ensayo página.
index=<indexName> sourcetype=aemerror aem_envId=<environmentId> msg="*com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished*"
(aem_tier=golden-publish OR aem_tier=author) | table _time aem_tier pod_name msg | sort -_time desc
Donde:
environmentId
: un identificador de entorno del cliente; por ejemplo, e1234
indexName
- un nombre de índice de cliente, recopilación aemerror
eventosEjemplo de salida: