DokumentationAEM as a Cloud ServiceAnvändarhandbok

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

Last update: Tue Mar 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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. 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 updating-content-fragments

  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:

    table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 layout-auto html-authored
    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 anmärkningarna 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å 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.
    Det här är bara minimum den tid som krävs för att slutföra jobbet, men 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 Splunk-loggning 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 av kundens miljö, 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.

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

  4. table html-authored no-header
    table 0-row-8 1-row-8 layout-auto html-authored
    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 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
      note note
      NOTE
      Proceduren uppdaterar innehållsfragment för författare- och publiceringsinstanser.
      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 visas genom 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, beaktas inte dessa innehållsfragment i GraphQL-frågeresultat förrän uppdateringsproceduren körs igen.

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