가상 에이전트 구성

에이전트가 보고하는 Enterprise Manager의 <EM_Home>/config 디렉터리에 있는 agentclusters.xml 파일을 사용하여 가상 에이전트를 구성합니다. 클러스터된 Enterprise Manager를 실행하는 경우에는 MOM <EM_Home>/config 디렉터리에 있는 agentclusters.xml 파일을 사용하여 가상 에이전트를 구성하십시오. 예제 agentclusters.xml 파일이 <EM_Home>/config 디렉터리에서 제공됩니다.

이 예제 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 도메인에 할당합니다.
agent-cluster 정의에 domain=""으로 정의된 도메인이 없는 경우 가상 에이전트는 기본적으로 SuperDomain에 할당됩니다.

가상 에이전트를 여러 개 정의하는 경우에는 각 가상 에이전트마다 <agent-cluster> 요소를 정의합니다. <agent-cluster> 요소에는 다음 두 가지 하위 요소가 필요합니다.

<agent-specifier> - 다음과 같이 표준 정규화된 에이전트 이름을 사용하여 가상 에이전트 내의 에이전트를 지정하는 정규식을 포함합니다.
<host> | <process> | <agentName>
<metric-specifier> - 리소스 유형이나 리소스 유형 인스턴스의 하위 집합 측면에서, 가상 에이전트 내의 에이전트에서 수집할 메트릭을 지정하는 접두사를 포함합니다. 권장되는 접두사는 다음과 같습니다.
- 프런트엔드
- CPU
- JMX
- WebSpherePMI

참고: 이러한 접두사가 권장되지만 어떠한 리소스든 메트릭 지정자로 사용할 수 있습니다.

<agent-cluster> 요소에는 <metric-specifier> 스탠자가 여러 개 포함될 수 있습니다.

참고: 일치하는 메트릭의 볼륨이 커질수록 Enterprise Manager에 부과되는 오버헤드가 커지고 궁극적으로 Enterprise Manager 수용 능력이 저하될 수 있습니다.

중요! 정규식과 ".*" 및 "(.*)" 등의 와일드카드 메트릭 지정자가 허용되지만 주의해서 사용해야 합니다. 와일드카드를 사용하면 메트릭 볼륨이 커지고 성능이 저하될 수 있습니다.

특정 "탐색" 트리 도메인 노드 아래에 가상 에이전트를 표시하려면 tgtDomain 특성을 정의하십시오.

tgtDomain - 도메인 특성에 정의된 가상 에이전트 메트릭이 "탐색" 트리에 표시되도록 복사되는 대상 도메인을 정의합니다.
- tgtDomain을 정의하지 않으면 도메인 이름이 tgtDomain으로 지정됩니다.
- tgtDomain 값이 domains.xml에 정의된 유효한 도메인이 아니면 Introscope에서 대상 도메인 "탐색" 트리 노드를 생성할 수 없습니다.
- 사용자가 tgtDomain 특성을 사용하여 정의된 도메인을 보려면 domains.xml에 정의된 권한이 있어야 합니다. domains.xml 권한에 대한 자세한 내용은 CA APM 보안 안내서를 참조하십시오.

다음 예제 agentclusters.xml에서는 Introscope SuperDomain 노드에 정의되어 MyDomain 노드에 표시되는 BuyNowAppCluster라는 가상 에이전트를 정의합니다.

<?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 사용자에게 다음 "탐색" 트리가 표시됩니다.

Custom Metric Host(Virtual)(사용자 지정 메트릭 호스트(가상))

Customer Metric Process(Virtual)(사용자 지정 메트릭 프로세스(가상))

BuyNowAppCluster