Painel de operações operations-dashboard

Desempenho da consulta

Esta verificação de integridade foi simplificada no AEM 6.4 e agora verifica o Oak QueryStats MBean refatorado recentemente, mais especificamente o atributo SlowQueries . Se as estatísticas contiverem consultas lentas, a verificação de integridade retornará um aviso. Caso contrário, retornará o status OK.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck.

Comprimento da fila de observação

O Comprimento da fila de observação repete todos os Ouvintes de eventos e Observadores de segundo plano; compara seus queueSize a seus maxQueueSize e:

• retorna o status Crítico se o valor queueSize exceder o valor maxQueueSize (isto é, quando os eventos serão descartados)
• retorna um Aviso se o valor de queueSize estiver acima de maxQueueSize * WARN_THRESHOLD (o valor padrão é 0,75)

O comprimento máximo de cada fila vem de configurações separadas (Oak e AEM) e não é configurável nesta verificação de integridade. O MBean para esta verificação de integridade é org.apache.sling.healthy:name=ObservationQueueLengthHealthCheck,type=HealthCheck.

Limites de cruzamento da consulta

Limites de cruzamento de consulta verifica o MBean QueryEngineSettings, mais especificamente os atributos LimitInMemory e LimitReads, e retorna o seguinte status:

• retorna o status de Aviso se um dos limites for igual ou superior a Integer.MAX_VALUE
• retorna o status Aviso se um dos limites for inferior a 10000 (a configuração recomendada do Oak)
• retorna o status Crítico se o QueryEngineSettings ou qualquer um dos limites não puder ser recuperado

O Mbean para esta verificação de integridade é org.apache.sling.healthcheck:name=queryTraversalLimitsBundle,type=HealthCheck.

Relógios sincronizados

Esta verificação é relevante somente para clusters de armazenamento de nós de documentos. Ele retorna o seguinte status:

• retorna o status Aviso quando os relógios da instância saem de sincronia e ultrapassam um limite baixo predefinido
• retorna o status Crítico quando os relógios da instância saem de sincronia e ultrapassam um limite alto predefinido

O Mbean para esta verificação de integridade é org.apache.sling.healthcheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Índices assíncronos

A verificação de Índices assíncronos:

• retorna um status Crítico se pelo menos uma via de indexação estiver falhando

• verifica se há lastIndexedTime para todas as faixas de indexação e:

  • retorna um status Crítico se houver mais de 2 horas atrás
  • retorna um status de Aviso se estiver entre 2 horas e 45 minutos atrás
  • retorna um status OK se houver menos de 45 minutos atrás

• se nenhuma dessas condições for atendida, retornará o status OK

Os limites de status Crítico e Aviso são configuráveis. O Mbean para esta verificação de integridade é org.apache.sling.healthcheck:name=asyncIndexHealthCheck,type=HealthCheck.

Observação: Esta verificação de integridade está disponível com AEM 6.4 e foi revertida para AEM 6.3.0.1.

Índices Lucene grandes

Esta verificação usa os dados expostos pelo MBean Lucene Index Statistics para identificar índices e retornos grandes:

• um Status de aviso se houver um índice com mais de 1 bilhão de documentos
• um Status crítico se houver um índice com mais de 1,5 bilhão de documentos

Os limites podem ser configurados e o MBean para a verificação de integridade é org.apache.sling.healthcheck:name=largeIndexHealthCheck,type=HealthCheck.

Observação: Esta verificação está disponível com AEM 6.4 e foi revertida para AEM 6.3.2.0.

Manutenção do sistema

A Manutenção do Sistema é uma verificação composta que retorna o OK se todas as tarefas de manutenção estiverem sendo executadas como configuradas. Lembre-se:

• cada tarefa de manutenção é acompanhada por uma verificação de integridade associada
• se uma tarefa não for adicionada a uma janela de manutenção, sua verificação de integridade retornará Critical
• configure as tarefas de manutenção Audit Log e Workflow Purge ou remova-as das janelas de manutenção. Se não configuradas, essas tarefas falharão na primeira tentativa de execução, portanto, a verificação de Manutenção do sistema retornará o status Crítico.
• Com o AEM 6.4, também há uma verificação para a tarefa Manutenção de Binários Lucene
• no AEM 6.2 e inferior, a verificação de manutenção do sistema retorna um status de Aviso logo após a inicialização porque as tarefas nunca são executadas. A partir do 6.3, eles retornarão OK se a primeira janela de manutenção ainda não tiver sido atingida.

O MBean para esta verificação de integridade é org.apache.sling.health check:name=systemchecked,type=HealthCheck.

Fila de replicação

Essa verificação repete os agentes de replicação e observa suas filas. Para o item na parte superior da fila, a verificação verifica quantas vezes o agente repetiu a replicação. Se o agente repetiu a replicação além do valor do parâmetro numberOfRetriesAllowed, ele retorna um aviso. O parâmetro numberOfRetriesAllowed pode ser configurado.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck.

Sling Jobs

O Sling Jobs verifica o número de trabalhos em fila no JobManager, compara-o com o Limite de maxNumQueueJobs e:

• retorna uma Critical se mais de maxNumQueueJobs estiverem na fila
• retorna Crítico se houver jobs ativos de longa duração com mais de 1 hora
• retorna Crítico se houver jobs enfileirados e a última hora do job concluído tiver mais de 1 hora

Somente o parâmetro de número máximo de tarefas em fila é configurável e tem o valor padrão de 1000.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=slingJobs,type=HealthCheck.

Desempenho da solicitação

Esta verificação analisa a granite.request.metrics.timer métrica de slinge:

• retorna Crítico se o valor do percentil 75 estiver acima do limite crítico (o valor padrão é 500 milissegundos)
• retorna um Aviso se o valor do percentil 75 estiver acima do limite de aviso (o valor padrão é 200 milissegundos)

O MBean para esta verificação de integridade é org.apache.sling.health check:name=requestsStatus,type=HealthCheck.

Erros de log

Essa verificação retorna o status Aviso se houver erros no log.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck.

Espaço de disco

A verificação de Espaço em Disco examina o FileStoreStats MBean, recupera o tamanho do Armazenamento de Nós e a quantidade de espaço em disco utilizável na partição de Armazenamento de Nós, e:

• retorna um Aviso se a relação entre o espaço de uso em disco e o tamanho do repositório for menor que o limite de aviso (o valor default é 10)
• retorna Crítico se a relação entre o espaço de uso em disco e o tamanho do repositório for menor que o limite crítico (o valor default é 2)

Ambos os limites são configuráveis. A verificação só funciona em instâncias com um Repositório de segmentos.

O MBean para esta verificação de integridade é org.apache.sling.healthy:name=DiskSpaceHealthCheck,type=HealthCheck.

Verificação de integridade do assistente de agendamento

Essa verificação retorna um aviso se a instância tiver trabalhos do Quartz em execução por mais de 60 segundos. O limite de duração aceitável é configurável.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck.

Verificações de segurança

A verificação de segurança é um composto que agrega os resultados de várias verificações relacionadas à segurança. Essas verificações de integridade individuais solucionam problemas diferentes da lista de verificação de segurança disponível na página Lista de verificação de segurança. A verificação é útil como um teste de fumaça de segurança quando a instância é iniciada.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=securitycheck,type=HealthCheck

Grupos ativos

Grupos ativos verifica o estado de todos os pacotes e:

• retorna o status Aviso se qualquer um dos pacotes não estiver ativo ou (iniciando, com ativação lenta)
• ignora o status dos pacotes na lista de itens a serem ignorados

O parâmetro ignore list pode ser configurado.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=inativeBundles,type=HealthCheck.

Verificação de Code Cache

Uma verificação de integridade que verifica várias condições JVM que podem acionar um bug de CodeCache presente no Java™ 7:

• retorna um Aviso se a instância estiver em execução no Java™ 7, com a limpeza do Code Cache ativada
• retorna um Aviso se a instância estiver em execução no Java™ 7 e o tamanho do Cache de código reservado for menor que um limite mínimo (o valor padrão é 90 MB)

O limite minimum.code.cache.size pode ser configurado. Para obter mais informações sobre o erro, consulte e pesquise a ID de Erro 8012547.

O MBean para esta verificação de integridade é org.apache.sling.healthcheck:name=codeCacheHealthCheck,type=HealthCheck.

Recurso Buscar erros de caminho

Verifica se há recursos no caminho /apps/foundation/components/primary e:

• retorna um Aviso se houver nós filhos em /apps/foundation/components/primary

O MBean para esta verificação de integridade é org.apache.sling.healthy:name=resourceSearchPathErrorHealthCheck,type=HealthCheck.

granite.maintenance.isStoppable

Atributo booleano que define se a tarefa pode ser interrompida pelo usuário. Se uma tarefa declarar que é parável, ela deverá verificar durante sua execução se está interrompida e agir de acordo. O padrão é false.

verdadeiro

Opcional

granite.maintenance.mandatory

Atributo booleano que define se uma tarefa é obrigatória e deve ser executada periodicamente. Se uma tarefa for obrigatória, mas não estiver em nenhuma janela de programação ativa no momento, uma Verificação de integridade relatará esse erro. O padrão é false.

verdadeiro

Opcional

granite.maintenance.name

Um nome exclusivo para a tarefa; o nome é usado para fazer referência à tarefa e é apenas um nome simples.

MinhaTarefaDeManutenção

Obrigatório

granite.maintenance.title

Um título exibido para esta tarefa

Minha tarefa de manutenção especial

Obrigatório

job.topics

Um tópico exclusivo da tarefa de manutenção.
A manipulação de trabalhos do Apache Sling inicia um trabalho com exatamente este tópico para executar a tarefa de manutenção e, conforme a tarefa é registrada para este tópico, ela é executada.
O tópico deve começar com com/adobe/granite/maintenance/job/

com/adobe/granite/maintenance/job/MyMaintenanceTask

Obrigatório

/*

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

Verificações de integridade

• uma lista de verificações com status Crítico
• uma lista de verificações com status de Aviso

Indicado visualmente:

• uma tag vermelha para verificações críticas
• uma tag laranja para verificações de Aviso

• Página Relatórios de integridade

Tarefas de manutenção

• uma lista de tarefas que falharam
• uma lista de tarefas que estão sendo executadas no momento
• uma lista de tarefas que tiveram êxito na última execução
• uma lista de tarefas que nunca foram executadas
• uma lista de tarefas que não estão agendadas

Indicado visualmente:

• uma tag vermelha para tarefas com falha
• uma tag laranja para tarefas em execução (já que podem afetar o desempenho)
• tags cinza para todos os outros status

• Página Tarefas de manutenção

Sistema

• sistema operacional e versão do SO (por exemplo, macOS X)
• média de carregamento do sistema, conforme recuperado de OperatingSystemMXBeanusable
• espaço em disco (na partição onde o diretório base está localizado)
• heap máximo, conforme retornado por MemoryMXBean

N/A

N/A

Instância

• a versão AEM
• lista de modos de execução
• a data em que a instância foi iniciada

N/A

N/A

Repositório

• a versão do Oak

• tipo de armazenamento de nós (Tar de segmento ou Documento)

  • se o tipo for documento, o tipo de armazenamento de documento será exibido (RDB ou Mongo)

• se houver um armazenamento de dados personalizado:

  • para um Armazenamento de dados de arquivo, o caminho é exibido
  • para um armazenamento de dados S3, o nome do bucket do S3 é exibido
  • para um Armazenamento de dados S3 compartilhado, o nome do bucket do S3 é exibido
  • para um Azure Data Store, o contêiner é exibido

• se não houver um armazenamento de dados externo personalizado, uma mensagem indicando esse fato será exibida

N/A

N/A

Agentes de distribuição

• uma lista de agentes com filas bloqueadas
• uma lista de agentes configurados incorretamente ("Erro de configuração")
• uma lista de agentes com o processamento da fila pausado
• uma lista de agentes ociosos
• uma lista de agentes em execução (que estão atualmente processando entradas)

Indicado visualmente:

• uma tag vermelha para agentes bloqueados ou erros de configuração
• uma tag laranja para agentes pausados
• uma marca cinza para agentes pausados, ociosos ou em execução

Página de distribuição

Agentes de replicação

• uma lista de agentes com filas bloqueadas
• uma lista de agentes ociosos
• uma lista de agentes em execução (que estão atualmente processando entradas)

Indicado visualmente:

• uma tag vermelha para agentes bloqueados
• uma tag cinza para agentes pausados

Página Replicação

Fluxos de trabalhos

• Tarefas do fluxo de trabalho:

  • número de tarefas de workflow com falha (se houver)
  • número de tarefas de workflow canceladas (se houver)

• Contagens de workflow - número de workflows em um determinado status (se houver):

  • em execução
  • com falha
  • suspenso
  • abortado

Para cada um dos status apresentados acima, uma consulta é executada, com um limite de 400 milissegundos. Em 400 milissegundos, o número de entradas obtidas até esse ponto é exibido.

Não interpretado:

• o usuário deve investigar quando há workflows e trabalhos em status inesperados.

Página Falhas do fluxo de trabalho

Sling Jobs

Contagens de trabalhos do Sling - número de trabalhos em um determinado status (se houver):

• com falha
• na fila
• cancelado
• ativo

Não interpretado:

• o usuário deve investigar quando há trabalhos em status inesperados ou com altas contagens.

N/A

Contagens estimadas de nós

Número estimado de:

• páginas
• ativos
• tags
• autorizáveis
• número total de nós

O número total de nós é obtido do nodeCounterMBean, enquanto o restante das estatísticas é obtido do IndexInfoService.

N/A

N/A

Backup

Exibe "Backup on-line em andamento", se houver.

N/A

N/A

Indexação

Exibições:

• "Indexação em andamento"
• "Consulta em andamento"

Se uma thread de indexação ou consulta estiver presente no despejo de thread.

N/A

N/A