报告

为了帮助您监视和分析实例的状态，AEM提供了一系列默认报表选项，这些报表可根据您的各个要求进行配置：

• 组件报告
• 磁盘使用情况
• 运行状况检查
• 页面活动报告
• 用户生成的内容报告
• 用户报告
• 工作流实例报告
• 工作流报表

可以从​工具​控制台访问所有报表。 在左窗格中选择​Reports ，然后双击右窗格中的所需报表以将其打开以进行查看和/或配置。

也可以从​工具​控制台创建报表的新实例。 在左侧窗格中选择​Reports，然后选择​新建……。 定义​标题​和​名称，选择所需的报表类型，然后单击​创建。 您的新报表实例将显示在列表中。 双击此图标以打开，然后从Sidekick中拖动组件以创建第一列并开始报表定义。

报表自定义的基础知识

可使用各种格式的报表。 以下报表都使用可自定义的列，如以下各节所述：

• 组件报告
• 页面活动报告
• 用户生成的内容报告
• 用户报告
• 工作流实例报告

选择和定位数据列

可向任何报表添加列、将列重新定位到报表或从任何报表中删除列（标准报表或自定义报表）。

Sidekick的​组件​选项卡（在报表页面上提供）列出了可以选择为列的所有数据类别。

要更改数据选择，请执行以下操作：

• 要添加新列，请将所需组件从sidekick拖放到所需位置

  • 绿色勾号将指示位置何时有效，并且一对箭头将指示位置的确切位置
  • 位置无效时，将显示一个红色的禁用符号

• 要移动列，请单击标题，按住并拖动到新位置

• 要删除列，请单击列标题，按住并向上拖动到报表标题区域（红色减号表示该位置无效）；释放鼠标按钮，删除组件对话框将请求确认您确实要删除该列。

列下拉菜单

报表中的每列都有一个下拉菜单。 当鼠标光标移动到列标题单元格上时，此图标会变得可见。

箭头将显示在标题单元格的最右侧（不要与标题文本右侧的箭头头混淆，该箭头头指示当前排序机制）。

菜单中的可用选项取决于列的配置（在项目开发期间进行），任何无效选项都将灰显。

对数据进行排序

数据可以按以下任一方式根据特定列进行排序：

• 点击相应的列标题；排序将在升序和降序之间进行切换，如标题文本旁边的箭头所示
• 使用列的下拉菜单专门选择​升序排序​或​降序排序;同样，在标题文本的正旁边，将用箭头指示

组和当前数据图

在相应的列上，您可以从列的下拉菜单中选择​按此列分组。 这将根据该列中的每个不同值对数据进行分组。 您可以选择多个要分组的列。 当列中的数据不适当时，选项将灰显；例如，每个条目都是不同且唯一的，因此无法组成组，例如用户报表的“用户ID”列。

在将至少一列分组后，将根据此分组生成​当前数据​的饼图。 如果将多个列分组，则图表中也会显示这一情况。

将光标移到饼图上将显示相应区段的聚合值。 它使用当前为列定义的聚合；例如，计数、最小值、平均值等。

过滤器和聚合

在相应的列上，您还可以从列的下拉菜单中配置​过滤器设置​和/或​聚合。

筛选器

过滤器设置允许您指定要显示的条目的条件。 可用的运算符包括：

• contains
• equals

要设置过滤器，请执行以下操作：

1. 从下拉列表中选择所需的运算符。
2. 输入要筛选的文本。
3. 单击​Apply。

要取消激活过滤器，请执行以下操作：

1. 删除过滤器文本。
2. 单击​Apply。

聚合

您还可以选择聚合方法（这些方法可能因所选列而异）：

列属性

仅当Generic column在用户报表中使用了Generic column时，此选项才可用。

历史数据

在​历史数据​下可看到数据随时间变化的图表。 这是从定期拍摄的快照派生的。

数据为：

• 收集者（如果可用）是第一个已排序列，否则是第一个（非分组）列
• 按相应列分组

可以生成报表：

1. 在所需列上设置​Grouping。

2. ​​编辑配置以定义应创建快照的频率；每小时或每天。

3. 完成…… 用于开始快照集合的定义。

   左上角的红色/绿色滑块按钮指示何时收集快照。

结果图表显示在右下方：

数据收集开始后，您可以选择：

• 时间段

  您可以选择要显示的报表数据的开始日期和结束日期。

• 间隔

  可以选择月、周、日、小时，以进行报表的规模和汇总。

  例如，如果每日快照在2011年2月可用：

  • 如果间隔设置为Day，则每个快照在图表中显示为一个值。
  • 如果间隔设置为Month，则2月份的所有快照都会聚合为一个值（在图表中显示为单个“点”）。

选择您的要求，然后单击​Go​以将这些要求应用到报表。 要在进一步创建快照后更新显示屏，请再次单击​Go。

在收集快照时，您可以：

• 使用​完成……再次​以重新初始化集合。

  完成 “冻结”报表的结构（即分配给报表的列，这些列经过分组、排序、过滤等）开始拍摄快照。

• 打开​编辑​对话框以选择​无数据快照​以终止收集，直到需要为止。

  ​​“编辑”可仅打开或关闭快照的拍摄。如果再次打开快照，则会使用上次完成时报表的状态，以便进一步拍摄快照。

显示限制

历史数据报表的外观也可能因可设置的限制而略有变化，这取决于所选时段的结果数。

每个水平线都称为系列（对应于图表图例中的一个条目），每个垂直圆点列都表示聚合的快照。

为了在较长的时间段内保持图表清洁，可以设置一些限制。 对于标准报表，这些报表包括：

• 水平系列 — 默认和系统最大值均为9

• 垂直汇总快照 — 默认值为35（每个水平系列）

因此，当超出（适当）限制时：

• 不会显示点
• 历史数据图表的图例可能显示与当前数据图表不同的条目数

自定义报表还可显示所有系列的​总计​值。 它显示为系列（图例中的水平行和条目）。

编辑（报表）

编辑​按钮可打开​编辑报表​对话框。

这是定义用于收集历史数据快照的时段的位置，但也可以定义各种其他设置：

• 标题

  您可以定义自己的标题。

• 描述

  您可以定义自己的描述。

• 根路径 (仅对某些报表处于活动状态)

  使用此选项可将报表限制为存储库的（子）部分。

• 报表处理

  • 自动刷新数据

    每次更新报表定义时，报表数据都会刷新。

  • 手动刷新数据

    此选项可用于防止在有大量数据时自动刷新操作导致的延迟。

    选择此选项表示当报表配置的任何方面发生更改时，必须手动刷新报表数据。 这还意味着，一旦您更改了配置的任何方面，报表表就会被清空。

    选择此选项后，将显示​Load data​按钮（位于报表的​Edit​旁边）。 加载 数据将加载数据并刷新显示的报表数据。

• ​
  快照您可以定义快照的制作频率；每天、每小时或根本不是。

加载数据

仅当从​Edit​中选择了​手动刷新数据​时，才会显示​Load data​按钮。

单击​加载数据​将重新加载数据并更新所显示的报表。

选择手动刷新数据意味着：

1. 一旦更改报表配置，报表数据表将被清空。

   例如，如果更改列的排序机制，则不会显示数据。

2. 如果希望再次显示报表数据，则需要单击​Load data​以重新加载数据。

完成（报告）

在​完成​报表时：

• 报告定义​自该时间点起将用于拍摄快照（之后，您可以继续处理报告定义，因为它与快照分开）。
• 将删除任何现有的快照。
• 为历史数据收集新快照。

通过此对话框，您可以为生成的报表定义或更新自己的标题和描述。

报表类型

组件报告

组件报表提供有关您的网站如何使用组件的信息。

有关以下 项的信息列：

• 作者
• 组件路径
• 组件类型
• 上次修改时间
• 页面

表示您可以看到，例如：

• 在何处使用哪些组件。

  例如，在测试时很有用。

• 特定组件的实例的分发方式。

  如果特定页面(例如，“页面繁多”)遇到性能问题。

• 识别网站中更改频繁/较少的部分。

• 了解页面内容随时间的推移而如何发展。

所有组件均包含在内，产品标准组件和特定于项目的组件中。 使用​编辑​对话框，用户还可以设置定义报表起点的​根路径 — 该根下的所有组件都将被考虑到报表中。

磁盘使用情况

磁盘使用情况报表显示有关存储在您的存储库中的数据的信息。

报表在存储库的根(/)中启动；通过单击特定分支，您可以在存储库内向下展开（当前路径将反映在报表标题中）。

运行状况检查

此报表分析当前请求日志：

<cq-installation-dir>/crx-quickstart/logs/request.log
以帮助您确定给定时间段内最昂贵的请求。

要生成报表，您可以指定：

• 期间（小时）

  要分析的小时数（过去）。

  默认: 24

• 最大. 结果

  最大输出行数。

  默认: 50

• 最大. 请求

  要分析的请求数上限。

  默认：-1（全部）

• 电子邮件地址

  将结果发送到电子邮件地址。

  可选；默认：空白

• 每日运行时间：(hh:mm)

  指定报表每天自动运行的时间。

  可选；默认：空白

页面活动报告

页面活动报表列出了页面以及对页面执行的操作。

有关以下 项的信息列：

• 页面
• 时间
• 类型
• 用户

表示您可以监控：

• 最新修改。
• 在特定页面上工作的作者。
• 最近未修改的页面，因此可能需要执行操作。
• 更改次数最多/最不频繁的页面。
• 最多/最不活动的用户。

页面活动报表从审核日志中获取其所有信息。 默认情况下，根路径配置为位于/var/audit/com.day.cq.wcm.core.page的审核日志。

用户生成的内容报告

此报表提供有关用户生成内容的信息；评论、评级或论坛。

有关以下 内容的列：

• 日期
• IP 地址
• 页面
• 引用
• 类型
• 用户标识符

允许您：

• 查看哪些页面收到的评论最多。
• 获取特定网站访客离开的所有评论的概述，这些问题可能与之相关。
• 通过监控在页面上进行评论时，判断新内容是否会引发评论。

用户报告

此报表提供有关已注册帐户和/或用户档案的所有用户的信息；这可以包括组织内的作者和外部访客。

有关以下信息列 （如果可用）：

• 年龄
• 国家/地区
• 域
• 电子邮件
• 姓氏
• 性别
• 通用
• 名字
• 信息
• 关注
• 语言
• NTLM 哈希码
• 用户 ID

允许您：

• 查看用户的人口统计分布。
• 报告已添加到用户档案的自定义字段。

一般列

“用户报表”中提供了​Generic​列，以便您能够访问自定义信息，通常从用户配置文件访问；例如，收藏颜色，详见向配置文件定义添加字段中。

当您执行以下任一操作时，将打开“常规”列对话框：

• 将通用组件从Sidekick拖到报表中。
• 为现有的“通用”列选择“列属性”。

在​Definitions​选项卡中，您可以定义：

• 标题

  您自己的通用列标题。

• 属性

  存储库中存储的属性名称，通常在用户的配置文件中。

• 路径

  通常，属性是从profile中获取的。

• 类型

  从String、Number、Integer、Date中选择字段类型。

• 默认聚合

  这定义了当列在至少具有一个分组列的报表中未分组时，默认使用的聚合。 从Count、Minimum、Average、Maximum、Sum中选择所需的聚合。

  例如，String字段的​计数​表示在聚合状态下为列显示不同的String值的数量。

在​Extended​选项卡中，您还可以定义可用的聚合和过滤器：

工作流实例报告

这为您提供了简洁的概述，其中提供了有关运行和已完成的工作流各个实例的信息。

有关以下 项的信息列：

• 已完成
• 持续时间
• 发起者
• 模型
• 有效负荷
• 启动时间
• 状态

这意味着您可以：

• 监控工作流的平均持续时间；如果定期发生这种情况，可能会突出显示工作流存在的问题。

工作流报告

这会提供有关实例上运行的工作流的关键统计信息。

在发布环境中使用报表

按照特定要求配置报表后，您可以将其激活以将配置传输到发布环境。

然后，可在

/etc/reports

例如，用户生成的内容报表可在以下位置找到：

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

此时将报告从发布环境收集的数据。

由于发布环境中不允许进行报表配置，因此​编辑​和​完成​按钮不可用。 但是，如果正在收集快照，则可以为​历史数据​报表选择​期间​和​间隔。

运行报表所需的权限

所需的权限取决于操作：

• 报表数据基本上是使用当前用户的权限收集的。
• 使用完成报告的用户权限收集历史数据。

在标准AEM安装中，为报表预设了以下权限：

• 用户报告

  user administrators — 读写

• 页面活动报告

  contributors — 读写

• 组件报告

  contributors — 读写

• 用户生成的内容报告

  contributors — 读写

• 工作流实例报告

  workflow-users — 读写

administrators组的所有成员都具有创建新报告的必要权限。