Monitorar recursos do servidor usando o console JMX

O Console JMX permite monitorar e gerenciar serviços no servidor CRX. As seções a seguir resumem os atributos e operações expostos por meio da estrutura JMX.

Para obter informações sobre como usar os controles do console, consulte Uso do Console JMX. Para obter informações de fundo sobre JMX, consulte a 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 Integração de serviços com o console JMX.

Manutenção do workflow

Operações para administrar instâncias de fluxo de trabalho em execução, concluídas, obsoletas e com falha.

• Domínio: com.adobe.granite.workflow
• Tipo: Manutenção

Operações

listRunningWorkflowsPerModel Lista o número de instâncias de fluxo de trabalho que estão sendo executadas 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 informações de processamento para tarefas 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 para todos os modelos de fluxo de trabalho.

• Argumentos:

  • modelo: 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, 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 em cada modelo de fluxo de trabalho.

• Argumentos: nenhum.
• Valor retornado: Dados tabulares contendo as colunas Contagem e ID do modelo .

terminateFailedInstances Encerrar 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 depois que elas forem encerradas. Você também pode testar a operação para ver os resultados sem realmente executar a operação.

• Argumentos:

  • Reinicie a instância: (Opcional) Especifique um valor de true para reiniciar as instâncias depois que terminarem. O valor padrão de false não causa reinício de instâncias de fluxo de trabalho finalizadas.

  • Execução seca: (Opcional) Especifique um valor de true para ver os resultados da operação sem realmente executar a operação. O valor padrão de false 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
  • StartComment
  • WorkflowTitle

retryFailedWorkItems Tenta executar etapas de item de trabalho que falharam. Você pode repetir todos os itens de trabalho com falha ou apenas os itens de trabalho com falha para 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:

  • Execução seca: (Opcional) Especifique um valor de true para ver os resultados da operação sem realmente executar a operação. O valor padrão de false 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
  • StartComment
  • WorkflowTitle

PurgeActive Remove instâncias ativas de fluxo de trabalho de uma página específica. Você pode limpar 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 que o fluxo de trabalho foi iniciado: A idade das instâncias do fluxo de trabalho a serem removidas, em dias.

  • Execução seca: (Opcional) Especifique um valor de true para ver os resultados da operação sem realmente executar a operação. O valor padrão de false faz com que a operação seja executada.

• Valor retornado: Dados tabulares sobre as instâncias do fluxo de trabalho ativas que são removidas, incluindo as seguintes colunas:

  • Iniciador
  • InstanceId
  • ModelId
  • Carga
  • StartComment
  • 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 somente 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

  • Execução seca: (Opcional) Especifique um valor de true para ver os resultados da operação sem realmente executar a operação. O valor padrão de false 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 quando você fizer uso intenso de workflows. Você pode limpar instâncias concluídas para 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 que o fluxo de trabalho foi concluído: O número de dias em que as instâncias do fluxo de trabalho foram concluídas.

  • Execução seca: (Opcional) Especifique um valor de true para ver os resultados da operação sem realmente executar a operação. O valor padrão de false 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
  • StartComment
  • WorkflowTitle

Repositório

Informações sobre o repositório CRX

• Domínio: com.adobe.granite
• Tipo: Repositório

Atributos

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.

CustomerName O nome do cliente para o qual a licença de software é emitida. Somente leitura.

LicenseKey A chave de licença exclusiva para esta instalação do repositório. Somente leitura.

EspaçoDiscoDisponível 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 de uma vez. Somente leitura.

SessionTracker O valor da variável do 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 as propriedades do repositório. Todas as propriedades são somente leitura.

Chave	Valor
option.node.and.property.with.same.name.supported	Indica se um nó e uma propriedade do nó podem ter o mesmo nome. true indica que os mesmos nomes são suportados, false indica que não é suportado.
identifier.stability	Indica a estabilidade de identificadores de nós não referenciáveis. Os seguintes valores são possíveis: identifier.stability.indefined.duration: Os identificadores não são alterados. identifier.stability.method.duration: Os identificadores podem mudar entre chamadas de método. identifier.stability.save.duration: Os identificadores não são alterados em um ciclo de salvamento/atualização. identifier.stability.session.duration: Os identificadores não são alterados durante uma sessão.
query.xpath.pos.index	Indica se a linguagem de consulta JCR 1.0 XPath é compatível. true indica suporte e false indica que não há suporte.
crx.repository.systemid	O identificador do sistema, conforme encontrado no arquivo system.id.
option.query.sql.supported	Indica se a linguagem de consulta JCR 1.0 XPath é compatível. true indica suporte e false indica que não há suporte.
jcr.repository.version	A versão da implementação do repositório.
option.update.primary.node.type.supported	Indica se o tipo de nó primário de um nó pode ser alterado. true indica que você pode alterar o tipo de nó primário e false indica que a alteração não é suportada.
option.node.type.management.supported	Indica se o gerenciamento de tipo de nó é compatível. true indica que é compatível, e false indica que não há suporte.
node.type.management.overrides.supported	Indica se você pode substituir a propriedade herdada ou a definição do nó filho de um tipo de nó. true indica que as substituições são suportadas e false indica que não há substituições.
option.observation.supported	true indica que há suporte para a observação assíncrona de alterações no repositório. O suporte à observação assíncrona permite que os aplicativos recebam e respondam às notificações sobre cada alteração à medida que elas ocorrerem.
query.jcrscore	true indica que a pseudo-propriedade jcr:score está disponível em queries XPath e SQL que incluem uma função jcrfn:contains (in XPath) ou CONTAINS (in SQL) para executar uma pesquisa de texto completo.
option.simple.versioning.supported	true indica que o repositório suporta o controle de versão simples. Com o controle de versão simples, o repositório mantém uma série sequencial de versões de um nó.
option.workspace.management.supported	true indica que o repositório oferece suporte à criação e exclusão de espaços de trabalho usando APIs.
option.update.mixin.node.types.supported	true indica que o repositório suporta a adição e remoção de tipos de nó mixin de um nó existente.
node.type.management.primary.item.name.supported	true indica que o repositório permite que as definições de nó contenham um item principal como filho. Um item principal pode ser acessado usando a API sem conhecer o nome do item.
level.2.supported	true indica que LEVEL_1_SUPPORTED e OPTION_XML_IMPORT_SUPPORTED são verdadeiros.
write.supported	true indica que o repositório fornece acesso de gravação usando a API. false indica acesso somente leitura.
node.type.management.update.in.use.supported	true indica que você pode alterar as definições de nó que estão em uso pelos nós existentes.
jcr.specification.version	A versão da especificação do JCR que o repositório implementa.
option.journaled.observation.supported	true indica que os aplicativos podem executar a observação em diário do repositório. com a observação em diário, pode ser obtido um conjunto de notificações de variações por um período específico.
query.languages	Os idiomas de consulta compatíveis com o repositório. Nenhum valor indica que não há suporte para consulta.
option.xml.export.supported	true indica que o repositório suporta a exportação de nós como código XML.
node.type.management.multiple.binary.properties.supported	true indica que o repositório suporta o registro de tipos de nó que têm várias propriedades binárias. falso indica que uma única propriedade binária é suportada para um tipo de nó.
option.access.control.supported	true indica que o repositório suporta o controle de acesso, para definir e determinar os privilégios de usuário para o acesso ao nó.
option.baselines.supported	true indica que o repositório suporta tanto configurações quanto linhas de base.
option.shareable.nodes.supported	true indica que o repositório oferece suporte à criação de nós compartilháveis.
crx.cluster.id	O identificador do cluster de repositório.
query.stored.queries.supported	true indica que o repositório suporta consultas armazenadas.
query.full.text.search.supported	true indica que o repositório suporta pesquisa de texto completo.
node.type.management.inheritance	Indica o nível de suporte do repositório para herança do tipo de nó. Os seguintes valores são possíveis: node.type.management.hereitance.Minimum: O registro dos tipos de nó primário é limitado àqueles que têm somente nt:base como um supertipo. O registro de tipos de nó mixin é limitado aos que não têm supertipo. node.type.management.herança.single: O registro dos tipos de nó primário é limitado aos que possuem um supertipo. O registro de tipos de nó mixin é limitado aos que têm no máximo um supertipo. node.type.management.herança.multiple: Os tipos de nós primários podem ser registrados com um ou mais supertipos. Os tipos de nó Mixin podem ser registrados com zero ou mais supertipos.
crx.cluster.preferredMaster	true indica que este nó de cluster é o principal preferencial do cluster.
option.transactions.supported	true indica que o repositório suporta transações.
jcr.repository.vendor.url	O URL do fornecedor do repositório.
node.type.management.value.constraints.supported	true indica que o repositório suporta restrições de valor para propriedades de nó.
node.type.management.property.types	uma matriz de constantes javax.jcr.PropertyType que representam os tipos de propriedade que um tipo de nó registrado pode especificar. Uma matriz de comprimento zero indica que os tipos de nó registrados não podem especificar definições de propriedade. Os tipos de propriedades são STRING, URI, BOOLEANO, LONGO, DUPLO, DECIMAL, BINÁRIO, DATE, NAME, PATH, WEAKREFERENCE, REFERENCE e UNDEFINED (se suportado)
node.type.management.orderable.child.nodes.supported	true indica que o repositório oferece suporte à preservação da ordem dos nós filhos.
jcr.repository.vendor	O nome do fornecedor do repositório.
query.joins	O nível de suporte para associações em consultas. Os seguintes valores são possíveis: query.joins.none: Sem suporte para associações. As consultas podem usar um seletor. query.joins.inner: Suporte para associações internas. query.joins.inner.outer: Suporte para associações internas e externas.
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order	true indica que o repositório suporta a linguagem de consulta XPath 1.0.
query.jcrpath
option.xml.import.supported	true indica que o repositório suporta a importação do código XML como conteúdo.
node.type.management.same.name.siblings.supported	true indica que o repositório suporta nós irmãos (nós com o mesmo pai) com os mesmos nomes.
node.type.management.residual.definitions.supported	true indica que o repositório oferece suporte a propriedades name com definições residuais. Quando suportado, o atributo name de uma definição de item pode ser um asterisco ("*").
node.type.management.autocreated.definitions.supported	true indica que o repositório oferece suporte à criação automática de itens filhos (nós ou propriedades) de um nó quando esse nó for criado.
crx.cluster.master	true indica que esse nó de repositório é o nó principal do cluster.
level.1.supported	true indica que option.xml.export.support é verdadeiro e query.languages tem comprimento diferente de zero.
option.unfiled.content.supported	true indica que o repositório suporta conteúdo não arquivado. Os nós não arquivados não fazem parte da hierarquia do repositório.
jcr.specification.name	O nome da especificação JCR que o repositório implementa.
option.versioning.supported	true indica que o repositório suporta o controle de versão completo.
jcr.repository.name	O nome do repositório.
option.locking.supported	true indica que o repositório suporta o bloqueio de nós. O bloqueio permite que um usuário impeça temporariamente outros usuários de fazer alterações.
jcr.repository.version.display
option.activities.supported	true indica que o repositório suporta atividades. Atividades são um conjunto de alterações que são executadas em um espaço de trabalho que são mescladas em outro espaço de trabalho.
node.type.management.multivalued.properties.supported	true indica que o repositório suporta propriedades de nó que podem ter zero ou mais valores.
option.retention.supported	true indica que o repositório suporta o uso de aplicativos de gerenciamento de retenção externos para aplicar políticas de retenção ao conteúdo e suporta retenção e liberação.
option.lifecycle.supported	true indica que o repositório suporta o gerenciamento do ciclo de vida.

WorkspaceNames Os nomes dos espaços de trabalho no repositório. Somente leitura.

DataStoreGarbageCollectionDelay O tempo em milissegundos que a coleta de lixo dorme após a varredura de cada décimo nó. Leitura/gravação.

BackupDelay O tempo em milissegundos que o processo de backup permanece 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, a porcentagem de todos os arquivos que foram submetidos a 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 que 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: Ocorreu um erro durante a cópia de segurança. 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 O tempo em milissegundos que o processo de otimização do TAR dorme entre cada etapa do processo. Leitura/gravação.

ClusterProperties Um conjunto de pares de valores chave que representam propriedades e valores do cluster. Cada linha na tabela representa uma propriedade de cluster. Somente leitura.

ClusterNodes Os membros do cluster de repositório.

ClusterId O identificador deste cluster de repositório. Somente leitura.

ClusterMasterId O identificador do nó principal deste cluster de repositório. Somente leitura.

ClusterNodeId O identificador deste nó do cluster de repositório. Somente leitura.

Operações

createWorkspace Cria um espaço de trabalho neste repositório.

• Argumentos:

  • name: Um valor 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 de repositório não utilizados devem ser excluídos. Um valor true causa a exclusão de nós e propriedades não utilizados. Um valor false faz com que todos os nós sejam digitalizados, mas nenhum é excluído.

• Valor retornado: nenhum

stopDataStoreGarbageCollection Interrompe uma coleta de lixo do 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) A String que representa o nome do arquivo ZIP ou diretório no qual arquivar os dados do repositório. Para usar um arquivo ZIP, inclua a extensão de nome de arquivo ZIP. Para usar um diretório, não inclua nenhuma extensão de nome de arquivo.

    Para executar um backup incremental, especifique o diretório que foi usado anteriormente para o backup.

    Você pode especificar um caminho absoluto ou relativo. Caminhos relativos são relativos ao pai do diretório crx-quickstart.

    Quando nenhum valor é especificado, o valor padrão de backup-currentdate.zip é utilizada, em que currentdate está no formato yyyyMMdd-HHmm.

• Valor retornado: nenhum

cancelBackup Interrompe o processo de backup atual e exclui o arquivo temporário criado pelo processo para arquivamento de 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 do 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 de arquivo TAR usando o valor padrão para tarOtimizationDelay.

• Argumentos: nenhum
• Valor retornado: nenhum

stopTarOtimization Interrompe a otimização do arquivo TAR.

• Argumentos: nenhum
• Valor retornado: nenhum

tarIndexMerge Une os arquivos de índice principais de todos os conjuntos TAR. Os principais arquivos de índice são arquivos com versões principais diferentes. 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 que foram 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 booleano 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

becomeClusterMaster Define esse nó do repositório como o nó principal do cluster. Se ainda não for principal, esse comando interrompe o ouvinte da instância principal atual e inicia um ouvinte principal no nó atual. Esse nó é então definido como o nó principal e reiniciado, fazendo com que todos os outros nós no cluster (ou seja, aqueles que são controlados pelo principal) 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 principal. Você deve fornecer 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 string que representa o endereço IP ou o nome do computador que executa o nó do repositório principal.
  • username: O nome a ser usado para autenticar com o cluster.
  • password: A senha a ser usada para autenticação.

• Valor retornado: nenhum

traversalCheck Atravessa 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 sobre Gerentes de persistência.

consistencyCheck Verifica e, opcionalmente, corrige a consistência no armazenamento de dados. Isso é abordado em detalhes completos na documentação do armazenamento de dados.

Estatísticas do Repositório (TimeSeries)

O valor do campo TimeSeries para cada tipo de estatística que org.apache.jackrabbit.api.stats.RepositoryStatistics define.

• Domínio: com.adobe.granite

• Tipo: TimeSeries

• Nome: Um dos seguintes valores da variável org.apache.jackrabbit.api.stats.RepositoryStatistics.Type Classe Enum:

  • 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

Os atributos a seguir são fornecidos para cada tipo de estatística reportada:

• Valor por segundo: O valor medido por segundo no último minuto. Somente leitura.
• Valor por minuto: O valor medido por minuto durante a última hora. Somente leitura.
• Valor porHora: O valor medido por hora na última semana. Somente leitura.
• Valor por semana: O valor por semana medido nos últimos três anos. Somente leitura.

Estatísticas de consulta do repositório

Informações estatísticas sobre consultas de repositório.

• Domínio: com.adobe.granite
• Tipo: QueryStat

Atributos

SlowQueries Informações sobre as consultas do repositório que demoraram mais tempo para serem concluídas. Somente leitura.

SlowQueriesQueueSize O número máximo de consultas a incluir na lista SlowQueries. Leitura e 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 de Consultas Populares. Leitura e gravação.

Operações

clearSlowQueriesQueue Remove todas as consultas da lista SlowQueries.

• Argumentos: nenhum
• Valor retornado: nenhum

clearPopularQueriesQueue Remove todas as consultas da lista de Consultas Populares.

• Argumentos: nenhum
• Valor retornado: nenhum

Agentes de replicação

Monitore os serviços de 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: sem valor
• Propriedades: {id="Nome"}, onde Nome é o valor da propriedade Nome do agente.

Atributos

Id Um valor String 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 booleano que indica se o agente está configurado corretamente:

• true: Configuração válida.
• false : A configuração contém erros.

Somente leitura.

Ativado Um valor booleano que indica se o agente está ativado:

• true: Ativado.
• false: Desativado.

QueueBlocked Um valor booleano 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 booleano que indica se a fila de trabalhos está pausada:

• true: Pausado (suspenso)
• false: Não pausado ou não existe.

Leitura e 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 ao tempo em que a página foi carregada. Somente leitura.

QueueNextRetryTime Para filas bloqueadas, um valor Date 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 Date que indica quando o processamento começou para a tarefa atual. Quando nenhuma hora for exibida, a fila será bloqueada ou inativa. Somente leitura.

QueueLastProcessTime Um valor Date que indica quando o trabalho anterior foi concluído. Somente leitura.

Operações

queueForceRetry Para filas bloqueadas, emite o comando retentar para a fila.

• Argumentos: nenhum
• Valor retornado: nenhum

queueClear Remove todos os trabalhos da fila.

• Argumentos: nenhum
• Valor retornado: nenhum

Mecanismo Sling

Fornece estatísticas sobre solicitações HTTP para que você possa monitorar o desempenho do serviço SlingRequestProcessor .

• Domínio: org.apache.sling
• Tipo: motor
• Propriedades:

Atributos

RequestsCount O número de solicitações que ocorreram desde a última redefinição das estatísticas.

MinRequestDurationMsec O menor tempo (em milissegundos) necessário para processar uma solicitação desde que as estatísticas foram redefinidas pela última vez.

MaxRequestDurationMsec O maior período de tempo (em milissegundos) necessário 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 O tempo médio necessário para processar uma solicitação. A média é calculada usando todas as solicitações desde que as estatísticas foram redefinidas pela última vez

Operações

resetStatistics Define todas as estatísticas como 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 string da ID do pacote.

instalado Um valor booleano que indica se o pacote está instalado:

• true: Instalado.
• false: Não instalado.

installedBy A ID 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 contém o tamanho do pacote em bytes.

Início rápido do Launcher

Informações sobre o processo de inicialização e o iniciador do Quickstart.

• Domínio: com.adobe.granite.quickstart
• Tipo: Iniciador

Operações

log

Exibe uma mensagem na janela QuickStart .

Argumentos:

• p1: A String que representa a mensagem a ser exibida.
• Valor retornado: nenhum

startupFinished

Chama o método startupFinished do iniciador 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% de conclusão.
• Valor retornado: nenhum.

Serviços de terceiros

Vários recursos de servidores 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.

Domínio	Tipo	Classe MBean
Implementação do JMI	MBeanServerDelegate	javax.management.MBeanServerDelegate
com.sun.management	HotSpotDiagnostic	com.sun.management.HotSpotDiagnosticMXBean
java.lang	ClassLoading Compilação GarbageCollector Memória MemoryManager MemoryPool OperatingSystem Tempo de execução Threading	javax.management pacote
java.util.logging		java.util.logging.LoggingMXBean
osgi.core	bundleState estrutura packageState serviceState	org.osgi.jmx.framework pacote

Uso do Console JMX

O Console JMX exibe informações sobre vários serviços que estão sendo executados no servidor:

• Atributos: Propriedades do 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 você pode invocar no serviço.

Os MBeans que são implantados com um serviço OSGi expõem os atributos e as operações do serviço ao console. O MBean determina os atributos e as operações expostas 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.

1. Abra o Console da Web e clique na guia JMX. (http://localhost:4502/system/console/jmx)
2. Clique em um valor de célula para um serviço para ver os atributos e as operações do serviço.
3. Para alterar um valor de atributo, clique no valor, especifique o valor na caixa de diálogo exibida e clique em Salvar.
4. Para invocar 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 Invocar.

Uso de aplicativos JMX externos para monitoramento

O CRX permite que aplicativos externos interajam com o Managed Beans (MBeans) via JMX (Java Management Extensions). Uso de consoles genéricos como JConsole Para aplicativos de monitoramento específicos de domínio, o permite obter e definir configurações e propriedades do CRX, bem como monitorar o desempenho e o uso de recursos.

Uso do JConsole para conexão com o CRX

Para se conectar ao CRX usando o JConsole, siga estas etapas:

1. Abra uma janela de terminal.

2. Digite o seguinte comando:

   jconsole

O JConsole será iniciado e a janela JConsole será exibida.

Conectar-se a um processo CRX local

O JConsole exibirá uma lista de processos locais do Java Virtual Machine. A lista conterá dois processos de início rápido. Selecione o processo "CHILD" de início rápido na lista de processos locais (geralmente aquele com o PID mais alto).

Conectando-se a um processo CRX remoto

Para se conectar a um processo CRX remoto, a JVM que hospeda o processo CRX remoto precisará ser habilitada para aceitar conexões JMX remotas.

Para habilitar 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, definir essa propriedade publica um conector RMI adicional em um registro privado somente leitura na porta especificada usando um nome bem conhecido, "jmxrmi".

Por padrão, quando você habilita 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 VM Java:

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

Depois de se conectar ao processo de início rápido, o JConsole fornece uma variedade de ferramentas de monitoramento gerais 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 Atributos ou Operações na qual você 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.