구성 기반 .NET 전체 프레임워크 추적 SDK

구성 기반 SDK는 애플리케이션의 변경사항에 대해 취약합니다. 클래스 또는 메소드의 이름을 바꿀 수 있으며, 갑자기 구성이 더 이상 일치하지 않게 되어 추적 데이터가 유실됩니다. 가능한 경우, 코드 변경에 훨씬 더 탄력적으로 대응할 수 있고 목표 달성에 도움이 되는 기능이 더 풍부한 ‘.NET ’ 전체 프레임워크 SDK를 사용하시기를 권장합니다.

이 구성은 파일에 configuration.yaml 명시되어 있습니다.

다음 목록은 구성의 일반 형식을 설명합니다.

# .NET Full Framework Tracing
com.instana.plugin.clr:
  instrumentation:
    sdk:
      targets:
        - match:
            type: class
            class: '<type-name>'
            method: '<method-name>'
            arguments: <number of arguments>
          span:
            name: '<span-name>'
            type: 'ENTRY' | 'EXIT' | 'INTERMEDIATE'
            tags:
              - name: '<name of tag>'
                kind: argument
                index: <0-based index of the method's argument>
              - name: '<name of tag>'
                kind: constant
                value: '<constant value>'
              - name: '<name of tag>'
                kind: return
 

targets 키 내에 여러 대상을 정의할 수 있으며, 각 대상은 작성할 하나의 범위를 지정합니다. one의 객체는 match 계측을 target 적용할 메서드를 지정합니다. 이 span 객체는 스팬을 생성하는 방법을 지정하며, 여기에는 스팬의 이름(예: Unbounded Analytics의 call.name 필터에 사용됨)과 설정해야 할 태그가 포함됩니다.

가 계측된 Exception 메서드 외부로 전파될 경우, 해당 스팬은 자동으로 오류로 표시되며, 의 값은 오류 Exception::Message 메시지로 설정됩니다. 이 오 류 메시지는 Unbounded Analytics에서 call.error.message 태그를 통해 검색할 수 있습니다.

다음 스니펫은 일괄처리 작업을 처리하는 애플리케이션을 추적할 수 있는 방법에 대한 예제 구성을 보여줍니다.

com.instana.plugin.clr:
  instrumentation:
    sdk:
      targets:
        - match:
            type: class
            class: Example.BatchJobStarter
            method: ExecuteJob
            arguments: 1
          span:
            name: BatchJob
            type: ENTRY
            tags:
              - name: endpoint
                kind: constant
                value: BatchJob
              - name: batch.job
                kind: argument
                index: 0
        - match:
            type: class
            class: Example.ProprietaryDatabaseClient
            method: ExecuteQuery
            arguments: 1
          span:
            name: DatabaseCall
            type: EXIT
            tags:
              - name: db.connection_string
                kind: constant
                value: 'Data Source=SomeServer;Initial Catalog=SomeDB'
              - name: db.statement
                kind: argument
                index: 0
 

먼저 Example.BatchJobStarter 클래스의 ExecuteJob 메소드는 이름이 BatchJob인 항목 범위, 상수 값이 BatchJob인 endpoint 어노테이션 및 첫 번째 인수가 해당 값인 batch.job 어노테이션을 작성하도록 인스트루먼트됩니다.

또한 일괄처리 처리 중에 출력 DB 호출 (즉, Example.ProprietaryDatabaseClient의 ExecuteQuery 메소드 호출) 은 이름이 DatabaseCall 이고 어노테이션이 db.connection_string 이며 메소드 호출의 첫 번째 인수가 있는 상수 값이 Data Source=SomeServer;Initial Catalog=SomeDB 이고 어노테이션이 db.statement 인 엑시트 범위를 작성합니다.

ExecuteJob 를 사용하여 새 일괄처리를 처리하면 새 추적이 시작되고 ExecuteQuery 를 사용하는 후속 DB 업데이트가 하위 범위로 나열됩니다. Unbounded Analytics와 같은 모든 Instana 기능은 Instana AutoTrace 를 통해 생성된 추적 정보와 동일한 방식으로 사용할 수 있습니다.

다음 제한 사항은 구성 기반 .NET 전체 프레임워크 추적 SDK에 적용됩니다:

• 생성자 인스트루먼트는 지원되지 않습니다.
• 정적 메서드에 대한 인스트루멘테이션은 지원되지 않습니다.
• 한 메소드에서 범위를 시작하고 다른 메소드에서 범위를 닫는 것은 지원되지 않습니다. 즉, 구성 기반 SDK에는 autotrace에서 사용되는 MethodPairInstrumentation 에 해당하는 것이 없습니다.
• tag 를 명시적으로 작성하지 않고 모든 인수 또는 리턴 값을 캡처하는 것은 지원되지 않습니다.
• 클래스 또는 메소드의 이름 패턴 지정은 지원되지 않습니다.
• 범위를 작성하기 전에 추적 컨텍스트 복원은 지원되지 않습니다.