将 IT 度量标准发布到移动设备 › 为 CSV 文件配置连接器

为 CSV 文件配置连接器

通过 CA Executive Insight，您可以在移动设备上查看关键的公司业务度量标准。 这些业务度量标准可以来自许多不同源，包括 CSV （分隔符分隔值）文件，这些文件以纯文本格式存储表格数据。 CA Executive Insight 支持以下分隔符：逗号、分号、冒号以及 Tab 键。

CA Executive Insight 使您可以将 CSV 文件数据上传到 CA Executive Insight 数据库中。 您可以在移动设备上获得此数据。

遵循这些步骤:

1. 获得或创建一个或多个包含要使用该产品查看的数据的 CSV 文件。

   CSV 文件必须具有一行时间戳和一列度量标准名称，或具有一行度量标准名称和一列时间戳。 CSV 文件也可以具有针对每个度量标准名称的度量标准路径或度量单位。 度量单位、路径或全部两者必须在不同的行或列中，但它们的方向必须与度量标准名称的方向相同。

   注意：建议 CSV 文件的最大文件大小为 2 MB。 但该值是可配置的值，因此可以根据需要更新此值。

   重要信息！ 增加文件大小将会导致服务器进程用光内存，具体取决于服务器正在处理的其他负载。 如果数据的持久性不够迅速，还有可能会丢失数据。 更改此值前，应先执行警告。

   您可以在以下位置更新此属性：

   Windows

   install_dir\config\execConfig.properties
   

   Linux

   install_dir/config/execConfig.properties
   

   install_dir

   指定 CA Executive Insight 的安装目录。

   您可以通过编辑值来更新此属性：

   service.dirMonitor.maxCsvFileSize=<desired file size in Megabytes>
   

2. 登录到管理用户界面。
3. 在“管理”选项卡下单击“度量标准连接器”。

   “度量标准连接器”页面打开。

4. 单击“新添”，并从下拉列表中选择“CSV 连接器”。

   此时将打开“新通用 CSV 文件连接器”页面。

5. 填充必需字段。 将鼠标悬停在各个字段上，可获得字段的说明。

   名称

   定义连接器的名称。

   限制：最多 255 个字符

   连接器名称用作 CA Executive Insight 默认位置的文件夹名称；因此，?、%、#、;、|、<、>、\ 和 / 等特殊符号无法用于连接器名称。

   注意：连接器名称应是唯一的。

   说明

   （可选）定义连接器的说明。

   限制：最多 512 个字符

   文件夹位置

   默认文件夹位置为：

   <Executive Insight installation directory>/csvUploads/<connector name>
   

   您也可以指定文件夹位置。 要指定不同的文件夹位置，您可以利用本地或远程计算机上的文件夹。 文件夹应该已经存在，因为 CA Executive Insight 不会创建文件夹；如果文件夹不存在，将会显示一条错误消息。

   请指定要访问此文件夹的完整路径。 远程计算机上的共享文件夹应为读写共享。 只读共享将会导致错误。 如果该产品无法访问位于非默认位置上的文件夹，则在日志文件中将会记录一条错误消息。 文件夹可访问/可到达时，该产品恢复监控。

   分隔符

   从具有四个选项（逗号、分号、冒号以及 Tab 键）的下拉列表中选择 CSV 文件的分隔符。

   默认：逗号

   数据起始行编号

   在 CSV 文件中数据开始的位置输入所需的行编号。 支持编号从 1 开始。

   数据起始列编号

   在 CSV 文件中数据开始的位置输入所需的列编号。 支持与 Excel 使用的约定类似的字母和数字。

   在正被使用的文件中，在数据起始行和数据起始列的值之后不应存在非数字值。

   数据组织

   从下拉列表中选择 CSV 文件中数据的方向。

   • 按照列列出时间－表示在 CSV 文件中针对每个度量标准，每列按单个时间戳显示数据。
   • 按照行列出时间－表示每行按单个时间戳显示数据。

   时间戳行编号/时间戳列编号、度量标准名称行编号/度量标准名称列编号、度量标准路径行编号/度量标准路径列编号

   这些字段表示能够找到这些字段的行/列。

   度量单位行编号/度量单位列编号

   该字段不是必填字段。 可以在上传的文件中指定该字段。 仅当创建业务指标时才考虑该字段。 升级或忽略业务指标的值时，不会在后续的上传中更新此字段。 要更新现有业务指标的值，请参阅“自定义基本业务指标”。

   如果 CA Executive Insight 不再支持此值，则将忽略此值，并针对此操作写入日志文件消息。

   日期/时间格式

   使用下拉列表选择多个日期/时间格式，也可以指定特定于您组织的任何格式。 此格式不能包含所选的分隔符。

   注意：在正被使用的文件中，在数据起始行和数据起始列的值之后不应存在非数字值。 后面的所有值都应为度量标准数据。

6. 单击“保存”。

   连接器的所有属性均能够更新，并将用于所处理的下一个文件。 此时将创建 CSV 连接器。

7. 将 CSV 文件放在默认文件夹或您指定的文件夹位置中。

   CA Executive Insight 每分钟扫描指定的文件夹位置，从在该目录中找到的所有 CSV 文件中提取数据，并创建或更新相应的业务指标。 将仅处理 CSV 文件类型（具有“.csv”扩展名）；所有其他的文件类型/扩展名将被忽略。 对于每个 CSV 文件，如果提取成功，将从源目录中删除该文件。 如果提取失败，将对文件名附加“.bad”扩展名，且文件将仍保留在受监控的目录中。 CA Executive Insight 会将文件提取/上传的所有错误消息输出到日志文件中。

   业务指标由度量标准名称和度量标准路径数据进行唯一标识。

   CA Executive Insight 按每分钟粒度保存数据。 每分钟将最多保存 1 个数据值。 如果每分钟有多个数据值，则将保存与时间戳相关的第一个值。 所有其他值将被忽略。

   数据每小时在半点聚合一次，如在 12:30、1:30 等聚合一次。 在聚合运行前，不会提供针对 15M（15 分钟）或 1H（1 小时）之外的时段的任何数据。 所有 1 小时以前的数据将在数据聚合后显示。 对于某些文件，可能需要 2 个聚合周期。

   如果已在数据库中上传新文件，该文件具有针对时间戳的现有业务指标的数据，则将使用已更新的值，且将重新运行聚合。

注意：CSV 中找到的所有度量标准都会自动成为业务指标。 您无需像使用其他类型连接器那样选择度量标准。

日期/时间格式注意事项

日期和时间格式不区分大小写。 字母“m”是基于是否检测到“h”或“s”来区分上下文的。 如果检测到时，则接下来的“m”值将为分，或者如果在“m”实例之后直接检测到秒；否则，“m”将表示月。