Painel de operações operations-dashboard

Desempenho da consulta

Este exame de saúde foi simplificado no AEM 6.4 e agora verifica a função recém-refatorada Oak QueryStats MBean, mais especificamente o SlowQueries atributo. Se as estatísticas contiverem queries lentos, a verificação de integridade retornará um aviso. Caso contrário, retorna o status OK.

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

Comprimento da fila de observação

A Duração da Fila de Observação é repetida em todos os Ouvintes de Eventos e Observadores de Plano de Fundo, e compara seus queueSize para maxQueueSize e:

• retorna o status Crítico se a variável queueSize excede o valor maxQueueSize valor (é quando os eventos são soltos)
• retorna Avisar se a variável queueSize é maior que maxQueueSize * WARN_THRESHOLD (o valor padrão é 0,75)

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

Limites de cruzamento da consulta

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

• retorna o status Warn se um dos limites for igual ou superior a Integer.MAX_VALUE
• retorna o status Warn se um dos limites for menor que 10000 (a configuração recomendada do Oak)
• retorna o status Crítico se a variável QueryEngineSettings ou qualquer um dos limites não pode ser recuperado

O Mbean para este exame de saúde é org.apache.sling.health check:name=queryTraversalLimitsBundle,type=HealthCheck.

Relógios sincronizados

Esta verificação é relevante apenas para clusters de nodestore de documentos. Ele retorna o seguinte status:

• retorna o status Warn quando os relógios da instância ficam fora de sincronia e passam por um limite baixo predefinido
• retorna o status Crítico quando os relógios de instância ficam fora de sincronia e ultrapassam um limite alto predefinido

O Mbean para este exame de saúde é org.apache.sling.health check:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Índices assíncronos

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

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

• verifica a lastIndexedTime para todas as vias de indexação e:

  • retorna o status Crítico se tiver mais de 2 horas atrás
  • retorna o status Warning se estiver entre 2 horas e 45 minutos atrás
  • retorna o status OK se for inferior a 45 minutos atrás

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

Os limites de status Crítico e Aviso podem ser configurados. O Mbean para este exame de saúde é org.apache.sling.health check:name=asyncIndexHealthCheck,type=HealthCheck.

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

Índices Lucene grandes

Essa verificação usa os dados expostos pela variável Lucene Index Statistics MBean 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 são configuráveis e o MBean para a verificação de integridade é org.apache.sling.health check:name=largeIndexHealthCheck,type=HealthCheck.

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

Manutenção do sistema

System Maintenance (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 de um exame de saúde associado
• se uma tarefa não for adicionada a uma janela de manutenção, sua verificação de integridade retornará Crítico
• é necessário configurar as tarefas de manutenção Log de auditoria e Expurgação do fluxo de trabalho ou removê-las das janelas de manutenção. Se deixadas não configuradas, essas tarefas falharão na primeira execução tentada, de modo que a verificação de Manutenção do Sistema retornará o status Crítico.
• Com AEM 6.4, também há uma verificação para o Manutenção de binários Lucene tarefa
• em AEM 6.2 e inferior, a verificação de manutenção do sistema retorna um status Warning logo após a inicialização, pois as tarefas nunca são executadas. A partir da versão 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=systemcontrols,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 tentou novamente a replicação. Se o agente tiver tentado novamente a replicação mais do que o valor da numberOfRetriesAllowed , retorna um aviso. O numberOfRetriesAllowed é configurável.

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

Sling Jobs

O Sling Jobs verifica o número de tarefas enfileiradas no JobManager, o compara ao maxNumQueueJobs limite e:

• retorna Crítico se for maior que a variável maxNumQueueJobs estão na fila
• retorna Crítico se houver trabalhos ativos de longa duração com mais de 1 hora
• retorna Crítico se houver trabalhos em fila e o último horário de trabalho concluído for superior a 1 hora

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

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

Desempenho da solicitação

Essa verificação analisa o granite.request.metrics.timer Métrica Slinge:

• retorna Crítico se o valor do percentil 75 estiver acima do limite crítico (o valor padrão é 500 milissegundos)
• retorna Warn 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 Warn se houver erros no log.

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

Espaço em disco

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

• retorna Warn se a proporção de espaço em disco utilizável para o tamanho do repositório for menor que o limite de aviso (o valor padrão é 10)
• retorna Crítico se a proporção de espaço em disco utilizável para o tamanho do repositório for menor que o limite crítico (o valor padrão é 2)

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

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

Verificação de integridade do assistente de agendamento

Essa verificação retornará 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.health check: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. Estes controlos de saúde individuais abordam preocupações diferentes da lista de controlo de segurança disponível no Página de documentação da Lista de verificação de segurança. A verificação é útil como um teste de segurança de fumaça quando a instância é iniciada.

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

Grupos ativos

Os Pacotes Ativos verificam o estado de todos os pacotes e:

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

O parâmetro ignore list pode ser configurado.

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

Verificação do Cache de Código

Esta é uma Verificação de integridade que verifica várias condições da JVM que podem acionar um bug do CodeCache presente no Java 7:

• retorna Avisar se a instância estiver sendo executada no Java 7, com a limpeza do Cache de Código ativada
• retorna Avisar se a instância estiver sendo executada 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 minimum.code.cache.size limite é configurável. Para obter mais informações sobre o erro, check esta página.

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

Recurso Buscar erros de caminho

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

• retorna Avisar se houver nós secundários em /apps/foundation/components/primary

O MBean para esta verificação de integridade é org.apache.sling.health check: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 foi 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, uma Verificação de integridade relatará isso como um erro. O padrão é false.

verdadeiro

Opcional

granite.maintenance.name

Um nome exclusivo para a tarefa - é usado para fazer referência à tarefa. Geralmente é um nome simples.

MyMaintenanceTask

Obrigatório

granite.maintenance.title

Um título exibido para esta tarefa

Minha Tarefa de Manutenção Especial

Obrigatório

job.topics

Este é um tópico exclusivo da tarefa de manutenção.
A manipulação do trabalho do Apache Sling iniciará um trabalho com exatamente este tópico para executar a tarefa de manutenção e, à medida que a tarefa for registrada para este tópico, ele será executado.
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 que estão em estado Crítico
• uma lista de verificações que estão no status Warn

Indicado visualmente:

• uma marca vermelha para verificações Críticas
• uma tag laranja para as 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 em execução 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 executar tarefas (pois elas podem afetar o desempenho)
• tags cinza para todos os outros status

• Página Tarefas de manutenção

Sistema

• sistema operacional e versão do sistema operacional (por exemplo, Mac OS X)
• média de carga do sistema, conforme recuperado de OperatingSystemMXBeable
• espaço em disco (na partição onde o diretório inicial está localizado)
• heap máximo, como 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 Oak

• tipo de armazenamento de nó (Segment Tar ou Document)

  • 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 S3 é exibido
  • para um armazenamento de dados S3 compartilhado, o nome do bucket S3 é exibido
  • para um Data Store do Azure, 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 mal configurados ("Erro de configuração")
• uma lista de agentes com processamento de fila pausado
• uma lista de agentes ociosos
• uma lista de agentes em execução (que estão processando entradas no momento)

Indicado visualmente:

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

Página 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 processando entradas no momento)

Indicado visualmente:

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

Página Replicação

Fluxos de trabalhos

• Trabalhos do fluxo de trabalho:

  • número de tarefas de fluxo de trabalho com falha (se houver)
  • número de trabalhos de fluxo de trabalho cancelados (se houver)

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

  • em execução
  • Falha
  • suspenso
  • abortado

Para cada um dos status apresentados acima, é realizada uma query 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 tarefas Sling - número de tarefas em um determinado status (se houver):

• Falha
• em fila
• cancelado
• ativo

Não interpretado:

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

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 a partir do nodeCounterMBean, enquanto o resto das estatísticas são obtidas a partir de IndexInfoService.

N/A

N/A

Backup

Exibe "Backup online em andamento", se for o caso.

N/A

N/A

Indexação

Exibições:

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

Se um encadeamento de indexação ou consulta estiver presente no despejo de encadeamento.

N/A

N/A