DokumentationAEM as a Cloud ServiceAnvändarhandbok

Uppdatera dina innehållsfragment för optimerad GraphQL-filtrering updating-content-fragments-for-optimized-graphql-filtering

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Utvecklare

Om du vill optimera prestanda för dina GraphQL-filter kör du en procedur för att uppdatera dina innehållsfragment.

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

Förutsättningar prerequisites

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

  1. Kontrollera att du har minst version 2023.1.0 av AEM as a Cloud Service.

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

    • minst måste rollen Deployment Manager i Cloud Manager anges.

Uppdatera dina innehållsfragment updating-content-fragments

  1. Aktivera uppdateringen genom att ange följande variabler för instansen med Cloud Manager-gränssnittet:

    Konfiguration av Cloud Manager-miljö

    De tillgängliga variablerna är:

    table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8
    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 du anger flaggan 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. Den första migreringen rekommenderas för tvång (value=1).
    3 CF_MIGRATION_BATCH 50 50 Alla Variabel Storlek på gruppen för att spara antalet innehållsfragment efter migreringen. Detta gäller hur många CF:er som 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 anteckningar för CF_MIGRATION_INTERVAL.
    5 CF_MIGRATION_INTERVAL 60 600 Alla Variabel Intervall (sekunder) för att bearbeta återstående innehållsfragment upp till nästa gräns. Det här intervallet betraktas också som både en väntetid innan jobbet startas och en fördröjning mellan bearbetningen av varje efterföljande CF_MIGRATION_LIMIT-antal CF:er. (*)
    note note
    NOTE
    (*)
    Värdet för CF_MIGRATION_INTERVAL kan också bidra till att approximera 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.
    Det här är bara den minsta tiden som krävs för att slutföra jobbet, och det inkluderar inte I/O-tiden. Den faktiska tiden kan vara 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:

        code language-shell 
        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:

        code language-shell 
        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 hur du aktiverar segmentloggning finns i Felsöka produktion och scen.

    code language-splunk 
    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 identifierare för kundmiljö, till exempel e1234
    • indexName - ett kundindexnamn, samla in aemerror händelser

    Exempelutdata:

    table 0-row-4 1-row-4 2-row-4 layout-auto
    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 Slutför uppgraderingen av innehållsfragment på 391m, slingJobId: 2023/4/20/23/16/db7963df-e267-489b-b69a-5930b0dadb333 7_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 Slutför uppgradering av innehållsfragment i 211m, slingJobId: 2023/4/20/23/15/66c1690a-cdb7-4e66-bc52-90f394ddfc_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Uppgradering till version '1' lyckades.', errors=[], successCount=19557, failedCount=0, SkippedCount=0}

  3. Inaktivera uppdateringsproceduren.

    note important
    IMPORTANT
    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 aktivera återanvändning av alla poder.

  4. table html-authored no-header
    table 0-row-8 1-row-8
    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.
    note note
    NOTE
    Detta är viktigt för publiceringsnivån eftersom innehållsuppdateringen endast görs vid publicering i golden och när poderna återvinns är alla normala publiceringsrutor baserade på den gyllene publiceringen.

    Verifiera att uppdateringsproceduren har slutförts.

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

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

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

      • _strucVersion ska ha värdet 1
      • Strukturen indexedData måste finnas
      note note
      NOTE
      Proceduren uppdaterar innehållsfragment för författare och Publish-instanser.
      Därför rekommenderar Adobe att du utför verifieringen via databaswebbläsaren för minst en författare och en Publish-instans.

Begränsningar limitations

Tänk på 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 anges av närvaron av egenskapen cfGlobalVersion för JCR-noden /content/dam)

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab