操作ダッシュボード operations-dashboard

クエリパフォーマンス

このヘルスチェックは AEM 6.4 で簡素化され、最近リファクタリングされた Oak QueryStats MBean（具体的には SlowQueries 属性）をチェックするようになりました。統計に処理に時間のかかるクエリが含まれている場合、ヘルスチェックは警告を返します。 それ以外の場合は、OK ステータスを返します。

このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck です。

監視キューの長さ

監視キューの長さは、すべてのイベントリスナーとバックグラウンドオブザーバーを繰り返し処理し、それらの queueSize を maxQueueSize と比較します。

• queueSize 値が maxQueueSize 値を超えた場合（つまり、イベントがドロップされた場合）、重要ステータスを返します。
• queueSize 値が maxQueueSize * WARN_THRESHOLD を超えた場合、警告を返します（デフォルト値は 0.75）。

各キューの最大長は別々の設定 (Oak とAEM) から取得され、このヘルスチェックからは設定できません。 このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=ObservationQueueLengthHealthCheck,type=HealthCheck です。

クエリトラバーサルの制限

クエリトラバーサルの制限は、QueryEngineSettings MBean（具体的には LimitInMemory 属性と LimitReads 属性）をチェックし、次のステータスを返します。

• いずれかの制限が 以上の場合、警告ステータスを返します。 Integer.MAX_VALUE
• いずれかの制限が 10,000（Oak の推奨設定）より低い場合、警告ステータスを返します。
• QueryEngineSettings またはいずれかの制限を取得できない場合、重要ステータスを返します。

このヘルスチェックの Mbean は、org.apache.sling.healthcheck:name=queryTraversalLimitsBundle,type=HealthCheck です。

同期済みのクロック

このチェックは、 document nodestore クラスター. 次のステータスを返します。

• インスタンスクロックが同期しなくなり、事前に定義された低しきい値を超えた場合、警告ステータスを返します
• インスタンスクロックが同期しなくなり、事前に定義された高しきい値を超えた場合、重要ステータスを返します

このヘルスチェックの Mbean は、org.apache.sling.healthcheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck です。

非同期インデックス

非同期インデックスのチェック：

• 少なくとも 1 つのインデックス作成レーンが失敗した場合に、重要ステータスを返します。

• すべてのインデックス作成レーンについて lastIndexedTime をチェックし、次のことを行います。

  • 2 時間以上前である場合は、重要ステータスを返します。
  • 2 時間～ 45 分前の場合は、警告ステータスを返します。
  • 45 分前以内の場合は、OK ステータスを返します。

• これらの条件がいずれも満たされない場合は、OK ステータスを返します。

Critical ステータスと Warn ステータスの両方のしきい値を設定できます。 このヘルスチェックの Mbean は、org.apache.sling.healthcheck:name=asyncIndexHealthCheck,type=HealthCheck です。

注意： このヘルスチェックは、AEM 6.4 で使用でき、AEM 6.3.0.1 に移植されています。

大きい Lucene インデックス

このチェックは、Lucene Index Statistics MBean によって公開されたデータを使用して大きいインデックスを識別し、次のステータスを返します。

• 10 億を超えるドキュメントを含むインデックスがある場合の警告ステータス
• 15 億を超えるドキュメントを含むインデックスがある場合の重大なステータス

しきい値は設定可能で、このヘルスチェックの MBean は org.apache.sling.healthcheck:name=largeIndexHealthCheck,type=HealthCheck です。

注意： このチェックはAEM 6.4 で利用でき、AEM 6.3.2.0 に移植されています。

システムメンテナンス

システムメンテナンスは複合チェックで、すべてのメンテナンスタスクが設定どおりに実行されている場合は OK を返します。 次の点に注意してください。

• 各メンテナンスタスクは、関連するヘルスチェックを伴います。
• タスクがメンテナンスウィンドウに追加されていない場合、そのヘルスチェックは「重大」を返します
• 監査ログとワークフローのパージのメンテナンスタスクを設定するか、メンテナンスウィンドウから削除する必要があります。 未構成のままにした場合、最初に試行した実行時にこれらのタスクは失敗するので、システムメンテナンスチェックは重大ステータスを返します。
• 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 時間より古い場合は、重要を返します

設定できるのは、queued jobs パラメーターの最大数のみで、デフォルト値は 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 です。

ディスク容量

ディスク容量チェックは、FileStoreStats MBean を確認し、ノードストアのサイズおよびノードストアパーティション上の使用可能なディスク容量を取得します。

• 使用可能なディスク容量とリポジトリのサイズの比率が警告しきい値（デフォルト値は 10）未満の場合、警告を返します
• 使用可能なディスク容量とリポジトリのサイズの比率が、重大のしきい値（デフォルト値は 2）未満の場合、重大を返します

どちらのしきい値も設定可能です。このチェックは、セグメントストアを含むインスタンスに対してのみ機能します。

このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=DiskSpaceHealthCheck,type=HealthCheck です。

スケジューラーヘルスチェック

このチェックは、インスタンスで Quartz ジョブが 60 秒以上実行されている場合に警告を返します。 許容可能な期間しきい値は設定できます。

このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck です。

セキュリティチェック

セキュリティチェックは、複数のセキュリティ関連チェックの結果を集計する複合です。 これらの個別ヘルスチェックは、セキュリティチェックリストドキュメントページで利用できるセキュリティチェックリストの様々な問題に対処します。このチェックは、インスタンス開始時のセキュリティスモークテストとして役立ちます。

このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=codeCacheHealthCheck,type=HealthCheck です。

アクティブなバンドル

アクティブなバンドルは、すべてのバンドルの状態をチェックし、以下を実行します。

• いずれかのバンドルがアクティブでない場合、または（遅延アクティベーションで開始）、警告ステータスを返します
• 無視リスト内のバンドルのステータスを無視します。

無視リストのパラメーターは設定可能です。

このヘルスチェックの MBean は、org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck です。

コードキャッシュチェック

これは、Java 7 に存在する CodeCache バグをトリガーする可能性のある複数の JVM 条件を検証するヘルスチェックです。

• インスタンスが Java 7 上で実行され、コードキャッシュのフラッシュが有効な場合、警告を返します
• インスタンスが Java 7 上で実行され、予約済みコードキャッシュのサイズが最小しきい値未満の場合（デフォルト値は 90MB）、警告を返します

minimum.code.cache.size しきい値は設定可能です。バグについて詳しくは、このページを参照してください。

このヘルスチェックの 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

タスクの一意の名前 - タスクを参照するために使用されます。これは通常、単純な名前です。

MyMaintenanceTask

必須

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 のバージョン ( 例：Mac OS X)
• から取得したシステム負荷平均 OperatingSystemMXBeanusable
• ディスク容量（ホームディレクトリがあるパーティション上）
• 最大ヒープ（MemoryMXBean によって返されます）

該当なし

該当なし

インスタンス

• AEM版
• 実行モードのリスト
• インスタンスが開始された日付

該当なし

該当なし

リポジトリ

• Oak バージョン

• ノードストアのタイプ（セグメント Tar またはドキュメント）

  • タイプが document の場合は、ドキュメントストアのタイプが表示されます（RDB または Mongo）

• カスタムデータストアがある場合：

  • ファイルデータストアの場合、パスが表示されます
  • S3 データストアの場合は、S3 バケットの名前が表示されます
  • 共有 S3 データストアの場合は、S3 バケットの名前が表示されます
  • Azure データストアの場合は、コンテナが表示されます

• カスタムの外部データストアがない場合は、この事実を示すメッセージが表示されます

該当なし

該当なし

配布エージェント

• ブロックされたキューを持つエージェントのリスト
• 誤って設定されたエージェントのリスト（「設定エラー」）
• キューの処理が一時停止されたエージェントのリスト
• アイドルエージェントのリスト
• 実行中のエージェント（現在エントリを処理中）のリスト

視覚的に示す：

• ブロックされたエージェントまたは設定エラーの赤いタグ
• 一時停止したエージェントのオレンジ色のタグ
• 一時停止、待機中、または実行中のエージェント用の灰色のタグ

配布ページ

レプリケーションエージェント

• ブロックされたキューを持つエージェントのリスト
• アイドルエージェントのリスト
• 実行中のエージェント（現在エントリを処理中）のリスト

視覚的に示す：

• ブロックされたエージェントの赤いタグ
• 一時停止中のエージェント用の灰色のタグ

レプリケーションページ

ワークフロー

• ワークフロージョブ：

  • 失敗したワークフロージョブの数（存在する場合）
  • キャンセルされたワークフロージョブの数（ある場合）

• ワークフロー数 - 特定のステータスのワークフローの数（ある場合）：

  • 実行中
  • 失敗
  • 停止中
  • 中止

上記に示した各ステータスに対して、クエリが実行されます（制限は 400 ミリ秒）。 400 ミリ秒で、その時点までに取得されたエントリ数が表示されます。

未解釈：

• 予期しないステータスのワークフローとジョブがある場合は、調査する必要があります。

ワークフローエラーページ

Sling ジョブ

Sling ジョブ数 — 特定のステータスのジョブの数（存在する場合）:

• 失敗
• キュー
• キャンセル
• アクティブ

未解釈：

• 予期しないステータスのジョブや、カウントが高いジョブがある場合は、調査する必要があります。

該当なし

予測ノード数

推定数：

• ページ
• アセット
• タグ
• 許可可能
• ノードの総数

ノードの合計数は nodeCounterMBean から取得しますが、残りの統計は IndexInfoService から取得します。

該当なし

該当なし

バックアップ

該当する場合は、「オンラインバックアップ中」と表示されます。

該当なし

該当なし

インデックス作成

表示：

• "インデックスを処理中"
• "クエリを処理中"

インデックス作成またはクエリスレッドがスレッドダンプに存在する場合。

該当なし

該当なし