.NET Framework 모니터링을 위한 추가 기능 구성

.NET Framework 의 기본 모니터링 설정을 완료한 후에는 모니터링 기능을 강화하기 위해 추가 기능을 구성할 수 있습니다.

이 주제에서는 다음과 같은 추가 기능을 다룹니다:

사용자 정의 추적

.NET Instana 의 추적 SDK를 사용하면 Instana 에서 자동으로 추적하지 않는 구성 요소에 대해 사용자 지정 추적을 활성화할 수 있습니다.

프로세스 무시

환경 변수를 설정하여 특정 프로세스를 `.NET Framework ` 추적에서 제외할 수 있습니다.

Windows 에서 특정 프로세스의 모니터링을 제외하려면 다음 단계를 수행하십시오:

  1. 호스트 수준에서 환경 변수를 INSTANA_REWRITER_BACKOFF 추가하십시오.
  2. 다음 예시와 같이 세미콜론으로 구분된 풀 이름 또는 프로세스 이름 목록으로 값을 설정하십시오:
    INSTANA_REWRITER_BACKOFF=my_pool_1;process_1;my_pool_2
  3. IIS가 새로운 환경을 불러올 수 있도록 다음 iisreset 명령을 사용하여 IIS 서비스를 다시 시작하십시오.

화이트리스트 등록 절차

Instana 의 화이트리스트 기능을 사용하면 특정 프로세스만 추적하도록 설정할 수 있습니다. 화이트리스트가 구성되면, 지정된 패턴과 일치하는 프로세스만 추적 대상으로 지정됩니다. 그 외의 모든 프로세스는 제외됩니다.

화이트리스트 기능은 대소문자를 구분하지 않는 정규 표현식을 사용하며 세미콜론으로 구분된 값을 지원하므로, 유연한 프로세스 일치를 위해 여러 패턴을 정의할 수 있습니다.

특정 프로세스에 대해 화이트리스트 기능을 활성화하려면 다음 단계를 따르십시오:

  1. 호스트 수준에서 환경 변수를 INSTANA_NET_WHITELIST 추가하십시오.
  2. 다음 예시와 같이 값을 세미콜론으로 구분된 프로세스 이름 목록이나 정규식 패턴으로 설정하십시오:
    INSTANA_NET_WHITELIST="^(weBapi|cORe).*;DefaultAppPool;myApp.exe"

    상황:

    • ^(weBapi|cORe).* 대소문자를 구분하지 않고 또는 core 로 webapi 시작하는 프로세스를 일치시킵니다. 이 패턴은 정규식 앵커와 와일드카드를 사용하여 여러 관련 애플리케이션을 일치시킵니다.
    • DefaultAppPoolDefaultAppPool .로 시작하는 IIS 애플리케이션 풀 이름에 대해 대소문자를 구분하지 않고 일치 여부를 확인합니다. DefaultAppPoolAPI예를 들어, 또는 과 같은 DefaultAppPool IIS 풀과 일치합니다.
    • myApp.exe 특정 애플리케이션을 전체 파일 이름 및 파일 확장자와 일치시킵니다.
  3. IIS에서 호스팅되는 애플리케이션의 경우, 환경 변수가 적용되도록 다음 iisreset 명령을 사용하여 IIS 서비스를 다시 시작하십시오. IIS가 아닌 응용 프로그램의 경우, 응용 프로그램을 다시 시작하십시오.

화이트리스트가 구성되면, 프로파일러는 초기화 과정에서 각 프로세스를 화이트리스트 패턴과 대조하여 확인합니다. 적어도 하나의 패턴과 일치하는 프로세스만 모니터링 대상이 됩니다. 일치하는 항목이 발견되지 않으면, 프로파일러는 프로세스에 연결하지 않고 종료됩니다.

화이트리스트 기능은 특히 다음과 같은 환경에서 유용합니다:

  • 중요한 애플리케이션만 추적하여 오버헤드를 줄이세요
  • 모니터링을 위해 특정 서비스를 분리합니다
  • 비생산 또는 테스트 프로세스를 추적에서 제외
참고:
환경 INSTANA_NET_WHITELIST 변수가 설정되어 있지 않거나 비어 있는 경우, 모든 프로세스는 추적 대상이 됩니다(를 통해 구성된 블랙리스트 규칙이 적용되는 경우를 제외하고 INSTANA_REWRITER_BACKOFF).

스팬 필터링 구성

스팬 필터링 기능을 사용하면 어떤 스팬을 수집하여 Instana 으로 전송할지 제어할 수 있어, 데이터 양을 줄이고 가장 관련성 높은 트레이스에 집중하는 데 도움이 됩니다. .NET 센서는 다양한 구성 방법을 통해 유연한 스팬 필터링을 지원합니다.

자세한 내용은 ‘스팬 필터링’을 참조하십시오.

스택 트레이스 구성

중요:
스택 트레이스 구성 기능이 도입됨에 따라, .NET Framework Tracer 1.321.2 에서 환경 INSTANA_OMIT_CALLBACK 변수는 더 이상 사용되지 않게 되었습니다.

스택 트레이스 구성을 사용하여 Instana 에서 수집 및 처리하는 스택 트레이스 데이터의 양을 제어할 수 있습니다. .NET Framework Tracer를 구성하여 다음 작업 중 하나를 수행하도록 설정할 수 있습니다:

  • 오류가 발생한 EXIT 스팬에 대해서만 스택 트레이스를 수집합니다
  • 스택 트레이스 수집 비활성화
  • 스택 트레이스 깊이 제어
참고:
HTTP 오류를 발생시키는 진입 및 종료 스팬(span.ec=1)은 구성된 스택 트레이스 모드와 관계없이 항상 스택 트레이스를 보고합니다.

자세한 내용은 ‘.NET Framework 용 스택 트레이스 구성’을 참조하십시오.

AutoProfile 활성화

.NET Framework 사용자의 경우, .NET Framework 4.7.2 이상을 실행하는 애플리케이션에서 AutoProfile 를 사용할 수 있습니다.

AutoProfile, 를 활성화하려면 다음 단계를 따르세요:

  1. 에이전트의 configuration.yml 파일에 다음 설정을 추가하십시오:
    com.instana.plugin.clr:
  profiling:
    enabled: true
  2. true환경 변수를 INSTANA_AUTO_PROFILE 로 설정하십시오.

자세한 내용은 ‘프로필 분석’을 참조하십시오.