アセット監視のベストプラクティス

Adobe Experience Manager（AEM）Assets の観点から見た場合、監視の際には、以下のプロセスおよびテクノロジについての観察および報告をおこなう必要があります。

• システム CPU

• システムメモリ使用量

• システムディスク IO および IO 待機時間

• システムネットワーク IO

• 以下のための JMX MBean：

  • ヒープ使用状況
  • ワークフローなどの非同期プロセス

• OSGi コンソールヘルスチェック

通常、AEM Assets の監視には、ライブ監視と長期的監視の 2 種類があります。

ライブモニタリング

開発のパフォーマンステストの段階、または高負荷な状態になったときに、環境のパフォーマンス特性を把握するためにライブ監視を実行する必要があります。通常、ライブ監視はいくつかのツールを使用して実行します。以下にお勧めのツールを示します。

• ビジュアルVM:Visual VMを使用すると、CPU使用率、Javaメモリ使用量など、Java VMの詳細な情報を表示できます。また、インスタンス上で実行されるコードをサンプリングおよび評価できます。

• Top：Top は、CPU、メモリ、IO 使用量などの使用量統計を表示するダッシュボードを開く Linux コマンドです。インスタンスの状況の概要を示します。

• Htop：Htop は、インタラクティブなプロセスビューアです。Top が提供する情報に加えて、詳細な CPU およびメモリ使用状況が表示されます。Htopは、yum install htopまたはapt-get install htopを使用して、ほとんどのLinuxシステムにインストールできます。

• Iotop：Iotop は、ディスク IO 使用量の詳細なダッシュボードです。ディスク IO を使用するプロセス、およびそのプロセスによる使用量を示すバーやメーターが表示されます。iotopは、yum install iotopまたはapt-get install iotopを使って、ほとんどのLinuxシステムにインストールできます。

• Iftop：Iftop は、イーサネット／ネットワークの使用量についての詳細情報を表示します。Iftop では、イーサネットを使用するエンティティについての通信チャネルごとの統計情報、および使用されている帯域幅の量が表示されます。iftopは、yum install iftopやapt-get install iftopを使って、ほとんどのLinuxシステムにインストールできます。

• Java Flight Recorder（JFR）：非実稼動環境で自由に使用できる、Oracle の市販ツールです。詳しくは、Java Flight Recorderを使用してCQランタイムの問題を診断する方法を参照してください。

• AEM の error.log ファイル：システムでログに記録されたエラーの詳細を AEM の error.log ファイルで調査できます。tail -F quickstart/logs/error.logコマンドを使用して、調査する必要のあるエラーを識別します。

• ワークフローコンソール：ワークフローコンソールを使用して、遅れているワークフローや、停止しているワークフローを監視できます。

通常は、これらのツールを組み合わせて使用し、AEM インスタンスのパフォーマンスについて包括的に把握します。

長期的監視

AEM インスタンスの長期的監視では、ライブで監視されるのと同じ部分の長期にわたる監視をおこないます。また、環境に固有のアラートも定義します。

ログの集約とレポート

Splunk（TM）や Elastic Search/Logstash/Kabana（ELK）など、いくつかのログ集約ツールがあります。AEM インスタンスの稼動時間を評価するには、システムに固有のログイベントを理解し、それに基づきアラートを作成することが重要です。開発と運用に関する慣習を十分に理解しておくと、重要なアラートを生成するログ集計プロセスを調整する方法をより深く理解できます。

環境の監視

環境の監視には、以下の監視が含まれます。

• ネットワークのスループット
• ディスク IO
• メモリ
• CPU 使用率
• JMX MBean
• 外部 Web サイト

それぞれの項目を監視するには、NewRelic（TM）や AppDynamics（TM）などの外部ツールが必要です。これらのツールを使用して、システム固有のアラート（システム利用率が高い、ワークフローのバックアップ、ヘルスチェック失敗、Web サイトへの不正なアクセスなど）を定義できます。アドビでは、特定のツールを推奨することはありません。ご自身に合ったツールを見つけ、説明した項目の監視に利用してください。

内部アプリケーション監視

内部アプリケーション監視には、JVM などの AEM スタックを構成するアプリケーションコンポーネントの監視、コンテンツリポジトリの監視、およびプラットフォーム上に構築されたカスタムアプリケーションコードによる監視が含まれます。通常、SolarWinds（TM）、HP OpenView（TM）、Hyperic（TM）、Zabbix（TM）などの一般的な多くの監視ソリューションで直接監視できる JMX MBean を通して監視を実行します。JMX への直接接続をサポートしないシステムでは、JMX データを抽出して、それらのシステムがネイティブで理解できる形式で公開するシェルスクリプトを記述できます。

JMX MBean へのリモートアクセスは、デフォルトで無効になっています。JMXによる監視の詳細については、Monitoring and Management Using JMX Technologyを参照してください。

多くの場合、統計情報を効果的に監視するにはベースラインが必要です。ベースラインを作成するには、通常の動作条件の下で一定期間システムを監視し、通常の指標を特定します。

JVM 監視

他の Java ベースのアプリケーションスタックと同様に、AEM は基盤となる Java Virtual Machine から提供されたリソースを利用します。JVM により公開されているプラットフォーム MXBean によって、それらのリソースの多くの状態を監視できます。MXBean について詳しくは、プラットフォーム MBean サーバーおよびプラットフォーム MXBean の使用を参照してください。

JVMの基準パラメーターの一部を以下に示します。

メモリ

• MBean: lava.lang:type=Memory
• URL：/system/console/jmx/java.lang:type=Memory
• インスタンス：すべてのサーバー
• アラームしきい値：ヒープまたは非ヒープメモリ使用率が、対応する最大メモリの 75％を超えた場合。
• アラーム定義：システムメモリが不十分である、またはコードにメモリリークがあります。スレッドダンプを分析して、定義を満たすかどうか判断します。

注意：この Bean から提供される情報の単位はバイトです。

スレッド

• MBean:java.lang:type=Threading
• URL：/system/console/jmx/java.lang:type=Threading
• インスタンス：すべてのサーバー
• アラームしきい値：スレッド数がベースラインの 150％を超えた場合。
• アラーム定義：適切に停止できていないアクティブなプロセスがある、または非効率な操作で大量のリソースを消費しています。スレッドダンプを分析して、定義を満たすかどうか判断します。

AEM 監視

AEM も、JMX を通して一連の統計情報および操作を公開しています。これにより、システムヘルスの評価をおこない、ユーザーに影響を与える前に問題を特定できます。詳しくは、AEM JMX MBean のドキュメントを参照してください。

AEM で監視できるベースラインパラメーターをいくつか示します。

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

• MBean:com.adobe.granite.replication:type=agent,id=”<AGENT_NAME>”

• URL：/system/console/jmx/com.adobe.granite.replication:type=agent,id=”<AGENT_NAME>”

• インスタンス：1 つのオーサーインスタンスおよびすべてのパブリッシュインスタンス（フラッシュエージェント）

• アラームしきい値：QueueBlocked の値が true、または QueueNumEntries の値がベースラインの 150％を超えた場合。

• アラーム定義：システムにブロックされたキューが存在しており、レプリケーションターゲットがダウンしているか、または到達不能であることを示しています。多くの場合、ネットワークまたはインフラストラクチャの問題により過剰なエントリがキューに登録されています。それによってシステムのパフォーマンスに悪影響が生じる可能性があります。

注意:MBeanおよびURLパラメーターの場合は、を、監視 <AGENT_NAME> する複製エージェントの名前に置き換えます。

セッションカウンター

• MBean:org.apache.jackrabbit.oak:id=7,name="OakRepository Statistics",type="RepositoryStats"
• URL：/system/console/jmx/org.apache.jackrabbit.oak:id=7,name="OakRepository Statistics",type="RepositoryStats"
• インスタンス：すべてのサーバー
• アラームしきい値：開いているセッションの数がベースラインよりも 50％以上多い場合。
• アラーム定義：特定のコードによりセッションが開かれ、閉じられない状態になっています。この状態は徐々に進行し、最終的にはシステムでメモリリークの原因となります。システム上のセッション数は多少変動しますが、継続的に上昇してはいけません。

ヘルスチェック

操作ダッシュボードのヘルスチェックには、監視用の対応する JMX MBean があります。ただし、カスタムのヘルスチェックを記述して、追加のシステム統計情報を公開できます。

監視に役立つ、あらかじめ用意されたヘルスチェックをいくつか示します。

• システムチェック

  • MBean:org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck
  • URL：/system/console/jmx/org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck
  • インスタンス：1 つのオーサーサーバー、およびすべてのパブリッシュサーバー
  • アラームしきい値：ステータスが OK ではない場合。
  • アラーム定義：いずれかの指標のステータスが警告または重要となっています。問題の原因について詳しくは、ログ属性を確認してください。

• レプリケーションキュー

  • MBean:org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck

  • URL：/system/console/jmx/org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck
  • インスタンス：1 つのオーサーサーバー、およびすべてのパブリッシュサーバー
  • アラームしきい値：ステータスが OK ではない場合。
  • アラーム定義：いずれかの指標のステータスが警告または重要となっています。問題を発生させたキューについて詳しくは、ログ属性を確認してください。

• 応答パフォーマンス

  • MBean:org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck

  • URL：/system/console/jmx/org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck
  • インスタンス：すべてのサーバー
  • アラーム期間：ステータスが OK ではない場合。
  • アラーム定義：いずれかの指標のステータスが警告または重要となっています。問題を発生させたキューについて詳しくは、ログ属性を確認してください。

• クエリパフォーマンス

  • MBean:org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck

  • URL：/system/console/jmx/org.apache.sling.healthcheck:name= queriesStatus,type=HealthCheck
  • インスタンス：1 つのオーサーサーバー、およびすべてのパブリッシュサーバー
  • アラームしきい値：ステータスが OK ではない場合。
  • アラーム定義：システムで 1 つ以上のクエリの実行速度が遅くなっています。問題を発生させたクエリについて詳しくは、ログ属性を確認してください。

• アクティブなバンドル

  • MBean：org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck
  • URL：/system/console/jmx/org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck
  • インスタンス：すべてのサーバー
  • アラームしきい値：ステータスが OK ではない場合。
  • アラーム定義：システム上の非アクティブまたは未解決な OSGi バンドルの存在。問題を発生させたバンドルについて詳しくは、ログ属性を確認してください。

• ログエラー

  • MBean:org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck

  • URL：/system/console/jmx/org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck
  • インスタンス：すべてのサーバー
  • アラームしきい値：ステータスが OK ではない場合。
  • アラーム定義：ログファイルにエラーがあります。問題の原因について詳しくは、ログ属性を確認してください。

よくある問題と解決策

監視中に問題が発生した場合は、以下のトラブルシューティングを実行して、AEM インスタンスでよくある問題を解決できます。

• TarMK を使用している場合は、Tar 圧縮を頻繁に実行します。詳しくは、リポジトリの管理を参照してください。
• OutOfMemoryErrorログを確認します。 詳しくは、メモリの問題の分析を参照してください。
• ログを確認し、インデックス化されていないクエリ、ツリートラバーサル、インデックストラバーサルへの参照がないかを確認します。これらは、インデックス化されていないクエリ、または不適切にインデックス化されたクエリを示しています。クエリとインデックス作成のパフォーマンスを最適化するベストプラクティスについては、クエリのベストプラクティスとインデックス作成を参照してください。
• ワークフローが予期したとおりに動作していることを確認するには、ワークフローコンソールを使用します。可能な場合は、複数のワークフローを単一のワークフローにまとめます。
• ライブ監視を再確認し、他にボトルネックがないか、または特定のリソースを大量に使用している箇所がないかを確認します。
• ディスパッチャーを含むクライアントネットワークからの出口ポイントおよび AEM インスタンスへの入り口ポイントを調査します。多くの場合、これらがボトルネックが発生する領域となります。詳しくは、Assets のネットワークにおける考慮事項を参照してください。
• AEM サーバーを拡張します。AEM インスタンスのサイジングが不適切な可能性があります。Adobeカスタマーケアは、サーバーのサイズが小さいかどうかを特定するのに役立ちます。
• access.log および error.log ファイルで、不具合の発生した時刻付近のエントリを調査します。カスタムコードの異常の兆候となるパターンを探します。それらを監視するイベントのリストに追加します。