Uppdatera dina innehållsfragment för optimerad GraphQL-filtrering

För att optimera prestanda för dina GraphQL-filter måste du köra en procedur för att uppdatera dina innehållsfragment.

OBSERVERA

När du har uppdaterat dina innehållsfragment kan du följa rekommendationerna för Optimera GraphQL-frågor.

Förutsättningar

Det finns krav för den här uppgiften:

  1. Se till att du har minst 2023.1.0-utgåvan av AEM as a Cloud Service.

  2. Se till att användaren som utför uppgiften har de behörigheter som krävs:

    • minst Deployment Manager en roll i Cloud Manager krävs.

Uppdatera dina innehållsfragment

Så här kör du proceduren:

  1. Aktivera uppdateringen genom att ange följande variabler för instansen med användargränssnittet i Cloud Manager:

    Miljökonfiguration för Cloud Manager

    De tillgängliga variablerna är:

      Namn Värde Standardvärde Tjänst Används Typ Anteckningar
    1 "CF_MIGRATION_ENABLED" `1` `0` Alla Variabel Enables(!=0) eller inaktiverar(0) som utlöser migreringsjobb för innehållsfragment.
    2 `CF_MIGRATION_ENFORCE` `1` `0` Alla Variabel Tvinga (!=0) ommigrering av innehållsfragment.
    Om flaggan anges till 0 utförs en stegvis migrering av CF:er. Detta innebär, om jobbet avslutas av någon anledning, att nästa körning av jobbet startar migreringen från den punkt där det avslutades. Observera att den allra första migreringen rekommenderas (value=1).
    3 "CF_MIGRATION_BATCH" `50` `50` Alla Variabel Storlek på gruppen för att spara antal innehållsfragment efter migrering.
    Detta gäller hur många CF:er som ska sparas i databasen i en batch och kan användas för att optimera antalet skrivningar i databasen.
    4 "CF_MIGRATION_LIMIT" `1000` `1000` Alla Variabel Maximalt antal innehållsfragment som ska bearbetas samtidigt.
    Se även anmärkningarna för "CF_MIGRATION_INTERVAL".
    5 "CF_MIGRATION_INTERVAL" `60` `600` Alla Variabel Intervall (sekunder) för bearbetning av återstående innehållsfragment upp till nästa gräns
    Det här intervallet betraktas också som en väntetid innan jobbet startas samt en fördröjning mellan bearbetningen av varje efterföljande CF_MIGRATION_LIMIT-antal CF:er.
    (*)
    OBSERVERA

    (*)

    Värdet för CF_MIGRATION_INTERVAL kan också hjälpa till att beräkna den totala körningstiden för migreringsjobbet.

    Till exempel:

    • Totalt antal innehållsfragment = 20 000
    • CF_MIGRATION_LIMIT = 1000
    • CF_MIGRATION_INTERNAL = 60 (Sec)
    • Ungefärlig tid krävs för att slutföra migreringen = 60 + (20 000/1 000 * 60) = 1 260 sek = 21 minuter
      De ytterligare"60" sekunder som läggs till i början beror på den initiala fördröjningen när jobbet startas.

    Du bör också vara medveten om att detta bara är minimum den tid som krävs för att slutföra jobbet, men inte I/O-tiden. Den faktiska tiden kan vara betydligt längre än denna uppskattning.

  2. Övervaka uppdateringens förlopp och slutförande.

    För att göra detta ska du övervaka loggarna på författaren och publicera med golden från:

    • com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob

      • Författarloggar. till exempel:

        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}
        
      • Golden-publish logs; till exempel:

        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}
        

    Kunder som har aktiverat åtkomst till miljöloggar med Splunk kan använda exempelfrågan nedan för att övervaka uppgraderingsprocessen. Mer information om att aktivera Splunk-loggning finns i Felsöka produktion och scen sida.

    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
    

    Var:

    • environmentId - en kundmiljöidentifierare, till exempel e1234
    • indexName - ett kundindexnamn, samla in aemerror händelser

    Exempelutdata:

    tid aem_tier pod_name msg
    2023-04-21 06:00:35.723 författare cm-p1234-e1234-aem-author-76d6dc4b79-8lsb5 [sling-threadpool-bb5da4dd-6b05-4230-93ea-1d5cd242e24f-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upsekretessen)] com.adobe.cq.dam.cfm.impl .upgrade.UpgradeJob Avslutade uppgradering av innehållsfragment på 391 m, slingJobId: 2023/4/20/23/16/db7963df-e267-489b-b69a-5930b0dadb37_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Uppgradering till version '1' lyckades.', errors=[], successCount=36756, failedCount=0, SkippedCount=0}
    2023-04-21 06:05:48.207 gyllene-publicering cm-p1234-e1234-aem-golden-publish-64487c9c5-lvkv2 [sling-threadpool-284b9a9a-8454-461e-9bdb-44866c6ddfb1-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upsekretessing)] com.adobe.cq.dam.cfm.cfm.m.cfm.fm.cfm.m.m.cfm.m.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.a impl.upgrade.UpgradeJob Avslutade uppgradering av innehållsfragment 211 m, slingJobId: 2023/4/20/23/15/66c1690a-cdb7-4e66-bc52-90f3394ddfc_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Uppgradering till version '1' lyckades.', errors=[], successCount=19557, failedCount=0, SkippedCount=0}
  3. Inaktivera uppdateringsproceduren.

    VIKTIGT

    Det här steget krävs för att slutföra uppgraderingen.

    När uppdateringsproceduren har körts återställer du molnmiljövariabeln CF_MIGRATION_ENABLED till '0', för att utlösa återvinning av alla poder.

  4.   Namn Värde Standardvärde Tjänst Används Typ Anteckningar
    "CF_MIGRATION_ENABLED" `0` `0` Alla Variabel Inaktiverar(0) (eller Enables(!)=0)) utlöser migreringsjobb för innehållsfragment.
    OBSERVERA

    Detta är särskilt viktigt för publiceringsnivån, eftersom innehållsuppdateringen endast görs vid publicering i guld och när poder återvinns, är alla normala publiceringsrutor baserade på publiceringen i golden.

  5. Verifiera att uppdateringsproceduren har slutförts.

    Du kan verifiera att uppdateringen har slutförts med hjälp av databaswebbläsaren i Cloud Managers utvecklarkonsol för att kontrollera data för innehållsfragment.

    • Innan den första fullständiga migreringen cfGlobalVersion egenskapen finns inte.
      Därför finns den här egenskapen på JCR-noden /content/dam med värdet 1, bekräftar att migreringen har slutförts.

    • Du kan även kontrollera följande egenskaper för de enskilda innehållsfragmenten:

      • _strucVersion ska ha värdet 1
      • indexedData struktur måste finnas
      OBSERVERA

      Proceduren uppdaterar innehållsfragment för författare och publiceringsinstanser.

      Vi rekommenderar därför att du utför verifieringen via webbläsaren i databasen för minst en författare och en publiceringsinstans.

Begränsningar

Observera följande begränsningar:

  • Optimering av prestanda för GraphQL-filter är endast möjligt efter en fullständig uppdatering av alla dina innehållsfragment (vilket indikeras av närvaron av cfGlobalVersion egenskap för JCR-noden /content/dam)

  • Om innehållsfragment importeras från ett innehållspaket (med crx/de) när uppdateringsproceduren har körts kommer dessa innehållsfragment inte att beaktas i GraphQL-frågeresultat förrän uppdateringsproceduren körs igen.

På denna sida