Painel de operações operations-dashboard
Introdução introduction
O Painel de operações no AEM 6 ajuda os operadores do sistema a monitorar rapidamente a integridade do sistema AEM. Ele também fornece informações de diagnóstico geradas automaticamente sobre aspectos relevantes do AEM e permite configurar e executar automação de manutenção independente para reduzir significativamente as operações do projeto e os casos de suporte. O Painel de operações pode ser estendido com verificações de integridade personalizadas e tarefas de manutenção. Além disso, os dados do Painel de operações podem ser acessados a partir de ferramentas de monitoramento externas por meio do JMX.
O Painel de Operações:
- É um status de sistema com um clique para ajudar os departamentos de operações a ganhar eficiência
- Fornece uma visão geral da integridade do sistema em um local único e centralizado
- Reduz o tempo para localizar, analisar e corrigir problemas
- Oferece automação de manutenção autossuficiente que ajuda a reduzir significativamente os custos operacionais do projeto
Ele pode ser acessado indo até Ferramentas - Operações na tela de boas-vindas AEM.
Relatórios de integridade health-reports
O sistema de Relatório de integridade fornece informações sobre a integridade de uma instância do AEM por meio das Verificações de integridade do Sling. Você executa essa operação por meio de solicitações OSGI, JMX, HTTP (por meio de JSON) ou pela interface para toque. Ele oferece medidas e limite de determinados contadores configuráveis e, às vezes, oferece informações sobre como resolver o problema.
Ele tem vários recursos, descritos abaixo.
Verificações de integridade health-checks
A variável Relatórios de integridade são um sistema de cartões que indica bom ou mau funcionamento de uma área específica do produto. Esses cartões são visualizações das Verificações de integridade do Sling, que agregam dados de JMX e outras fontes e expõem as informações processadas novamente como MBeans. Esses MBeans também podem ser inspecionados no Console Web JMX, no âmbito do org.apache.sling.health check domínio.
A interface de Relatórios de integridade pode ser acessada por meio da Ferramentas - Operações - Relatórios de integridade na tela de boas-vindas do AEM ou diretamente pelo seguinte URL:
https://<serveraddress>:port/libs/granite/operations/content/healthreports/healthreportlist.html
O sistema de placa expõe três estados possíveis: OK, AVISO e CRÍTICO. Os estados são resultado de regras e limites, que podem ser configurados ao passar o mouse sobre o cartão e clicar no ícone de engrenagem na barra de ação:
Tipos de verificação de integridade health-check-types
Há dois tipos de verificações de integridade no AEM 6:
- Verificações de integridade individuais
- Verificações de integridade do composto
Um Verificação de integridade individual O é uma única verificação de integridade que corresponde a um cartão de status. As Verificações de integridade individuais podem ser configuradas com regras ou limites, e podem fornecer uma ou mais dicas e links para resolver problemas de integridade identificados. Vamos ver a verificação "Erros de log" como exemplo: se houver entradas ERRO nos logs de instância, localize-as na página de detalhes da verificação de integridade. Na parte superior da página, você pode ver um link para o analisador "Mensagem de log" na seção Ferramentas de diagnóstico, que permite analisar esses erros com mais detalhes e reconfigurar os registradores.
A Verificação de integridade do composto é uma verificação que agrega informações de várias verificações individuais.
As verificações de integridade compostas são configuradas com a ajuda de filtrar tags. Basicamente, todas as verificações únicas que têm a mesma tag de filtro são agrupadas como uma verificação de integridade composta. Uma Verificação de integridade composta terá um status OK somente se todas as verificações únicas agregadas também tiverem status OK.
Como criar verificações de integridade how-to-create-health-checks
No Painel de operações, é possível visualizar o resultado das verificações de integridade individuais e compostas.
Criação de uma verificação de integridade individual creating-an-individual-health-check
A criação de uma verificação de integridade individual envolve duas etapas: implementar uma verificação de integridade do Sling e adicionar uma entrada para a verificação de integridade nos nós de configuração do painel.
-
Para criar uma verificação de integridade do Sling, crie um componente OSGI que implemente a interface Sling HealthCheck. Adicione este componente dentro de um pacote. As propriedades do componente identificam completamente a Verificação de integridade. Após a instalação do componente, um MBean JMX é criado automaticamente para a verificação de integridade. Consulte a Documentação de verificação de integridade do Sling para obter mais informações.
Exemplo de um componente de Verificação de integridade do Sling, gravado com anotações de componente de serviço OSGI:
code language-java @Component(service = HealthCheck.class, property = { HealthCheck.NAME + "=Example Check", HealthCheck.TAGS + "=example", HealthCheck.TAGS + "=test", HealthCheck.MBEAN_NAME + "=exampleHealthCheckMBean" }) public class ExampleHealthCheck implements HealthCheck { @Override public Result execute() { // health check code } }
note note NOTE A variável MBEAN_NAME
define o nome do mbean gerado para esta verificação de integridade. -
Depois de criar uma verificação de integridade, um novo nó de configuração deve ser criado para torná-lo acessível na interface do Painel de operações. Para esta etapa, é necessário saber o nome do Mbean JMX da Verificação de integridade (o
MBEAN_NAME
propriedade). Para criar uma configuração para a Verificação de integridade, abra o CRXDE e adicione um nó (do tipo nt:não estruturado) no seguinte caminho:/apps/settings/granite/operations/hc
As seguintes propriedades devem ser definidas no novo nó:
-
Nome:
sling:resourceType
- Tipo:
String
- Valor:
granite/operations/components/mbean
- Tipo:
-
Nome:
resource
- Tipo:
String
- Valor:
/system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/exampleHealthCheck
- Tipo:
note note NOTE O caminho do recurso acima é criado da seguinte maneira: se o nome do mbean da sua verificação de integridade for "teste", adicione "teste" ao final do caminho /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck
Portanto, o caminho final é o seguinte: /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/test
note note NOTE Certifique-se de que a variável /apps/settings/granite/operations/hc
o caminho tem as seguintes propriedades definidas como true:sling:configCollectionInherit
sling:configPropertyInherit
Esse processo informa ao gerenciador de configurações para mesclar as novas configurações com as existentes do /libs
. -
Criação de uma verificação de integridade composta creating-a-composite-health-check
A função de uma Verificação de integridade composta é agregar várias Verificações de integridade individuais que compartilham um conjunto de recursos comuns. Por exemplo, a Verificação de integridade do composto de segurança agrupa todas as verificações de integridade individuais que executam verificações relacionadas à segurança. A primeira etapa para criar uma verificação composta é adicionar uma configuração OSGI. Para que seja exibido no Painel de operações, um novo nó de configuração deve ser adicionado da mesma forma que uma verificação simples.
-
Vá para o Gerenciador de configuração da Web no Console OSGI. Acesso
https://serveraddress:port/system/console/configMgr
-
Procure a entrada chamada Verificação de integridade do Apache Sling Composite. Depois de localizá-la, observe que há duas configurações já disponíveis: uma para as Verificações de sistema e outra para as Verificações de segurança.
-
Crie uma configuração pressionando o botão "+" no lado direito da configuração. Uma nova janela é exibida, conforme mostrado abaixo:
-
Crie uma configuração e salve-a. Um Mbean é criado com a nova configuração.
A finalidade de cada propriedade de configuração é a seguinte:
- Nome (hc.name): O nome da Verificação de integridade do composto. Recomenda-se um nome significativo.
- Tags (hc.tags): As tags desta verificação de integridade. Se esta verificação de integridade composta tiver que fazer parte de outra verificação de integridade composta (como em uma hierarquia de verificações de integridade), adicione as tags às quais este composto está relacionado.
- Nome do MBean (hc.mbean.name): O nome do Mbean que é fornecido ao MBean JMX desta verificação de integridade composta.
- Tags de filtro (filter.tags): A propriedade específica das verificações de integridade do composto. Essas tags são agregadas pelo composto. A verificação de integridade do composto agrega em seu grupo todas as verificações de integridade que têm qualquer tag correspondente a qualquer uma das tags de filtro deste composto. Por exemplo, uma verificação de integridade composta com as tags de filtro test e check, agrega todas as verificações de integridade individuais e compostas que têm qualquer uma das test e check tags na propriedade tags (
hc.tags
).
note note NOTE Um novo Mbean JMX é criado para cada nova configuração da verificação de integridade do Apache Sling Composite.** -
Por fim, a entrada da verificação de integridade do composto que foi criada deve ser adicionada nos nós de configuração do Painel de operações. O procedimento é o mesmo das verificações de integridade individuais: um nó do tipo nt:não estruturado deve ser criado em
/apps/settings/granite/operations/hc
. A propriedade resource do nó é definida pelo valor de hc.medium.name na configuração OSGI.Por exemplo, se você criou uma configuração e definiu o hc.mbean.name valor para diskusage, os nós de configuração são semelhantes ao seguinte:
-
Nome:
Composite Health Check
- Tipo:
nt:unstructured
- Tipo:
Com as seguintes propriedades:
-
Nome:
sling:resourceType
- Tipo:
String
- Valor:
granite/operations/components/mbean
- Tipo:
-
Nome:
resource
- Tipo:
String
- Valor:
/system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/diskusage
- Tipo:
note note NOTE Se você criar verificações de integridade individuais que pertencem logicamente a uma verificação composta que já está presente no Dashboard por padrão, elas serão automaticamente capturadas e agrupadas na respectiva verificação composta. Dessa forma, não há necessidade de criar um nó de configuração para essas verificações. Por exemplo, se você criar uma verificação de integridade de segurança individual, atribua a ela a função "segurança" e ele será instalado. Ele aparece automaticamente na verificação composta Verificações de segurança no Painel de operações. -
Verificações de integridade fornecidas com AEM health-checks-provided-with-aem
Configuração de verificação de integridade health-check-configuration
Por padrão, para uma instância de AEM pronta para uso, as verificações de integridade são executadas a cada 60 segundos.
Você pode configurar o Período com o Configuração OSGi Configuração de verificação de integridade da consulta (com.adobe.granite.queries.impl.hc.QueryHealthCheckMetrics).
Monitoramento com o Nagios monitoring-with-nagios
O Painel de verificação de integridade pode se integrar ao Nagios por meio dos Mbeans Granite JMX. O exemplo abaixo ilustra como adicionar uma verificação que mostra a memória usada no servidor que executa o AEM.
-
Configure e instale o Nagios no servidor de monitoramento.
-
Em seguida, instale o NRPE (Nagios Remote Plugin Executor).
note note NOTE Para obter mais informações sobre como instalar o Nagios e o NRPE em seu sistema, consulte o Documentação do Nagios. -
Adicione uma definição de host para o servidor AEM. Você pode realizar essa tarefa por meio da interface da Web do Nagios XI, usando o Gerenciador de configurações:
- Abra um navegador e aponte para o servidor Nagios.
- Pressione a Configurar no menu superior.
- No painel esquerdo, pressione a tecla Gerenciador de configuração principal em Configuração avançada.
- Pressione a Hosts no link Monitoramento seção.
- Adicione a definição do host:
Abaixo está um exemplo de um arquivo de configuração de host, caso você esteja usando o Nagios Core:
code language-xml define host { address 192.168.0.5 max_check_attempts 3 check_period 24x7 check-command check-host-alive contacts admin notification_interval 60 notification_period 24x7 }
-
Instale o Nagios e o NRPE no servidor AEM.
-
Instale o check_http_json em ambos os servidores.
-
Defina um comando de verificação JSON genérico em ambos os servidores:
code language-xml define command{ command_name check_http_json-int command_line /usr/lib/nagios/plugins/check_http_json --user "$ARG1$" --pass "$ARG2$" -u 'https://$HOSTNAME$:$ARG3$/$ARG4$' -e '$ARG5$' -w '$ARG6$' -c '$ARG7$' }
-
Adicionar um serviço para memória usada no servidor AEM:
code language-xml define service { use generic-service host_name my.remote.host service_description AEM Author Used Memory check_command check_http_json-int!<cq-user>!<cq-password>!<cq-port>!system/sling/monitoring/mbeans/java/lang/Memory.infinity.json!{noname}.mbean:attributes.HeapMemoryUsage.mbean:attributes.used.mbean:value!<warn-threshold-in-bytes>!<critical-threshold-in-bytes> }
-
Verifique no painel do Nagios o serviço recém-criado:
Ferramentas de diagnóstico diagnosis-tools
O Painel de operação também fornece acesso às Ferramentas de diagnóstico que podem ajudar a encontrar e solucionar as causas raiz dos avisos provenientes do Painel de verificação de integridade e fornecer informações de depuração importantes para os operadores do sistema.
Entre suas características mais importantes estão:
- Um analisador de mensagens de registro
- A capacidade de acessar despejos de heap e thread
- Solicitações e analisadores de desempenho de consulta
Para acessar a tela Ferramentas de diagnóstico, acesse Ferramentas - Operações - Diagnóstico na tela de boas-vindas AEM. Você também pode acessar a tela acessando diretamente o seguinte URL: https://serveraddress:port/libs/granite/operations/content/diagnosis.html
Mensagens de registro log-messages
A interface do usuário de mensagens de log exibe todas as mensagens de ERRO por padrão. Se quiser que mais mensagens de log sejam exibidas, configure um agente de log com o nível de log apropriado.
As mensagens de log usam um anexador de log na memória e, portanto, não estão relacionadas aos arquivos de log. Outra consequência é que alterar os níveis de log nesta interface não altera as informações registradas nos arquivos de log tradicionais. A adição e remoção de registradores nesta interface afeta somente o registrador de memória. Além disso, a alteração das configurações do agente de log é refletida no futuro do agente de log na memória. As entradas que já estão registradas e não são mais relevantes não são excluídas, mas entradas semelhantes não são registradas no futuro.
Você pode definir o que é registrado fornecendo configurações do registrador no botão de engrenagem superior esquerdo na interface do usuário. Você pode adicionar, remover ou atualizar configurações do agente de log. Uma configuração de agente de log é composta de um nível de log (AVISO / INFORMAÇÕES / DEPURAÇÃO) e um nome do filtro. A variável nome do filtro tem a função de filtrar a origem das mensagens de log registradas. Como alternativa, se um agente de log deve capturar todas as mensagens de log para o nível especificado, o nome do filtro deve ser "raiz". Definir o nível de um agente aciona a captura de todas as mensagens com um nível igual ou superior ao especificado.
Exemplos:
-
Se você planeja capturar todas as ERRO mensagens - nenhuma configuração é necessária. Todas as mensagens de ERRO são capturadas por padrão.
-
Se você planeja capturar todas as ERRO, AVISO e INFORMAÇÕES messages - o nome do agente de log deve ser definido como: "raiz" e o nível do agente de log para: INFORMAÇÕES.
-
Se você quiser capturar todas as mensagens provenientes de um determinado pacote (por exemplo, com.adobe.granite), o nome do agente de log deverá ser definido como: "com.adobe.granite". E o nível do agente de log definido como: DEPURAR (isso captura todas as ERRO, AVISO, INFORMAÇÕES, e DEPURAR conforme mostrado na imagem abaixo.
Log level: INFO
DATE+TIME [MaintanceLogger] Name=<MT_NAME>, Status=<MT_STATUS>, Time=<MT_TIME>, Error=<MT_ERROR>, Details=<MT_DETAILS>
Desempenho da solicitação request-performance
A página Desempenho da solicitação permite a análise das solicitações de página mais lentas processadas. Somente as solicitações de conteúdo são registradas nesta página. Mais especificamente, as seguintes solicitações são capturadas:
- Solicitações de acesso a recursos em
/content
- Solicitações de acesso a recursos em
/etc/design
- Solicitações com o
".html"
extensão
A página é exibida:
- A hora em que a solicitação foi feita
- O URL e o método de solicitação
- A duração em milissegundos
Por padrão, as 20 solicitações de página mais lentas são capturadas, mas o limite pode ser modificado no Configuration Manager.
Desempenho da consulta query-performance
A página Desempenho da consulta permite a análise das consultas mais lentas executadas pelo sistema. Essas informações são fornecidas pelo repositório em um Mbean JMX. Em Jackrabbit, o com.adobe.granite.QueryStat
O JMX Mbean fornece estas informações, enquanto no repositório Oak, ele é oferecido por org.apache.jackrabbit.oak.QueryStats.
A página é exibida:
- A hora em que a consulta foi feita
- O idioma da consulta
- O número de vezes que a consulta foi emitida
- A instrução da consulta
- A duração em milissegundos
Explicar consulta explain-query
Para qualquer consulta, o Oak tenta descobrir a melhor maneira de executar com base nos índices Oak definidos no repositório no oak:índice nó. Dependendo da consulta, índices diferentes podem ser escolhidos pelo Oak. Entender como o Oak está executando uma consulta é a primeira etapa para otimizar a consulta.
A Explicar consulta é uma ferramenta que explica como o Oak está executando uma consulta. Ele pode ser acessado indo até Ferramentas - Operações - Diagnóstico na tela de boas-vindas do AEM. Em seguida, clique em Desempenho da consulta e mude para o Explicar consulta guia.
Recursos
- Suporta as linguagens de consulta Xpath, JCR-SQL e JCR-SQL2
- Relata o tempo de execução real da consulta fornecida
- Detecta consultas lentas e avisa sobre consultas que podem ser potencialmente lentas
- Relata o índice Oak usado para executar a consulta
- Exibe a explicação real do mecanismo de consulta Oak
- Fornece uma lista de cliques para carregar consultas lentas e populares
Depois de entrar na interface de Explicar consulta, insira a consulta e pressione a tecla Explicar botão:
A primeira entrada na seção Explicação da Consulta é a explicação real. A explicação mostra o tipo de índice usado para executar a consulta.
A segunda entrada é o plano de execução.
Marcar a variável Incluir tempo de execução antes da execução da consulta também mostra o tempo em que a consulta foi executada. A variável Incluir contagem de nós opção relata a contagem de nós. O relatório permite obter mais informações que podem ser usadas para otimizar os índices do seu aplicativo ou implantação.
O gerenciador de índice the-index-manager
A finalidade do Gerenciador de índice é facilitar o gerenciamento de índice, como manter índices ou exibir seu status.
Ele pode ser acessado indo até Ferramentas - Operações - Diagnóstico na Tela de boas-vindas e clicando no link Gerenciador de índice botão.
Ele também pode ser acessado diretamente neste URL: https://serveraddress:port/libs/granite/operations/content/diagnosistools/indexManager.html
A interface pode ser usada para filtrar índices na tabela digitando os critérios de filtro na caixa de pesquisa no canto superior esquerdo da tela.
Baixar o ZIP de status download-status-zip
Essa ação aciona o download de um zip que contém informações úteis sobre o status e a configuração do sistema. O arquivo contém configurações de instância, uma lista de pacotes, OSGI, métricas e estatísticas do Sling, que podem resultar em um arquivo grande. Você pode reduzir o impacto de arquivos de status grandes usando o Fazer download do ZIP de status janela. A janela pode ser acessada de:AEM > Ferramentas > Operações > Diagnóstico > Baixar o ZIP de status.
Nessa janela, você pode selecionar o que exportar (arquivos de log e/ou despejos de thread) e o número de dias dos logs incluídos no download em relação à data atual.
Baixar o despejo de encadeamento download-thread-dump
Essa ação aciona o download de um zip que contém informações sobre as threads presentes no sistema. As informações sobre cada thread são fornecidas, como seu status, o carregador de classe e o rastreamento de pilha.
Baixar o despejo da pilha download-heap-dump
É possível baixar um instantâneo do heap para analisá-lo posteriormente. Essa ação aciona o download de um arquivo grande (centenas de megabytes).
Tarefas de manutenção automatizada automated-maintenance-tasks
A página Tarefas de manutenção automatizada é um local onde você pode visualizar e rastrear tarefas de manutenção recomendadas programadas para execução periódica. As tarefas são integradas ao sistema de Verificação de integridade. As tarefas também podem ser executadas manualmente na interface.
Para acessar a página de Manutenção no Painel de Operações, na tela de Boas-vindas do AEM, acesse Ferramentas - Operações - Painel - Manutenção ou siga diretamente este link:
https://serveraddress:port/libs/granite/operations/content/maintenance.html
As seguintes tarefas estão disponíveis no Painel de operações:
- A variável Limpeza de revisão tarefa, localizada abaixo de Janela de manutenção diária menu.
- A variável Limpeza de binários do Lucene tarefa, localizada abaixo de Janela de manutenção diária menu.
- A variável Limpeza do fluxo de trabalho tarefa, localizada abaixo de Janela de manutenção semanal menu.
- A variável Coleta de lixo do armazenamento de dados tarefa, localizada abaixo de Janela de manutenção semanal menu.
- A variável Manutenção do Log de Auditoria tarefa, localizada abaixo de Janela de manutenção semanal menu.
- A variável Manutenção de limpeza de versão tarefa, localizada abaixo de Janela de manutenção semanal menu.
O tempo padrão para a janela de manutenção diária é de 2h às 5h. As tarefas configuradas para serem executadas na janela de manutenção semanal são executadas entre 1:00 e 2:00 aos sábados.
Você também pode configurar os horários pressionando o ícone de engrenagem em qualquer uma das duas placas de manutenção:
Limpeza da revisão revision-clean-up
Para obter mais informações sobre como executar a Limpeza de revisão, consulte este artigo dedicado.
Limpeza de binários do Lucene lucene-binaries-cleanup
Ao usar a tarefa Limpeza de binários do Lucene, você pode limpar os binários do Lucene e reduzir o requisito de tamanho do armazenamento de dados em execução. O churn binário de Lucene é recuperado diariamente em vez da dependência anterior em um coleta de lixo do armazenamento de dados executar.
Embora a tarefa de manutenção tenha sido desenvolvida para reduzir o lixo de revisão relacionado ao Lucene, há ganhos gerais de eficiência ao executar a tarefa:
- A execução semanal da tarefa de coleta de lixo do armazenamento de dados pode ser concluída mais rapidamente.
- Também pode melhorar ligeiramente o desempenho geral do AEM.
Você pode acessar a tarefa Limpeza de binários do Lucene em: AEM > Ferramentas > Operações > Manutenção > Janela de manutenção diária > Limpeza de binários do Lucene.
Coleta de lixo do armazenamento de dados data-store-garbage-collection
Para obter detalhes sobre a Coleta de lixo do armazenamento de dados, consulte a seção dedicada página da documentação.
Limpeza do fluxo de trabalho workflow-purge
Os workflows também podem ser removidos do Painel de manutenção. Para executar a tarefa Expurgação de Workflow, faça o seguinte:
- Clique em Janela de manutenção semanal página.
- Na página a seguir, clique em Reproduzir no Limpeza do fluxo de trabalho cartão.
Manutenção do Log de Auditoria audit-log-maintenance
Para Manutenção do log de auditoria, consulte página de documentação separada.
Remoção da versão version-purge
Você pode programar a tarefa de manutenção Limpeza de versão para excluir versões antigas automaticamente. Essa ação minimiza a necessidade de usar manualmente a variável Ferramentas de limpeza de versão. Você pode agendar e configurar a tarefa Limpeza de versão acessando Ferramentas > Operações > Manutenção > Janela de manutenção semanal e siga estas etapas:
-
Clique em Adicionar.
-
Escolher Limpeza de versão no menu suspenso.
-
Para configurar a tarefa Limpeza de versão, clique no link engrenagens no cartão de manutenção Version Purge recém-criado.
Com AEM 6.4, você poderá interromper a tarefa de manutenção Limpeza de Versão da seguinte maneira:
- Automaticamente - se a janela de manutenção programada fechar antes que a tarefa possa ser concluída, a tarefa será interrompida automaticamente. Ele será retomado quando a próxima janela de manutenção for aberta.
- Manualmente - Para interromper a tarefa manualmente, no cartão de manutenção Limpeza de versão, clique no link Parar ícone. Na próxima execução, a tarefa será retomada com segurança.
Tarefas de manutenção personalizadas custom-maintenance-tasks
As tarefas de manutenção personalizadas podem ser implementadas como serviços OSGi. Como a infraestrutura da tarefa de manutenção se baseia na manipulação de trabalhos do Apache Sling, uma tarefa de manutenção deve implementar a interface Java™ [org.apache.sling.event.jobs.consumer.JobExecutor](https://sling.apache.org/apidocs/sling7/org/apache/sling/event/jobs/consumer/JobExecutor.html)
. Além disso, ele deve declarar várias propriedades de registro de serviço para serem detectadas como uma tarefa de manutenção, conforme listado abaixo:
Além das propriedades de serviço acima, a variável process()
método do JobConsumer
A interface do deve ser implementada adicionando o código que deve ser executado para a tarefa de manutenção. Os dados fornecidos JobExecutionContext
pode ser usado para gerar informações de status, verificar se o trabalho foi interrompido pelo usuário e criar um resultado (com êxito ou com falha).
Para situações em que uma tarefa de manutenção não deve ser executada em todas as instalações (por exemplo, executar somente na instância de publicação), é possível fazer com que o serviço exija uma configuração para estar ativo adicionando @Component(policy=ConfigurationPolicy.REQUIRE)
. Você pode marcar a configuração de acordo como sendo modo de execução dependente no repositório. Para obter mais informações, consulte Configuração do OSGi.
Veja abaixo um exemplo de uma tarefa de manutenção personalizada que exclui arquivos de um diretório temporário configurável que foi modificado nas últimas 24 horas:
src/main/java/com/adobe/granite/samples/maintenance/impl/DeleteTempFilesTask.java
experiencemanager-java-maintenance-ask-sample- src/main/java/com/adobe/granite/samples/maintenance/impl/DeleteTempFilesTask.java
Depois que o serviço é implantado, ele é exposto à interface do usuário do Painel de operações. Você pode adicioná-lo a um dos cronogramas de manutenção disponíveis:
Esta ação adiciona um recurso correspondente em /apps/granite/operations/config/maintenance/schedule
/taskname
. Se a tarefa for dependente do modo de execução, a propriedade granite.operations.conditions.runmode deverá ser definida nesse nó com os valores dos modos de execução que devem estar ativos para essa tarefa de manutenção.
Visão geral do sistema system-overview
A variável Painel de visão geral do sistema exibe uma visão geral de alto nível da configuração, do hardware e da integridade da instância AEM. O status de integridade do sistema é transparente e todas as informações são agregadas em um único painel.
Como Acessar how-to-access
Para acessar o Painel de Visão Geral do Sistema, navegue até Ferramentas > Operações > Visão geral do sistema.
Painel de visão geral do sistema explicado system-overview-dashboard-explained
A tabela abaixo descreve todas as informações exibidas no Painel de visão geral do sistema. Quando não há informações relevantes para mostrar (por exemplo, o backup não está em andamento, não há verificações de integridade críticas), a respectiva seção exibe a mensagem "Nenhuma entrada".
Você também pode baixar um JSON
arquivo resumindo as informações do painel clicando no ícone Baixar no canto superior direito do painel. A variável JSON
o endpoint é /libs/granite/operations/content/systemoverview/export.json
e pode ser usado em um curl
script para monitoramento externo.