Analysator van best practices gebruiken using-best-practices-analyzer
Belangrijke overwegingen voor het Gebruiken van Analyzer van Beste praktijken imp-considerations
Volg de sectie hieronder om de belangrijke overwegingen voor het runnen van de Analysator van Beste praktijken (BPA) te begrijpen:
-
Het BPA-rapport wordt samengesteld met de uitvoer van de Adobe Experience Manager (AEM) Patroondetector. De versie van de Detector van het Patroon die door BPA wordt gebruikt is inbegrepen in het BPA installatiepakket.
-
BPA mag alleen door de admin of een gebruiker in de beheerders groep.
-
BPA wordt ondersteund op AEM instanties met versie 6.1 en hoger.
note note NOTE Zie Installeren op AEM 6.1 voor speciale voorschriften voor de installatie van BPA op AEM 6.1. -
BPA kan op om het even welk milieu lopen, maar het wordt verkiest om het te hebben op een lopen Werkgebied milieu.
note note NOTE Om een effect op bedrijfskritieke instanties te vermijden, wordt u aangeraden BPA op een Auteur milieu dat zo dicht mogelijk bij de Productie omgeving op het gebied van aanpassingen, configuraties, inhoud en gebruikerstoepassingen. CRA kan ook worden uitgevoerd op een kloon van de auteur laag van de productieomgeving. -
Het genereren van de inhoud van het BPA-rapport kan een aanzienlijke hoeveelheid tijd in beslag nemen, van enkele minuten tot een paar uur. De benodigde tijd is in hoge mate afhankelijk van de grootte en aard van de AEM-repository-content, de AEM-versie en andere factoren.
-
Vanwege de tijd die nodig is om de rapportcontent te produceren, gebeurt dit in een achtergrondproces, waarbij de data in cache worden opgeslagen. Het bekijken en downloaden van het rapport gaat relatief snel, omdat hierbij de content in het cachegeheugen wordt opgehaald, totdat het geheugen verloopt of het rapport uitdrukkelijk wordt vernieuwd. Tijdens de generatie van de rapportcontent kunt u uw browsertabblad sluiten en later terugkeren om het rapport te bekijken zodra de content in het cachegeheugen beschikbaar is.
Beschikbaarheid availability
De Analysator van Beste praktijken kan als zip dossier van het portaal van de Distributie van de Software worden gedownload. U kunt het pakket installeren via Pakketbeheer op uw bron-Adobe Experience Manager (AEM)-exemplaar.
Connectiviteit bronomgeving source-environment-connectivity
De bron AEM instantie kan achter een firewall lopen waar het slechts bepaalde gastheren kan bereiken die aan een Lijst van gewenste personen zijn toegevoegd. Als u het door BPA gegenereerde rapport automatisch wilt uploaden naar Cloud Acceleration Manager, moeten de volgende eindpunten toegankelijk zijn vanuit de instantie die AEM wordt uitgevoerd:
- De Azure-opslagservice:
casstorageprod.blob.core.windows.net
Het Rapport van de Analysator van Beste praktijken bekijken viewing-report
Adobe Experience Manager 6.3.0 en hoger aem-later-versions
Volg deze sectie om te leren hoe te om het rapport van de Analysator van Beste praktijken te bekijken:
-
Selecteer Adobe Experience Manager en navigeer naar gereedschappen > Bewerkingen > Analysator van best practices.
-
Klikken Rapport genereren om de Analysator van Beste praktijken uit te voeren.
-
Geef de BPA-upload-sleutel op om het gegenereerde BPA-rapport automatisch te uploaden naar Cloud Acceleration Manager (CAM). Navigeer naar de knop Analyse van beste praktijken in CAM
-
De Genereren wordt geactiveerd wanneer een geldige toets wordt opgegeven. Klikken op Genereren om rapportgeneratie in werking te stellen.
-
Terwijl BPA het rapport produceert, kunt u de vooruitgang zien die door het hulpmiddel op het scherm wordt gemaakt. De voortgang wordt weergegeven in procenten dat is voltooid. Ook wordt het aantal geanalyseerde items weergegeven en wordt het aantal gevonden bevindingen weergegeven.
-
Nadat het BPA-rapport is gegenereerd, worden een samenvatting en het aantal bevindingen weergegeven in een tabelvorm die is ingedeeld op basis van het type bevinding en het belangrijkste niveau. Voor meer informatie over een bepaalde bevinding kunt u op het nummer klikken dat overeenkomt met het type bevinding in de tabel.
-
U kunt het rapport downloaden in de indeling CSV (comma-separated values, door komma's van elkaar gescheiden waarden) door op Exporteren naar CSV. U kunt het rapport ook weergeven in CAM door op Ga naar CAM. Hiermee gaat u naar de Analyse van best practices pagina in CAM.
U kunt BPA dwingen om zijn geheime voorgeheugen te ontruimen en het rapport opnieuw te produceren door te klikken Rapport vernieuwen.
- Als het geheime voorgeheugen verloopt, hebt u de optie om het laatste geproduceerde rapport in CAM te bekijken door op te klikken Bekijk het laatste geproduceerde rapport in CAM of stel een nieuwe rapportgeneratie in door op Nieuw rapport genereren.
Het gebruiken van Filters in het Rapport van de Analysator van Beste praktijken bpa-filters
Bevindingen met betrekking tot ACS-opdrachtenvolgt u de onderstaande stappen:
-
Klik op het linkerspoorpictogram aan de linkerkant van de pagina. Hiermee wordt het dialoogvenster ACS-opdrachtfilter. Klik op de knop ACS-opdrachtfilter om het interactieve selectievakje weer te geven, zoals in de onderstaande afbeelding wordt getoond.
note note NOTE Het linkerspoorpictogram zal verschijnen slechts als BPA het gebruik van ACSCommons ontdekt. -
Schakel het selectievakje uit om alle bevindingen met betrekking tot ACS-opdrachten uit te filteren. U dient een Aantal gefilterde zoekopdrachten in het rapport zoals weergegeven in onderstaande afbeelding. Het filter wordt ook toegepast op het rapport wanneer het in een komma-gescheiden-waarde (CSV) formaat wordt uitgevoerd.
note note NOTE De bevindingen van de ACS-Gemeenschappelijke Gemeenschap moeten niet worden genegeerd. Zie documentatie om de verenigbaarheid met AEM as a Cloud Service te bepalen.
Het rapport met de analyse van best practices interpreteren cra-report
Wanneer het hulpmiddel van de Analysator van Beste praktijken in de AEM instantie in werking wordt gesteld, wordt het rapport getoond als resultaten in het hulpmiddelvenster.
Het rapport is als volgt ingedeeld:
-
Overzicht van rapport: Informatie over het rapport zelf. het overzicht biedt de volgende gegevens:
- Tijd van rapport: Tijdstip waarop de rapportcontent is gegenereerd en voor het eerst beschikbaar gesteld.
- Vervaltijd: Tijdstip waarop de cachecontent verloopt.
- Tijdsperiode voor genereren: De benodigde tijd om de rapportcontent te genereren.
- Aantal bevindingen: Het totale aantal bevindingen in het rapport.
-
Systeemoverzicht: Informatie over het AEM systeem waarop BPA werd uitgevoerd.
-
Categorieën voor bevindingen: Meerdere secties waarin elk een of meer bevindingen van dezelfde categorie worden behandeld. Elke sectie bevat de volgende items: categorienaam, subtypen, aantal en belang, samenvatting, koppeling naar categoriedocumentatie en individuele informatie over de bevindingen.
Aan elke bevinding wordt een belangniveau toegewezen als ruwe prioriteit voor de benodigde actie.
Bekijk de onderstaande tabel om inzicht te krijgen in de belangniveaus:
Het CSV-rapport van de Analysator van best practices interpreteren cra-csv-report
Wanneer u op de knop CSV van uw AEM instantie, wordt het formaat CSV van het rapport van de Analysator van Beste praktijken gebouwd van het inhoudsgeheime voorgeheugen en teruggekeerd aan uw browser. Afhankelijk van de browserinstellingen wordt dit rapport automatisch gedownload als een bestand met de standaardnaam: results.csv.
Als het geheime voorgeheugen is verlopen, dan wordt het rapport opnieuw geproduceerd alvorens het Csv- dossier wordt gebouwd en gedownload.
De CSV-indeling van het rapport bevat informatie die wordt gegenereerd op basis van de Pattern Detector-uitvoer. Deze informatie is gesorteerd en ingedeeld op categorietype, subtype en belang. De indeling is geschikt voor weergave en bewerking in een applicatie zoals Microsoft Excel. Het is bedoeld om alle vindingsinformatie in een herhaalbare formaat te verstrekken dat wanneer het vergelijken van rapporten in tijd kan nuttig zijn om vooruitgang te meten.
Het CSV-indelingsrapport bevat de volgende kolommen:
- code: De categoriecode
- type: De categorienaam
- subtype: Het subtype van de categorie
- importance: Het belang van de bevinding
- identifier: De primaire id van de bevinding
- other: Aanvullende informatie over de bevinding
- message: Het bericht dat voor de bevinding wordt verstrekt
- moreInfo: Een koppeling voor toegang tot online hulp over de categorie
- context: Een JSON-tekenreeks voor het zoeken naar data
De waarde "\N" in een kolom voor een individuele bevinding geeft aan dat er geen data zijn opgegeven.
HTTP-interface http-interface
BPA verstrekt een interface van HTTP die als alternatief aan zijn gebruikersinterface binnen AEM kan worden gebruikt. Deze interface ondersteunt zowel HEAD- als GET-opdrachten. Het kan worden gebruikt om het BPA- rapport te produceren en het in één van drie formaten terug te keren: JSON, CSV, en lusje-gescheiden waarden (TSV).
De volgende URL's zijn beschikbaar voor HTTP-toegang, waarbij <host> is hostname, en haven indien nodig, van de server waarop BPA wordt geïnstalleerd:
http://<host>/apps/best-practices-analyzer/analysis/report.jsonvoor de JSON-indelinghttp://<host>/apps/best-practices-analyzer/analysis/report.csvvoor de CSV-indelinghttp://<host>/apps/best-practices-analyzer/analysis/report.tsvvoor de TSV-indeling
Een HTTP-aanvraag uitvoeren executing-http-request
De HTTP-interface kan op een aantal manieren worden gebruikt.
Een eenvoudige manier is om een browsertabblad te openen in dezelfde browser waarin u zich al als beheerder hebt aangemeld bij AEM. U kunt de URL invoeren op het browsertabblad en de resultaten laten weergeven of downloaden door de browser.
U kunt ook een opdrachtregelprogramma gebruiken, zoals curl of wget en elke HTTP-clienttoepassing. Wanneer u geen browsertabblad gebruikt met een geverifieerde sessie, moet u de naam en wachtwoord van een beheerder-gebruiker opgeven als onderdeel van de opmerking.
Hieronder ziet u hoe u dit kunt doen:curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.csv' > report.csv.
Kopteksten en parameters http-headers-and-parameters
De volgende HTTP-headers worden door deze interface gebruikt:
De volgende handige HTTP-queryparameters zijn beschikbaar wanneer HTTP-headers niet gemakkelijk kunnen worden gebruikt:
max-age(getal, optioneel): geeft de levensduur van de cacheverversheid op in seconden. Dit getal moet 0 of hoger zijn. De standaard versheidslevensduur is 86400 seconden. Zonder deze parameter of de overeenkomstige kopbal, wordt een vers geheime voorgeheugen gebruikt om verzoeken voor 24 uren te dienen, waarbij het geheime voorgeheugen moet worden opnieuw geproduceerd. Gebruikenmax-age=0zal dwingen het geheime voorgeheugen wordt ontruimd en een regeneratie van het rapport in werking stellen, gebruikend het vorige niet-nul freshness leven voor het pas geproduceerde geheime voorgeheugen.respond-async(Booleaans, optioneel): geeft aan dat de reactie asynchroon moet worden opgegeven. Gebruikenrespond-async=truewanneer de cache leeg is, retourneert de server een reactie van202 Acceptedzonder te wachten op het geheime voorgeheugen om worden verfrist en op het rapport wordt geproduceerd. Als de cache vernieuwd is, heeft deze parameter geen effect. De standaardwaarde isfalse. Zonder deze parameter of de overeenkomstige kopbal zal de server synchroon antwoorden, die een significante hoeveelheid tijd kan vereisen en een aanpassing van de maximumreactietijd voor de cliënt van HTTP vereisen.may-refresh-cache(Booleaans, optioneel): Geeft aan dat de server de cache kan vernieuwen als reactie op een aanvraag als de huidige cache leeg, verouderd of binnenkort leeg is. Indienmay-refresh-cache=trueof als deze niet is opgegeven, kan de server een achtergrondtaak starten die de Patroondetector oproept en de cache vernieuwt. Indienmay-refresh-cache=falsedan zal de server geen verfrissingstaak in werking stellen die anders zou gedaan zijn als het geheime voorgeheugen leeg of verouderd is, in welk geval het rapport leeg is. Deze parameter heeft geen invloed op vernieuwingstaken die al in uitvoering zijn.return-minimal(Booleaans, optioneel): geeft aan dat de reactie van de server alleen de status moet bevatten die de voortgangsindicatie en cachestatus in de JSON-indeling bevat. Indienreturn-minimal=truedan is de responsinstantie beperkt tot het statusobject. Indienreturn-minimal=false, of als het niet wordt gespecificeerd, dan wordt een volledige reactie verstrekt.log-findings(Booleaans, optioneel): geeft aan dat de server de inhoud van de cache moet vastleggen wanneer deze voor het eerst wordt gemaakt of vernieuwd. Elke bevinding via de cache wordt geregistreerd als een JSON-tekenreeks. Dit registreren zal slechts voorkomen alslog-findings=trueen de aanvraag genereert een nieuwe cache.
Wanneer zowel de HTTP-header en de overeenkomstige queryparameter aanwezig zijn, heeft de queryparameter prioriteit.
De volgende opdracht vormt een eenvoudige manier om de productie van het rapport via de HTTP-interface te starten:curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.json?max-age=0&respond-async=true'.
Zodra een aanvraag is ingediend, hoeft de client niet actief te zijn voor het produceren van het rapport. De rapportgeneratie zou met één cliënt kunnen in werking worden gesteld gebruikend een verzoek van de GET van HTTP en, zodra het rapport is geproduceerd, bekeken van het geheime voorgeheugen met een andere cliënt of met het hulpmiddel BPA in het AEM gebruikersinterface.
Reacties http-responses
De volgende responswaarden zijn mogelijk:
200 OK: Geeft aan dat de reactie bevindingen van de Patroondetector bevat die zijn gegenereerd binnen de versheidslevensduur van de cache.202 Accepted: Wordt gebruikt om aan te geven dat de cache leeg is. Wanneerrespond-async=trueenmay-refresh-cache=truedeze reactie wijst erop dat een verfrissingstaak lopend is. Wanneermay-refresh-cache=falsedit antwoord wijst eenvoudig erop dat het geheime voorgeheugen stabiel is.400 Bad Request: Geeft aan dat er een fout is opgetreden met de aanvraag. Een bericht in de indeling Probleemdetails (zie RFC 7807) bevat meer details.401 Unauthorized: Geeft aan dat de aanvraag niet is geautoriseerd.500 Internal Server Error: Geeft aan dat er een interne serverfout is opgetreden. Een bericht in de indeling voor probleemdetails biedt meer informatie.503 Service Unavailable: Geeft aan dat de server bezig is met een andere respons en deze aanvraag niet tijdig kan uitvoeren. Dit gebeurt alleen bij synchrone aanvragen. Een bericht in de indeling voor probleemdetails biedt meer informatie.
Beheerdersinformatie
Aanpassing van levensduur cache cache-adjustment
De standaardlevensduur van de BPA-cache is 24 uur. Met de optie om een rapport te verfrissen, en het geheime voorgeheugen, in zowel de AEM instantie als de interface van HTTP te regenereren, zal deze standaardwaarde waarschijnlijk voor de meeste toepassingen van BPA aangewezen zijn. Als de tijd van de rapportgeneratie voor uw AEM instantie bijzonder lang is, kunt u het geheim voorgeheugenleven willen aanpassen om de regeneratie van het rapport te minimaliseren.
De langetermijnwaarde is opgeslagen als de eigenschap maxCacheAge op de volgende repository-node:/apps/best-practices-analyzer/content/BestPracticesReport/jcr:content
De waarde van deze eigenschap is de levensduur van de cache in seconden. Een beheerder kan de levensduur aanpassen met CRX/DE Lite.
Installeren op AEM 6.1 installing-on-aem61
BPA gebruikt een genoemde rekening van de systeemdienstgebruiker repository-reader-service om de Patroondetector uit te voeren. Dit account is beschikbaar op AEM 6.2 en hoger. Op AEM 6.1 moet dit account worden aangemaakt vóór installatie van BPA door de volgende stappen te nemen:
-
Volg de instructies bij het Nieuwe servicegebruiker maken om een gebruiker te maken. Stel de UserID in op
repository-reader-serviceen laat het tussenpad leeg en klik op het groene vinkje. -
Volg de instructies bij Gebruikers en groepen beheren, met name de instructies voor het toevoegen van gebruikers aan een groep om de
repository-reader-service-gebruiker aan de groepadministratorstoe te voegen. -
Installeer het BPA-pakket via Package Manager op de bron-AEM. (Dit zal de noodzakelijke configuratiewijziging toevoegen aan de ServiceUserMapper-configuratie voor de gebruiker van de
repository-reader-service-systeemservicegebruiker.)