AEM インスタンスの監視および保守 monitoring-and-maintaining-your-aem-instance

AEM インスタンスがデプロイされた後は、操作、パフォーマンス、統合性を監視および保守するために、一定の作業が必要になります。

ここでの主な要因は、潜在的な問題を認識するために、システムが通常の状態でどのように見え、動作するかを知る必要がある点です。 これは、システムを監視し、一定期間にわたって情報を収集することで最も効果的です。

バックアップ backups

次のバックアップを実行することをお勧めします。

おそらく、お客様の会社には、従う必要のあるバックアップポリシーが用意されています。その他の考慮事項と、バックアップの対象となるタイミングについては、次の点が考慮されます。

多くの場合、フル・バックアップは定期的に（日別、週別、月別など）実行され、差分バックアップはその間（時間別、日別、週別など）に行われます。

ソフトウェアインストールのバックアップ backing-up-your-software-installation

インストール後、または設定の大幅な変更後は、ソフトウェアのインストールのバックアップを作成します。

これをおこなうには、次の手順を実行します。 リポジトリ全体のバックアップ そして次に、

リポジトリのバックアップ backing-up-your-repository

この バックアップと復元 CRX リポジトリのバックアップに関するすべての問題については、CRX ドキュメントの節で説明しています。

オンラインの「ホット」バックアップの作成の詳細については、を参照してください。 オンラインバックアップの作成.

バージョンのパージ version-purging

この バージョンをパージ このツールは、リポジトリ内のノードまたはノードの階層のバージョンをパージすることを目的としています。 その主な目的は、古いバージョンのノードを削除して、リポジトリのサイズを小さくすることです。

この節では、AEMのバージョン管理機能に関連するメンテナンス操作について説明します。 この バージョンをパージ このツールは、リポジトリ内のノードまたはノードの階層のバージョンをパージすることを目的としています。 その主な目的は、古いバージョンのノードを削除して、リポジトリのサイズを小さくすることです。

概要 overview

バージョンのパージ ​ツールは、ツールコンソール ​の「バージョン管理」の下か、次の場所にあります。

https://<server>:<port>/etc/versioning/purge.html

開始パス パージを実行する必要がある場所の絶対パスです。リポジトリツリーナビゲーターをクリックして「開始パス」を選択できます。

繰り返し データをパージする際は、「繰り返し」を選択して、1 つのノードで操作を実行するか、階層全体で操作を実行するかを選択できます。後者の場合は、指定したパスが階層のルートノードを定義します。

保持するバージョンの最大数 ノード用に保持するバージョンの最大数。バージョンの数がこの値を超えると、最も古いバージョンがパージされます。

バージョンの最長有効期間 ノードのバージョンの最長有効期間。バージョンの期間がこの値を超えると、パージされます。

ドライラン コンテンツのバージョンの削除は取り消しできず、元に戻すにはバックアップを復元するしかないので、バージョンのパージツールでは、パージ対象のバージョンをプレビューできるドライランモードが提供されています。パージ処理のドライランを開始するには、「ドライラン」をクリックします。

パージ 「開始パス」で定義したノードでバージョンのパージを開始します。

Web サイトのバージョンのパージ purging-versions-of-a-web-site

Web サイトのバージョンをパージするには、次の手順を実行します。

コンソールの分析 analyzing-the-console

「ドライラン」と「パージ」の処理では、処理されたすべてのノードがリストされます。処理の間、ノードのステータスは次のうちいずれかになります。

さらに、コンソールでは、バージョンに関して次のような有益な情報が提供されます。

例を以下に示します。

監査レコードとログファイルの操作 working-with-audit-records-and-log-files

Adobe Experience Manager(AEM) に関する監査レコードおよびログファイルは、様々な場所で見つけることができます。 次に、場所の概要を示します。

ログの使用 working-with-logs

AEM WCM は詳細なログを記録します。 クイックスタートを解凍して起動した後、次の場所でログを検索できます。

ログファイルのローテーション log-file-rotation

ログファイルのローテーションとは、定期的に新しいファイルを作成することによってファイルサイズの拡大を制限するプロセスのことです。AEM では、error.log というログファイルが、以下のルールに従って 1 日 1 回ローテーションされます。

ログファイルの検索 finding-the-log-files

AEMをインストールしたファイルサーバーには、次のような様々なログファイルが保持されます。

デバッグログレベルのアクティベート activating-the-debug-log-level

デフォルトのログレベル Apache Sling Logging Configuration は情報なので、デバッグメッセージはログに記録されません。

ロガーのデバッグログレベルをアクティブにするには、リポジトリでプロパティ org.apache.sling.commons.log.level をデバッグに設定します。例えば、/libs/sling/config/org.apache.sling.commons.log.LogManager で global Apache Sling Logging を設定します。

デバッグファイルの行は、通常は DEBUG で始まり、ログレベル、インストーラーのアクション、ログメッセージを示します。 次に例を示します。

DEBUG 3 WebApp Panel: WebApp successfully deployed

ログレベルは次のとおりです。

カスタムログファイルの作成 create-a-custom-log-file

状況によっては、異なるログレベルでカスタムログファイルを作成する必要があります。 リポジトリでは、次の方法で実行できます。

Felix コンソールでは、../system/console/slinglog の Sling Log Support に関する情報も提供されます。例えば、http://localhost:4502/system/console/slinglog. です。

監査レコードの検索 finding-the-audit-records

監査記録は、誰がいつ何をしたかを記録するために保持されます。 AEM WCM と OSGi の両方のイベントに対して、異なる監査レコードが生成されます。

ページオーサリング時に表示されるAEM WCM 監査レコード aem-wcm-audit-records-shown-when-page-authoring

リポジトリ内のAEM WCM 監査レコード aem-wcm-auditing-records-within-the-repository

/var/audit フォルダー内で、監査レコードは、リソースに応じて保持されます。個々のレコードとそのレコードに含まれる情報が表示されるまでドリルダウンできます。

これらのエントリには、ページの編集時に表示される情報と同じ情報が含まれます。

Web コンソールからの OSGi 監査レコード osgi-audit-records-from-the-web-console

OSGi イベントで生成される監査記録は、AEM Web コンソールの「設定ステータス」タブ／「ログファイル」タブから確認できます。

レプリケーションエージェントの監視 monitoring-your-replication-agents

次の項目を監視できます： レプリケーションキュー キューが停止したかブロックされたかを検出するには、次の手順を実行します。この場合、パブリッシュインスタンスまたは外部システムに問題がある可能性があります。

レプリケーションエージェントを監視するには：

ここでも、すべてのレプリケーションエージェント（/etc/replication/author または /etc/replication/publish の下）を検出して、エージェントのステータス（enabled、disabled）および基になるキューのステータス（active、idle、blocked）を確認するソリューションを開発できます。

パフォーマンスの監視 monitoring-performance

パフォーマンスの最適化は、開発時に注目を集めるインタラクティブなプロセスです。デプロイメント後、通常は特定の間隔またはイベントの後でレビューされます。

最適化のための情報収集に使用する方法は、継続中の監視にも使用できます。

以下のリストは、よく発生するパフォーマンス上の問題と、それぞれの見分け方および対策を示しています。

パフォーマンスの問題は、接続速度の一時的な低下、CPU 負荷など、Web サイトとは何の関係もない多くの原因に起因する場合があります。

また、すべての訪問者に影響を与えるか、一部の訪問者にのみ影響を与える場合があります。

この情報をすべて入手し、分類および分析して初めて、一般的なパフォーマンスを最適化したり、特定の問題を解決したりできます。

パフォーマンスの監視および分析用ツール tools-for-monitoring-and-analyzing-performance

次に、パフォーマンスの監視と分析に使用できるツールの一部の概要を示します。

これらの一部は、オペレーティングシステムに依存します。

request.log の解釈 interpreting-the-request-log

このファイルは、AEMに対しておこなわれたすべてのリクエストに関する基本情報を登録します。 この貴重な結論から抜き出すことができる。

request.log は、リクエストにかかる時間を確認するための組み込みの方法を提供します。開発目的では、request.log を tail -f して、応答時間の遅延を監視することが有用です。より大きな request.log を分析するには、応答時間の並べ替えおよびフィルタリングが可能な rlog.jar の使用を推奨します。

「遅い」ページを request.log から分離してから、パフォーマンスを向上させるために個別に調整することをお勧めします。これは、通常、コンポーネントごとのパフォーマンス指標を含めるか、 [yourkit](https://www.yourkit.com/) のようなパフォーマンスプロファイルツールを使用して行います。

Web サイト上のトラフィックの監視 monitoring-traffic-on-your-website

リクエストログは、おこなわれた各リクエストと、おこなわれた応答を登録します。

09:43:41 [66] -> GET /author/y.html HTTP/1.1
09:43:41 [66] <- 200 text/html 797ms

特定の期間（例：様々な 24 時間以上）内のすべてのGETエントリを合計することで、Web サイトの平均トラフィックに関する情報を提供できます。

request.log を使用した応答時間の監視 monitoring-response-times-with-the-request-log

パフォーマンス分析は、request.log から始めることをお勧めします。

<cq-installation-dir>/crx-quickstart/logs/request.log

ログは次のようになります（行が短くなり、簡単になります）。

31/Mar/2009:11:32:57 +0200 [379] -> GET /path/x HTTP/1.1
31/Mar/2009:11:32:57 +0200 [379] <- 200 text/html 33ms
31/Mar/2009:11:33:17 +0200 [380] -> GET /path/y HTTP/1.1
31/Mar/2009:11:33:17 +0200 [380] <- 200 application/json 39ms

このログは、リクエストまたは応答ごとに 1 行です。

小さなスクリプトを使用して、必要な情報をログファイルから抽出し、必要な統計を組み立てることができます。 これらから、どのページまたはページのタイプが低速か、および全体的なパフォーマンスが満足のいくものかを確認できます。

request.log を使用した検索応答時間の監視 monitoring-search-response-times-with-the-request-log

検索リクエストもログファイルに登録されます。

31/Mar/2009:11:35:34 +0200 [338] -> GET /author/playground/en/tools/search.html?query=dilbert&size=5&dispenc=utf-8 HTTP/1.1
31/Mar/2009:11:35:34 +0200 [338] <- 200 text/html 1562ms

したがって、上記のように、スクリプトを使用して関連情報を抽出し、統計を構築できます。

ただし、応答時間を決定したら、リクエストに時間がかかっている理由と、応答を改善するために何ができるかを分析する必要がある場合があります。

現在のユーザーの数と影響の監視 monitoring-the-number-and-impact-of-concurrent-users

ここでも、request.log を使用して、並行性およびそれに対するシステムの反応を監視できます。

負の影響が見られる前に、システムが処理できる同時ユーザー数を判断するためにテストを実施する必要があります。 ログファイルから結果を抽出するスクリプトを再度使用できます。

31/Mar/2009:11:45:29 +0200 [333] -> GET /author/libs/Personalize/content/statics.close.gif HTTP/1.1
31/Mar/2009:11:45:29 +0200 [334] -> GET /author/libs/Personalize/content/statics.detach.gif HTTP/1.1
31/Mar/2009:11:45:30 +0200 [335] -> GET /author/libs/CFC/content/imgs/logo.rZMNURccynWcTpCxyuBNiTCoiBMmw000.default.gif HTTP/1.1
31/Mar/2009:11:45:32 +0200 [335] <- 304 text/html 0ms
31/Mar/2009:11:45:33 +0200 [334] <- 200 image/gif 31ms
31/Mar/2009:11:45:38 +0200 [333] <- 200 image/gif 31ms
31/Mar/2009:11:45:42 +0200 [336] -> GET /author/libs/CFC/content/imgs/logo.rZMNURccynWcTZRXunQbbQtvuuCMbRRBuWXz0000.default.gif HTTP/1.1
31/Mar/2009:11:45:43 +0200 [337] -> GET /author/titlebar_bg.gif HTTP/1.1
31/Mar/2009:11:45:43 +0200 [336] <- 304 text/html 0ms
31/Mar/2009:11:45:44 +0200 [337] <- 304 text/html 0ms

rlog.jar を使用した長期間のリクエストの検索 using-rlog-jar-to-find-requests-with-long-duration-times

AEM には、次の場所に様々なヘルパーツールが含まれています。

<cq-installation-dir>/crx-quickstart/opt/helpers

その 1 つ、rlog.jar を使用すると、request.log を短時間で分類し、所要時間を基準として、最長から最短の順序で要求を表示できます。

次のコマンドは、考えられる引数を示しています。

$java -jar rlog.jar
Request Log Analyzer Version 21584 Copyright 2005 Day Management AG
Usage:
  java -jar rlog.jar [options] <filename>
Options:
  -h               Prints this usage.
  -n <maxResults>  Limits output to <maxResults> lines.
  -m <maxRequests> Limits input to <maxRequest> requests.
  -xdev            Exclude POST request to CRXDE.

例えば、request.log ファイルをパラメーターとして指定してコマンドを実行し、所要時間が長いほうから 10 個の要求を表示することができます。

$ java -jar ../opt/helpers/rlog.jar -n 10 request.log
*Info * Parsed 464 requests.
*Info * Time for parsing: 22ms
*Info * Time for sorting: 2ms
*Info * Total Memory: 1mb
*Info * Free Memory: 1mb
*Info * Used Memory: 0mb
------------------------------------------------------
     18051ms 31/Mar/2009:11:15:34 +0200 200 GET /content/geometrixx/en/company.html text/ html
      2198ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/cq/widgets.js application/x-javascript
      1981ms 31/Mar/2009:11:15:11 +0200 200 GET /libs/wcm/content/welcome.html text/html
      1973ms 31/Mar/2009:11:15:52 +0200 200 GET /content/campaigns/geometrixx.teasers..html text/html
      1883ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/security/cq-security.js application/x-javascript
      1876ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/tagging/widgets.js application/x-javascript
      1869ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/tagging/widgets/themes/default.js application/x-javascript
      1729ms 30/Mar/2009:16:45:56 +0200 200 GET /libs/wcm/content/welcome.html text/html; charset=utf-8
      1510ms 31/Mar/2009:11:15:34 +0200 200 GET /bin/wcm/contentfinder/asset/view.json/ content/dam?_dc=1238490934657&query=&mimeType=image&_charset_=utf-8 application/json
      1462ms 30/Mar/2009:17:23:08 +0200 200 GET /libs/wcm/content/welcome.html text/html; charset=utf-8

大容量のデータサンプルに関してこの処理をおこなう必要がある場合は、個々の request.log ファイルを連結する必要があります。

Apache Bench apache-bench

特殊なケース（ガベージコレクションなど）の影響を最小限にするために、apachebench（詳細なドキュメントについては ab などを参照）などのツールを使用してメモリリークを特定し、応答時間を選択分析することをお勧めします。

Apache Bench は次の方法で使用できます。

$ ab -c 5 -k -n 1000 "http://localhost:4503/content/geometrixx/en/company.html"
This is ApacheBench, Version 2.3 <$Revision: 655654 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, https://www.zeustech.net/
Licensed to The Apache Software Foundation, https://www.apache.org/

Benchmarking localhost (be patient)
Completed 100 requests
Completed 200 requests
Completed 300 requests
Completed 400 requests
Completed 500 requests
Completed 600 requests
Completed 700 requests
Completed 800 requests
Completed 900 requests
Completed 1000 requests
Finished 1000 requests

Server Software: Day-Servlet-Engine/4.1.52
Server Hostname: localhost
Server Port: 4503

Document Path: /content/geometrixx/en/company.html
Document Length: 24127 bytes

Concurrency Level: 5
Time taken for tests: 69.766 seconds
Complete requests: 1000
Failed requests: 998
(Connect: 0, Receive: 0, Length: 998, Exceptions: 0)
Write errors: 0
Keep-Alive requests: 0
Total transferred: 24160923 bytes
HTML transferred: 24010923 bytes
Requests per second: 14.33 /sec (mean)
Time per request: 348.828 [ms] (mean)
Time per request: 69.766 [ms] (mean, across all concurrent requests)
Transfer rate: 338.20 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 3.9 0 58
Processing: 138 347 568.5 282 8106
Waiting: 137 344 568.1 281 8106
Total: 139 348 568.4 283 8106

Percentage of the requests served within a certain time (ms)
50% 283
66% 323
75% 356
80% 374
90% 439
95% 512
98% 1047
99% 1132
100% 8106 (longest request)

上記の番号は、デフォルトのAEMインストールに含まれている、geometrixx 会社ページにアクセスする標準の MAcBook Pro ノートパソコン（2010 年中頃）から取得されます。 このページは非常に単純ですが、パフォーマンスが最適化されていません。

apachebench は、すべての同時リクエストの平均として、リクエストあたりの時間も表示します。Time per request: 54.595 [ms]（すべての同時リクエストの平均）を参照してください。同時実行パラメーター -c の値（一度に実行する複数リクエストの数）を変更して、影響を確認できます。

要求カウンター request-counters

リクエストトラフィックに関する情報（特定の期間内のリクエスト数）は、インスタンスの負荷を示します。 この情報は、 request.logカウンターを使用すると、データ収集が自動化され、以下が確認できます。

情報の収集を自動化するには、RequestFilter をインストールして、リクエストごとにカウンタを増やすこともできます。 異なる期間に対して複数のカウンタを使用できます。

収集された情報は、次の内容を示すために使用できます。

HTMLコメント html-comments

サーバーのパフォーマンスのために、すべてのプロジェクトに html comments を含めることをお勧めします。多くの優れた公開事例を見ることができます。ページを選択し、表示するページソースを開いて、下までスクロールすると、次のようなコードを表示できます。

</body>
 </html>
        <!--
        Page took 58 milliseconds to be rendered by server
         -->

JConsole を使用したパフォーマンスの監視 monitoring-performance-using-jconsole

ツールコマンド jconsole を、JDK で使用できます。

（J）VisualVM を使用したパフォーマンスの監視 monitoring-performance-using-j-visualvm

JDK 1.6 以降、ツールコマンド jvisualvm を使用できます。JDK 1.6 をインストールすると、次の操作を実行できます。

このツールを使用して、スレッドダンプとメモリヘッドダンプを生成できます。 この情報は、多くの場合、テクニカルサポートチームからリクエストされます。

情報収集 information-collection

インストールについてできる限り知っておくことは、パフォーマンスの変化の原因や、変化が正当かどうかを追跡する上で役立ちます。これらの指標を一定の間隔で収集し、重大な変化を簡単に確認できるようにする必要があります。

有益な情報を以下に示します。

システムで作業をしている作成者の数 how-many-authors-are-working-with-the-system

インストール以降にシステムを使用した作成者の数を確認するには、次のコマンドラインを使用します。

cd <cq-installation-dir>/crx-quickstart/logs
cut -d " " -f 3 access.log | sort -u | wc -l

特定の日付で作業している作成者の数を確認するには：

grep "<date>" access.log | cut -d " " -f 3 | sort -u | wc -l

1 日あたりのページアクティベーションの平均数 what-is-the-average-number-of-page-activations-per-day

サーバーのインストール以降のページのアクティベーションの合計数を確認するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

その後、インストール以降の経過日数を計算し、平均を計算します。

このシステムで現在保守しているページ数 how-many-pages-do-you-currently-maintain-on-this-system

サーバー上の現在のページ数を確認するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

MSM を使用する場合は、1 ヶ月あたりのロールアウトの平均数 if-you-use-msm-what-is-the-average-number-of-rollouts-per-month

インストール後のロールアウトの総数を判断するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

インストール以降の経過月数を計算し、平均を計算します。

1 ヶ月あたりのライブコピーの平均数 what-is-the-average-number-of-live-copies-per-month

インストール後に行われたライブコピーの合計数を確認するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

ここでも、インストール以降の経過月数を使用して、平均を計算します。

AEM Assets を使用する場合は、Assets で現在保守しているアセットの数 if-you-use-aem-assets-how-many-assets-do-you-currently-maintain-in-assets

現在保守している DAM アセットの数を確認するには、リポジトリクエリを使用します。CRXDE のツール／クエリで、次のように指定します。

アセットの平均サイズ what-is-the-average-size-of-the-assets

/var/dam フォルダーの合計サイズを特定するには：

現在使用されているテンプレートの数 how-many-templates-are-currently-used

現在サーバー上にあるテンプレートの数を確認するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

現在使用されているコンポーネントの数 how-many-components-are-currently-used

現在サーバー上にあるコンポーネントの数を確認するには、リポジトリクエリを使用します。CRXDE — ツール — クエリ：

ピーク時のオーサーシステムの 1 時間あたりの要求数 how-many-requests-per-hour-do-you-have-on-the-author-system-at-peak-time

ピーク時のオーサーシステムの 1 時間あたりの要求数を特定するには：

ピーク時のパブリッシュシステムの 1 時間あたりの要求数 how-many-requests-per-hour-do-you-have-on-the-publish-system-at-peak-time

パブリッシュインスタンスで上記の手順を繰り返します。

具体的なシナリオの分析 analyzing-specific-scenarios

次に、特定のパフォーマンスの問題が発生し始めた場合の確認方法に関する推奨事項を示します。 リストは（残念ながら）完全に網羅的ではありません。

100 %の CPU cpu-at

システムの CPU が常に 100 %で稼働している場合は、次のように表示されます。

メモリ不足 out-of-memory

このようなエラーは開発およびテスト中に検出されるはずですが、一部のシナリオが誤って検出される場合があります。

システムのメモリが不足している場合は、パフォーマンスの低下やサブテキストを含むエラーメッセージなど、様々な方法で表示されます。

java.lang.OutOfMemoryError

このような場合は、以下をチェックします。

ディスク I/O disk-i-o

システムのディスク容量が不足しているか、ディスクのスラッシュが開始している場合は、次を参照してください。

通常のパフォーマンス低下 regular-performance-degradation

再起動後（場合によっては 1 週間以上後）にインスタンスのパフォーマンスが低下している場合は、次の点を確認できます。

JVM の調整 jvm-tuning

Java 仮想マシン (JVM) は、チューニング（特に Java 7 以降）に関して大幅に改善されました。 このため、適切な固定 JVM サイズを指定し、デフォルトを使用することが適している場合が多いです。

デフォルト設定が適切でない場合は、JVM を調整する前に、GC のパフォーマンスを監視および評価する方法を確立することが重要です。これには、ヒープサイズ、アルゴリズム、その他の側面などの監視要因が含まれる場合があります。

一般的な選択肢は次のとおりです。

結果のログは、次のような GC 可視化機能によって取り込み可能です。

[https://www.ibm.com/developerworks/library/j-ibmtools2/](https://www.ibm.com/developerworks/library/j-ibmtools2/)

JConsole の場合は以下のとおりです。

これは、使用中のメモリ量、使用されている GC アルゴリズム、アルゴリズムの実行にかかる時間、アプリケーションのパフォーマンスへの影響を確認するうえで役立ちます。これがないと、チューニングは「ノブをランダムに回している」だけになります。