Instrumentpanel för åtgärder operations-dashboard

Frågeprestanda

Den här hälsokontrollen förenklades i AEM 6.4 och kontrollerar nu det nyligen omfakterade Oak QueryStats MBean, närmare bestämt SlowQueries -attributet. Om statistiken innehåller långsamma frågor returnerar hälsokontrollen en varning. Annars returneras OK-status.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=queriesStatus,type=HealthCheck.

Längd på observationskö

Längden på observationskön itererar över alla händelseavlyssnare och bakgrundsobservrar, jämför deras queueSize med deras maxQueueSize och:

• returnerar Kritisk status om värdet queueSize överskrider värdet maxQueueSize (det vill säga när händelser skulle tas bort)
• returnerar en varning om värdet queueSize är över maxQueueSize * WARN_THRESHOLD (standardvärdet är 0,75)

Den maximala längden för varje kö kommer från olika konfigurationer (Oak och AEM) och kan inte konfigureras från den här hälsokontrollen. MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=ObservationQueueLengthHealthCheck,type=HealthCheck.

Gränser för genomgång av frågor

Gränser för genomgång av frågor kontrollerar QueryEngineSettings MBean, närmare bestämt attributen LimitInMemory och LimitReads, och returnerar följande status:

• returnerar varningsstatus om en av gränserna är lika med eller högre än Integer.MAX_VALUE
• returnerar varningsstatus om en av gränserna är lägre än 10000 (den rekommenderade inställningen från Oak)
• returnerar statusen Kritisk om QueryEngineSettings eller någon av gränserna inte kan hämtas

Mönstret för den här hälsokontrollen är org.apache.sling.healthCheck:name=queryTraversalLimitsBundle,type=HealthCheck.

Synkroniserade klockor

Den här kontrollen gäller endast för dokumentnodore-kluster. Den returnerar följande status:

• returnerar Warn-status när instansklockorna inte är synkroniserade och går över ett fördefinierat lågt tröskelvärde
• returnerar statusen Kritisk när instansklockorna inte är synkroniserade och går över ett fördefinierat högt tröskelvärde

Mönstret för den här hälsokontrollen är org.apache.sling.healthCheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Asynkrona index

Kontrollen Asynkrona index:

• returnerar en kritisk status om minst ett indexeringsfält misslyckas

• kontrollerar om lastIndexedTime innehåller alla indexeringsbanor och:

  • returnerar en Kritisk status om det är mer än 2 timmar sedan
  • returnerar en varningsstatus om det är mellan 2 timmar och 45 minuter sedan
  • returnerar OK-status om den är mindre än 45 minuter sedan

• om inget av dessa villkor uppfylls returneras OK-statusen

Både statuströskelvärdena Kritisk och Varna är konfigurerbara. Mönstret för den här hälsokontrollen är org.apache.sling.healthCheck:name=asyncIndexHealthCheck,type=HealthCheck.

Obs! Den här hälsokontrollen är tillgänglig i AEM 6.4 och har säkerhetskopierats till AEM 6.3.0.1.

Stora Lucene-index

Den här kontrollen använder data som exponeras av Lucene Index Statistics MBean för att identifiera stora index och returnerar:

• en varningsstatus om det finns ett index med mer än 1 miljard dokument
• en kritisk status om det finns ett index med mer än 1,5 miljarder dokument

Tröskelvärdena kan konfigureras och MBean för hälsokontrollen är org.apache.sling.hälsocheck:name=largeIndexHealthCheck,type=HealthCheck.

Obs! Den här kontrollen är tillgänglig i AEM 6.4 och har flyttats tillbaka till AEM 6.3.2.0.

Systemunderhåll

Systemunderhåll är en sammansatt kontroll som returnerar OK om alla underhållsåtgärder körs som de är konfigurerade. Kom ihåg att:

• varje underhållsåtgärd åtföljs av en tillhörande hälsokontroll
• Om en uppgift inte läggs till i ett underhållsfönster returneras Critical-kontrollen
• konfigurera underhållsuppgifterna för granskningslogg och tömning av arbetsflöde eller på annat sätt ta bort dem från underhållsfönstren. Om dessa uppgifter inte är konfigurerade misslyckas de vid den första körningen, så systemunderhållskontrollen returnerar statusen Kritisk.
• I AEM 6.4 finns det även en kontroll för Lucene Binaries-underhållsuppgiften
• på AEM 6.2 och lägre returnerar systemunderhållskontrollen en varningsstatus direkt efter start eftersom aktiviteterna aldrig körs. Från och med 6.3 returneras OK om det första underhållsfönstret inte har nåtts ännu.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=systemchecks,type=HealthCheck.

Replikeringskö

Den här kontrollen itererar över replikeringsagenter och tittar på deras köer. För objektet högst upp i kön kontrolleras hur många gånger agenten försökte replikera på nytt. Om agenten försökte replikera igen mer än värdet för parametern numberOfRetriesAllowed returneras en varning. Parametern numberOfRetriesAllowed kan konfigureras.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=replicationQueue,type=HealthCheck.

Försäljningsjobb

Sling Jobs kontrollerar antalet jobb som köas i JobManager, jämför det med tröskelvärde för maxNumQueueJobs och:

• returnerar ett kritiskt värde om fler än maxNumQueueJobs finns i kön
• returnerar ett kritiskt värde om det finns tidskrävande aktiva jobb som är äldre än 1 timme
• returnerar ett kritiskt värde om det finns jobb i kö och den senaste jobbtiden är äldre än 1 timme

Endast parametern för maximalt antal jobb i kö kan konfigureras och har standardvärdet 1 000.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=slingJobs,type=HealthCheck.

Begär prestanda

Den här kontrollen tittar på granite.request.metrics.timer Sling-måttetoch:

• returnerar ett kritiskt värde om det 75:e percentilvärdet överstiger det kritiska tröskelvärdet (standardvärdet är 500 millisekunder)
• returnerar ett varningsmeddelande om det 75:e percentilvärdet överstiger varningsvärdet (standardvärdet är 200 millisekunder)

MBean för den här hälsokontrollen är org.apache.sling.hälsothcheck:name=requestsStatus,type=HealthCheck.

Loggfel

Den här kontrollen returnerar varningsstatus om loggen innehåller fel.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=logErrorHealthCheck,type=HealthCheck.

Diskutrymme

Kontrollen av diskutrymme söker på FileStoreStats MBean, hämtar storleken på nodarkivet och mängden användbart diskutrymme på nodlagringspartitionen, och:

• returnerar en varning om det tillgängliga diskutrymmet till databasstorleken är mindre än varningsvärdet (standardvärdet är 10)
• returnerar ett kritiskt värde om det tillgängliga diskutrymmet till databasstorleken är mindre än det kritiska tröskelvärdet (standardvärdet är 2)

Båda tröskelvärdena kan konfigureras. Kontrollen fungerar bara på instanser med ett segmentlager.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=DiskSpaceHealthCheck,type=HealthCheck.

Hälsokontroll för schemaläggare

Den här kontrollen returnerar en varning om instansen har Quartz-jobb som körs i mer än 60 sekunder. Tröskelvärdet för acceptabel varaktighet är konfigurerbart.

Mbean för den här hälsokontrollen är org.apache.sling.healthCheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck.

Säkerhetskontroller

Säkerhetskontrollen är en sammansatt kontroll som sammanställer resultaten av flera säkerhetsrelaterade kontroller. Dessa enskilda hälsokontroller åtgärdar andra problem än säkerhetskontrolllistan som finns på dokumentationssidan för säkerhetschecklistan. Kontrollen är användbar som säkerhetsröktest när instansen startas.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=securityChecks,type=HealthCheck

Aktiva paket

Active Bundles kontrollerar statusen för alla paket och:

• returnerar Warn-status om något av paketen inte är aktivt eller (med start, med lat aktivering)
• ignorerar paketens status i ignoreringslistan

Parametern för ignoreringslistan kan konfigureras.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=inactiveBundles,type=HealthCheck.

Kontroll av kodcache

En hälsokontroll som verifierar flera JVM-förhållanden som kan utlösa ett CodeCache-fel i Java™ 7:

• returnerar en varning om instansen körs på Java™ 7, med tömning av kodcache aktiverat
• returnerar ett varningsmeddelande om instansen körs på Java™ 7 och storleken på den reserverade kodcachen är mindre än ett minimivärde (standardvärdet är 90 MB)

Tröskelvärdet minimum.code.cache.size kan konfigureras. Mer information om felet finns i och sök sedan på fel-ID 8012547.

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=codeCacheHealthCheck,type=HealthCheck.

Sökvägsfel för resurssökning

Kontrollerar om det finns några resurser i sökvägen /apps/foundation/components/primary och:

• returnerar en varning om det finns underordnade noder under /apps/foundation/components/primary

MBean för den här hälsokontrollen är org.apache.sling.healthCheck:name=resourceSearchPathErrorHealthCheck,type=HealthCheck.

granite.maintenance.isStoppable

Booleskt attribut som definierar om aktiviteten kan stoppas av användaren. Om en aktivitet deklarerar att den kan avbrytas måste den under körningen kontrollera om den har stoppats och sedan agera därefter. Standardvärdet är false.

true

Valfritt

granite.maintenance.mandatory

Booleskt attribut som definierar om en uppgift är obligatorisk och måste köras regelbundet. Om en uppgift är obligatorisk men inte finns i något aktivt schemafönster rapporterar en hälsokontroll det här felet. Standardvärdet är false.

true

Valfritt

granite.maintenance.name

Ett unikt namn för aktiviteten - namnet används för att referera till uppgiften och är bara ett enkelt namn.

MyMaintenanceTask

Obligatoriskt

granite.maintenance.title

En titel som visas för den här uppgiften

Min speciella underhållsuppgift

Obligatoriskt

job.topics

Ett unikt ämne i underhållsaktiviteten.
Jobbhanteringen i Apache Sling startar ett jobb med exakt det här avsnittet för att köra underhållsaktiviteten. När aktiviteten registreras för det här avsnittet körs den.
Ämnet måste börja med com/adobe/granite/Maintenance/job/

com/adobe/granite/Maintenance/job/MyMaintenanceTask

Obligatoriskt

/*

* #%L

* sample-maintenance-task

* %%

* Copyright (C) 2014 Adobe

* %%

* Licensed under the Apache License, Version 2.0 (the "License");

* you may not use this file except in compliance with the License.

* You may obtain a copy of the License at

*

* https://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software

* distributed under the License is distributed on an "AS IS" BASIS,

* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

* See the License for the specific language governing permissions and

* limitations under the License.

* #L%

*/

``

package com.adobe.granite.samples.maintenance.impl;

``

import java.io.File;

import java.util.Calendar;

import java.util.Collection;

import java.util.Map;

``

import org.apache.commons.io.FileUtils;

import org.apache.commons.io.filefilter.IOFileFilter;

import org.apache.commons.io.filefilter.TrueFileFilter;

import org.apache.felix.scr.annotations.Activate;

import org.apache.felix.scr.annotations.Component;

import org.apache.felix.scr.annotations.Properties;

import org.apache.felix.scr.annotations.Property;

import org.apache.felix.scr.annotations.Service;

import org.apache.sling.commons.osgi.PropertiesUtil;

import org.apache.sling.event.jobs.Job;

import org.apache.sling.event.jobs.consumer.JobConsumer;

import org.apache.sling.event.jobs.consumer.JobExecutionContext;

import org.apache.sling.event.jobs.consumer.JobExecutionResult;

import org.apache.sling.event.jobs.consumer.JobExecutor;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

``

import com.adobe.granite.maintenance.MaintenanceConstants;

``

@Component(metatype = true,

label = "Delete Temp Files Maintenance Task",

description = "Maintatence Task which deletes files from a configurable temporary directory which have been modified in the last 24 hours.")

@Service

@Properties({

@Property(name = MaintenanceConstants.PROPERTY_TASK_NAME, value = "DeleteTempFilesTask", propertyPrivate = true),

@Property(name = MaintenanceConstants.PROPERTY_TASK_TITLE, value = "Delete Temp Files", propertyPrivate = true),

@Property(name = JobConsumer.PROPERTY_TOPICS, value = MaintenanceConstants.TASK_TOPIC_PREFIX

+ "DeleteTempFilesTask", propertyPrivate = true) })

public class DeleteTempFilesTask implements JobExecutor {

``

private static final Logger log = LoggerFactory.getLogger(DeleteTempFilesTask.class);

``

@Property(label = "Temporary Directory", description="Temporary Directory. Defaults to the java.io.tmpdir system property.")

private static final String PROP_TEMP_DIR = "temp.dir";

``

private File tempDir;

``

@Activate

private void activate(Map<string, object=""> properties) {

this.tempDir = new File(PropertiesUtil.toString(properties.get(PROP_TEMP_DIR),

System.getProperty("java.io.tmpdir")));

}

``

@Override

public JobExecutionResult process(Job job, JobExecutionContext context) {

log.info("Deleting old temp files from {}.", tempDir.getAbsolutePath());

Collection<file> files = FileUtils.listFiles(tempDir, new LastModifiedBeforeYesterdayFilter(),

TrueFileFilter.INSTANCE);

int counter = 0;

for (File file : files) {

log.debug("Deleting file {}.", file.getAbsolutePath());

counter++;

file.delete();

// TODO - capture the output of delete() and do something useful with it

}

return context.result().message(String.format("Deleted %s files.", counter)).succeeded();

}

``

/**

* IOFileFilter which filters out files which have been modified in the last 24 hours.

*

*/

private static class LastModifiedBeforeYesterdayFilter implements IOFileFilter {

``

private final long minTime;

``

private LastModifiedBeforeYesterdayFilter() {

Calendar cal = Calendar.getInstance();

cal.add(Calendar.DATE, -1);

this.minTime = cal.getTimeInMillis();

}

``

@Override

public boolean accept(File dir, String name) {

// this method is never actually called.

return false;

}

``

@Override

public boolean accept(File file) {

return file.lastModified() <= this.minTime;

}

}

``

}

<file></string,>

Hälsokontroller

• en lista över kontroller som har statusen Kritisk
• en lista över kontroller som har statusen Varna

Visuellt:

• en röd tagg för kritiska kontroller
• en orange tagg för Warn-kontroller

• Sidan Hälsorapporter

Underhållsaktiviteter

• en lista över misslyckade uppgifter
• en lista över aktiviteter som körs
• en lista över åtgärder som har slutförts i den senaste körningen
• en lista över uppgifter som aldrig har körts
• en lista över aktiviteter som inte är schemalagda

Visuellt:

• en röd tagg för misslyckade uppgifter
• en orange tagg för att köra uppgifter (eftersom de kan påverka prestandan)
• grå taggar för varannan status

• Underhållsaktiviteter

System

• operativsystem och OS-version (till exempel macOS X)
• systemets genomsnittliga belastning, som hämtats från OperatingSystemMXBeanusable
• diskutrymme (på partitionen där arbetskatalogen finns)
• maximal heap, som returnerats av MemoryMXBean

Ej tillämpligt

Ej tillämpligt

Instans

• AEM
• lista över körningslägen
• det datum då instansen startades

Ej tillämpligt

Ej tillämpligt

Databas

• Oak

• typ av nodarkiv (Segmentmål eller dokument)

  • om typen är dokument, visas typen av dokumentarkiv (RDB eller Mongo)

• om det finns ett anpassat datalager:

  • för ett fildatalager visas sökvägen
  • för ett S3-datalager visas namnet på S3-bucket
  • för ett delat S3-datalager visas namnet på S3-bucket
  • för ett Azure Data Store visas behållaren

• om det inte finns något anpassat externt datalager visas ett meddelande som anger detta

Ej tillämpligt

Ej tillämpligt

Distributionsagenter

• en lista över agenter med blockerade köer
• en lista över felkonfigurerade agenter ("Konfigurationsfel")
• en lista över agenter med köbearbetning pausad
• en lista över inaktiva agenter
• en lista över agenter som körs (som för närvarande bearbetar poster)

Visuellt:

• en röd tagg för blockerade agenter eller konfigurationsfel
• en orange tagg för pausade agenter
• en grå tagg för pausade, inaktiva eller aktiva agenter

Distributionssida

Replikeringsagenter

• en lista över agenter med blockerade köer
• en lista över inaktiva agenter
• en lista över agenter som körs (som för närvarande bearbetar poster)

Visuellt:

• en röd tagg för blockerade agenter
• en grå tagg för pausade agenter

Replikeringssida

Arbetsflöden

• Arbetsflödesjobb:

  • antal misslyckade arbetsflödesjobb (om sådana finns)
  • antal avbrutna arbetsflödesjobb (om sådana finns)

• Antal arbetsflöden - antal arbetsflöden i en viss status (om sådana finns):

  • körs
  • misslyckades
  • pausad
  • avbruten

För vart och ett av de statusvärden som anges ovan utförs en fråga, med en gräns på 400 millisekunder. Vid 400 millisekunder visas antalet poster fram till den punkten.

Ej tolkad:

• användaren bör undersöka när det finns arbetsflöden och jobb i oväntade statusvärden.

Sidan med arbetsflödesfel

Försäljningsjobb

Antal jobb vid körning - antal jobb med en given status (om sådana finns):

• misslyckades
• köad
• avbruten
• aktiv

Ej tolkad:

• användaren bör undersöka när det finns jobb i oväntade statusvärden eller med höga räkningar.

Ej tillämpligt

Beräknat nodantal

Beräknat antal:

• sidor
• resurser
• taggar
• auktoriszables
• totalt antal noder

Det totala antalet noder hämtas från nodeCounterMBean, medan resten av statistiken hämtas från IndexInfoService.

Ej tillämpligt

Ej tillämpligt

Säkerhetskopiering

Visar i så fall "Onlinesäkerhetskopiering pågår".

Ej tillämpligt

Ej tillämpligt

Indexering

Skärmar:

• "Indexering pågår"
• "Fråga pågår"

Om det finns en indexerings- eller frågetråd i tråddumpen.

Ej tillämpligt

Ej tillämpligt