レポート

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

• コンポーネントのレポート
• ディスク使用量
• ヘルスチェック
• ページアクティビティレポート
• ユーザー生成コンテンツレポート
• ユーザーレポート
• ワークフローインスタンスレポート
• ワークフローレポート

レポートはすべて​ツール​コンソールからアクセスできます。左側のウィンドウで「レポート」を選択し、右側のウィンドウで必要なレポートをダブルクリックして、表示用や設定用に開きます。

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

レポートのカスタマイズの基本

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

• コンポーネントのレポート
• ページアクティビティレポート
• ユーザー生成コンテンツレポート
• ユーザーレポート
• ワークフローインスタンスレポート

データ列の選択と配置

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

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

データの選択を変更するには：

• 新しい列を追加するには、必要なコンポーネントをサイドキックからドラッグして、必要な場所にドロップします。

  • 緑のチェックマークは位置が有効である場合を示し、矢印のペアは正確にどこに配置されるかを示します。
  • 赤のバツ印は、位置が無効である場合を示します。

• 列を移動するには、ヘッダーをクリックし、マウスボタンを押したまま新しい場所までドラッグします。

• 列を削除するには、列のタイトルをクリックし、マウスボタンを押したまま上のレポートヘッダー領域までドラッグします（赤のマイナス記号は位置が有効でないことを示します）。マウスボタンを放すと、列を本当に削除するかどうかの確認を要求するコンポーネントを削除ダイアログが表示されます。

列のドロップダウンメニュー

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

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

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

データの並べ替え

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

• 該当する列ヘッダーをクリックすると、そのたびに昇順と降順が切り替わり、タイトルテキストのすぐ横にある矢印で示されます。
• 列のドロップダウンメニューを使用して「昇順に並べ替え」または「降順に並べ替え」を選択。この場合も、タイトルテキストのすぐ横にある矢印で示されます。

グループと現在のデータチャート

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

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

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

フィルターと集計

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

フィルター

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

• contains
• equals

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

1. 必要な演算子をドロップダウンリストから選択します。
2. フィルター条件とするテキストを入力します。
3. 「適用」をクリックします。

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

1. フィルターテキストを削除します。
2. 「適用」をクリックします。

集計

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

列のプロパティ

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

履歴データ

時間の経過に伴うデータの変化のチャートを、履歴データ​で確認できます。これは、一定間隔で作成されたスナップショットから得られます。

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

• 使用可能であれば最初に並べ替えられた列、または最初の（グループ化されていない）列によって収集されます。
• 該当する列を基準としてグループ化されます。

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

1. 必要な列で​グループ化​を設定します。

2. 設定を​編集​して、スナップショット作成の頻度（時間単位または日単位）を定義します。

3. 完了… スナップショットの収集を開始する定義。

   左上の赤と緑のスライダーボタンは、スナップショットが収集されるタイミングを示します。

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

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

• 期間

  レポートデータを表示する開始日と終了日を選択できます。

• 間隔

  レポートの目盛りと集計には、月、週、日、時間を選択できます。

  例えば、2011年2月に日別のスナップショットを利用できる場合は、次のようになります。

  • 間隔が Day に設定されている場合、各スナップショットが単一の値としてチャートに表示されます。
  • 間隔が Month に設定されている場合、2月のすべてのスナップショットが単一の値に集計（チャートに単一の「ドット」として表示）されます。

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

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

• コレクションを再初期化するには、完了…​を再度使用します。

  完了​は、レポートの構造（レポートに割り当てられた列や、グループ化、並べ替え、フィルター処理された列など）を「フリーズ」し、スナップショットの作成を開始します。

• 編集​ダイアログを開いて、データスナップショットがありません​を選択し、必要になるまでコレクションを停止します。

  編集​は、スナップショットの取得のオンやオフを切り替えるだけです。スナップショットの取得が再度オンになった場合は、さらにスナップショットを取得するために最後に完了した時点のレポートの状態が使用されます。

表示の制限

履歴データレポートは、設定可能な制限により、選択した期間の結果数に従って、外観が少々変わる場合もあります。

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

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

• 水平方向のシリーズ - デフォルトも、システムの最大値も 9

• 垂直方向の集計スナップショット - デフォルトは 35（水平方向のシリーズあたり）

該当する制限を超えた場合は、

• ドットは表示されません。
• 履歴データチャートの凡例に、現在のデータチャートとは異なる数のエントリが表示される場合があります。

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

編集（レポート）

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

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

• タイトル

  独自のタイトルを定義できます。

• 説明

  独自の説明を定義できます。

• ルートパス（特定のレポートでのみ有効）

  レポートをリポジトリの（サブ）セクションに制限する場合に使用します。

• レポート処理

  • データを自動的に更新

    レポート定義を更新するたびに、レポートデータが更新されます。

  • データを手動で更新

    このオプションは、大量のデータがある場合の自動更新操作による遅延を防ぐために使用できます。

    これを選択すると、レポート設定のいずれかの側面が変更された場合に、レポートデータを手動で更新する必要があることを示します。また、設定の任意の側面を変更すると、レポートテーブルは空白になります。

    これを選択すると「データを読み込み」ボタンが表示されます（レポートの「編集 」の横）。データを読み込み​はデータを読み込み、表示されているレポートデータを更新します。

• スナップショット
  スナップショットの作成頻度として、日単位、時間単位、まったく作成しない、のいずれかを定義できます。

データを読み込み

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

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

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

1. レポート設定を変更するとすぐに、レポートデータのテーブルが空白になります。

   例えば、列の並べ替えメカニズムを変更した場合、データは表示されません。

2. レポートデータを再度表示するには、「データを読み込み」をクリックしてデータを再読み込みする必要があります。

完了（レポート）

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

• その時点​のレポート定義を使用してスナップショットが作成されます（その後、スナップショットから分離されたレポート定義で作業を続行できます）。
• 既存のスナップショットはすべて削除されます。
• 履歴データ用に新しいスナップショットが収集されます。

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

レポートのタイプ

コンポーネントのレポート

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

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

• 作成者
• コンポーネントのパス
• コンポーネントの種類
• 最終変更日
• ページ

これはつまり、以下のような情報を確認できるということです。

• どのコンポーネントが、どこで使用されているか。

  例えば、テスト時に役立ちます。

• 特定のコンポーネントのインスタンスの配布方法。

  これは、特定のページ（「重いページ」など）で、パフォーマンスの問題が発生している場合に興味深い点となることがあります。

• サイトの中で、変更が頻繁におこなわれる部分とそうでない部分を特定。

• 時間の経過に伴ってページコンテンツがどのように発展するかを確認。

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

ディスク使用量

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

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

ヘルスチェック

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

<cq-installation-dir>/crx-quickstart/logs/request.log
指定された期間内で最も高価なリクエストを特定するのに役立ちます。

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

• 期間 (時間) ：

  分析する時間数（過去）。

  デフォルト：24

• max. 結果

  出力行の最大数。

  デフォルト：50

• max. リクエスト

  分析するリクエストの最大数。

  デフォルト：-1（すべて）

• メールアドレス

  結果をメールアドレスに送信します。

  （オプション）デフォルト：空白

• 毎日（hh:mm）に実行

  レポートが毎日自動的に実行される時間を指定します。

  （オプション）デフォルト：空白

ページアクティビティレポート

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

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

• ページ
• 時刻
• タイプ
• ユーザー

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

• 最新の変更内容。
• 特定のページで作業をしている作成者。
• 最近変更されていないので、アクションが必要と思われるページ。
• 変更頻度が最大／最小のページ。
• アクティビティが最大／最小のユーザー。

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

ユーザー生成コンテンツレポート

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

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

• 日付
• IP アドレス
• ページ
• リファラー
• タイプ
• ユーザー識別子

次のことが可能です。

• 最もコメントの多いページを確認。
• 特定のサイト訪問者が残しているすべてのコメントの概要を把握（問題が関係している可能性あり）。
• ページにコメントが残された時期を監視することにより、新しいコンテンツがコメントを誘発しているかどうかを判断。

ユーザーレポート

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

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

• 年齢
• 国
• ドメイン
• 電子メール
• 姓
• 性別
• 一般
• 名
• 情報
• 興味
• 言語
• NTLM ハッシュコード
• ユーザー ID

次のことが可能です。

• ユーザーの人口統計上の分布を確認。
• プロファイルに追加したカスタマイズフィールドに関して報告。

汎用列

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

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

• 汎用コンポーネントをサイドキックからレポートへドラッグ。
• 既存の汎用列の「列のプロパティ」を選択。

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

• タイトル

  汎用列の、独自のタイトル。

• プロパティ

  リポジトリに格納されているプロパティ名（通常はユーザーのプロファイル内）。

• パス

  通常、プロパティは profile から取得されます。

• タイプ

  String、Number、Integer、Date の中からフィールドタイプを選択します。

• デフォルトの集計

  これは、少なくとも 1 つのグループ化された列を含むレポートで列のグループ化が解除された場合に、デフォルトで使用される集計を定義します。 Count、Minimum、Average、Maximum、Sum の中から必要な集計を選択します。

  例えば、String フィールドの​カウント​は、集約された状態の列に個別の String 値の数が表示されることを意味します。

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

ワークフローインスタンスレポート

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

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

• 完了
• 期間
• イニシエーター
• モデル
• ペイロード
• 開始済み
• ステータス

これはつまり、次のことが可能ということです。

• ワークフローの平均の期間を監視。定期的に発生する場合は、ワークフローに問題がある可能性があります。

ワークフローレポート

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

パブリッシュ環境でのレポートの使用

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

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

/etc/reports

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

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

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

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

レポートの実行に必要な権限

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

• レポートデータは基本的に、現在のユーザーの権限を使用して収集されます。
• 履歴データは、レポートを完了したユーザーの権限を使用して収集されます。

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

• ユーザーレポート

  user administrators - 読み取りおよび書き込み

• ページアクティビティレポート

  contributors - 読み取りおよび書き込み

• コンポーネントのレポート

  contributors - 読み取りおよび書き込み

• ユーザー生成コンテンツレポート

  contributors - 読み取りおよび書き込み

• ワークフローインスタンスレポート

  workflow-users - 読み取りおよび書き込み

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