JMX 콘솔을 사용하여 서버 리소스 모니터링 monitoring-server-resources-using-the-jmx-console

JMX 콘솔을 사용하면 CRX 서버에서 서비스를 모니터링하고 관리할 수 있습니다. 다음 섹션에서는 JMX 프레임워크를 통해 노출된 속성 및 작업을 요약합니다.

콘솔 컨트롤 사용 방법에 대한 자세한 내용은 JMX 콘솔 사용. JMX에 대한 배경 정보는 JMX(Java Management Extensions) 기술 oracle 웹 사이트의 페이지.

JMX 콘솔을 사용하여 서비스를 관리할 MBean 만들기에 대한 자세한 내용은 JMX 콘솔과 서비스 통합.

워크플로우 유지 관리 workflow-maintenance

실행, 완료, 부실 및 실패한 워크플로우 인스턴스를 관리하는 작업입니다.

작업 operations

listRunningWorkflowsPerModel 각 워크플로우 모델에 대해 실행 중인 워크플로우 인스턴스 수를 나열합니다.

listCompletedWorkflowsPerModel 각 워크플로우 모델에 대해 완료된 워크플로우 인스턴스 수를 나열합니다.

returnWorkflowQueueInfo 처리를 위해 큐에 올라가 있는 워크플로우 항목에 대한 정보를 나열합니다.

returnWorkflowJobTopicInfo 주제별로 구성된 워크플로우 작업의 처리 정보를 나열합니다.

returnFailedWorkflowCount 실패한 워크플로우 인스턴스 수를 표시합니다. 모든 워크플로우 모델에 대한 정보를 쿼리하거나 검색할 워크플로우 모델을 지정할 수 있습니다.

returnFailedWorkflowCountPerModel 각 워크플로우 모델에 대해 실패한 워크플로우 인스턴스 수를 표시합니다.

terminateFailedInstances 실패한 워크플로우 인스턴스를 종료합니다. 실패한 모든 인스턴스를 종료하거나 특정 모델에 대해 실패한 인스턴스만 종료할 수 있습니다. 원할 경우 인스턴스가 종료된 후 인스턴스를 다시 시작할 수 있습니다. 작업을 실제로 수행하지 않고 결과를 보기 위해 작업을 테스트할 수도 있습니다.

retryFailedWorkItems 실패한 작업 항목 단계 실행을 시도합니다. 실패한 모든 작업 항목을 다시 시도하거나 특정 워크플로우 모델에 대해 실패한 작업 항목만 다시 시도할 수 있습니다. 작업을 실제로 수행하지 않고 결과를 보기 위해 작업을 선택적으로 테스트할 수 있습니다.

PurgeActive 특정 페이지의 활성 워크플로우 인스턴스를 제거합니다. 모든 모델의 활성 인스턴스 또는 특정 모델의 인스턴스만 제거할 수 있습니다. 작업을 실제로 수행하지 않고도 작업을 테스트하여 결과를 확인할 수도 있습니다.

countStaleWorkflows 오래된 워크플로우 인스턴스 수를 반환합니다. 모든 워크플로우 모델 또는 특정 모델에 대한 오래된 인스턴스 수를 검색할 수 있습니다.

restartStaleWorkflows 오래된 워크플로우 인스턴스를 다시 시작합니다. 모든 오래된 인스턴스 또는 특정 모델의 오래된 인스턴스만 다시 시작할 수 있습니다. 작업을 실제로 수행하지 않고 결과를 보기 위해 작업을 테스트할 수도 있습니다.

fetchModelList 모든 워크플로우 모델을 나열합니다.

countRunningWorkflows 실행 중인 워크플로우 인스턴스 수를 반환합니다. 모든 워크플로우 모델 또는 특정 모델에 대해 실행 중인 인스턴스 수를 검색할 수 있습니다.

countCompletedWorkflows 완료된 워크플로우 인스턴스 수를 반환합니다. 모든 워크플로우 모델 또는 특정 모델에 대해 완료된 인스턴스 수를 검색할 수 있습니다.

purgeCompleted 저장소에서 특정 페이지의 완료된 워크플로우의 레코드를 제거합니다. 워크플로우를 많이 사용할 때 저장소의 크기를 최소화하기 위해 이 작업을 주기적으로 사용합니다. 모든 모델에 대해 완료된 인스턴스 또는 특정 모델의 인스턴스만 제거할 수 있습니다. 작업을 실제로 수행하지 않고도 작업을 테스트하여 결과를 확인할 수도 있습니다.

저장소 repository

CRX 저장소 정보

속성 attributes

이름 JCR 저장소 구현의 이름입니다. 읽기 전용.

버전 저장소 구현 버전입니다. 읽기 전용.

HomeDir 저장소가 있는 디렉토리입니다. 기본 위치는 입니다. <quickstart_jar_location>/crx-quickstart/repository. 읽기 전용.

CustomerName 소프트웨어 라이센스가 발급된 고객의 이름입니다. 읽기 전용.

LicenseKey 이 저장소 설치에 대한 고유 라이센스 키입니다. 읽기 전용.

사용 가능한 디스크 공간 저장소의 이 인스턴스에 사용할 수 있는 디스크 공간(MB)입니다. 읽기 전용.

MaximumNumberOfOpenFiles 한 번에 열 수 있는 파일 수입니다. 읽기 전용.

SessionTracker crx.debug.sessions 시스템 변수의 값입니다. true는 디버그 세션을 나타냅니다. false는 일반 세션을 나타냅니다. 읽기/쓰기.

설명자 저장소 속성을 나타내는 키-값 쌍 집합입니다. 모든 속성은 읽기 전용입니다.

작업 공간 이름 저장소의 작업 공간 이름 읽기 전용.

DataStoreGarbageCollectionDelay 가비지 수집이 10번째 노드를 스캔한 후 일시 중지된 시간(밀리초)입니다. 읽기/쓰기.

BackupDelay 백업 프로세스가 각 백업 단계 사이에서 대기하는 시간(밀리초)입니다. 읽기/쓰기.

백업 진행 중 값이 true이면 백업 프로세스가 실행 중임을 나타냅니다. 읽기 전용.

백업 진행률 현재 백업의 경우 백업된 모든 파일의 백분율입니다. 읽기 전용.

현재 백업 대상 현재 백업의 경우 백업 파일이 저장되는 ZIP 파일입니다. 백업이 진행 중이 아니면 값이 표시되지 않습니다. 읽기 전용.

BackupWasSuccessful 값이 true이면 현재 백업 중에 오류가 발생하지 않았거나 진행 중인 백업이 없음을 나타냅니다. false는 현재 백업 중에 오류가 발생했음을 나타냅니다. 읽기 전용.

백업 결과 현재 백업의 상태입니다. 다음 값을 사용할 수 있습니다.

읽기 전용.

TarOptimizationRunningSince 현재 TAR 파일 최적화 프로세스가 시작된 시간입니다. 읽기 전용.

TarOptimizationDelay TAR 최적화 프로세스가 프로세스의 각 단계 사이에서 잠기는 시간(밀리초)입니다. 읽기/쓰기.

ClusterProperties 클러스터 속성 및 값을 나타내는 키-값 쌍 집합입니다. 테이블의 각 행은 클러스터 속성을 나타냅니다. 읽기 전용.

ClusterNodes 저장소 클러스터의 멤버입니다.

ClusterId 이 저장소 클러스터의 식별자입니다. 읽기 전용.

ClusterMasterId 이 저장소 클러스터의 마스터 노드의 식별자입니다. 읽기 전용.

ClusterNodeId 저장소 클러스터의 이 노드의 식별자입니다. 읽기 전용.

작업 operations-1

createWorkspace 이 저장소에 작업 공간을 만듭니다.

runDataStoreGarbageCollection 저장소 노드에서 가비지 수집을 실행합니다.

stopDataStoreGarbageCollection 실행 중인 데이터 저장소 가비지 수집을 중지합니다.

startBackup ZIP 파일로 저장소 데이터를 백업합니다.

cancelBackup 현재 백업 프로세스를 중지하고 데이터를 보관하기 위해 생성되는 임시 아카이브를 삭제합니다.

blockRepositoryWrites 저장소 데이터의 변경 내용을 차단합니다. 모든 저장소 백업 리스너는 블록에 대한 알림을 받습니다.

unlockedRepositoryWrites 저장소에서 블록을 제거합니다. 모든 저장소 백업 리스너는 블록 제거에 대한 알림을 받습니다.

startTarOptimization tarOptimizationDelay 기본값을 사용하여 TAR 파일 최적화 프로세스를 시작합니다.

stopTarOptimization TAR 파일 최적화를 중지합니다.

tarIndexMerge 모든 TAR 집합의 상위 인덱스 파일을 병합합니다. 상위 인덱스 파일은 다른 주요 버전을 사용하는 파일입니다. 예를 들어 다음 파일은 index_3_1.tar 파일에 병합됩니다. index_1_1.tar, index_2_0.tar, index_3_0.tar. 병합된 파일이 삭제됩니다(이전 예에서 index_1_1.tar, index_2_0.tar 및 index_3_0.tar는 삭제됨).

beClusterMaster 이 저장소 노드를 클러스터의 마스터 노드로 설정합니다. 아직 마스터가 아닌 경우 이 명령은 현재 마스터 인스턴스의 리스너를 중지하고 현재 노드에서 마스터 리스너를 시작합니다. 그러면 이 노드가 마스터 노드로 설정되고 다시 시작되어 클러스터의 다른 모든 노드(즉, 마스터에서 제어하는 노드)가 이 인스턴스에 접속됩니다.

joinCluster 이 저장소를 클러스터 마스터에서 제어하는 노드로 클러스터에 추가합니다. 인증을 위해 사용자 이름과 암호를 입력해야 합니다. 연결은 기본 인증을 사용합니다. 보안 자격 증명은 서버로 전송되기 전에 base-64로 인코딩됩니다.

trackCheck 특정 노드에서 시작되는 하위 트리의 불일치를 추적하고 선택적으로 수정합니다. 이 내용은 지속성 관리자에 대한 설명서에서 자세히 다룹니다.

consistencyCheck 데이터 저장소에서 일관성을 확인하고 선택적으로 수정합니다. 이 내용은 데이터 저장소의 설명서에서 자세히 다룹니다.

저장소 통계(시계열) repository-statistics-timeseries

각 통계 유형에 대한 시계열 필드의 값 org.apache.jackrabbit.api.stats.RepositoryStatistics 을 정의합니다.

속성 attributes-1

보고된 각 통계 유형에 대해 다음 속성이 제공됩니다.

저장소 쿼리 상태 repository-query-stats

저장소 쿼리에 대한 통계 정보입니다.

속성 attributes-2

SlowQueries 완료하는 데 가장 오랜 시간이 걸린 리포지토리 쿼리에 대한 정보입니다. 읽기 전용.

SlowQueriesQueueSize SlowQueries 목록에 포함할 최대 쿼리 수입니다. 읽기-쓰기.

PopularQueries 가장 많이 발생한 저장소 쿼리에 대한 정보입니다. 읽기 전용.

PopularQueriesQueueSize PopularQueries 목록의 최대 쿼리 수입니다. 읽기-쓰기.

작업 operations-2

clearSlowQueriesQueue SlowQueries 목록에서 모든 쿼리를 제거합니다.

clearPopularQueriesQueue PopularQueries 목록에서 모든 쿼리를 제거합니다.

복제 에이전트 replication-agents

각 복제 에이전트에 대한 서비스를 모니터링합니다. 복제 에이전트를 만들면 서비스가 JMX 콘솔에 자동으로 나타납니다.

속성 attributes-3

Id 복제 에이전트 구성의 식별자를 나타내는 문자열 값입니다. 여러 에이전트가 동일한 구성을 사용할 수 있습니다. 읽기 전용.

유효한 에이전트가 올바르게 구성되었는지 여부를 나타내는 부울 값:

읽기 전용.

활성화됨 에이전트가 활성화되었는지 여부를 나타내는 부울 값:

QueueBlocked 큐가 존재하며 차단되었는지 여부를 나타내는 부울 값:

읽기 전용.

대기열일시 중지됨 작업 큐가 일시 중지되었는지 여부를 나타내는 부울 값:

읽기-쓰기.

QueueNumEntries 에이전트 큐의 작업 수를 나타내는 int 값입니다. 읽기 전용.

QueueStatusTime 표시된 상태 값을 가져올 서버의 시간을 나타내는 날짜 값입니다. 값은 페이지를 로드한 시간에 해당합니다. 읽기 전용.

QueueNextRetryTime 차단된 큐의 경우 다음 자동 재시도가 발생하는 시기를 나타내는 날짜 값입니다. 시간이 나타나지 않으면 큐가 차단되지 않습니다. 읽기 전용.

QueueProcessingSince 현재 작업에 대한 처리가 시작된 시기를 나타내는 날짜 값입니다. 시간이 나타나지 않으면 큐가 차단되거나 유휴 상태가 됩니다. 읽기 전용.

QueueLastProcessTime 이전 작업이 완료된 시기를 나타내는 날짜 값입니다. 읽기 전용.

작업 operations-3

queueForceRetry 차단된 큐의 경우 다시 시도 명령을 큐에 실행합니다.

queueClear 큐에서 모든 작업을 제거합니다.

Sling 엔진 sling-engine

SlingRequestProcessor 서비스의 성능을 모니터링할 수 있도록 HTTP 요청에 대한 통계를 제공합니다.

속성 attributes-4

RequestsCount 통계가 마지막으로 재설정된 이후 발생한 요청 수입니다.

MinRequestDurationMsec 통계가 마지막으로 재설정된 이후 요청을 처리하는 데 필요한 가장 짧은 시간(밀리초)입니다.

MaxRequestDurationMsec 통계가 마지막으로 재설정된 이후 요청을 처리하는 데 필요한 가장 긴 시간(밀리초)입니다.

표준 편차 기간(M) 요청을 처리하는 데 필요한 시간의 표준 편차입니다. 표준 편차는 통계가 마지막으로 재설정된 이후 모든 요청을 사용하여 계산됩니다.

MeanRequestDurationMsec 요청을 처리하는 데 필요한 평균 시간입니다. 평균은 통계가 마지막으로 재설정된 이후의 모든 요청을 사용하여 계산됩니다

작업 operations-4

resetStatistics 모든 통계를 0으로 설정합니다. 특정 기간 동안 요청 처리 성능을 분석해야 하는 경우 통계를 재설정합니다.

패키지 관리자 package-manager

패키지 관리자에 포함된 모든 패키지에 대한 정보입니다.

Quickstart 시작 관리자 quickstart-launcher

시작 프로세스 및 Quickstart 실행 프로그램에 대한 정보입니다.

작업 operations-5

로그

빠른 시작 창에 메시지를 표시합니다.

인수:

startupFinished

서버 실행 프로그램의 startupFinished 메서드를 호출합니다. 이 메서드는 웹 브라우저에서 시작 페이지를 열려고 시도합니다.

startupProgress

서버 시작 프로세스의 완료 값을 설정합니다. QuickStart 창의 진행률 표시줄은 완료 값을 나타냅니다.

타사 서비스 third-party-services

여러 타사 서버 리소스는 속성 및 작업을 JMX 콘솔에 표시하는 MBeans를 설치합니다. 다음 표는 타사 리소스를 나열하고 자세한 정보에 대한 링크를 제공합니다.

JMX 콘솔 사용 using-the-jmx-console

JMX 콘솔은 서버에서 실행 중인 여러 서비스에 대한 정보를 표시합니다.

OSGi 서비스와 함께 배포되는 MBean은 서비스 속성 및 작업을 콘솔에 표시합니다. MBean은 노출된 속성 및 작업과 속성이 읽기 전용인지 읽기/쓰인지를 결정합니다.

JMX 콘솔의 기본 페이지에는 서비스 테이블이 포함되어 있습니다. 테이블의 각 행은 MBean으로 노출되는 서비스를 나타냅니다.

모니터링을 위한 외부 JMX 애플리케이션 사용 using-external-jmx-applications-for-monitoring

CRX를 통해 외부 애플리케이션이 관리되는 Bean(MBeans)과 상호 작용할 수 있습니다. JMX(Java Management Extensions). 과 같은 일반 콘솔 사용 JConsole 또는 도메인별 모니터링 응용 프로그램을 사용하면 CRX 구성 및 속성을 가져오고 설정할 수 있을 뿐만 아니라 성능 및 리소스 사용량을 모니터링할 수 있습니다.

JConsole을 사용하여 CRX에 연결 using-jconsole-to-connect-to-crx

JConsole을 사용하여 CRX에 연결하려면 다음 단계를 따르십시오.

JConsole이 시작되고 JConsole 창이 나타납니다.

로컬 CRX 프로세스에 연결 connecting-to-a-local-crx-process

JConsole에 로컬 Java 가상 컴퓨터 프로세스 목록이 표시됩니다. 목록에는 두 개의 빠른 시작 프로세스가 포함됩니다. 로컬 프로세스 목록에서 빠른 시작 "하위" 프로세스를 선택합니다(일반적으로 높은 PID가 있는 프로세스).

원격 CRX 프로세스에 연결 connecting-to-a-remote-crx-process

원격 CRX 프로세스에 연결하려면 원격 CRX 프로세스를 호스팅하는 JVM을 사용하여 원격 JMX 연결을 허용해야 합니다.

원격 JMX 연결을 활성화하려면 JVM을 시작할 때 다음 시스템 속성을 설정해야 합니다.

com.sun.management.jmxremote.port=portNum

위의 속성에서, portNum 는 JMX RMI 연결을 활성화할 포트 번호입니다. 사용하지 않은 포트 번호를 지정해야 합니다. 이 속성을 설정하면 로컬 액세스를 위해 RMI 커넥터를 게시하는 것 외에도 잘 알려진 이름 "jmxrmi"를 사용하여 지정된 포트의 개인 읽기 전용 레지스트리에 추가 RMI 커넥터를 게시합니다.

기본적으로 원격 모니터링용 JMX 에이전트를 활성화하는 경우, Java VM을 시작할 때 다음 시스템 속성을 사용하여 지정해야 하는 암호 파일을 기반으로 암호 인증을 사용합니다.

com.sun.management.jmxremote.password.file=pwFilePath

자세한 내용은 관련 JMX 설명서 암호 파일 설정에 대한 자세한 지침

예:

$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

CRX에서 제공하는 MBeans 사용 using-the-mbeans-provided-by-crx

빠른 시작 프로세스에 접속한 후 JConsole은 CRX가 실행 중인 JVM을 위한 다양한 일반 모니터링 도구를 제공합니다.

CRX의 내부 모니터링 및 구성 옵션에 액세스하려면 MBeans 탭으로 이동한 다음 왼쪽의 계층 컨텐츠 트리에서 원하는 속성 또는 작업 섹션을 선택합니다. 예를 들어 com.adobe.granite/Repository/Operations 섹션이 있습니다.

해당 섹션 내에서 왼쪽 창에서 원하는 속성 또는 작업을 선택합니다.