ProbeBuilder 지시문 작업 › 사용자 지정 추적 프로그램 생성 › 추적 프로그램 구문

추적 프로그램 구문

PBD 파일에는 추적 프로그램을 그룹에 연결하거나 그룹이 사용 또는 사용되지 않도록 설정하는 단순 키워드 외에 추적 프로그램 정의도 포함됩니다. Introscope가 추적 프로그램을 인식하고 처리하도록 하려면 사용자 지정 추적 프로그램을 구성할 때 특정 구문을 사용해야 합니다. 추적 프로그램은 지시문과 추적할 메서드 또는 클래스에 대한 정보로 구성되며 형식은 다음과 같습니다.

<directive>: [arguments]

여기서 [arguments]는 목록으로, 지시문에 따라 다릅니다. 추적 지시문에 사용되는 인수에는 <Tracer-Group>, GHOST, <method>, <Tracer-name> 및 <metric-name>이 있습니다.

참고: 사용되는 지시문에 따라 이러한 매개 변수 중 일부만이 필요합니다.

<directive>

사용자 지정 추적에 사용할 수 있는 6개의 기본 지시문이 있습니다.

• TraceOneMethodOfClass - 지정된 클래스의 지정된 메서드를 추적합니다.
• TraceAllMethodsOfClass - 지정된 클래스의 모든 메서드를 추적합니다.
• TraceOneMethodIfInherits - 지정된 클래스나 인터페이스의 모든 직접 서브클래스 또는 직접 인터페이스 구현에서 메서드 하나를 추적합니다.
• TraceAllMethodsIfInherits - 지정된 클래스나 인터페이스의 모든 직접 서브클래스 또는 직접 인터페이스 구현에 포함된 모든 메서드를 추적합니다.

참고: 구체적으로 구현된 메서드만이 추적 가능하며 실행 중에 메트릭 데이터를 보고할 수 있습니다. 사용자 지정 추적 프로그램에 추상 메서드를 지정하면 메트릭 데이터가 보고되지 않습니다.

• TraceOneMethodIfFlagged - 지정된 클래스가 TurnOn 키워드로 사용하도록 설정된 추적 프로그램 그룹에 포함된 경우 메서드 하나를 추적합니다.
• TraceAllMethodsIfFlagged - 지정된 클래스가 TurnOn 키워드로 사용하도록 설정된 추적 프로그램 그룹에 포함된 경우 모든 메서드를 추적합니다.

<Tracer-Group>

추적 프로그램을 연결할 그룹입니다.

GHOST

추적할 클래스 또는 인터페이스의 정규화된 이름입니다. 정규화된 클래스 이름에는 다음과 같이 클래스 이름뿐 아니라 클래스의 전체 어셈블리 이름도 포함됩니다.

[MyAssembly]com.mycompany.myassembly.MyClass

참고: 어셈블리 이름은 대괄호([])로 묶어야 합니다.

<method>

• 메서드 이름(예: MyMethod)

또는

• 반환 유형 및 매개 변수가 포함된 전체 메서드 서명(예: myMethod;[mscorlib]System.Void([mscorlib]System.Int32) 메서드 서명에 대한 자세한 내용은 서명 구별을 참조하십시오.

<Tracer-name>

사용할 추적 프로그램 유형을 지정합니다. 예를 들어 BlamePointTracer입니다. 추적 프로그램 이름과 추적 프로그램이 추적하는 항목에 대한 설명은 추적 프로그램 이름을 참조하십시오.

<metric-name>

수집된 데이터가 Introscope Workstation에 표시되는 방식을 제어합니다.

다음 예에서는 메트릭 트리의 서로 다른 수준에서 메트릭 이름 및 위치를 지정하는 세 가지 방법에 대해 설명합니다.

• metric-name - 메트릭이 에이전트 노드 내에 바로 표시됩니다.
• resource:metric-name - 메트릭이 에이전트 노드에서 한 수준 아래의 리소스(폴더) 내에 표시됩니다.
• resource|sub-resource|sub-sub-resource:metric-name - 메트릭이 에이전트 노드에서 두 수준 이상 아래의 리소스(폴더)에 표시됩니다. 파이프 문자(|)를 사용하여 리소스를 구분합니다.