Instrumentpanel för åtgärder operations-dashboard

Frågeprestanda

Den här hälsokontrollen har förenklats i AEM 6.4 och nu kontrollerar den nyligen omarbetade Oak QueryStats MBean, mer specifikt SlowQueries -attribut. Om statistiken innehåller långsamma frågor returnerar hälsokontrollen en varning. Annars returneras OK-statusen.

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 och jämför deras queueSize till maxQueueSize och:

• returnerar Kritisk status om queueSize värdet överskrider maxQueueSize värde (d.v.s. när händelser tas bort)
• returnerar Varna om queueSize värdet ä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 frågesport kontrollerar QueryEngineSettings MBean, mer specifikt 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 Warn-status 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

The Mbean for this health check is org.apache.sling.healthCheck:name=queryTraversalLimitsBundle,type=HealthCheck.

Synkroniserade klockor

Den här kontrollen gäller endast för dokumentnodestore-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

The Mbean for this health check is org.apache.sling.healthCheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Asynkrona index

Kontrollen Asynkrona index:

• returnerar Kritisk status om minst ett indexeringsfält misslyckas

• kontrollerar lastIndexedTime för alla indexeringsbanor och

  • returnerar Kritisk status om det är mer än 2 timmar sedan
  • returnerar varningsstatus om det är mellan 2 timmar och 45 minuter sedan
  • returnerar OK-status om det ä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. The Mbean for this health check is org.apache.sling.healthCheck:name=asyncIndexHealthCheck,type=HealthCheck.

Obs! Den här hälsokontrollen är tillgänglig i AEM 6.4 och har flyttats tillbaka 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 returnera:

• 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.healthCheck: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 den kritiska hälsokontrollen
• du måste konfigurera underhållsaktiviteterna Granskningslogg och Arbetsflödestömning eller på annat sätt ta bort dem från underhållsfönstren. Om de inte konfigureras kommer dessa uppgifter att misslyckas vid den första körningen, så systemunderhållskontrollen returnerar statusen Kritisk.
• Med AEM 6.4, finns det också en kontroll för Lucene Binaries-underhåll uppgift
• 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ållet inte har nåtts än.

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 gjorde ett nytt försök att replikera mer än värdet för numberOfRetriesAllowed returnerar den en varning. The numberOfRetriesAllowed parametern 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 maxNumQueueJobs och

• returnerar Critical om mer än maxNumQueueJobs finns i kön
• returnerar Kritisk om det finns aktiva jobb som körs länge och är äldre än 1 timme
• returnerar Kritisk om det finns jobb i kö och den senaste slutförda 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åttoch:

• returnerar Kritisk om det 75:e percentilvärdet överstiger det kritiska tröskelvärdet (standardvärdet är 500 millisekunder)
• returnerar Varna om det 75:e percentilvärdet överstiger varningströskeln (standardvärdet är 200 millisekunder)

MBean för den här hälsokontrollen är org.apache.sling.healthCheck: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 finns på FileStoreStats MBean, hämtar storleken på nodarkivet och hur mycket diskutrymme som kan användas på partitionen Node Store, och:

• returnerar Varna om det tillgängliga diskutrymmet till databasstorleken är mindre än varningströskeln (standardvärdet är 10)
• returnerar Kritisk om det användbara 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 kan konfigureras.

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 individuella hälsokontroller tar upp andra problem än checklistan för säkerhet som finns på Dokumentationssida för checklista för säkerhet. 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=securityCheck,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.hälsokontroll:name=inactiveBundles,type=HealthCheck.

Kontroll av kodcache

Det här är en hälsokontroll som verifierar flera JVM-villkor som kan utlösa ett CodeCache-fel i Java 7:

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

The minimum.code.cache.size Tröskelvärdet kan konfigureras. Mer information om felet finns i check den här sidan.

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 Varna 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 uppgift deklarerar att den kan avbrytas måste den under körningen kontrollera om den har stoppats och sedan vidta åtgärder i enlighet med detta. 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 visas en hälsokontroll som ett fel. Standardvärdet är false.

true

Valfritt

granite.maintenance.name

Ett unikt namn för aktiviteten - det används för att referera till uppgiften. Det här är vanligtvis 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

Detta är ett unikt ämne i underhållsaktiviteten.
Jobbhanteringen i Apache Sling startar ett jobb med exakt det här avsnittet för att utfö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ållsåtgärder

• 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 Mac OS X)
• systemets genomsnittliga belastning, som hämtats från OperatingSystemMXBeusable
• diskutrymme (på partitionen där arbetskatalogen finns)
• maximal heap, som returneras 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-versionen

• 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

Uppskattat 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 "Onlinesäkerhetskopiering pågår" om så är fallet.

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