创建报告模板

Introscope 报告 › 创建报告模板

创建报告模板

报告模板定义了要跟踪的度量标准数据、已报告度量标准数据的时间范围，以及如何以图形和表格形式呈现数据。保存报告模板后，任何用户都可随时生成报告。

创建报告模板：

在“管理模块编辑器”中，选择“元素”>“新建报告模板”。
注意：如果没有写权限，“新建报告模板”菜单项会被禁用。

此时将打开“新建报告模板”对话框。
指定报告的初始元素。
1. 输入新报告模板的名称。
2. 选择“强制唯一性”以验证报告名称是否唯一。
如果选择了此选项，然后又输入非唯一的名称，Introscope 会在该名称中添加数字，使之成为唯一的名称。

注意：创建报告模板之后，在管理模块编辑器中查看时即可看到附加的数字。如果未选择“强制唯一性”且存在相同的报告模板名称，Introscope 将显示一条错误消息且不会创建报告。
1. 从下拉列表框中选择一个“管理模块”，选择将包含报告的“管理模块”。
2. 可选：如果不选择现有“管理模块”来包含报告，请单击“选择”，然后单击“新建管理模块”，为新“管理模块”指定名称。
3. 单击“确定”。
有关创建管理模块的详细信息，请参阅“创建和使用管理模块”。

新报告模板被添加在“管理模块编辑器”中，设置窗格会打开。
如果准备激活报告模板，请在设置窗格中选中“活动”复选框。
生成“活动”报告模板时，报告模板会出现在“控制台”、“调查器”和“管理模块编辑器”的报告模板列表中。请参阅从报告模板生成报告。

提示：最好在创建新报告后将其保留为未激活，以便可以测试生成的报告，而不让新报告出现在列表中。报告经测试可以使用后，请单击“活动”可使之可用。
单击“打开模板编辑器”，定义报告数据。
在“报告编辑器”中，指定报告的目的、报告运行时间和时长以及结果的外观如何。
使用工具栏将元素添加到报告中。

现在，您可以：

将诸如图表的报告元素添加到报告中－请参阅将报告元素添加到报告中。
定义报告属性－请参阅在报告编辑器中定义属性。

将报告元素添加到报告中

可以根据度量标准或度量组，将诸如图表和图形的图形元素添加到报告中。

要将图形报告元素添加到报告中：

如果报告模板编辑器尚未打开，请打开它：
1. “管理模块编辑器”打开之后，在左侧窗格中选择报告。
2. 单击“打开模板编辑器”。
右键单击左上方窗格中列出的“报告”，然后选择“添加”。
此时会显示可用元素列表。
选择元素类型之一。
一个新选项卡集将出现。

在下列步骤中，配置报告元素的设置。要保存当前的工作，请单击编辑窗口底部的“应用”。
使用“文本”选项卡，配置新报告元素的文本设置。
1. 指定要与报告元素一起出现的标题。
  默认情况下，已选择“将度量标准组名称用作标题”。如果选择此选项，元素将采用显示其数据的度量标准组的名称。（在下面第 5d 步中，将元素与度量标准组相关联。）
  
  还可以单击“输入标题”，然后键入与报告元素一起显示的新标题。
2. 可选：输入报告元素的描述。这些描述将出现在元素的工具提示中。
使用“数据属性”选项卡配置报告元素的“数据属性”。
1. 设置时间范围。
  时间范围由“开始时间”和“结束时间”定义。报告元素将以这些时间为界显示数据。
  
  “模板默认时间范围”是在默认报告属性中设置的（请参阅在报告编辑器中定义属性中的第 3 步以设置默认时间范围）。可以选择接受默认时间范围，或单击“覆盖模板默认时间范围”。
  
  要设置时间范围，请单击“开始时间”字段旁的日历图标。
  
  这时日历对话框将出现，其中当前日期（“今天”）已经圈出。
  - 使用日历对话框来设置日期，在该对话框关闭之后在文本字段中编辑时钟时间。
  - 重复上述步骤来设置“结束时间”。
2. 使用“持续时间”字段来设置报告持续时间。
注意：如果已经指定“开始时间”和“结束时间”，请将“持续时间”字段保留为空白。
1. 使用“单位”下拉列表来匹配在“持续时间”字段中输入的数字。
2. 选择度量标准组来与报告元素相关联。
  - 单击“度量标准组”标签旁边的下拉列表。
  - 此时会显示可用度量标准组列表。
  - 选择其中一个可用的度量标准组。
3. 可选：筛选与度量标准组关联的度量标准，或者定义新的度量标准组。
要筛选与度量标准组关联的度量标准，请单击“选择”并输入正则表达式。

要创建新的度量标准组，请单击“选择”，单击“新建度量标准组”，使用对话框根据管理模块来创建新的度量标准组。有关定义度量标准组的信息，请参阅《CA APM 配置和管理指南》。
1. 在元素属性表中设置元素属性的值。
在“显示属性”选项卡上设置报告元素的显示属性。
有关显示属性的信息，请参阅在报告编辑器中定义属性。
完成报告元素所有属性的设置后，单击“确定”。

在报告编辑器中定义属性

报告中的每一个元素－图表、表格、条形图和饼图－都有通过选择属性选项卡可以编辑的属性。选择“报告元素”（列表顶部的元素，标有报告标题）后，将看到使您能够指定默认属性的下列选项卡：

封面－这些属性仅应用到选定元素：报告的标题、封面上适当提供的徽标及报告的描述。
默认数据属性－指定整个报告的默认属性：数据的时间范围（开始和结束时间）、报告周期（例如 15 秒或 1 分钟）和要报告度量标准数据的规范。
报告属性－指定仅应用到此报告的格式属性（是否显示标题页和目录）以及应用到整个报告的属性（时区和语言）。
默认显示属性－定义整个报告图表和表格的默认外观。

注意：在“默认属性”和“默认显示”选项卡中对属性所做的更改将影响报告中的所有元素。单个元素自定义不受默认属性更改的影响。

在报告编辑器中定义属性：

单击“封面”选项卡指定报告的用途。
输入将在报告封面上出现的信息：

要添加	请执行
报告标题	为生成的报告键入一个标题；该标题与目录一起显示在标题页。
徽标	单击“选择”浏览徽标或其他图形文件。此处选择的任何图形都出现在标题页左上角。支持的格式包括 .jpg、.gif 或 .png。
报告介绍	键入描述生成的报告内容的文本。介绍出现在标题页上目录的上方。

单击“默认数据属性”选项卡，指定所有元素的默认时间和数据参数。
可以接受默认的数据属性，也可以设置新的：

元素	请执行
开始时间和结束时间	指定时间范围时，可指定特定开始日期和结束日期，也可以指定时间段，如“24 小时”。可以采用以下方法之一指定报告的时间范围：键入特定开始和结束日期和时间，或单击日历图标选择开始和结束日期。将“开始时间”保留为空，而使用“持续时间”和“单位”参数来指定报告运行的时长。将“结束时间”保留为空，而使用“持续时间”和“单位”参数来指定报告运行的时长。在“结束时间”中键入立即，并使用“持续时间”和“单位”参数来指定要报告的历史长度。注意：输入特定的开始或结束日期与时间时，请使用格式 mm/dd/yy hh:mm（或 dd/mm/yy hh:mm，这取决于计算机的区域设置），然后指定 AM 或 PM－例如，对“英语区域”应输入 12/15/06 10:00 AM。
Duration	键入一个数以指定报告运行的时长。此数字与“单位”值结合使用－例如，如果“单位”为小时，您可能在“持续时间”中键入 24。注意：有关“持续时间”和“单位”参数如何与“开始时间”和“结束时间”配合使用的说明，请参阅对“开始时间”和“结束时间”的解释。
单位	从下拉列表中选择一个时间单位。选项是分钟、小时、天或周。
默认时期	单击此字段可激活下拉菜单，然后选择报告的默认报告时间间隔。可以选择对该时间间隔内的所有数据进行聚合，或者选择特定的报告时间间隔－例如，15 秒、15 分钟、一天或一个星期。如果选择特定的时间间隔，将对指定时间间隔内的数据求取平均值。默认时期值是“自动”；这会根据选择的“开始和结束时间”范围自动选择时期。
默认代理覆盖表达式	如果要覆盖其他代理表达式，请输入要使用的默认表达式：如果要输入报告元素的数据属性，对于整个报告，模板中的所有元素都使用此表达式。此处输入的值会覆盖度量标准组或管理模块设置。如果要输入单个元素的数据属性，此处输入的值会覆盖为顶级元素及度量标准组或管理模块设置输入的值。该字段是可选的。如果将此字段保留为空白，Introscope 会根据度量标准组设置报告代理。如果度量标准组设置为继承管理模块的代理表达式，Introscope 会根据管理模块报告代理。注意：生成报告时，您可以指定一个代理表达式来覆盖模板代理表达式。请参阅从报告模板生成报告。
引用数据的开始时间	如果要使用来自同一度量标准组但来自不同时间范围的度量标准数据来覆盖图表，请输入日期和时间。使用覆盖时，Introscope 会识别在图表上绘制的度量标准数据，并使用来自同一度量标准组但属于您指定的时间范围的数据来覆盖这些度量标准数据。时期长度与基本度量标准组的长度相同。要指定引用数据的开始时间，可以：输入日期和时间，使用格式 mm/dd/yy hh:mm（或 dd/mm/yy hh:mm，这取决于计算机的区域设置），然后指定 AM 或 PM－例如，对“英语区域”应输入 12/15/06 10:00 AM。单击日历图标来选择开始日期。使用日历选择开始日期时，Introscope 会将时间设置为当前时间－要更改时间，请通过输入来覆盖它。

单击“报表属性”选项卡来指定报告的格式、时区和语言的设置。
输入报告的设置：

至...	请执行
显示标题页	单击“打开”来生成报告的标题页。
包括目录	单击“打开”在标题页上创建目录。
添加报告签名	输入要出现在标题页底部的签名。
时区	单击该行来打开时区列表并选择时区。默认值是“使用客户端的时区”。在这种报告中，对“报告日期”、“开始”和“结束”日期使用选定的时区。
语言	单击该行来打开语言列表。选择一种语言，根据其标准来确定报告的日期和时间的格式。例如，意大利语的日期/时间标准是 9-mar-2008 15.50；日语标准是 2008/03/09 15:50。语言设置还确定了在 PDF 文件中显示报告的字体。要在 PDF 文件中正确地显示亚洲语言文本，请确保适当地设置语言。注意：在设置为非英语语言的报告中，某些英文词将仍然出现，它们代表一些标签，不支持对这些英文词进行国际化转换。默认值是“使用客户端区域设置”，选择此选项时，日期和时间的格式取决于客户端计算机上使用的语言。注意：要生成采用亚洲语言的报告，需要在 Introscope 安装期间在“Workstation”上安装一些其他组件。有关信息，请参阅《CA APM 安装和升级指南》中有关“针对亚洲语言报告配置 Workstation”的讨论。

单击“默认显示属性”选项卡。
可以接受默认属性，也可以设置新属性，以确定报告生成之后报告中图表和表格的外观如何。

此选项卡与其他“默认”选项卡一样，可在其中设置报告中所有元素的默认属性值。例如，将“行限制”设置为 10，可以确保报告中的所有表格最多有 10 行。但是，在选择报告中的一个特定表元素之后，单击“显示属性”选项卡，然后输入新的“行限制”属性，可以为该元素覆盖此值。

注意：使用“默认显示属性”选项卡右侧的滚动条可查看所有属性。
单击“显示属性”选项卡来设置默认显示属性。
在报告中，“平均最小”、“平均最大”、“平均值”、“绝对最小”和“绝对最大”的定义如下：
- 平均最小－所有时期内最小值的未加权平均数。
- 平均最大－所有时期内最大值的未加权平均数。
- 平均值－加权平均值，计算如下：
  (tv1 + tv2 + tvn...) / dp
  
  其中 tv 是一个时期所有值的总和，dp 是所有时期数据点的总数。这给有更多数据点的时期提供更大的加权。
- 绝对最大－所有时期中实际最大或最高的一个值。
- 绝对最小－所有时期中实际最小或最低的一个值。

下表包含有关显示属性的附加信息和配置这些信息所必需的步骤。

注意：本步骤中，可能仅为报告元素类型“度量标准数据表”和“条形图”设置显示属性“对行进行排序”、“排序顺序”和“值格式”属性。不能为报告元素类型“度量标准数据条形图”和“度量标准数据图表”设置这些属性。

元素	请执行
按组聚合数据	选择此选项时，将通过对组中所有度量标准进行合计或平均来组合度量标准中的数据（根据“聚合使用”属性）。度量标准已分组时，报告中只出现组的汇总值，而不出现单个度量标准级别的值。聚合的摘要行如同表格中的度量标准级别的行或图表中的一个绘图，但是这些行的标签显示组名称而不是单个度量标准名称。组名称变为数据项的标签，替换“项标签”正则表达式。使用“组定义”正则表达式属性可确定组－请参阅设置自定义组定义。
聚合使用	如果选择“按组聚合数据”，那么将此属性设置为“总和”或“平均”，可指定分组的度量标准如何出现在报告中。
填充计时标记	如果选中此选项，在报告中将突出显示“标记开始”和“标记结束”时间之间的时间。
填充 Y 轴标记	如果选中此选项，在报告中将突出显示“Y 轴标记开始值”和“Y 轴标记结束值”之间的区域。
组定义	选择“按组聚合数据”或者“按组小计数据”时，使用此属性可定义组。可以从下拉列表中选择组，或者创建自定义正则表达式。菜单中的组选项有：完全限定度量标准名称代理位置代理位置－度量标准名称代理名称主机度量标准类别度量标准类别：度量标准名称度量标准名称 Servlet 名称选择这些选项中的一个选项，可插入适当的正则表达式。要使用自定义正则表达式创建组，请参阅时间系列条形图。
项标签	选择在图例中出现项的标签：完全限定度量标准名称代理位置代理位置－度量标准名称代理名称主机度量标准类别度量标准类别：度量标准名称度量标准名称 Servlet 名称选择一个选项时，将插入相应的正则表达式。可以使用变量或正则表达式来创建标签。请参阅设置自定义组定义。
列出代理	通过此设置，可以选择是否显示要显示其度量标准的代理列表。选中（默认）－将显示代理列表未选中－将不显示代理列表
最小/最大条	针对任何给定度量标准，绘制每一时期内的最小值和最大值。指定希望最小条形和最大条形如何出现：不显示（仅显示平均值）仅显示最大值仅显示最小值显示最小值和最大值
红线值	如果指定了红线标签，用红线标签指定 Y 轴值，该轴上绘制红线的位置表示一个报警触发器值。
红线标签	输入红线的标签。
行限制	根据“对行进行排序”设置为升序还是降序，指定一个值进行筛选，只显示在该限制以上或以下的值。
显示平均线	如果选中此选项，则在图表中显示度量标准的平均值。
显示一秒钟的片段	如果选中此选项，将显示秒的小数部分，最多向右显示六位小数。例如： 03:22.123456 代表 3 分 22 秒 123456 毫秒。 00:00.25 代表 250 毫秒。 3.13s 代表 3130 毫秒。
显示图例	如果选中此选项，则包括选择图表的图例。根据每一绘图的颜色，图例显示对应于图表中该绘图的度量标准，如果选中“显示形状”，则根据用来标记每一数据点的形状来显示对应的度量标准。
显示形状	如果选中此选项，Introscope 除了在点之间绘制线条以外，还在各点处绘制形状。如果图表有许多的度量标准或者高密度的数据，则显示形状时可能会掩盖数据，但是如果省略形状，那么将绘图与图例相关联的唯一方法是使用颜色。如果绘图只包含给定时间范围内的一个数据点，那么除非形状已出现，否则绘图不会出现在图表中。特别是，如果将时期设置为“聚合所有”，则会在图表中绘制单个值；但是如果形状未出现，则不会出现任何内容。至少需要两个数据点来绘制一条线。
显示量	如果选中此选项，每一时期内度量标准数据点的数目被绘制为报告中的一个条形。如果图表中出现一个以上的度量标准，这些量条形会彼此覆盖。
排序依据	选择如何对列进行排序：度量标准/组标签平均值平均最小平均最大绝对最小绝对最大计数总和
对行进行排序	选择“升序”或“降序”对行进行排序。
按组小计数据	在表格中，可以设置“按组小计数据”以按组对项进行排序，然后求其小计－选中“按组聚合数据”选项时，“按组小计数据”属性将无效。使用“组定义”可定义如何将度量标准组，还可提供组的标签。注意：总是在整个时间范围内汇总表格中的数据。根据“聚合使用”设置，“值”列被标记为“总和”或“平均值”。选择“总和”可将所有度量标准值加起来。
摘要行标签	输入要显示为摘要行标签的文本。
表列	选择一个值指定在报告中出现的列： “显示所有列”包括“平均值”（或“总和”，取决于“聚合使用”属性的设置）、“平均最小”、“平均最大”、“绝对最小”、“绝对最大”以及“计数” 显示平均值、最小、最大、计数显示平均值、计数 “只显示度量标准的文本值”将导致标记为“值”的单个列，它显示未定格式的度量标准。这通常用于不以零出现的“字符串”度量标准。注意：对于要报告的文本字符串值，数据的时间范围必须是过去 8 分钟的“有效范围”。
值格式	选择用于表格值显示格式以及 Y 轴格式（饼图除外）的值：常规使用 M（百万）和 B（十亿）内存值格式（MB、GB、KB）百分比 (%) 百分比 x 100 (%) 显示两个小数位以 HH:MM:SS（以小时、分和秒显示毫秒）显示的毫秒，用于值为毫秒的度量标准微秒以 HH:MM:SS（以小时、分和秒显示微秒）形式显示，用于值为微秒的度量标准以 d、h、m、s 显示的毫秒（以天、小时、分和秒显示毫秒－例如，3h 22m 36s）
X 轴标签	输入要沿图表 X 轴出现的标签。
“X 轴标记开始时间”、“X 轴开始标记标签”、“X 轴标记结束时间”和“X 轴结束标记标签”	使用这些属性，可以囊括报告图表内的一个时期，还可为出现的开始点和结束点添加标签。开始/结束日期/时间格式表示如下： 3/31/99 11:30 AM 也可以使用日历工具，将光标放在“开始时间”或“结束时间”字段时会出现日历工具。标签是文本字符串。指定时期将出现在报告图表中，以垂直线为界限，并且有标签。
“X 轴标记开始偏移(单位: 秒)”和“X 轴标记结束偏移(单位: 秒)”	这些设置提供替代选项，可设置开始标记和结束标记的绝对日期值。值是以秒为单位的偏移量，从图表开始起到标记出现位置为止。当报告的日期范围是相对于报告的开始日期和结束日期且不是从现在起的绝对日期范围时，例如，1 小时之前到现在，偏移量非常有用。对于要出现的 X 轴标记，必须设置日期或者偏移量。如果两者均已设置，则使用日期；如果两者均未设置，则不会出现任何标记。
X 轴时间格式	单击该行可从时间格式列表中进行选择
Y 轴格式	单击该行可从格式列表中选择－例如，“内存值格式 (MB、GB、KB)”或“百分比 (%)”。
Y 轴标签	键入将沿图表的 Y 轴显示的标签。
“Y 轴标记开始值”、“Y 轴标记开始标签”、“Y 轴标记结束值”和“Y 轴标记结束标签”	使用“标记开始”和“结束值”来囊括 Y 轴上的值，并为那些值提供标签。
“Y 轴上部界限”和“Y 轴下部界限”	在这些字段中输入值可指定要报告的值。您将使用这些属性，例如，您具有可能远远超出值范围的度量标准－例如 50 秒相对于 1 秒。如果在这种情况下将“上部界限”属性指定为 0.8，并将“下部界限”属性指定为 0.2，则在报告中只报告那些值之间的内容。
黄线值	指定 Y 轴值（在该轴上绘制黄线表示报警触发器值），该轴上有一个黄线标签（如果指定了标签）。
黄线标签	输入黄线的标签－例如，“响应时间缓慢”。