작업 대시보드 operations-dashboard

쿼리 성능

이 상태 검사는 AEM 6.4에서 간소화되었으며, 이제 최근에 리팩터링된 Oak QueryStatsMBean, 특히 SlowQueries 특성을 확인합니다. 통계에 느린 쿼리가 포함되어 있으면 상태 검사가 경고를 반환합니다. 그렇지 않으면 OK 상태를 반환합니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck입니다.

관찰 큐 길이

관찰 큐 길이는 모든 이벤트 리스너 및 백그라운드 관찰자를 반복하고 해당 queueSize 을(를) maxQueueSize과(와) 비교하며 다음 작업을 수행합니다.

• queueSize 값이 maxQueueSize 값을 초과하는 경우 위험 상태를 반환합니다(이벤트가 삭제되는 경우).
• queueSize 값이 maxQueueSize * WARN_THRESHOLD보다 크면 Warn을 반환합니다(기본값 0.75).

각 큐의 최대 길이는 별도의 구성(Oak 및 AEM)에서 가져오며, 이 상태 검사에서는 구성할 수 없습니다. 이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=ObservationQueueLengthHealthCheck,type=HealthCheck입니다.

쿼리 순회 제한

쿼리 통과 제한은 QueryEngineSettingsMBean, 특히 LimitInMemory 및 LimitReads 특성을 확인하고 다음 상태를 반환합니다.

• 제한 중 하나가 다음보다 크거나 같은 경우 경고 상태 반환 Integer.MAX_VALUE
• 제한 중 하나가 10000 미만인 경우 경고 상태를 반환합니다(Oak의 권장 설정).
• QueryEngineSettings 또는 제한을 검색할 수 없는 경우 중요 상태를 반환합니다.

이 상태 검사에 대한 Mbean은 org.apache.sling.healthcheck:name=queryTraversalLimitsBundle,type=HealthCheck입니다.

동기화된 시계

이 검사는 문서 노드 저장소 클러스터에만 관련됩니다. 이 메서드는 다음 상태를 반환합니다.

• 인스턴스 시계가 동기화되지 않고 사전 정의된 낮은 임계값을 초과하면 경고 상태를 반환합니다.
• 인스턴스 시계가 동기화되지 않고 사전 정의된 상한 임계값을 초과하는 경우 위험 상태를 반환합니다.

이 상태 검사에 대한 Mbean은 org.apache.sling.healthcheck:name=slingDiscoveryOakSynchronizedCcks,type=HealthCheck입니다.

비동기 색인

비동기 인덱스 검사:

• 하나 이상의 인덱싱 레인이 실패한 경우 위험 상태를 반환합니다.

• 모든 인덱싱 레인에 대해 lastIndexedTime을(를) 확인하고 다음 작업을 수행합니다.

  • 2시간 이상 지난 경우 위험 상태를 반환합니다.
  • 2시간과 45분 사이의 경우 경고 상태를 반환합니다.
  • 45분 미만인 경우 확인 상태를 반환합니다.

• 이러한 조건이 하나도 충족되지 않으면 OK 상태를 반환합니다

위기 및 경고 상태 임계값은 모두 구성할 수 있습니다. 이 상태 검사의 Mbean은 org.apache.sling.healthcheck:name=asyncIndexHealthCheck,type=HealthCheck입니다.

참고: 이 상태 검사는 AEM 6.4에서 사용할 수 있으며 AEM 6.3.0.1로 백포팅되었습니다.

큰 Lucene 색인

이 검사는 Lucene Index StatisticsMBean에 의해 노출된 데이터를 사용하여 큰 인덱스를 식별하고 반환합니다.

• 10억 개 이상의 문서가 포함된 색인이 있는 경우 경고 상태
• 15억 개 이상의 문서가 포함된 색인이 있는 경우 위험 상태

임계값을 구성할 수 있으며 상태 검사에 대한 MBean은 org.apache.sling.healthcheck:name=largeIndexHealthCheck,type=HealthCheck.입니다.

참고: 이 검사는 AEM 6.4에서 사용할 수 있으며 AEM 6.3.2.0으로 백포팅되었습니다.

시스템 유지 관리

시스템 유지 관리는 모든 유지 관리 작업이 구성된 대로 실행 중인 경우 확인을 반환하는 복합 검사입니다. 주의 사항:

• 각 유지 관리 작업에는 관련 상태 검사가 수반됩니다.
• 유지 관리 창에 작업이 추가되지 않으면 상태 검사가 위험 을 반환합니다
• 감사 로그 및 워크플로우 제거 유지 관리 작업을 구성하거나 유지 관리 창에서 제거하십시오. 구성되지 않은 상태로 두면 이러한 작업은 첫 번째 실행 시도에서 실패하므로 시스템 유지 관리 검사는 위험 상태를 반환합니다.
• AEM 6.4 에서 Lucene 바이너리 유지 관리 작업도 확인합니다.
• AEM 6.2 이하에서 시스템 유지 관리 검사는 작업이 실행되지 않으므로 시작 직후 경고 상태를 반환합니다. 6.3부터 첫 번째 유지 관리 창에 아직 도달하지 않은 경우 OK 를 반환합니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck입니다.

복제 큐

이 검사는 복제 에이전트를 반복하고 해당 대기열을 확인합니다. 큐 맨 위에 있는 항목에 대해서는 에이전트가 복제를 다시 시도한 횟수를 확인합니다. 에이전트가 numberOfRetriesAllowed 매개 변수의 값보다 많은 복제를 다시 시도하면 경고가 반환됩니다. numberOfRetriesAllowed 매개 변수를 구성할 수 있습니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck입니다.

Sling 작업

Sling 작업은 JobManager에서 대기 중인 작업 수를 확인하고 비교합니다. maxNumQueueJobs 임계값 및:

• 큐에 maxNumQueueJobs개 이상이 있는 경우 위험 반환
• 1시간 이상 오래된 장기 실행 활성 작업이 있는 경우 위험 을 반환합니다.
• 큐에 있는 작업이 있고 마지막으로 완료된 작업 시간이 1시간보다 오래된 경우 요일을 반환합니다.

대기열에 추가된 최대 작업 수 매개 변수만 구성할 수 있으며 기본값은 1000입니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=slingJobs,type=HealthCheck입니다.

요청 성능

이 검사는 granite.request.metrics.timer Sling 지표을(를) 검사하며:

• 75번째 백분위수 값이 중요 임계값을 초과하는 경우 위험(기본값: 500밀리초) 반환
• 75번째 백분위수 값이 경고 임계값을 초과하는 경우 경고 반환(기본값은 200밀리초)

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck입니다.

오류 로그

이 검사는 로그에 오류가 있는 경우 경고 상태를 반환합니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck입니다.

디스크 공간

디스크 공간 검사는 FileStoreStatsMBean을 검사하고 노드 저장소 크기 및 노드 저장소 파티션에서 사용 가능한 디스크 공간을 검색하여 다음을 수행합니다.

• 저장소 크기 대비 사용 가능한 디스크 공간 비율이 경고 임계값보다 작은 경우 경고 를 반환합니다(기본값은 10).
• 저장소 크기 대비 사용 가능한 디스크 공간 비율이 중요 임계값보다 작은 경우 위험(기본값: 2) 반환

두 임계값 모두 구성할 수 있습니다. 이 검사는 세그먼트 스토어가 있는 인스턴스에서만 작동합니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=DiskSpaceHealthCheck,type=HealthCheck입니다.

스케줄러 상태 확인

이 검사는 인스턴스에 60초 이상 실행 중인 Quartz 작업이 있는 경우 경고를 반환합니다. 허용 가능한 기간 임계값은 구성할 수 있습니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck. 입니다.

보안 확인

보안 검사는 여러 보안 관련 검사 결과를 종합하는 합성 검사입니다. 이러한 개별 상태 검사는 보안 검사 목록 문서 페이지에서 사용할 수 있는 보안 검사 목록과 다른 문제를 해결합니다. 이 검사는 인스턴스가 시작될 때 보안 연기 테스트로 유용합니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=securitychecks,type=HealthCheck입니다.

활성 상태 번들

활성 번들은 모든 번들의 상태를 확인하고,

• 번들이 활성 상태가 아니거나 (소극적 활성화로 시작) 경우 경고 상태를 반환합니다.
• 무시 목록의 번들 상태를 무시합니다.

목록 무시 매개 변수는 구성할 수 있습니다.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck입니다.

코드 캐시 검사

Java™ 7에 있는 CodeCache 버그를 트리거할 수 있는 여러 JVM 조건을 확인하는 상태 검사:

• 인스턴스가 Java™ 7에서 실행 중이며 코드 캐시 플러시가 활성화된 경우 경고를 반환합니다.
• 인스턴스가 Java™ 7에서 실행 중이고 예약된 코드 캐시 크기가 최소 임계값보다 작은 경우 경고(기본값: 90MB)를 반환합니다.

minimum.code.cache.size 임계값을 구성할 수 있습니다. 버그에 대한 자세한 내용은 을(를) 참조한 다음 버그 ID 8012547을(를) 검색하십시오.

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=codeCacheHealthCheck,type=HealthCheck입니다.

리소스 검색 경로 오류

/apps/foundation/components/primary 경로에 리소스가 있는지 확인하고,

• 아래에 하위 노드가 있으면 경고를 반환합니다. /apps/foundation/components/primary

이 상태 검사의 MBean은 org.apache.sling.healthcheck:name=resourceSearchPathErrorHealthCheck,type=HealthCheck입니다.

granite.maintenance.isStoppable

사용자가 작업을 중지할 수 있는지 여부를 정의하는 부울 속성. 작업이 중지 가능하다고 선언하면 실행 중에 중지 여부를 확인한 다음 그에 따라 작업을 수행해야 합니다. 기본값은 false입니다.

true

옵션

granite.maintenance.mandatory

작업이 필수이고 정기적으로 실행해야 하는지 여부를 정의하는 부울 속성. 작업이 필수이지만 현재 활성 스케줄 창에 없는 경우 상태 점검 이 오류를 보고합니다. 기본값은 false입니다.

true

옵션

granite.maintenance.name

작업의 고유한 이름 - 이름은 작업을 참조하는 데 사용되며 단순한 이름입니다.

내 유지 관리 작업

필수

granite.maintenance.title

이 작업에 대해 표시된 제목

내 특별 유지 관리 작업

필수

job.topics

유지 관리 작업의 고유 주제입니다.
Apache Sling 작업 처리는 유지 관리 작업을 실행하기 위해 정확히 이 주제가 포함된 작업을 시작하고 이 주제에 대해 작업이 등록되면 실행됩니다.
항목은 com/adobe/granite/maintenance/job/(으)로 시작해야 합니다.

com/adobe/granite/maintenance/job/MyMaintenanceTask

필수

/*

* #%L

* sample-maintenance-task

* %%

* Copyright (C) 2014 Adobe

* %%

* Licensed under the Apache License, Version 2.0 (the "License");

* you may not use this file except in compliance with the License.

* You may obtain a copy of the License at

*

* https://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software

* distributed under the License is distributed on an "AS IS" BASIS,

* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

* See the License for the specific language governing permissions and

* limitations under the License.

* #L%

*/

``

package com.adobe.granite.samples.maintenance.impl;

``

import java.io.File;

import java.util.Calendar;

import java.util.Collection;

import java.util.Map;

``

import org.apache.commons.io.FileUtils;

import org.apache.commons.io.filefilter.IOFileFilter;

import org.apache.commons.io.filefilter.TrueFileFilter;

import org.apache.felix.scr.annotations.Activate;

import org.apache.felix.scr.annotations.Component;

import org.apache.felix.scr.annotations.Properties;

import org.apache.felix.scr.annotations.Property;

import org.apache.felix.scr.annotations.Service;

import org.apache.sling.commons.osgi.PropertiesUtil;

import org.apache.sling.event.jobs.Job;

import org.apache.sling.event.jobs.consumer.JobConsumer;

import org.apache.sling.event.jobs.consumer.JobExecutionContext;

import org.apache.sling.event.jobs.consumer.JobExecutionResult;

import org.apache.sling.event.jobs.consumer.JobExecutor;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

``

import com.adobe.granite.maintenance.MaintenanceConstants;

``

@Component(metatype = true,

label = "Delete Temp Files Maintenance Task",

description = "Maintatence Task which deletes files from a configurable temporary directory which have been modified in the last 24 hours.")

@Service

@Properties({

@Property(name = MaintenanceConstants.PROPERTY_TASK_NAME, value = "DeleteTempFilesTask", propertyPrivate = true),

@Property(name = MaintenanceConstants.PROPERTY_TASK_TITLE, value = "Delete Temp Files", propertyPrivate = true),

@Property(name = JobConsumer.PROPERTY_TOPICS, value = MaintenanceConstants.TASK_TOPIC_PREFIX

+ "DeleteTempFilesTask", propertyPrivate = true) })

public class DeleteTempFilesTask implements JobExecutor {

``

private static final Logger log = LoggerFactory.getLogger(DeleteTempFilesTask.class);

``

@Property(label = "Temporary Directory", description="Temporary Directory. Defaults to the java.io.tmpdir system property.")

private static final String PROP_TEMP_DIR = "temp.dir";

``

private File tempDir;

``

@Activate

private void activate(Map<string, object=""> properties) {

this.tempDir = new File(PropertiesUtil.toString(properties.get(PROP_TEMP_DIR),

System.getProperty("java.io.tmpdir")));

}

``

@Override

public JobExecutionResult process(Job job, JobExecutionContext context) {

log.info("Deleting old temp files from {}.", tempDir.getAbsolutePath());

Collection<file> files = FileUtils.listFiles(tempDir, new LastModifiedBeforeYesterdayFilter(),

TrueFileFilter.INSTANCE);

int counter = 0;

for (File file : files) {

log.debug("Deleting file {}.", file.getAbsolutePath());

counter++;

file.delete();

// TODO - capture the output of delete() and do something useful with it

}

return context.result().message(String.format("Deleted %s files.", counter)).succeeded();

}

``

/**

* IOFileFilter which filters out files which have been modified in the last 24 hours.

*

*/

private static class LastModifiedBeforeYesterdayFilter implements IOFileFilter {

``

private final long minTime;

``

private LastModifiedBeforeYesterdayFilter() {

Calendar cal = Calendar.getInstance();

cal.add(Calendar.DATE, -1);

this.minTime = cal.getTimeInMillis();

}

``

@Override

public boolean accept(File dir, String name) {

// this method is never actually called.

return false;

}

``

@Override

public boolean accept(File file) {

return file.lastModified() <= this.minTime;

}

}

``

}

<file></string,>

상태 검사

• 위험 상태의 검사 목록
• 경고 상태의 검사 목록

시각적으로 표시됨:

• 중요 검사를 위한 빨간색 태그
• 경고 수표에 대한 주황색 태그

• 상태 보고서 페이지

유지 관리 작업

• 실패한 작업 목록
• 현재 실행 중인 작업 목록
• 마지막 실행에서 성공한 작업 목록
• 실행된 적이 없는 작업 목록
• 예약되지 않은 작업 목록

시각적으로 표시됨:

• 실패한 작업에 대한 빨간색 태그
• 작업에 대한 주황색 태그(성능에 영향을 줄 수 있음)
• 다른 모든 상태에 대한 회색 태그

• 유지 관리 작업 페이지

시스템

• 운영 체제 및 OS 버전(예: macOS X)
• OperatingSystemMXBeanusable에서 검색된 시스템 로드 평균
• 디스크 공간(홈 디렉터리가 있는 파티션에 있음)
• MemoryMXBean에서 반환된 최대 더미

N/A

N/A

인스턴스

• AEM 버전
• 실행 모드 목록
• 인스턴스가 시작된 날짜

N/A

N/A

저장소

• Oak 버전

• 노드 저장소 유형(세그먼트 Tar 또는 문서)

  • 유형이 문서인 경우 문서 저장소 유형이 표시됩니다(RDB 또는 Mongo).

• 사용자 지정 데이터 저장소가 있는 경우:

  • 파일 데이터 저장소의 경우 경로가 표시됩니다
  • s3 데이터 저장소의 경우 S3 버킷의 이름이 표시됩니다
  • 공유 S3 데이터 저장소의 경우 S3 버킷의 이름이 표시됩니다
  • azure 데이터 저장소의 경우 컨테이너가 표시됩니다

• 사용자 지정 외부 데이터 저장소가 없는 경우 이 사실을 나타내는 메시지가 표시됩니다

N/A

N/A

분산 에이전트

• 큐가 차단된 에이전트 목록
• 잘못 구성된 에이전트 목록("구성 오류")
• 큐 처리가 일시 중지된 에이전트 목록
• 유휴 에이전트 목록
• 실행 중인 에이전트(현재 처리 중인 항목) 목록

시각적으로 표시됨:

• 차단된 에이전트 또는 구성 오류에 대한 빨간색 태그
• 일시 중지된 에이전트에 대한 주황색 태그
• 일시 중지, 유휴 상태 또는 실행 중인 에이전트
  에 대한 회색 태그

배포 페이지

복제 에이전트

• 큐가 차단된 에이전트 목록
• 유휴 에이전트 목록
• 실행 중인 에이전트(현재 처리 중인 항목) 목록

시각적으로 표시됨:

• 차단된 에이전트의 빨간색 태그
• 일시 중지된 에이전트에 대한 회색 태그

복제 페이지

워크플로

• 워크플로 작업:

  • 실패한 워크플로 작업 수(있는 경우)
  • 취소된 워크플로 작업 수(있는 경우)

• 워크플로 카운트 - 주어진 상태에 있는 워크플로 수(있는 경우):

  • 실행 중
  • 실패
  • 일시 중단됨
  • 중단됨

위에 표시된 각 상태에 대해 400밀리초 제한으로 쿼리가 수행됩니다. 400밀리초에서 해당 지점까지 획득된 엔트리의 수가 디스플레이된다.

해석되지 않음:

• 사용자는 예기치 않은 상태의 워크플로 및 작업이 있는 경우 조사해야 합니다.

워크플로 실패 페이지

Sling 작업

Sling 작업 수 - 지정된 상태의 작업 수(있는 경우):

• 실패
• 대기열에 추가됨
• 취소됨
• 활성

해석되지 않음:

• 사용자는 예기치 않은 상태에 있거나 개수가 많은 작업이 있는 경우 조사해야 합니다.

해당 사항 없음

예상 노드 수

예상 수:

• 페이지
• assets
• 태그
• 승인 가능 대상
• 총 노드 수

총 노드 수는 nodeCounterMBean에서 가져오고 나머지 통계는 IndexInfoService에서 가져옵니다.

N/A

N/A

백업

온라인 백업 진행 중 을 표시합니다.

N/A

N/A

색인화

표시:

• "색인화 진행 중"
• "쿼리 진행 중"

스레드 덤프에 인덱싱 또는 쿼리 스레드가 있는 경우.

N/A

N/A