Dashboard operazioni operations-dashboard

Prestazioni delle query

Il controllo di integrità è stato semplificato in AEM 6.4 e ora controlla Oak QueryStats MBean di cui è stato eseguito il refactoring di recente, in particolare l'attributo SlowQueries . Se le statistiche contengono query lente, la verifica stato restituisce un avviso. In caso contrario, verrà restituito lo stato OK.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck.

Lunghezza coda di osservazione

La lunghezza della coda di osservazione scorre tutti i listener di eventi e gli osservatori in background, confronta i queueSize con i maxQueueSize e:

• restituisce lo stato Critico se il valore queueSize supera il valore maxQueueSize (ovvero quando gli eventi verrebbero eliminati)
• restituisce un avviso se il valore queueSize è maggiore di maxQueueSize * WARN_THRESHOLD (il valore predefinito è 0,75)

La lunghezza massima di ciascuna coda proviene da configurazioni separate (Oak e AEM) e non è configurabile da questa verifica di integrità. MBean per questa verifica stato è org.apache.sling.healthcheck:name=ObservationQueueLengthHealthCheck,type=HealthCheck.

Limiti di attraversamento per query

Query Traversal Limits controlla QueryEngineSettings MBean, in particolare gli attributi LimitInMemory e LimitReads, e restituisce il seguente stato:

• restituisce lo stato Warn se uno dei limiti è uguale o superiore al valore Integer.MAX_VALUE
• restituisce lo stato Warn se uno dei limiti è inferiore a 10000 (impostazione consigliata da Oak)
• restituisce lo stato Critico se non è possibile recuperare QueryEngineSettings o uno qualsiasi dei limiti

Il valore Mbean per questa verifica stato è org.apache.sling.healthcheck:name=queryTraversalLimitsBundle,type=HealthCheck.

Orologi sincronizzati

Questa verifica è valida solo per cluster di tipo nodo documento. Restituisce il seguente stato:

• restituisce lo stato Warn quando gli orologi dell’istanza escono dalla sincronizzazione e superano una soglia bassa predefinita
• restituisce lo stato Critico quando gli orologi dell’istanza escono dalla sincronizzazione e superano una soglia elevata predefinita

L'Mbean per questa verifica stato è org.apache.sling.healthcheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Indici asincroni

La verifica degli indici asincroni:

• restituisce uno stato Critico se almeno una corsia di indicizzazione non riesce

• controlla lastIndexedTime per tutte le corsie di indicizzazione e:

  • restituisce uno stato Critico se è più di 2 ore fa
  • restituisce uno stato di avvertenza se è compreso tra 2 ore e 45 minuti fa
  • restituisce lo stato OK se è meno di 45 minuti fa

• se nessuna di queste condizioni è soddisfatta, viene restituito lo stato OK

È possibile configurare sia le soglie di stato Critico che quelle di Avviso. L'Mbean per questa verifica stato è org.apache.sling.healthcheck:name=asyncIndexHealthCheck,type=HealthCheck.

Nota: Questo controllo di integrità è disponibile con AEM 6.4 ed è stato supportato nell'AEM 6.3.0.1.

Indici Lucene di grandi dimensioni

Questo controllo utilizza i dati esposti da Lucene Index Statistics MBean per identificare indici di grandi dimensioni e restituisce:

• uno stato di avvertenza se è presente un indice con più di 1 miliardo di documenti
• uno stato Critico se è presente un indice con più di 1,5 miliardi di documenti

Le soglie sono configurabili e l'elemento MBean per il controllo dello stato è org.apache.sling.healthcheck:name=largeIndexHealthCheck,type=HealthCheck.

Nota: Questo controllo è disponibile con AEM 6.4 ed è stato eseguito il backport in AEM 6.3.2.0.

Manutenzione sistema

Manutenzione sistema è un controllo composito che restituisce l'OK se tutte le attività di manutenzione sono in esecuzione come configurato. Tieni presente che:

• ogni attività di manutenzione è accompagnata da un controllo di integrità associato
• se un'attività non viene aggiunta a una finestra di manutenzione, la verifica dello stato restituisce un valore Critico
• configurare le attività di manutenzione Registro di controllo e Rimozione flusso di lavoro o rimuoverle in altro modo dalle finestre di manutenzione. Se non viene configurata, queste attività non riusciranno al primo tentativo di esecuzione, pertanto la verifica di manutenzione del sistema restituirà lo stato Critico.
• Con AEM 6.4, è stata eseguita anche una verifica per l'attività Manutenzione binary di Lucene
• in AEM 6.2 e versioni precedenti, il controllo di manutenzione del sistema restituisce lo stato di avviso subito dopo l'avvio perché le attività non vengono mai eseguite. A partire dalla versione 6.3, se la prima finestra di manutenzione non è stata ancora raggiunta viene visualizzato OK.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=systemchecs,type=HealthCheck.

Coda di replica

Questo controllo scorre gli agenti di replica e ne esamina le code. Per l'elemento nella parte superiore della coda, il controllo verifica il numero di tentativi di replica eseguiti dall'agente. Se l'agente ha ritentato la replica con un valore superiore a quello del parametro numberOfRetriesAllowed, verrà restituito un avviso. Il parametro numberOfRetriesAllowed è configurabile.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck.

Processi Sling

Sling Jobs controlla il numero di job in coda in JobManager, confrontandolo con Soglia maxNumQueueJobs e:

• restituisce un valore Critico se nella coda sono presenti più di maxNumQueueJobs
• restituisce un valore Critico se sono presenti processi attivi con tempi di esecuzione lunghi più vecchi di 1 ora
• restituisce un valore Critico se sono presenti processi in coda e l'ultima ora del processo finito è precedente a 1 ora

È possibile configurare solo il parametro relativo al numero massimo di processi in coda e il valore predefinito è 1000.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=slingJobs,type=HealthCheck.

Prestazioni delle richieste

Questo controllo esamina la metrica granite.request.metrics.timer Slinge:

• restituisce un valore Critico se il valore del 75° percentile supera la soglia critica (il valore predefinito è 500 millisecondi)
• restituisce un valore Warn se il valore del 75° percentile supera la soglia di avvertenza (il valore predefinito è 200 millisecondi)

MBean per questa verifica stato è org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck.

Errori registro

Questo controllo restituisce lo stato Warn in caso di errori nel registro.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck.

Spazio su disco

Il controllo dello spazio su disco esamina FileStoreStats MBean, recupera le dimensioni dell'archivio nodi e la quantità di spazio su disco utilizzabile nella partizione dell'archivio nodi e:

• restituisce un avviso se il rapporto tra lo spazio su disco utilizzabile e le dimensioni dell’archivio è inferiore alla soglia di avviso (il valore predefinito è 10)
• restituisce un valore Critico se il rapporto tra lo spazio su disco utilizzabile e le dimensioni dell’archivio è inferiore alla soglia critica (il valore predefinito è 2)

Entrambe le soglie sono configurabili. Il controllo funziona solo sulle istanze con un archivio segmenti.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=DiskSpaceHealthCheck,type=HealthCheck.

Verifica stato modulo di pianificazione

Questo controllo restituisce un avviso se l’istanza ha processi Quartz in esecuzione per più di 60 secondi. È possibile configurare la soglia di durata accettabile.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck.

Verifiche di sicurezza

Il controllo di sicurezza è un elemento composito che aggrega i risultati di più controlli relativi alla sicurezza. Questi singoli controlli di integrità rispondono a problemi diversi dall'elenco di controllo della sicurezza disponibile nella pagina della documentazione dell'elenco di controllo della sicurezza . Il controllo è utile come test di fumo di sicurezza all'avvio dell'istanza.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=securitychecs,type=HealthCheck

Bundle attivi

Bundle attivi controlla lo stato di tutti i bundle e:

• restituisce lo stato Warn se uno dei bundle non è attivo o (a partire da, con attivazione lenta)
• ignora lo stato dei bundle nell’elenco da ignorare

Il parametro dell’elenco da ignorare è configurabile.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck.

Controllo cache codice

Verifica stato che verifichi diverse condizioni JVM che possono attivare un bug CodeCache presente in Java™ 7:

• restituisce un avviso se l’istanza è in esecuzione su Java™ 7, con lo svuotamento della cache del codice abilitato
• restituisce un avviso se l’istanza è in esecuzione su Java™ 7 e la dimensione della cache codice riservato è inferiore a una soglia minima (il valore predefinito è 90 MB)

La soglia minimum.code.cache.size è configurabile. Per ulteriori informazioni sul bug, vedere e quindi eseguire una ricerca nell'ID bug 8012547.

MBean per questa verifica stato è org.apache.sling.healthcheck:name=codeCacheHealthCheck,type=HealthCheck.

Errori nel percorso di ricerca delle risorse

Verifica se sono presenti risorse nel percorso /apps/foundation/components/primary e:

• restituisce un avviso se sono presenti nodi figlio in /apps/foundation/components/primary

MBean per questa verifica stato è org.apache.sling.healthcheck:name=resourceSearchPathErrorHealthCheck,type=HealthCheck.

granite.maintenance.isStoppable

Attributo booleano che definisce se l’attività può essere interrotta dall’utente. Se un'attività dichiara di essere arrestabile, durante l'esecuzione deve verificare se è stata arrestata e quindi agire di conseguenza. Il valore predefinito è false.

vero

Facoltativo

granite.maintenance.mandatory

Attributo booleano che definisce se un’attività è obbligatoria e deve essere eseguita periodicamente. Se un'attività è obbligatoria ma al momento non è presente in alcuna finestra di programmazione attiva, un controllo di integrità segnala questo errore. Il valore predefinito è false.

vero

Facoltativo

granite.maintenance.name

Nome univoco per l'attività: il nome viene utilizzato per fare riferimento all'attività ed è solo un nome semplice.

MyMaintenanceTask

Obbligatorio

granite.maintenance.title

Titolo visualizzato per l'attività

La mia attività di manutenzione speciale

Obbligatorio

job.topics

Argomento univoco dell’attività di manutenzione.
La gestione del processo Apache Sling avvia un processo con esattamente questo argomento per eseguire l'attività di manutenzione e quando l'attività viene registrata per questo argomento viene eseguita.
L'argomento deve iniziare con com/adobe/granite/maintenance/job/

com/adobe/granite/maintenance/job/MyMaintenanceTask

Obbligatorio

/*

* #%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,>

Verifiche stato

• un elenco di controlli che si trovano nello stato Critico
• un elenco di assegni in stato Avvertenza

Indicato visivamente:

• un tag rosso per i controlli critici
• un tag arancione per i controlli di avviso

• Pagina Rapporti stato

Attività di manutenzione

• elenco delle attività non riuscite
• un elenco delle attività attualmente in esecuzione
• elenco delle attività completate nell'ultima esecuzione
• un elenco di attività che non sono mai state eseguite
• un elenco di attività non pianificate

A vista:

• un tag rosso per le attività non riuscite
• un tag arancione per l’esecuzione delle attività (in quanto potrebbero influire sulle prestazioni)
• tag grigi per ogni altro stato

• Pagina Attività di manutenzione

Sistema

• versione del sistema operativo e del sistema operativo (ad esempio, macOS X)
• media del carico di sistema, recuperata da OperatingSystemMXBeanusable
• spazio su disco (nella partizione in cui si trova la home directory)
• heap massimo restituito da MemoryMXBean

N/D

N/D

Istanza

• versione AEM
• elenco delle modalità di esecuzione
• la data in cui è stata avviata l’istanza

N/D

N/D

Archivio

• la versione Oak

• tipo di archivio nodi (Segment Tar o Document)

  • se il tipo è documento, viene visualizzato il tipo di archivio documenti (RDB o Mongo)

• se è presente un archivio dati personalizzato:

  • per un archivio dati file, viene visualizzato il percorso
  • per un archivio dati S3, viene visualizzato il nome del bucket S3
  • per un archivio dati S3 condiviso, viene visualizzato il nome del bucket S3
  • per un Azure Data Store, viene visualizzato il contenitore

• se non è presente un archivio dati esterno personalizzato, viene visualizzato un messaggio che indica tale fatto

N/D

N/D

Agenti di distribuzione

• elenco di agenti con code bloccate
• un elenco di agenti non configurati correttamente ("Errore di configurazione")
• elenco di agenti con elaborazione coda in pausa
• un elenco di agenti inattivi
• un elenco di agenti in esecuzione (che stanno attualmente elaborando le voci)

A vista:

• un tag rosso per gli agenti bloccati o per gli errori di configurazione
• un tag arancione per gli agenti in pausa
• un tag grigio per gli agenti in pausa, inattivi o in esecuzione

Pagina di distribuzione

Agenti di replica

• elenco di agenti con code bloccate
• un elenco di agenti inattivi
• un elenco di agenti in esecuzione (che stanno attualmente elaborando le voci)

Indicato visivamente:

• un tag rosso per gli agenti bloccati
• un tag grigio per gli agenti in pausa

Pagina di replica

Flussi di lavoro

• Processi flusso di lavoro:

  • numero di processi del flusso di lavoro non riusciti (se presenti)
  • numero di processi del flusso di lavoro annullati (se presenti)

• Conteggi flussi di lavoro: numero di flussi di lavoro in un determinato stato (se presenti):

  • in esecuzione
  • non riuscito
  • sospeso
  • interrotto

Per ciascuno degli stati presentati sopra viene eseguita una query, con un limite di 400 millisecondi. A 400 millisecondi, viene visualizzato il numero di voci ottenute fino a quel punto.

Non interpretato:

• l’utente deve analizzare quando esistono flussi di lavoro e processi con stati imprevisti.

Pagina Errori di flusso di lavoro

Processi Sling

Conteggi processi Sling - numero di processi in un determinato stato (se presenti):

• non riuscito
• in coda
• annullato
• attivi

Non interpretato:

• l’utente deve analizzare quando ci sono processi con stati imprevisti o conteggi elevati.

N/D

Conteggi nodi stimati

Numero stimato di:

• pagine
• risorse
• tag
• autorizzabili
• numero totale di nodi

Il numero totale di nodi viene ottenuto da nodeCounterMBean, mentre le altre statistiche vengono ottenute da IndexInfoService.

N/D

N/D

Backup

In tal caso, viene visualizzato "Backup online in corso".

N/D

N/D

Indicizzazione

Visualizza:

• "Indicizzazione in corso"
• "Query in corso"

Se nel dump del thread è presente un thread di indicizzazione o di query.

N/D

N/D