配置虚拟代理

可使用 agentclusters.xml 文件配置虚拟代理，该文件位于代理向其报告的企业管理器的 <EM_Home>/config 目录中。如果您运行群集企业管理器，请使用 MOM <EM_Home>/config 目录中的 agentclusters.xml 文件来配置虚拟代理。 <EM_Home>/config 目录中提供了一个示例 agentclusters.xml。

示例 agentclusters.xml 定义了 Introscope SuperDomain 中名为 BuyNowAppCluster 的虚拟代理。该虚拟代理包括任意主机上的所有代理，其代理名称以 BuyNow 开头。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<agent-clusters xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:noNamespaceSchemaLocation="agentclusters0.1.xsd" version="0.1" >
   <agent-cluster name="BuyNowAppCluster" domain="SuperDomain" >
      <agent-specifier>.*\|.*\|BuyNow.*</agent-specifier>
      <metric-specifier>Frontends\|.*</metric-specifier>
   </agent-cluster>
</agent-clusters>

根元素 <agent-clusters> 是必需的元素。 <agent-cluster> 元素定义了一个虚拟代理，该元素具有两个必需的属性：

name－如果定义多个虚拟代理，则每个虚拟代理必须具有唯一的名称。
domain－将虚拟代理分配给 Introscope 域。
如果代理-群集定义中没有定义任何域（如 domain=""），则虚拟代理默认为 SuperDomain。

如果定义多个虚拟代理，应为每个虚拟代理各定义一个 <agent-cluster> 元素。 <agent-cluster> 元素需要具有两个子元素：

<agent-specifier>－包含一个用于指定虚拟代理中的代理的正则表达式，它使用标准的完全限定代理名称：
<host> | <process> | <agentName>
<metric-specifier>－包含一个前缀，该前缀按照资源类型或资源类型实例的子集指定要从虚拟代理中的代理收集的度量标准。建议使用以下前缀：
- Frontends
- CPU
- JMX
- WebSpherePMI

注意：使用以上建议的前缀时，任何资源均可用作度量标准说明符。

<agent-cluster> 元素可以包含多个 <metric-specifier> 节。

注意：较高的匹配度量标准量会大大增加企业管理器的开销，并最终影响企业管理器的容量。

重要信息！ 允许使用正则表达式和通配符度量标准说明符（如“.*”和“(.*)”），但是如果确实需要，应当谨慎使用。使用通配符会生成大量度量标准并影响性能。

要在特定浏览树域节点下显示虚拟代理，请定义 tgtDomain 属性。

tgtDomain — 定义目标域，会在其中复制域属性中定义的虚拟代理度量标准以显示在浏览树中。
- 如果没有定义 tgtDomain，域则命名为 tgtDomain。
- 如果 tgtDomain 值不是在 domains.xml 中定义的有效域，Introscope 则无法创建目标域浏览树节点。
- 要查看使用 tgtDomain 属性定义的域，用户必须在 domains.xml 中定义了权限。有关 domains.xml 权限的信息，请参阅《CA APM 安全指南》。

该示例 agentclusters.xml 定义了名为 BuyNowAppCluster 的虚拟代理，该代理在 Introscope SuperDomain 节点中有所定义并显示在 MyDomain 节点中。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<agent-clusters xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:noNamespaceSchemaLocation="agentclusters0.1.xsd" version="0.1" >
   <agent-cluster name="BuyNowAppCluster" domain="SuperDomain" tgtDomain="MyDomain"
      <agent-specifier>.*\|.*\|BuyNow.*</agent-specifier>
      <metric-specifier>Frontends\|.*</metric-specifier>
   </agent-cluster>
</agent-clusters>

在这种情况下，具有仅查看 MyDomain 域的权限的 CA APM 用户会看到以下“浏览”树：

自定义度量标准主机 (虚拟)

自定义度量标准进程 (虚拟)

BuyNowAppCluster