트랜잭션 검색 및 진단

Azure Monitor Application Insights는 특정 원격 분석 항목의 정확한 파악 및 포괄적인 엔드투엔드 트랜잭션 분석을 위해 각각 트랜잭션 검색과 트랜잭션 진단을 제공합니다.

트랙잭션 검색: 이 환경을 통해 사용자는 페이지 보기, 예외, 웹 요청과 같은 개별 원격 분석 항목을 찾고 검사할 수 있습니다. 애플리케이션에 코딩된 로그 추적 및 이벤트를 볼 수 있는 기능도 제공합니다. 애플리케이션 내에서 성능 문제 및 오류를 식별합니다.

트랜잭션 진단: 종속성 및 예외를 포함하여 엔드투엔드 트랜잭션 세부 정보에 대한 포괄적인 인사이트를 통해 구성 요소의 문제를 빠르게 식별합니다. 검색 결과에서 항목을 선택하여 검색 인터페이스를 통해 이 기능에 액세스하십시오.

트랜잭션 검색

트랜잭션 검색은 페이지 보기, 예외 사항 또는 웹 요청과 같은 개별 원격 분석 항목을 찾고 검색하는 데 사용하는 Application Insights의 기능입니다. 코딩한 로그 추적 및 이벤트를 볼 수도 있습니다.

데이터에 대한 보다 복잡한 쿼리의 경우 Log Analytics를 사용합니다.

Search 기능은 어디에 있나요?

Azure Portal 또는 Visual Studio에서 검색을 찾을 수 있습니다.

Azure Portal에서

애플리케이션의 Application Insights 개요 탭에서 트랜잭션 검색을 열 수 있습니다. 왼쪽 메뉴의 조사에서 검색을 선택할 수도 있습니다.

이벤트 유형 드롭다운 메뉴로 이동하여 코딩한 서버 요청, 페이지 보기 및 사용자 지정 이벤트와 같은 원격 분석 항목 목록을 확인합니다. 결과 목록의 위쪽은 시간이 지남에 따른 이벤트의 수를 보여 주는 요약 차트입니다.

드롭다운 메뉴에서 나가거나 새로 고침을 선택하여 새 이벤트를 가져옵니다.

Visual Studio에서

Visual Studio에는 Application Insights Search 창도 있습니다. 이 창은 디버그 중인 애플리케이션에 의해 생성된 원격 분석 이벤트를 표시하는 데 가장 유용합니다. 하지만 게시된 앱에서 수집된 이벤트를 Azure Portal에 표시할 수도 있습니다.

Visual Studio에서 Application Insights 검색 창을 엽니다.

Application Insights 검색 창에는 웹 포털과 유사한 기능이 있습니다.

추적 작업 탭은 요청 또는 페이지 보기를 여는 경우에 사용할 수 있습니다. "작업"은 단일 요청 또는 페이지 보기와 관련된 일련의 이벤트입니다. 예를 들어 종속성 호출, 예외, 추적 로그 및 사용자 지정 이벤트는 단일 연산의 일부일 수 있습니다. 추적 작업 탭에는 요청 또는 페이지 보기와 관련해서 이러한 이벤트의 타이밍 및 기간을 그래픽으로 보여 줍니다.

개별 항목 검사

키 필드 및 관련 항목을 보려면 원격 분석 항목을 선택합니다.

엔드투엔드 트랜잭션 세부 정보 보기가 열립니다.

이벤트 유형 필터링

이벤트 유형 드롭다운 메뉴를 열고 보려는 이벤트 유형을 선택합니다. 필터를 나중에 복원하려면 다시 설정을 선택합니다.

이벤트 유형은 다음과 같습니다.

• 추적: TrackTrace, log4Net, NLog 및 System.Diagnostic.Trace 호출을 포함한 진단 로그입니다.
• 요청: 페이지, 스크립트, 이미지, 스타일 파일 및 데이터를 포함하는 서버 애플리케이션이 수신하는 HTTP 요청입니다. 이러한 이벤트는 요청을 만들고 개요 차트에 응답하는 데 사용됩니다.
• 페이지 보기: 웹 클라이언트가 전송한 원격 분석이며, 페이지 보기 보고서를 만드는 데 사용됩니다.
• 사용자 지정 이벤트: 사용량 모니터링을 위해 TrackEvent()에 대한 호출을 삽입한 경우 여기에서 검색할 수 있습니다.
• 예외: 포착되지 않은 서버의 예외 및 TrackException()을 사용하여 로그하는 예외입니다.
• 종속성: 서버 애플리케이션에서 REST API 또는 데이터베이스 등의 다른 서비스로의 호출 및 클라이언트 코드에서의 AJAX 호출입니다.
• 가용성: 가용성 테스트의 결과

속성 값에서 필터링

해당 속성 값에서 이벤트를 필터링할 수 있습니다. 사용 가능한 속성은 선택한 이벤트 유형에 따라 다릅니다. 시작하려면 필터을 선택합니다.

특정 속성 값을 선택하지 않는 것은 모든 값을 선택하는 것과 동일한 효과가 있습니다. 해당 속성에서 필터링을 전한합니다.

필터 값의 오른쪽에 있는 수는 현재 필터링된 집합에서 발생한 수를 보여줍니다.

동일한 속성이 있는 이벤트 찾기

속성 값이 동일한 모든 항목을 찾으려면 검색 상자에 입력하거나 필터 탭에서 속성을 살펴볼 때 확인란을 선택합니다.

데이터 검색

참고 항목

더 복잡한 쿼리를 작성하려면 검색 창 상단에서 로그(분석)를 엽니다.

속성 값 중 하나에서 용어를 검색할 수 있습니다. 이 기능은 속성 값으로 사용자 지정 이벤트를 작성한 경우에 유용합니다.

더 짧은 범위에 대한 검색이 더 빠르기 때문에 시간 범위를 설정할 수 있습니다.

하위 문자열이 아닌 전체 단어를 검색합니다. 인용 부호를 사용하여 특수 문자를 묶습니다.

문자열	찾을 수 없음	Found
HomeController.About	home controller out	homecontroller about "homecontroller.about"
미국	Uni ted	united states united AND states "united states"

다음 검색 식을 사용할 수 있습니다.

샘플 쿼리	효과
apple	지정된 시간 범위의 필드에 apple 단어가 포함된 모든 이벤트를 찾습니다.
apple AND banana apple banana	두 단어를 모두 포함하는 이벤트를 찾습니다. and아니라 대문자 AND를 사용합니다. 약식입니다.
apple OR banana	둘 중 한 단어를 포함하는 이벤트를 찾습니다. or이 아니라 OR을 사용합니다.
apple NOT banana	한 단어는 포함하지만 다른 단어는 포함하지 않는 이벤트를 찾습니다.

샘플링

앱이 중요한 원격 분석을 생성하고 ASP.NET SDK 버전 2.0.0-beta3 이상을 사용하는 경우 적응 샘플링을 통해 포털로 전송되는 볼륨을 자동으로 줄입니다. 이 모듈은 이벤트의 대표적인 부분만 전송합니다. 그룹과 동일한 요청과 관련된 이벤트를 선택하거나 선택 취소하여 관련 이벤트 간을 탐색할 수 있습니다.

샘플링에 대해 알아봅니다.

작업 항목 만들기

원격 분석 항목의 세부 정보를 이용하여 GitHub 또는 Azure DevOps에서 버그를 만들 수 있습니다.

원격 분석 항목을 선택하여 엔드투엔드 트랜잭션 세부 정보 보기로 이동합니다. 그런 다음 작업 항목 만들기를 선택합니다.

이 단계를 처음 수행하면 Azure DevOps 조직 및 프로젝트에 대한 링크를 구성하라는 메시지가 표시됩니다. 작업 항목 탭에서 링크를 구성할 수도 있습니다.

Application Insights에 더 많은 원격 분석 전송

Application Insights SDK에서 보낸 기본 원격 분석 외에도 다음을 수행할 수 있습니다.

• .NET 또는 Java의 즐겨찾는 로깅 프레임워크에서 로그 추적을 캡처합니다. 이는 로그 추적을 통해 검색하고 페이지 보기, 예외 사항 및 기타 이벤트와 상관 관계를 지정할 수 있음을 의미합니다.

• 코드를 작성하여 사용자 지정 이벤트, 페이지 보기 및 예외 사항을 보냅니다.

Application Insights에 로그 및 사용자 지정 원격 분석을 보내는 방법에 대해 알아봅니다.

자주 묻는 질문

일반적인 질문에 대한 답변을 찾습니다.

얼마나 많은 데이터가 보존되나요?

제한 요약을 참조하세요.

내 서버 요청에서 게시 데이터를 어떻게 볼 수 있나요?

게시 데이터를 자동으로 기록하지는 않지만 TrackTrace 또는 로그 호출을 사용할 수 있습니다. 메시지 매개 변수에 게시 데이터를 넣습니다. 속성을 필터링할 수 있는 동일한 방법으로 메시지에서 필터링할 수는 없지만 크기 제안은 더 깁니다.

Azure Function 검색에서 결과를 반환하지 않는 이유는 무엇인가요?

Azure Functions는 URL 쿼리 문자열을 기록하지 않습니다.

트랜잭션 진단

통합 진단 환경은 모든 Application Insights 모니터링 구성 요소에서 서버 쪽 원격 분석을 단일 보기로 자동으로 상관 관계를 지정합니다. 여러 리소스가 있는 경우에는 문제가 되지 않습니다. Application Insights는 기본 관계를 감지하여 트랜잭션 속도 저하 또는 실패가 발생하는 애플리케이션 구성 요소, 종속성 또는 예외를 쉽게 진단할 수 있도록 합니다.

구성 요소란?

구성 요소는 분산 또는 마이크로 서비스 애플리케이션의 독립적으로 배포 가능한 부분입니다. 개발자 및 운영 팀은 이러한 애플리케이션 구성 요소에서 생성된 원격 분석에 대한 코드 수준의 가시성 또는 액세스 권한을 갖습니다.

• 구성 요소는 팀이나 조직이 액세스할 수 없는 SQL, 이벤트 허브 등의 “관찰된” 외부 종속성(코드 또는 원격 분석)과 다릅니다.
• 구성 요소는 원하는 수의 서버, 역할 또는 컨테이너 인스턴스에서 실행됩니다.
• 구독이 서로 다른 경우에도 구성 요소는 별도의 Application Insights 계측 키일 수 있습니다. 구성 요소는 단일 Application Insights 계측 키에 보고하는 여러 가지 역할일 수도 있습니다. 새 환경에서는 설정 방법에 관계없이 모든 구성 요소에 대한 세부 정보를 보여 줍니다.

참고 항목

관련 항목 링크가 누락되었나요? 모든 관련 원격 분석은 위쪽 및 아래쪽 섹션의 왼쪽에 있습니다.

트랜잭션 진단 환경

이 보기에는 네 가지 주요 부분이 있습니다.

• 결과 목록
• 구성 요소 간 트랜잭션 차트
• 이 작업과 관련된 모든 원격 측정의 시간 시퀀스 목록
• 선택한 원격 분석 항목의 세부 정보 창

구성 요소 간 트랜잭션 차트

이 차트는 요청 중 가로 막대가 있는 타임라인과 구성 요소 간의 종속성을 제공합니다. 수집된 모든 예외도 타임라인에 표시됩니다.

• 이 차트의 위쪽 행은 진입점을 나타냅니다. 이 트랜잭션에서 호출되는 첫 번째 구성 요소에 대한 들어오는 요청입니다. 기간은 트랜잭션이 완료되는 데 걸린 총 시간입니다.
• 외부 종속성에 대한 호출은 종속성 유형을 나타내는 아이콘이 있고 축소 가능한 간단한 행입니다.
• 다른 구성 요소에 대한 호출은 접을 수 있는 행입니다. 각 행은 구성 요소에서 호출된 특정 작업에 해당합니다.
• 기본적으로 선택한 요청, 종속성 또는 예외가 오른쪽에 표시됩니다. 행을 선택하면 해당 세부 정보가 표시됩니다.

참고 항목

다른 구성 요소에 대한 호출에는 두 개의 행이 있습니다. 한 행은 호출자 구성 요소의 아웃바운드 호출(종속성)을 나타냅니다. 다른 행은 호출된 구성 요소의 인바운드 요청에 해당합니다. 기간 막대의 선행 아이콘과 고유한 스타일은 구분하는 데 도움이 됩니다.

이 작업 ID를 사용한 모든 원격 분석

이 섹션에서는 이 트랜잭션에 관련된 모든 원격 분석의 시간 시퀀스에서 단순 목록 뷰를 보여 줍니다. 또한 트랜잭션 차트에 표시되지 않는 사용자 지정 이벤트 및 추적을 보여 줍니다. 특정 구성 요소 또는 호출에서 생성된 원격 분석에 이 목록을 필터링할 수 있습니다. 이 목록에서 원격 분석 항목을 선택하면 해당 세부 정보가 오른쪽에 표시됩니다.

선택한 원격 분석의 세부 정보

이 축소 가능한 창에는 트랜잭션 차트 또는 목록에서 선택한 모든 항목의 세부 정보가 표시됩니다. 모두 표시는 수집된 표준 특성을 모두 나열합니다. 모든 사용자 지정 특성은 표준 세트 아래에 별도로 나열됩니다. 호출 스택 추적 창에서 줄임표 단추(...)를 선택하여 추적을 복사하는 옵션을 가져옵니다. 프로파일러 추적 열기 및 디버그 스냅샷 열기는 해당 세부 정보 창에서 코드 수준 진단을 보여 줍니다.

검색 결과

이 접을 수 있는 창에는 필터 조건을 충족하는 다른 결과가 표시됩니다. 임의 결과를 선택하여 이전 세 개 섹션의 각 세부 정보를 업데이트합니다. 샘플링이 모든 샘플에 적용되는 경우에도 모든 구성 요소에서 사용 가능한 세부 정보가 있을 가능성이 가장 큰 샘플을 찾으려 노력합니다. 이 샘플은 제안 사항으로 표시됩니다.

프로파일러 및 스냅샷 디버거

Application Insights 프로파일러 또는 스냅샷 디버거는 성능 및 오류 문제에 대한 코드 수준 진단에 도움이 됩니다. 이 환경을 사용하면 한 번의 선택으로 모든 구성 요소에서 프로파일러 추적 또는 스냅샷을 볼 수 있습니다.

프로파일러를 작동시킬 수 없는 경우 serviceprofilerhelp@microsoft.com에 문의하세요.

스냅샷 디버거를 작동시킬 수 없는 경우 snapshothelp@microsoft.com에 문의하세요.

자주 묻는 질문

이 섹션에서는 일반적인 질문에 대한 답변을 제공합니다.

차트에 단일 구성 요소가 표시되고 다른 구성 요소가 세부 정보 없이 외부 종속성으로만 표시되는 이유는 무엇인가요?

잠재적 원인은 다음과 같습니다.

• 다른 구성 요소가 Application Insights를 통해 계측됩니까?
• 최신의 안정적인 Application Insights SDK를 사용하고 있습니까?
• 이 구성 요소가 별도의 Application Insights 리소스인 경우 필요한 액세스 권한이 있는지 확인합니다. 액세스 권한이 있고 구성 요소가 최신 Application Insights SDK를 통해 계측되는 경우 오른쪽 위에 있는 피드백 채널을 통해 알려 주세요.

종속성에 대해 중복된 행이 표시됩니다. 이 동작이 필요한가요?

현재 아웃바운드 종속성 호출은 인바운드 요청과는 별도로 표시됩니다. 일반적으로 두 호출은 네트워크 왕복으로 인해 기간 값만 다를 뿐 동일하게 보입니다. 기간 막대의 선행 아이콘과 고유한 스타일은 구분하는 데 도움이 됩니다. 이러한 데이터 표시가 혼란스러운가요? 의견을 보내주세요!

서로 다른 구성 요소 인스턴스 간의 클록 스큐는 어떨까요?

타임라인은 트랜잭션 차트의 클록 스큐에 맞게 조정됩니다. 세부 정보 창이나 Log Analytics를 사용하여 정확한 타임스탬프를 볼 수 있습니다.

새 환경에서 대부분의 관련 항목 쿼리가 누락되는 이유는 무엇인가요?

이 동작은 의도된 것입니다. 모든 구성 요소에서 관련된 모든 항목은 이미 위쪽 및 아래쪽 섹션의 왼쪽에서 사용할 수 있습니다. 새 환경에는 왼쪽에서 다루지 않는 두 개의 관련 항목, 즉 이 이벤트 전후 5분의 모든 원격 분석 및 사용자 타임라인이 있습니다.

Application Insights JavaScript SDK를 사용할 때 트랜잭션당 더 적은 이벤트를 보는 방법이 있나요?

트랜잭션 진단 환경은 작업 ID를 공유하는 단일 작업의 모든 원격 분석을 보여 줍니다. 기본적으로 JavaScript용 Application Insights SDK는 고유한 각 페이지 보기당 새 작업을 만듭니다. SPA(단일 페이지 애플리케이션)에서는 한 페이지 보기 이벤트만 생성되고 단일 작업 ID가 생성된 모든 원격 분석에서 사용됩니다. 따라서 많은 이벤트가 동일한 작업과 상호 연관될 수 있습니다.

이 시나리오에서는 자동 경로 추적을 사용하여 SPA에서 탐색을 위한 새 작업을 자동으로 만들 수 있습니다. URL 경로가 업데이트될 때마다(논리적 페이지 보기 발생) 페이지 보기가 생성되도록 enableAutoRouteTracking을 켜야 합니다. 작업 ID를 수동으로 새로 고치려면 appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId()를 호출합니다. PageView 이벤트를 수동으로 트리거하면 작업 ID도 다시 설정됩니다.

트랜잭션 세부 정보 기간이 상위 요청 기간에 합산되지 않는 이유는 무엇인가요?

Gantt 차트에 설명되지 않은 시간은 추적된 종속성이 적용되지 않는 시간입니다. 이 문제는 외부 호출이 자동으로 또는 수동으로 계측되지 않았기 때문에 발생할 수 있습니다. 또한 소요된 시간이 외부 호출이 아닌 처리 중이었기 때문에 발생할 수 있습니다.

모든 호출이 계측된 경우 처리 중이 소요 시간의 근본 원인일 수 있습니다. 프로세스 진단에 유용한 도구는 Application Insights 프로파일러입니다.

Azure Portal에서 Application Insights를 탐색하는 동안 데이터 검색 오류 메시지가 표시되면 어떻게 하나요?

이 오류는 브라우저가 필요한 API를 호출할 수 없거나 API가 실패 응답을 반환했음을 나타냅니다. 동작 문제를 해결하려면 브라우저 InPrivate 창을 열고 실행 중인 브라우저 확장을 사용하지 않도록 설정한 다음, 포털 동작을 재현할 수 있는지 확인합니다. 포털 오류가 계속 발생하면 다른 브라우저나 다른 머신으로 테스트를 시도하고 API 호출이 실패한 클라이언트 머신에서 DNS 또는 기타 네트워크 관련 문제를 조사합니다. 포털 오류가 지속되고 추가 조사가 필요한 경우 예기치 않은 포털 동작을 재현하는 동안 브라우저 네트워크 추적을 수집하고 Azure Portal에서 지원 사례를 엽니다.

참고 항목

• 분석에서 복잡한 쿼리 작성
• Application Insights에 로그 및 사용자 지정 원격 분석 전송
• 가용성 개요