配置 Cross-Enterprise_APM_Dynamic.properties 文件

如何安装和配置 CA APM 跨企业 › 安装和配置 CA APM 跨企业代理 › 配置 CA APM 跨企业代理 › 配置 Cross-Enterprise_APM_Dynamic.properties 文件

配置 Cross-Enterprise_APM_Dynamic.properties 文件

Cross-Enterprise_APM_Dynamic.properties 文件是主要扩展配置文件，因为它允许您指定 CA APM 跨企业的以下设置：

要保留的性能表现最差的事务
筛选要监控的 CICS 区域的正则表达式模式
筛选要监控的事务组的正则表达式模式
筛选要监控的队列管理器的正则表达式模式
筛选要监控的队列的正则表达式模式
筛选要监控的 IMS 子系统的正则表达式模式
筛选要监控的 IMS 事务组的正则表达式模式
筛选要监控的数据通信地址空间的正则表达式模式
筛选要监控的 TCP/IP 堆栈的正则表达式模式
关闭 z/OS 度量标准收集的选项
关闭 SYSVIEW 度量标准收集的选项
事务跟踪单击直览功能的 URL 格式
报告静态度量标准的频率
检索 CA SYSVIEW 度量标准的度量标准更新时间间隔
连接到特定 CA SYSVIEW 所需的参数
关闭 z/OS 度量标准收集或全部度量标准收集的配置选项
允许为每个度量标准类别设置不同收集时间间隔的配置选项
必须适当地设置下列配置属性，以从在本地 LPAR 上运行的一个或多个 CA Insight DPM for DB2 for z/OS 代理中收集度量标准：
- Insight.metrics.collect－此配置参数决定是否从在本地 LPAR 上运行的任何 CA Insight DPM for DB2 for z/OS 实例中收集度量标准。如果此参数设置为 no，则不会收集特定于 DB2 的度量标准。如果此参数设置为 yes，则 Cross-Enterprise APM 代理会尝试联系 CA Insight DPM for DB2 for z/OS 的已配置的 XNET 代理子任务，并检索特定于 DB2 的度量标准。
- Insight.connection.port－此配置参数允许您指定由 CA Insight DPM for DB2 for z/OS 的本地 XNET 代理子任务使用来侦听查询请求的 TCP/IP 端口。必须为 Cross-Enterprise APM 代理启用和配置此 XNET 代理子任务以收集特定于 DB2 的度量标准。
- Insight.passticket.support－此配置参数决定在将身份验证信息发送到 CA Insight DPM for DB2 for z/OS 的 XNET 代理子任务时是否使用 PassTicket。为了使用 PassTicket 身份验证，您必须适当地配置活动的 z/OS 安全管理器以允许 PassTicket 创建，用于启动 Cross-Enterprise APM 代理的用户帐号必须具备创建 PassTicket 的适当权限，并且 XNET 代理子任务必须已配置为允许 PassTicket 身份验证。如果此参数设置为 yes，身份验证时会使用 PassTicket，而不是用户密码。如果此参数设置为 no，您必须在 Insight.password 配置参数中指定有效的用户密码。
- Insight.passticket.appl－如果 Insight.passticket.support 参数设置为 yes，则应使用此配置参数来指定用于生成 PassTicket 身份验证标记的应用程序名称。必须通过在 PASSNAME() 配置参数中指定相同的值，来配置 CA Insight DPM for DB2 for z/OS 的 XNET 代理子任务以使用此应用程序名称。
- Insight.username－此配置参数可用于指定发送给 CA Insight DPM for DB2 for z/OS 的 XNET 代理子任务来进行身份验证的用户名。必须始终指定此参数，无论是否已启用 PassTicket 支持。
- Insight.password－此配置参数可用于指定发送给 CA Insight DPM for DB2 for z/OS 的 XNET 代理子任务来进行身份验证的用户密码。如果未启用 PassTicket 支持，则必须指定此参数。如果已启用 PassTicket 支持，则必须使此参数保持空白。出于安全原因，应使用 PassTicket 身份验证来避免将未加密的密码保存在配置文件中。
- Insight.DB2.subsystem.name.list－此配置参数可用于指定 CA APM 跨企业代理监控的本地 DB2 实例。已建立一个到监控 DB2 子系统（已在以逗号分隔的列表中指定）的 CA Insight DPM for DB2 for z/OS 每个数据收集器实例的连接。为了从所有正在监控 DB2 子系统的所有本地 CA Insight for DB2 for z/OS 数据收集器实例中收集度量标准，应为此参数的值指定“*”通配符。
- 在 Cross-Enterprise_APM_Dynamic.properties 文件中列出的以 Insight 前缀开头的其余配置参数包含可在大多数安装中正常起作用的默认值。

下列 Insight 配置属性会影响本地 DB2 子系统的度量标准收集性能：

Insight.DB2.subsystem.refresh.interval－此配置参数可用于指定 Cross-Enterprise APM 代理刷新可访问 DB2 子系统列表以及将状态查询提交给每个 DB2 子系统的频率。此参数的默认值是 Insight.update.interval 参数值的一半。此默认值可适用于大多数情况，但在必要时可更改此参数值。默认值为 60 秒或 Insight 更新时间间隔的一半。
Insight.DB2.subsystem.refresh.threads－此配置参数可用于指定使用多少个操作系统线程处理定义为在 DB2 子系统刷新时间间隔期间运行的任务。此参数的默认值是 1，这意味着可使用单个线程向每个配置的 DB2 子系统发出状态查询。如果 DB2 子系统刷新时间间隔需要更快速地执行，则可以增加此配置参数的值以允许多个任务同时执行（代价是在刷新时间间隔期间的 CPU 消耗增多）。
Insight.update.interval－此配置参数可用于指定 Cross-Enterprise APM 代理从每个配置的 DB2 子系统检索更新的度量标准值的频率。此参数的默认值是为 SYSVIEW.update.interval 参数定义的值。可以增加此配置参数的值，这将降低配置的 DB2 子系统用于处理度量标准值查询的速率。默认值为 120 秒。
Insight.update.threads－此配置参数可用于指定使用多少个操作系统线程处理发送给每个配置的 DB2 子系统的度量标准值查询。此参数的默认值是 1，这意味着可使用同一线程按顺序处理每个配置的 DB2 子系统查询。如果度量标准更新时间间隔需要更快速地执行，则可以增加此配置参数的值以允许多个度量标准值查询同时执行（代价是在度量标准更新时间间隔期间的 CPU 消耗增多）。

属性文件包含显式详细信息、示例，并且列出可帮助您选择最适合环境的内容的配置选项。

遵循这些步骤:

打开 Cross-Enterprise_APM_Dynamic.properties 文件，该文件位于
/root/C7C4950/Cross-Enterprise_APM/config 中。
编辑并保存文本文件。
代理动态地选取更改后将应用相应更改。