报告

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

注意

这些报表仅在经典UI中可用。 有关现代UI中的系统监视和报告,请参阅操作功能板。

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

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

注意

除了开箱即用的标准AEM报表之外,您还可以开发您自己的(全新的)报表

报表自定义的基础知识

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

注意

以下报表各自具有自己的格式和自定义设置:

  • 运行 状况检查使用选择字段指定要报告的数据。
  • 磁盘 使用区使用链接向下钻取存储库结构。
  • 工作 流报表概述了在实例上运行的工作流。

因此,列配置的以下过程不合适。 有关各个报表的详细信息,请参阅其描述。

选择和定位数据列

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

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

要更改数据选择,请执行以下操作:

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

    • 绿色勾号将指示位置何时有效,并且一对箭头将指示位置的确切位置
    • 位置无效时,将显示一个红色的禁用符号
  • 要移动列,请单击标题,按住并拖动到新位置

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

列下拉菜单

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

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

reportcolumnsort

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

对数据进行排序

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

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

组和当前数据图

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

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

reportuser

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

过滤器和聚合

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

筛选器

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

  • contains
  • equals

reportfilter

要设置过滤器,请执行以下操作:

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

要取消激活过滤器,请执行以下操作:

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

聚合

您还可以选择聚合方法(这些方法可能因所选列而异):

reportagregate

列属性

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

历史数据

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

数据为:

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

可以生成报表:

  1. 在所需列上设置​Grouping

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

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

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

结果图表显示在右下方:

报告趋势

数据收集开始后,您可以选择:

  • 时间段

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

  • 间隔

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

    例如,如果每日快照在2011年2月可用:

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

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

chlimage_1-43

在收集快照时,您可以:

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

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

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

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

注意

快照存储在/var/reports/...下,其中路径的其余部分反映报告完成时创建的相应报告和ID的路径。

如果您完全确定不再需要这些实例,则可以手动清除旧快照。

注意

预配置的报表不会占用大量的性能,但仍建议在生产环境中使用每日快照。 如果可能,在一天中您的网站上没有太多活动时运行这些每日快照;可以使用​Day CQ Reporting Configuration​的Daily snapshots (repconf.hourofday)参数进行定义;有关如何配置此配置的更多详细信息,请参阅OSGI配置

显示限制

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

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

chlimage_1-44

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

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

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

因此,当超出(适当)限制时:

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

chlimage_1-45

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

注意

对于自定义报表,限制的设置方式可以不同。

编辑(报表)

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

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

reportedit

  • 标题

    您可以定义自己的标题。

  • 描述

    您可以定义自己的描述。

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

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

  • 报表处理

    • 自动刷新数据

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

    • 手动刷新数据

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

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

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


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

加载数据

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

chlimage_1-46

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

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

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

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

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

完成(报告)

在​完成​报表时:

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

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

reportfinish

报表类型

组件报告

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

有关以下 项的信息列:

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

表示您可以看到,例如:

  • 在何处使用哪些组件。

    例如,在测试时很有用。

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

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

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

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

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

reportcomponentreportcompletell

磁盘使用情况

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

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

reportdiskusage

运行状况检查

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

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

要生成报表,您可以指定:

  • 期间(小时)

    要分析的小时数(过去)。

    默认: 24

  • 最大. 结果

    最大输出行数。

    默认: 50

  • 最大. 请求

    要分析的请求数上限。

    默认:-1(全部)

  • 电子邮件地址

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

    可选;默认:空白

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

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

    可选;默认:空白

报告

页面活动报告

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

有关以下 项的信息列:

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

表示您可以监控:

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

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

reportpageactivity

用户生成的内容报告

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

有关以下 内容的列:

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

允许您:

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

reportusercontent

用户报告

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

有关以下信息列 (如果可用):

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

允许您:

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

reportuseranced

一般列

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

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

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

reportusgenercorm

在​Definitions​选项卡中,您可以定义:

  • 标题

    您自己的通用列标题。

  • 属性

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

  • 路径

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

  • 类型

    StringNumberIntegerDate中选择字段类型。

  • 默认聚合

    这定义了当列在至少具有一个分组列的报表中未分组时,默认使用的聚合。 从CountMinimumAverageMaximumSum中选择所需的聚合。

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

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

reportusgenericcolmextensiond

工作流实例报告

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

有关以下 项的信息列:

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

这意味着您可以:

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

reportworkflowinstance

工作流报告

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

reportworkflow

在发布环境中使用报表

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

注意

如果您希望发布环境的​历史数据,请在激活页面之前先​完成创作环境的报表

然后,可在

/etc/reports

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

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

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

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

reportsuckpublish

注意

访问这些报告可能是安全问题;因此,我们建议您配置Dispatcher,以便外部访客不能使用/etc/reports。 有关更多详细信息,请参阅安全检查表

运行报表所需的权限

所需的权限取决于操作:

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

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

  • 用户报告

    user administrators — 读写

  • 页面活动报告

    contributors — 读写

  • 组件报告

    contributors — 读写

  • 用户生成的内容报告

    contributors — 读写

  • 工作流实例报告

    workflow-users — 读写

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

在此页面上