レポート reporting

インスタンスの状態を監視および分析しやすいように、Adobe Experience Manager（AEM）にはデフォルトのレポートが用意されており、個々の要件に合わせて設定できます。

すべてのレポートには、ツール ​コンソールからアクセスできます。左側のパネルで「レポート」を選択し、右側のパネルで必要なレポートをダブルクリックすると、レポートを開いて表示、設定、またはその両方を行うことができます。

レポートの新しいインスタンスは、ツール ​コンソールから作成することもできます。左側のパネルで「レポート」を選択し、ツールバーから「新規…」を選択します。「タイトル」および「名前」を定義して、必要なレポートタイプを選択し、「作成」をクリックします。新しいレポートインスタンスがリストに表示されます。これをダブルクリックして開き、サイドキックからコンポーネントをドラッグすると、最初の列を作成してレポート定義を開始できます。

レポートのカスタマイズの基本 the-basics-of-report-customization

様々な書式のレポートを使用できます。次のレポートはすべて、以下の節の説明に従ってカスタマイズできる列を使用します。

データ列の選択と配置 selecting-and-positioning-the-data-columns

標準レポートでもカスタマイズしたレポートでも、列の追加や再配置、削除が可能です。

サイドキックの「コンポーネント」タブ（レポートページで使用可能）に、列として選択可能なデータのすべてのカテゴリがリストされています。

データの選択を変更するには、以下の手順を実行します。

列のドロップダウンメニュー column-drop-down-menu

レポート内の列にはそれぞれドロップダウンメニューがあります。これは、列のタイトルセル上にマウスカーソルを移動すると表示されます。

タイトルセルの右端に矢印が表示されます（タイトルテキストのすぐ右側にある、現在の並べ替えメカニズムを示す矢印と混同しないでください）。

メニューで使用可能なオプションは、列の設定（プロジェクト開発時に行ったもの）によって異なり、無効なオプションは暗く表示（グレー表示）されます。

データの並べ替え sorting-the-data

データは、特定の列に従って、以下のいずれかの方法で並べ替えできます。

グループと現在のデータチャート groups-and-the-current-data-chart

適切な列で、列のドロップダウンメニューから「この列でグループ化」を選択できます。これにより、対象の列内のそれぞれの値に従ってデータがグループ化されます。グループ化する列は複数選択できます。列内のデータが不適切な場合、オプションは暗く（グレー表示）表示されます。つまり、すべてのエントリは個別で一意なので、グループを形成できません。例えば、ユーザーレポートの「ユーザー ID」列などです。

少なくとも 1 つの列がグループ化されると、このグループ化に基づいて​ 現在のデータ ​の円グラフが生成されます。複数の列がグループ化される場合は、そのことがグラフに示されます。

円グラフ上にカーソルを移動すると、該当するセグメントの集計値が表示されます。この場合は、列に対して現在定義されている集計（カウント、最小、平均など）が使用されます。

フィルターと集計 filters-and-aggregates

該当する列では、列のドロップダウンメニューから、「フィルター設定」や「集計」も設定できます。

フィルター filters

フィルター設定では、表示するエントリの条件を指定できます。使用可能な演算子は次のとおりです。

フィルターを設定するには：

フィルターをアクティベート解除するには：

集計 aggregates

集計方法（選択している列によって異なる）も選択できます。

列のプロパティ column-properties

このオプションは、ユーザーレポートで汎用列が使用されたことがある場合にのみ使用できます。

履歴データ historic-data

時間の経過に伴うデータの変化を示すグラフは​ 履歴データ ​にあります。これは、一定の間隔で作成されたスナップショットから得られます。

データは次のように処理されます。

レポートは次の手順で生成できます。

結果のチャートが右下に表示されます。

データ収集が開始されたら、以下を選択できます。

要件を選択し、「設定」をクリックしてレポートに適用します。スナップショットがさらに作成された後に表示を更新するには、「設定」を再度クリックします。

スナップショットを収集中に、以下の処理が可能です。

表示の制限 display-limits

履歴データレポートの表示方法には、制限が設定される場合があるので、選択した期間の結果数に応じて表示方法が若干変わることがあります。

水平方向の各線はシリーズと呼ばれ（チャート凡例の各エントリに対応）、垂直方向のドットの列はそれぞれ集計されたスナップショットを表します。

チャートをより長期間にわたってクリーンに保つために、制限が設定される場合があります。標準レポートの場合の制限は次のとおりです。

したがって、（適切な）制限を超えた場合は次のようになります。

カスタマイズされたレポートでは、すべてのシリーズの​ 合計 ​値も表示できます。これはシリーズ（水平方向の線および凡例のエントリ）として表示されます。

編集（レポート） edit-report

「編集」ボタンをクリックすると、レポートを編集 ​ダイアログが開きます。

これは、履歴データのスナップショットを収集する期間を定義する場所の 1 つですが、その他様々な設定も定義できます。

データを読み込み load-data

「データを読み込み」ボタンは、「編集」で「データを手動で更新」を選択している場合にのみ表示されます。

「データを読み込み」をクリックすると、データが再読み込みされ、レポートの表示が更新されます。

データを手動で更新することを選択すると、

完了（レポート） finish-report

レポートを​ 完了 ​すると、

このダイアログボックスで、生成されるレポートの独自のタイトルおよび説明を定義したり、更新したりできます。

レポートのタイプ report-types

コンポーネントレポート component-report

コンポーネントのレポートは、web サイトでのコンポーネントの使用方法に関する情報を提供します。

次の内容に関する情報の列があります。

次のような情報が表示されます。

すべてのコンポーネントは含まれ、製品の標準であり、プロジェクト固有のものです。編集 ​ダイアログを使用すると、ユーザーはレポートの開始点を定義する​ ルートパス ​も設定できます。そのルートの下のすべてのコンポーネントがレポート用に考慮されます。

ディスク使用量 disk-usage

ディスク使用量レポートは、リポジトリ内に格納されているデータに関する情報を表示します。

レポートはリポジトリのルート（/）で始まります。特定のブランチをクリックすると、リポジトリ内をドリルダウンできます（現在のパスがレポートタイトルに反映されます）。

ヘルスチェック health-check

このレポートは、現在のリクエストログを分析します。

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

指定された期間内で最も高価なリクエストを特定するのに役立ちます。

レポートを生成するには、以下を指定できます。

ページアクティビティレポート page-activity-report

ページアクティビティレポートは、ページおよびそこで実行されたアクションをリストします。

次の内容に関する情報の列があります。

これはつまり、以下を監視できるということです。

ページアクティビティレポートは、すべての情報を監査ログから取得します。デフォルトでは、ルートパスは /var/audit/com.day.cq.wcm.core.page にある監査ログに設定されています。

ユーザー作成コンテンツレポート user-generated-content-report

このレポートは、コンポーネント、評価、フォーラムなど、ユーザーが生成したコンテンツに関する情報を提供します。

次の内容に関する情報の列があります。

以下のように利用できます。

ユーザーレポート user-report

このレポートは、アカウントやプロファイルを登録済みのすべてのユーザーに関する情報を提供します。これには組織内の作成者と外部訪問者の両方が含まれます。

次の内容に関する情報の列（適宜）があります。

以下のように利用できます。

汎用列 generic-column

汎用 ​列は、ユーザーレポート内で、通常はユーザープロファイルからカスタマイズされた情報にアクセスするために使用できます。例えば、「プロファイル定義へのフィールドの追加」で説明されている「好きな色」などです。

汎用列ダイアログは、次のいずれかの操作で開きます。

「定義」タブから、以下を定義できます。

「拡張」タブでは、使用可能な集計およびフィルターも定義できます。

ワークフローインスタンスレポート workflow-instance-report

実行中と完了済みの両方のワークフローの個々のインスタンスに関する情報を提供することにより、わかりやすい概要を提供します。

次の内容に関する情報の列があります。

次のことが可能になります。

ワークフローレポート workflow-report

現在のインスタンスで実行されているワークフローに関する重要な統計を提供します。

パブリッシュ環境でのレポートの使用 using-reports-in-a-publish-environment

特定の要件に合わせてレポートの設定を完了したら、レポートをアクティブ化して、設定をパブリッシュ環境に転送できます。

該当するレポートは次の場所でアクセス可能になります。

/etc/reports

例えば、ユーザー作成コンテンツレポートは次の場所で見つかります。

http://localhost:4503/etc/reports/ugcreport.html

これは今後、パブリッシュ環境から収集されたデータに関するレポートとなります。

パブリッシュ環境ではレポートの設定はできないので、「編集」ボタンと「完了」ボタンは使用できません。ただし、スナップショットが収集されている場合は、履歴データ ​レポート用に「期間」と「間隔」を選択できます。

レポートの実行に必要な権限 permissions-needed-for-running-reports

必要な権限はアクションによって異なります。

標準の AEM インストールでは、レポートごとに以下の権限がプリセットされています。

administrators グループのメンバーは全員が、レポートの作成に必要な権限を持っています。