Recursos do Monitoring Server usando a console JMX monitoring-server-resources-using-the-jmx-console
A Console JMX permite que você monitore e gerencie serviços no servidor do CRX. As seções a seguir resumem os atributos e operações que são expostos por meio da estrutura JMX.
Para obter informações sobre como usar os controles do console, consulte Usando o Console JMX. Para obter informações de fundo sobre JMX, consulte a página Tecnologia Java Management Extensions (JMX) no site do Oracle.
Para obter informações sobre como criar MBeans para gerenciar seus serviços usando o Console JMX, consulte Integrando serviços com o Console JMX.
Manutenção do fluxo de trabalho workflow-maintenance
Operações para administrar instâncias de fluxos de trabalho em execução, concluídas, obsoletas e com falha.
- Domínio: com.adobe.granite.workflow
- Tipo: manutenção
Operações operations
listRunningWorkflowsPerModel Lista o número de instâncias de fluxo de trabalho em execução para cada modelo de fluxo de trabalho.
- Argumentos: nenhum
- Valor retornado: dados tabulares contendo as colunas Count e ModelId.
listCompletedWorkflowsPerModel Lista o número de instâncias de fluxo de trabalho concluídas para cada modelo de fluxo de trabalho.
- Argumentos: nenhum
- Valor retornado: dados tabulares contendo as colunas Count e ModelId.
returnWorkflowQueueInfo Lista informações sobre itens de fluxo de trabalho que foram processados e que estão na fila para processamento.
-
Argumentos: nenhum
-
Valor retornado: dados tabulares contendo as seguintes colunas:
- Tarefas
- Nome da Fila
- Tarefas ativas
- Tempo Médio de Processamento
- Tempo médio de espera
- Trabalhos cancelados
- Trabalhos com falhas
- Trabalhos Concluídos
- Trabalhos processados
- Trabalhos em fila
returnWorkflowJobTopicInfo Lista as informações de processamento dos trabalhos de fluxo de trabalho, organizadas por tópico.
-
Argumentos: nenhum
-
Valor retornado: dados tabulares contendo as seguintes colunas:
- Nome do tópico
- Tempo Médio de Processamento
- Tempo médio de espera
- Trabalhos cancelados
- Trabalhos com falhas
- Trabalhos Concluídos
- Trabalhos processados
returnFailedWorkflowCount Mostra o número de instâncias de fluxo de trabalho que falharam. Você pode especificar um modelo de fluxo de trabalho para consultar ou recuperar informações de todos os modelos de fluxo de trabalho.
-
Argumentos:
-
model: a ID do modelo a ser consultado. Para ver uma contagem de instâncias de fluxo de trabalho com falha para todos os modelos de fluxo de trabalho, não especifique nenhum valor. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: o número de instâncias de fluxo de trabalho com falha.
returnFailedWorkflowCountPerModel Mostra o número de instâncias de fluxo de trabalho que falharam para cada modelo de fluxo de trabalho.
- Argumentos: nenhum.
- Valor retornado: dados tabulares contendo as colunas Contagem e ID do modelo.
terminateFailedInstances Encerra instâncias de fluxo de trabalho que falharam. Você pode encerrar todas as instâncias com falha ou somente as instâncias com falha de um modelo específico. Opcionalmente, é possível reiniciar as instâncias após serem encerradas. Você também pode testar a operação para ver os resultados sem realmente executar a operação.
-
Argumentos:
-
Reiniciar a instância: (Opcional) Especifique um valor de
true
para reiniciar as instâncias após serem encerradas. O valor padrão defalse
não causa a reinicialização de instâncias de fluxo de trabalho encerradas. -
Dry run: (opcional) especifique um valor de
true
para ver os resultados da operação sem realmente executar a operação. O valor padrão defalse
faz com que a operação seja executada. -
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação às instâncias com falha de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: dados tabulares sobre as instâncias terminadas, contendo as seguintes colunas:
- Iniciador
- InstanceId
- ModelId
- Carga útil
- IniciarComentário
- WorkflowTitle
retryFailedWorkItems Tentativas de executar etapas de item de trabalho que falharam. Você pode repetir todos os itens de trabalho com falha ou somente os itens de trabalho com falha de um modelo de fluxo de trabalho específico. Opcionalmente, você testa a operação para ver os resultados sem realmente executar a operação.
-
Argumentos:
-
Dry run: (opcional) especifique um valor de
true
para ver os resultados da operação sem realmente executar a operação. O valor padrão defalse
faz com que a operação seja executada. -
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação aos itens de trabalho com falha de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: dados tabulares sobre os itens de trabalho com falha que são repetidos, incluindo as seguintes colunas:
- Iniciador
- InstanceId
- ModelId
- Carga útil
- IniciarComentário
- WorkflowTitle
PurgeActive remove as instâncias de fluxo de trabalho ativas de uma página específica. Você pode remover as instâncias ativas de todos os modelos ou apenas as instâncias de um modelo específico. Opcionalmente, você pode testar a operação para ver os resultados sem realmente executar a operação.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação às instâncias de fluxo de trabalho de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
Número de dias desde o início do workflow: a idade das instâncias de workflow a serem removidas, em dias.
-
Dry run: (opcional) especifique um valor de
true
para ver os resultados da operação sem realmente executar a operação. O valor padrão defalse
faz com que a operação seja executada.
-
-
Valor retornado: dados tabulares sobre as instâncias de fluxo de trabalho ativas que são removidas, incluindo as seguintes colunas:
- Iniciador
- InstanceId
- ModelId
- Carga útil
- IniciarComentário
- WorkflowTitle
countStaleWorkflows Retorna o número de instâncias de fluxo de trabalho obsoletas. Você pode recuperar o número de instâncias obsoletas para todos os modelos de fluxo de trabalho ou para um modelo específico.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação às instâncias de fluxo de trabalho de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: o número de instâncias de fluxo de trabalho obsoletas.
restartStaleWorkflows reinicia instâncias de fluxo de trabalho obsoletas. Você pode reiniciar todas as instâncias obsoletas ou apenas as instâncias obsoletas de um modelo específico. Você também pode testar a operação para ver os resultados sem realmente executar a operação.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação às instâncias obsoletas de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
Dry run: (opcional) especifique um valor de
true
para ver os resultados da operação sem realmente executar a operação. O valor padrão defalse
faz com que a operação seja executada.
-
-
Valor retornado: uma lista de instâncias de fluxo de trabalho que são reiniciadas.
fetchModelList Lista todos os modelos de fluxo de trabalho.
- Argumentos: nenhum
- Valor retornado: dados tabulares que identificam os modelos de fluxo de trabalho, incluindo as colunas ModelId e ModelName.
countRunningWorkflows Retorna o número de instâncias de fluxo de trabalho em execução. Você pode recuperar o número de instâncias em execução para todos os modelos de fluxo de trabalho ou para um modelo específico.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo para o qual o número de instâncias em execução é retornado. Especifique nenhum modelo para retornar o número de instâncias em execução de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: o número de instâncias de fluxo de trabalho em execução.
countCompletedWorkflows Retorna o número de instâncias de fluxo de trabalho concluídas. Você pode recuperar o número de instâncias concluídas para todos os modelos de fluxo de trabalho ou para um modelo específico.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo para o qual o número de instâncias concluídas é retornado. Especifique nenhum modelo para retornar o número de instâncias concluídas de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
Valor retornado: o número de instâncias de fluxo de trabalho concluídas.
purgeCompleted Remove registros de fluxos de trabalho concluídos de uma página específica do repositório. Use essa operação periodicamente para minimizar o tamanho do repositório ao usar workflows. Você pode remover as instâncias concluídas de todos os modelos ou apenas as instâncias de um modelo específico. Opcionalmente, você pode testar a operação para ver os resultados sem realmente executar a operação.
-
Argumentos:
-
Modelo: (opcional) a ID do modelo ao qual a operação é aplicada. Especifique nenhum modelo para aplicar a operação às instâncias de fluxo de trabalho de todos os modelos de fluxo de trabalho. A ID é o caminho para o nó do modelo, por exemplo:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
Número de dias desde a conclusão do fluxo de trabalho: o número de dias em que as instâncias de fluxo de trabalho estiveram no estado concluído.
-
Dry run: (opcional) especifique um valor de
true
para ver os resultados da operação sem realmente executar a operação. O valor padrão defalse
faz com que a operação seja executada.
-
-
Valor retornado: dados tabulares sobre as instâncias de fluxo de trabalho concluídas que são removidas, incluindo as seguintes colunas:
- Iniciador
- InstanceId
- ModelId
- Carga útil
- IniciarComentário
- WorkflowTitle
Repositório repository
Informações sobre o repositório do CRX
- Domínio: com.adobe.granite
- Tipo: Repositório
Atributos attributes
Nome O nome da implementação do repositório JCR. Somente leitura.
Versão A versão de implementação do repositório. Somente leitura.
HomeDir O diretório onde o repositório está localizado. O local padrão é <QuickStart_Jar_Location>/crx-quickstart/repository. Somente leitura.
NomeCliente O nome do cliente para o qual a licença de software foi emitida. Somente leitura.
LicenseKey A chave de licença exclusiva para esta instalação do repositório. Somente leitura.
AvailableDiskSpace O espaço em disco disponível para esta instância do repositório, em Mbytes. Somente leitura.
MaximumNumberOfOpenFiles O número de arquivos que podem ser abertos ao mesmo tempo. Somente leitura.
SessionTracker O valor da variável de sistema crx.debug.sessions. true indica uma sessão de depuração. false indica uma sessão normal. Leitura/gravação.
Descritores Um conjunto de pares de valores chave que representam propriedades do repositório. Todas as propriedades são somente leitura.
NomesDoEspaçoDeTrabalho Os nomes dos espaços de trabalho no repositório. Somente leitura.
DataStoreGarbageCollectionDelay A quantidade de tempo em milissegundos que a coleta de lixo fica em suspensão após a verificação de cada décimo nó. Leitura/gravação.
BackupDelay O tempo em milissegundos que o processo de backup aguarda entre cada etapa do backup. Leitura/gravação.
BackupInProgress Um valor true indica que um processo de backup está em execução. Somente leitura.
BackupProgress Para o backup atual, o percentual de todos os arquivos do backup. Somente leitura.
CurrentBackupTarget Para o backup atual, o arquivo ZIP onde os arquivos de backup estão sendo armazenados. Quando um backup não está em andamento, nenhum valor é exibido. Somente leitura.
BackupWasSuccessful Um valor true indica que nenhum erro ocorreu durante o backup atual ou nenhum backup está em andamento. false indica que ocorreu um erro durante o backup atual. Somente leitura.
BackupResult O status do backup atual. Os seguintes valores são possíveis:
- Backup em andamento: um backup está sendo executado no momento.
- Backup cancelado: o backup foi cancelado.
- Backup concluído com erro: erro durante o backup. A mensagem de erro fornece informações sobre a causa.
- Backup concluído: o backup foi bem-sucedido.
- Nenhum backup executado até o momento: não há backup em andamento.
Somente leitura.
TarOtimizationRunningSince A hora em que o processo de otimização de arquivos TAR atual começou. Somente leitura.
TarOtimizationDelay A quantidade de tempo em milissegundos que o processo de otimização de TAR permanece em suspensão entre cada etapa do processo. Leitura/gravação.
ClusterProperties Um conjunto de pares de valores chave que representam as propriedades e os valores do cluster. Cada linha na tabela representa uma propriedade de cluster. Somente leitura.
ClusterNodes Os membros do cluster do repositório.
ClusterId O identificador deste cluster de repositório. Somente leitura.
ClusterMasterId O identificador do nó mestre deste cluster de repositório. Somente leitura.
ClusterNodeId O identificador deste nó do cluster do repositório. Somente leitura.
Operações operations-1
createWorkspace Cria um espaço de trabalho neste repositório.
-
Argumentos:
- name: um valor de string que representa o nome do novo espaço de trabalho.
-
Valor retornado: nenhum
runDataStoreGarbageCollection Executa a coleta de lixo nos nós do repositório.
-
Argumentos:
- excluir: um valor booleano que indica se os itens do repositório não utilizados devem ser excluídos. Um valor true causa a exclusão de nós e propriedades não usados. Um valor false faz com que todos os nós sejam verificados, mas nenhum é excluído.
-
Valor retornado: nenhum
stopDataStoreGarbageCollection Para uma coleta de lixo de armazenamento de dados em execução.
- Argumentos: nenhum
- Valor retornado: representação da string do status atual
startBackup Faz backup dos dados do repositório em um arquivo ZIP.
-
Argumentos:
-
target
: (Opcional) Um valorString
que representa o nome do arquivo ZIP ou diretório em que os dados do repositório serão arquivados. Para usar um arquivo ZIP, inclua a extensão de nome de arquivo ZIP. Para usar um diretório, inclua nenhuma extensão de nome de arquivo.Para executar um backup incremental, especifique o diretório usado anteriormente para o backup.
Você pode especificar um caminho absoluto ou relativo. Os caminhos relativos são relativos ao pai do diretório crx-quickstart.
Quando você não especifica nenhum valor, o valor padrão de
backup-currentdate.zip
é usado, ondecurrentdate
está no formatoyyyyMMdd-HHmm
.
-
-
Valor retornado: nenhum
cancelBackup Interrompe o processo de backup atual e exclui o arquivo morto temporário criado pelo processo para arquivar dados.
- Argumentos: nenhum
- Valor retornado: nenhum
blockRepositoryWrites Bloqueia alterações nos dados do repositório. Todos os ouvintes de backup do repositório são notificados sobre o bloco.
- Argumentos: nenhum
- Valor retornado: nenhum
unblockRepositoryWrites Remove o bloco do repositório. Todos os ouvintes de backup do repositório são notificados sobre a remoção do bloco.
- Argumentos: nenhum
- Valor retornado: nenhum
startTarOtimization Inicia o processo de otimização do arquivo TAR usando o valor padrão para tarOtimizationDelay.
- Argumentos: nenhum
- Valor retornado: nenhum
stopTarOtimization Para a otimização do arquivo TAR.
- Argumentos: nenhum
- Valor retornado: nenhum
tarIndexMerge Mescla os arquivos de índice principais de todos os conjuntos TAR. Os principais arquivos de índice são arquivos com diferentes versões principais. Por exemplo, os seguintes arquivos são mesclados no arquivo index_3_1.tar: index_1_1.tar, index_2_0.tar, index_3_0.tar. Os arquivos mesclados são excluídos (no exemplo anterior, index_1_1.tar, index_2_0.tar e index_3_0.tar são excluídos).
-
Argumentos:
background
: um valor booliano que indica se a operação deve ser executada em segundo plano para que o Console da Web possa ser usado durante a execução. Um valor true executa a operação em segundo plano.
-
Valor retornado: nenhum
makeClusterMaster Define este nó de repositório como o nó mestre do cluster. Se ainda não tiver sido mestre, este comando interrompe o listener da instância mestre atual e inicia um listener mestre no nó atual. Em seguida, esse nó é definido como o nó mestre e reiniciado, fazendo com que todos os outros nós do cluster (ou seja, aqueles que são controlados pelo nó mestre) se conectem a essa instância.
- Argumentos: nenhum
- Valor retornado: nenhum
joinCluster Adiciona este repositório a um cluster como um nó controlado pelo cluster mestre. Forneça um nome de usuário e senha para fins de autenticação. A conexão usa autenticação básica. As credenciais de segurança são codificadas na base 64 antes de serem enviadas ao servidor.
-
Argumentos:
master
: um valor de cadeia de caracteres que representa o endereço IP ou o nome do computador que executa o nó de repositório mestre.username
: O nome a ser usado para autenticar com o cluster.password
: A senha a ser usada para autenticação.
-
Valor retornado: nenhum
traversalCheck Percorre e, opcionalmente, corrige inconsistências em uma subárvore que começa em um nó específico. Isso é abordado em detalhes completos na documentação dos Gerenciadores de persistência.
consistencyCheck verifica e, opcionalmente, corrige a consistência no Datastore. Isso é abordado em detalhes completos na documentação sobre o armazenamento de dados.
Estatísticas do repositório (TimeSeries) repository-statistics-timeseries
O valor do campo TimeSeries para cada tipo de estatística definido por org.apache.jackrabbit.api.stats.RepositoryStatistics
.
-
Domínio:
com.adobe.granite
-
Tipo:
TimeSeries
-
Nome: um dos seguintes valores da classe Enum
org.apache.jackrabbit.api.stats.RepositoryStatistics.Type
:- BUNDLE_CACHE_ACCESS_COUNTER
- BUNDLE_CACHE_MISS_AVERAGE
- BUNDLE_CACHE_MISS_COUNTER
- BUNDLE_CACHE_MISS_DURATION
- BUNDLE_CACHE_SIZE_COUNTER
- BUNDLE_COUNTER
- BUNDLE_READ_COUNTER
- BUNDLE_WRITE_AVERAGE
- BUNDLE_WRITE_COUNTER
- BUNDLE_WRITE_DURATION
- BUNDLE_WS_SIZE_COUNTER
- QUERY_AVERAGE
- QUERY_COUNT
- QUERY_DURATION
- SESSION_COUNT
- SESSION_LOGIN_COUNTER
- SESSION_READ_AVERAGE
- SESSION_READ_COUNTER
- SESSION_READ_DURATION
- SESSION_WRITE_AVERAGE
- SESSION_WRITE_COUNTER
- SESSION_WRITE_DURATION
Atributos attributes-1
Os seguintes atributos são fornecidos para cada tipo de estatística reportado:
- ValuePerSecond: o valor medido por segundo durante o último minuto. Somente leitura.
- ValuePerMinute: o valor medido por minuto na última hora. Somente leitura.
- ValuePerHour: o valor medido por hora na última semana. Somente leitura.
- ValuePerWeek: O valor medido por semana nos últimos três anos. Somente leitura.
Estatísticas de consulta do repositório repository-query-stats
Informações estatísticas sobre consultas de repositório.
- Domínio: com.adobe.granite
- Tipo: QueryStat
Atributos attributes-2
SlowQueries Informações sobre as consultas do repositório que levaram mais tempo para serem concluídas. Somente leitura.
SlowQueriesQueueSize O número máximo de consultas a serem incluídas na lista SlowQueries. Leitura-gravação.
PopularQueries Informações sobre as consultas do repositório que mais ocorreram. Somente leitura.
PopularQueriesQueueSize O número máximo de consultas na lista PopularQueries. Leitura-gravação.
Operações operations-2
clearSlowQueriesQueue Remove todas as consultas da lista SlowQueries.
- Argumentos: nenhum
- Valor retornado: nenhum
clearPopularQueriesQueue Remove todas as consultas da lista PopularQueries.
- Argumentos: nenhum
- Valor retornado: nenhum
Agentes de replicação replication-agents
Monitore os serviços para cada agente de replicação. Quando você cria um agente de replicação, o serviço aparece automaticamente no console JMX.
- Domínio: com.adobe.granite.replication
- Tipo: agente
- Nome: nenhum valor
- Propriedades: {id="Name"}, onde Name é o valor da propriedade Name do agente.
Atributos attributes-3
Id Um valor de cadeia de caracteres que representa o identificador da configuração do agente de replicação. Vários agentes podem usar a mesma configuração. Somente leitura.
Válido Um valor booliano que indica se o agente está configurado corretamente:
true
: configuração válida.false
: a configuração contém erros.
Somente leitura.
Habilitado Um valor booliano que indica se o agente está habilitado:
true
: Habilitado.false
: Desabilitado.
QueueBlocked Um valor booliano que indica se a fila existe e está bloqueada:
true
: Bloqueado. Uma nova tentativa automática está pendente.false
: Não bloqueado ou não existe.
Somente leitura.
QueuePaused Um valor booliano que indica se a fila de trabalhos está pausada:
true
: Pausado (suspenso)false
: Não pausado ou não existe.
Leitura-gravação.
QueueNumEntries Um valor int que representa o número de trabalhos na fila do agente. Somente leitura.
QueueStatusTime Um valor Date que indica a hora no servidor quando os valores de status exibidos foram obtidos. O valor corresponde à hora em que a página foi carregada. Somente leitura.
QueueNextRetryTime Para filas bloqueadas, um valor de Data que indica quando ocorre a próxima tentativa automática. Quando nenhuma hora for exibida, a fila não será bloqueada. Somente leitura.
QueueProcessingSince Um valor de Date que indica o início do processamento do trabalho atual. Quando não aparecer nenhuma hora, a fila será bloqueada ou ficará ociosa. Somente leitura.
QueueLastProcessTime Um valor Date que indica quando o trabalho anterior foi concluído. Somente leitura.
Operações operations-3
queueForceRetry Para filas bloqueadas, emite o comando retry para a fila.
- Argumentos: nenhum
- Valor retornado: nenhum
queueClear Remove todos os trabalhos da fila.
- Argumentos: nenhum
- Valor retornado: nenhum
Mecanismo Sling sling-engine
Fornece estatísticas sobre solicitações HTTP para que você possa monitorar o desempenho do serviço SlingRequestProcessor.
- Domínio: org.apache.sling
- Tipo: mecanismo
- Propriedades:
Atributos attributes-4
RequestsCount O número de solicitações que ocorreram desde que as estatísticas foram redefinidas pela última vez.
MinRequestDurationMsec O menor tempo (em milissegundos) necessário para processar uma solicitação desde a última redefinição das estatísticas.
MaxRequestDurationMsec A quantidade de tempo mais longa (em milissegundos) que foi necessária para processar uma solicitação desde que as estatísticas foram redefinidas pela última vez.
StandardDeviationDurationMsec O desvio padrão da quantidade de tempo necessária para processar solicitações. O desvio padrão é calculado usando todas as solicitações desde que as estatísticas foram redefinidas pela última vez.
MeanRequestDurationMsec A quantidade média de tempo necessária para processar uma solicitação. A média é calculada usando todas as solicitações desde a última redefinição das estatísticas
Operações operations-4
resetStatistics Define todas as estatísticas para zero. Redefina as estatísticas quando precisar analisar o desempenho do processamento de solicitações durante um período específico.
- Argumentos: nenhum
- Valor retornado: nenhum
id A representação da Cadeia de Caracteres da ID do pacote.
instalado Um valor booliano que indica se o pacote está instalado:
true
: Instalado.false
: Não instalado.
installedBy A identificação do usuário que instalou o pacote pela última vez.
installedDate A data em que o pacote foi instalado pela última vez.
size Um valor longo que armazena o tamanho do pacote em bytes.
Quickstart Launcher quickstart-launcher
Informações sobre o processo de inicialização e o Quickstart launcher.
- Domínio: com.adobe.granite.quickstart
- Tipo: Iniciador
Operações operations-5
log
Exibe uma mensagem na janela QuickStart.
Argumentos:
- p1: Um valor
String
que representa a mensagem a ser exibida. - Valor retornado: nenhum
startupFinished
Chama o método startupFinished do inicializador de servidor. O método tenta abrir a página de Boas-vindas em um navegador da Web.
- Argumentos: nenhum
- Valor retornado: nenhum
startupProgress
Define o valor de conclusão do processo de inicialização do servidor. A barra de progresso na janela QuickStart representa o valor de conclusão.
- Argumentos:
- p1: um valor flutuante que representa quanto do processo de inicialização está concluído, como uma fração. O valor deve estar entre zero e um. Por exemplo, 0,3 indica 30% concluído.
- Valor retornado: nenhum.
Serviços de terceiros third-party-services
Vários recursos de servidor de terceiros instalam MBeans que expõem atributos e operações ao console JMX. A tabela a seguir lista os recursos de terceiros e fornece links para mais informações.
Usando a console JMX using-the-jmx-console
A Console JMX exibe informações sobre vários serviços que estão sendo executados no servidor:
- Atributos: propriedades de serviço, como configurações ou dados de tempo de execução. Os atributos podem ser somente leitura ou leitura-gravação.
- Operações: Comandos que podem ser chamados no serviço.
Os MBeans implantados com um serviço OSGi expõem os atributos e as operações do serviço para o console. O MBean determina os atributos e operações que são expostos e se os atributos são somente leitura ou leitura-gravação.
A página principal do console JMX inclui uma tabela de serviços. Cada linha na tabela representa um serviço exposto por um MBean.
- Abra o Console da Web e clique na guia JMX. (http://localhost:4502/system/console/jmx)
- Clique em um valor de célula para um serviço para ver os atributos e as operações do serviço.
- Para alterar um valor de atributo, clique no valor, especifique o valor na caixa de diálogo exibida e clique em Salvar.
- Para chamar uma operação de serviço, clique no nome da operação, especifique valores de argumento na caixa de diálogo exibida e clique em Chamar.
Usando aplicações JMX externas para monitoramento using-external-jmx-applications-for-monitoring
O CRX permite que aplicativos externos interajam com Beans Gerenciados (MBeans) via Java Management Extensions (JMX). O uso de consoles genéricos, como o JConsole ou aplicativos de monitoramento específicos do domínio, permite obter e definir configurações e propriedades do CRX, além do monitoramento do desempenho e do uso de recursos.
Utilização do JConsole para se conectar ao CRX using-jconsole-to-connect-to-crx
Para se conectar ao CRX usando o JConsole, siga estas etapas:
-
Abra uma janela de terminal.
-
Digite o seguinte comando:
jconsole
O JConsole será iniciado e a janela JConsole será exibida.
Conexão com um processo local do CRX connecting-to-a-local-crx-process
O JConsole exibirá uma lista de processos locais da Java Virtual Machine. A lista conterá dois processos de início rápido. Selecione o processo de início rápido "CHILD" na lista de processos locais (geralmente aquele com o PID mais alto).
Conexão com um processo remoto do CRX connecting-to-a-remote-crx-process
Para se conectar a um processo CRX remoto, a JVM que hospeda o processo CRX remoto deve ser ativada para aceitar conexões JMX remotas.
Para ativar conexões JMX remotas, a seguinte propriedade do sistema deve ser definida ao iniciar a JVM:
com.sun.management.jmxremote.port=portNum
Na propriedade acima, portNum
é o número da porta pela qual você deseja habilitar as conexões JMX RMI. Certifique-se de especificar um número de porta não utilizado. Além de publicar um conector RMI para acesso local, a definição dessa propriedade publica um conector RMI adicional em um registro somente leitura privado na porta especificada usando um nome bem conhecido, "jmxrmi".
Por padrão, quando você ativa o agente JMX para monitoramento remoto, ele usa a autenticação de senha com base em um arquivo de senha que precisa ser especificado usando a seguinte propriedade do sistema ao iniciar a Java VM:
com.sun.management.jmxremote.password.file=pwFilePath
Consulte a documentação JMX relevante para obter instruções detalhadas sobre como configurar um arquivo de senha.
Exemplo:
$ java
-Dcom.sun.management.jmxremote.password.file=pwFilePath
-Dcom.sun.management.jmxremote.port=8463
-jar ./cq-quickstart.jar
Uso dos MBeans fornecidos pelo CRX using-the-mbeans-provided-by-crx
Depois de se conectar ao processo de início rápido, o JConsole fornece uma variedade de ferramentas gerais de monitoramento para a JVM em que o CRX está sendo executado.
Para acessar as opções internas de monitoramento e configuração do CRX, vá para a guia MBeans e, na árvore de conteúdo hierárquico à esquerda, selecione a seção Attributes or Operations na qual está interessado. Por exemplo, a seção com.adobe.granite/Repository/Operations.
Nessa seção, selecione o atributo ou a operação desejada no painel esquerdo.