다음을 통해 공유

Application Insights 원격 분석 데이터 모델

Application Insights는 애플리케이션 및 인프라의 성능 및 사용에 대한 인사이트를 제공하기 위해 웹 애플리케이션에서 Azure Portal로 원격 분석을 보냅니다. 원격 분석 데이터를 더 잘 이해하고 구성할 수 있도록 고유 형식으로 분류합니다.

원격 분석 데이터 모델은 표준화되어 플랫폼 및 언어 독립적 모니터링을 만들 수 있습니다. 처음에는 기본 시나리오를 지원할 수 있게 단순하고 간단한 모델을 구현한 후 고급 사용을 위해 스키마를 확장할 수 있도록 합니다.

Application Insights에서 수집된 데이터는 다음과 같은 일반적인 애플리케이션 실행 패턴을 모델로 합니다.

Application Insights 원격 분석 데이터 모델을 보여 주는 다이어그램

1availabilityResults 은 기본적으로 사용할 수 없으며 가용성 테스트를 설정해야 합니다.
2customEvents 및 customMetrics 사용자 지정 계측에서만 사용할 수 있습니다.

참고

Application Insights는 레거시 이유로 로그를 traces 테이블에 저장합니다. 분산 추적의 스팬은 requests 및 dependencies 테이블에 저장됩니다. 혼동을 방지하기 위해 향후 릴리스에서 이 문제를 해결할 계획입니다.

원격 분석 유형

애플리케이션 실행을 모니터링하는 데 사용되는 원격 분석 유형은 다음과 같습니다. Azure Monitor OpenTelemetry 배포판 및 Application Insights JavaScript SDK는 다음을 수집합니다.

원격 분석 유형 테이블 이름
(애플리케이션 인사이트)		 테이블 이름
로그 분석		 설명
가용성 availabilityResults AppAvailabilityResults 정기적으로 웹 요청을 보내고 애플리케이션이 응답하지 않거나 응답 시간이 너무 느린 경우 경고하여 애플리케이션의 가용성 및 응답성을 모니터링합니다.
브라우저 타이밍 browserTimings AppBrowserTimings 페이지 로드 시간 및 네트워크 기간을 포함하여 웹 페이지의 성능을 측정합니다.
종속성 dependencies AppDependencies 애플리케이션에서 REST API 또는 SQL 데이터베이스와 같은 외부 서비스 또는 스토리지로의 호출을 추적하고 이러한 호출의 기간과 성공을 측정합니다.
이벤트 customEvents AppEvents 일반적으로 사용 패턴을 분석하기 위해 사용자 상호 작용 및 애플리케이션 내에서 단추 클릭 또는 주문 체크 아웃과 같은 기타 중요한 항목을 캡처하는 데 사용됩니다.
예외 exceptions AppExceptions 오류 문제 해결 및 이해에 중요한 오류 정보를 캡처합니다.
메트릭 performanceCounters

customMetrics		 AppPerformanceCounters

AppMetrics		 성능 카운터는 CPU 사용량 및 메모리 사용량과 같은 애플리케이션 및 시스템 성능의 다양한 측면에 대한 숫자 데이터를 제공합니다.

또한 사용자 지정 메트릭을 사용하면 애플리케이션에 고유한 특정 측정값을 정의하고 추적할 수 있으므로 사용자 지정 성능 지표를 유연하게 모니터링할 수 있습니다.
페이지 보기 pageViews AppPageViews 사용자가 보는 페이지를 추적하여 애플리케이션 내에서 사용자 탐색 및 참여에 대한 인사이트를 제공합니다.
요청 requests AppRequests 애플리케이션에서 받은 요청을 기록하여 작업 ID, 기간, 성공 또는 실패 상태와 같은 세부 정보를 제공합니다.
흔적 traces AppTraces 시간이 지남에 따라 애플리케이션 동작을 디버깅하고 모니터링하는 데 유용한 사용자 지정 진단 메시지 또는 추적 문과 같은 애플리케이션 관련 이벤트를 기록합니다.

중요합니다

Application Insights 및 Log Analytics (권장)에서 애플리케이션 원격 분석을 쿼리할 수 있지만 테이블 및 필드 이름은 다릅니다. 이러한 구분은 이전 버전과의 호환성을 유지합니다. 예를 들어 Log Analytics 명명 규칙 전에 생성된 사용자 지정 쿼리가 있는 고객 대시보드가 계속 올바르게 작동하도록 합니다.

Azure Portal에서 필드 이름을 비교하려면 Application Insights>로그를 열고 쿼리를 실행하고 원격 분석 항목(예: 1234a5b6c7de8f90)의 Id을 복사합니다. 그런 다음 브라우저에서 새 탭을 열고 Log Analytics>로그로 이동하여 KQL 모드로 전환하고 쿼리를 실행합니다.

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

각 행의 왼쪽에 있는 펼침 단추를 선택하여 모든 속성을 확인하여 두 원격 분석 항목을 모두 확장합니다.

각 원격 분석 항목에는 애플리케이션 버전 또는 사용자 세션 ID와 같은 컨텍스트 정보가 포함될 수 있습니다. 컨텍스트는 다양한 분석 시나리오를 가능하게 하는 강력한 형식의 필드 집합으로 구성됩니다.

예를 들어 애플리케이션 버전이 제대로 초기화되면 Application Insights는 재배포와 상관 관계가 있는 애플리케이션 동작의 새 패턴을 검색할 수 있습니다. 마찬가지로 세션 ID를 사용하여 중단 또는 문제가 사용자에게 미치는 영향을 평가할 수 있습니다. 실패한 종속성, 오류 추적 또는 중요한 예외와 관련된 고유 세션 ID의 수를 계산하면 사용자에게 미치는 영향을 보다 명확하게 파악할 수 있습니다.

Application Insights 원격 분석 모델은 원격 분석 항목과 해당 항목이 속한 작업의 상관 관계 도 지원합니다. 예를 들어 요청이 SQL Database 호출을 트리거하는 경우 요청과 종속성 호출 모두 진단 데이터를 포함하고 공유 상관 관계 컨텍스트를 통해 연결하여 작업의 전체 흐름을 추적할 수 있습니다.

이 문서에서는 각 원격 분석 유형과 관련된 필드를 다룹니다. 모든 원격 분석 유형에 대해 사용 가능한 필드(컨텍스트 필드 포함)의 전체 목록을 보려면 각 관련 테이블 아래에 제공된 링크를 따릅니다.

가용성 원격 분석

가용성 원격 분석에는 가상 모니터링이 포함됩니다. 여기서 테스트는 사용자 상호 작용을 시뮬레이션하여 애플리케이션이 사용 가능하고 응답성이 있는지 확인합니다. 표준 가용성 테스트를 설정하여 전 세계 다양한 지점에서 애플리케이션의 가용성을 모니터링하고 고유한 테스트 정보를 Application Insights로 보내는 것이 좋습니다.

가용성 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
id Id 시간에 따른 특정 오류 또는 패턴을 추적하는 데 도움이 될 수 있는 개별 테스트 실행 간의 상관 관계에 사용되는 가용성 테스트 결과의 고유 식별자입니다. 자세한 내용은 Application Insights에서 원격 분석 상관 관계를 참조하세요.
name Name 가용성 테스트의 이름입니다. 테스트를 만들 때 정의됩니다(예: "홈페이지 ping 테스트").
___location Location 가용성 테스트가 실행된 지리적 위치 또는 데이터 센터 지역(예: 미국 서부, 북유럽)입니다. 지역 중단 또는 대기 시간 문제를 식별하는 데 도움이 됩니다.
success Success 이 필드는 가용성 테스트가 성공했는지 여부를 나타냅니다. true가 테스트가 성공했음을 의미하고 false가 실패했음을 의미하는 부울 값입니다.
message Message 테스트 결과에 대한 세부 정보가 포함된 설명 메시지입니다. 예외 세부 정보 또는 오류 응답이 포함된 경우가 많습니다.
duration Duration 가용성 테스트를 실행하는 데 걸린 시간입니다. 성능을 측정하고 응답 시간 문제를 식별하는 데 도움이 됩니다. 기간은 일반적으로 밀리초 단위로 측정됩니다.

사용 가능한 모든 필드 목록은 AppAvailabilityResults를 참조하세요.

브라우저 타이밍 원격 분석

브라우저는 성능 API를 사용하여 페이지 로드 작업에 대한 측정값을 노출합니다. Application Insights는 관련 타이밍을 표준 브라우저 메트릭으로 통합하여 이러한 측정을 간소화합니다.

브라우저 타이밍 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
networkDuration NetworkDurationMs 클라이언트는 DNS에 연결하여 웹 사이트 호스트 이름을 확인하고 DNS는 IP 주소로 응답합니다.

클라이언트는 TCP를 만든 다음 웹 서버와 TLS 핸드셰이크를 만듭니다.
sendDuration SendDurationMs 클라이언트는 요청 페이로드를 보내고, 서버가 요청을 실행할 때까지 대기하고, 첫 번째 응답 패킷을 받습니다.
receiveDuration ReceiveDurationMs 클라이언트는 웹 서버에서 나머지 응답 페이로드 바이트를 받습니다.
processingDuration ProcessingDurationMs 이제 클라이언트에 전체 응답 페이로드가 있으며 콘텐츠를 브라우저에 렌더링하고 DOM을 로드해야 합니다.
totalDuration TotalDurationMs 모든 브라우저 타이밍의 합계입니다.

사용 가능한 모든 필드 목록은 AppBrowserTimings를 참조하세요.

종속성 원격 분석

종속성 원격 분석 항목은 SQL 또는 HTTP 엔드포인트와 같은 원격 구성 요소와 모니터링되는 구성 요소의 상호 작용을 나타냅니다.

종속성 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
id Id 이 종속성 호출에 해당하는 요청 원격 분석 항목과의 상관 관계에 사용되는 종속성 호출 인스턴스의 고유 식별자입니다. 자세한 내용은 Application Insights에서 원격 분석 상관 관계를 참조하세요.
target Target 종속성 호출의 대상 사이트입니다. 예를 들어 서버 이름, 호스트 주소가 있습니다. 자세한 내용은 Application Insights에서 원격 분석 상관 관계를 참조하세요.
type DependencyType 종속성 형식 이름입니다. 종속성의 논리적 그룹화 및 다른 필드(예: commandName 및 resultCode)의 해석에 위한 낮은 카디널리티 값을 갖습니다. 예로 SQL, Azure 테이블 및 HTTP를 들 수 있습니다.
name Name 이 종속성 호출로 시작된 명령의 이름입니다. 카디널리티 값이 낮습니다. 예로는 저장 프로시저 이름 및 URL 경로 템플릿이 있습니다.
data Data 이 종속성 호출에 의해 시작된 명령입니다. 예로 모든 쿼리 매개 변수를 포함하는 SQL 문 및 HTTP URL을 들 수 있습니다.
success Success 이 필드는 호출이 성공했는지 여부를 나타냅니다. 호출이 성공했음을 의미하는 부울 값 true이며 실패했음을 의미하는 false입니다.
resultCode ResultCode 종속성 호출의 결과 코드입니다. 예로 SQL 오류 코드 및 HTTP 상태 코드를 들 수 있습니다.
duration DurationMs 요청 기간은 DD.HH:MM:SS.MMMMMM 형식입니다. 1000일보다 작아야 합니다.

사용 가능한 모든 필드 목록은 AppDependencies를 참조하세요.

이벤트 원격 분석

애플리케이션에서 발생한 이벤트를 나타내는 이벤트 원격 분석 항목을 만들 수 있습니다. 일반적으로 단추 클릭 또는 주문 체크 아웃과 같은 사용자 상호 작용입니다. 초기화 또는 구성 업데이트와 같은 애플리케이션 수명 주기 이벤트일 수도 있습니다.

사용자 지정 이벤트 원격 분석을 만드는 방법에 대한 자세한 내용은 .NET, Java, Node.js및 Python 애플리케이션에 대한 Azure Monitor OpenTelemetry 추가 및 수정을 참조하세요.

이벤트별 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
name Name 적절한 그룹화 및 유용한 메트릭을 허용하려면 애플리케이션이 몇 개의 개별 이벤트 이름을 생성하도록 제한합니다. 예를 들어 생성된 이벤트 인스턴스마다 별도의 이름을 사용하지 않습니다.

사용 가능한 모든 필드 목록은 AppEvents를 참조하세요.

예외 원격 분석

예외 원격 분석 항목은 모니터링되는 애플리케이션을 실행하는 동안 발생한 처리되거나 처리되지 않은 예외를 나타냅니다.

예외 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
problemId ProblemId 코드에서 예외가 throw된 위치를 식별합니다. 예외 그룹화에 사용됩니다. 일반적으로 예외 형식과 호출 스택 기반 함수의 조합입니다.
type ExceptionType 발생한 특정 종류의 예외입니다. 여기에는 일반적으로 네임스페이스 및 클래스 이름(예: System.NullReferenceException 또는 System.InvalidOperationException.)이 포함됩니다.
assembly Assembly 예외가 throw된 어셈블리. 이는 예외를 담당하는 애플리케이션의 구성 요소를 정확히 찾아내는 데 유용합니다.
method Method 예외가 발생된 어셈블리 내의 메서드 이름입니다. 코드에서 오류가 발생한 위치에 대한 컨텍스트 정보를 제공합니다.
outerType OuterType 현재 예외가 다른 예외 내에 중첩된 경우 외부(래핑) 예외의 형식입니다. 내부 예외가 발생한 컨텍스트를 이해하는 데 유용하며 오류 시퀀스를 추적하는 데 도움이 될 수 있습니다.
outerMessage OuterMessage 이 메시지는 외부 예외에 대한 사람이 읽을 수 있는 설명을 제공하며 더 광범위한 문제를 이해하는 데 도움이 될 수 있습니다.
outerAssembly OuterAssembly 외부 예외가 발생한 어셈블리.
outerMethod OuterMethod 외부 예외의 메서드. 외부 예외 내의 실패 지점에 대한 자세한 정보를 제공합니다.
severityLevel SeverityLevel 추적 심각도 수준은 다음 값 VerboseInformationWarningErrorCritical중 하나일 수 있습니다.
details Details 예외 메시지 및 호출 스택과 같은 예외 정보를 포함합니다.

사용 가능한 모든 필드 목록은 AppExceptions를 참조하세요.

메트릭 원격 분석

Application Insights는 두 가지 유형의 메트릭 원격 분석을 지원합니다.

  • 단일 측정값에는 이름과값이 있습니다.
  • 사전 집계된 메트릭은 1분 집계 기간에 여러 측정을 수행합니다.

성능 계수기

성능 카운터는 항상 name 및 value를 사용하는 단일 측정 메트릭이지만, 추가 필드인 category, counter와 함께 제공되며 Windows 애플리케이션에는 instance도 포함됩니다.

성능 카운터별 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
name Name Application Insights 포털에 표시할 메트릭의 이름입니다.
value Value 측정을 위한 단일 값입니다. 집계의 개별 측정값의 합계입니다.
category Category 관련 성능 카운터(예 Process: )의 그룹을 나타냅니다.
counter Counter 범주 내에서 측정되는 특정 성능 메트릭을 지정합니다(예: IO Data Bytes/sec).
instance Instance 범주 내에서 카운터의 특정 발생을 식별합니다(예: ??APP_WIN32_PROC??).

사용 가능한 모든 필드 목록은 AppPerformanceCounters를 참조하세요.

메트릭에 대한 자세한 내용은 Application Insights의 메트릭을 참조하세요. 메트릭 REST API에 대한 자세한 내용은 메트릭 - 가져오기를 참조하세요.

시스템 및 프로세스 카운터 지표

.NET 이름 설명
\Processor(_Total)\% Processor Time 총 컴퓨터 CPU.
\Memory\Available Bytes 컴퓨터에서 실행 중인 프로세스를 사용할 수 있는 실제 메모리 양을 바이트로 보여줍니다. 0으로 초기화된 사용 가능한 대기 메모리 목록의 공간 양을 합하여 계산됩니다. 사용 가능한 메모리가 준비되었습니다. 0으로 초기화된 메모리는 이후 프로세스가 이전 프로세스에서 사용한 데이터를 볼 수 없도록 0으로 채워진 메모리 페이지로 구성됩니다. 대기 메모리는 디스크로 가는 도중에 프로세스의 작업 집합(실제 메모리)에서 제거되었지만 여전히 회수할 수 있는 메모리입니다. 메모리 개체를 참조하세요.
\Process(??APP_WIN32_PROC??)\% Processor Time 애플리케이션을 호스트하는 프로세스의 CPU.
\Process(??APP_WIN32_PROC??)\Private Bytes 애플리케이션을 호스트하는 프로세스에 사용되는 메모리.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec 애플리케이션을 호스트하는 프로세스에서 실행하는 I/O 작업 속도입니다.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec 애플리케이션에서 처리되는 요청 속도입니다.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec 애플리케이션에서 던지는 예외 비율입니다.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time 평균 요청 실행 시간.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue 큐에서 처리를 대기 중인 요청 수입니다.

사용자 지정 속성

사용자 지정 속성 CustomPerfCounter가 true로 설정된 메트릭은 해당 메트릭이 Windows 성능 카운터를 나타냄을 표시합니다. 이러한 메트릭은 performanceCounters가 아닌 customMetrics 테이블에 배치됩니다. 또한 이 메트릭의 이름을 구문 분석하여 범주, 카운터 및 인스턴스 이름을 추출합니다.

사용자 지정 메트릭

사용자 지정 메트릭은 표준 메트릭에서 다루지 않는 인사이트를 얻기 위해 정의하고 수집하는 성능 지표 또는 비즈니스별 메트릭입니다. 사용자 지정 메트릭에 대한 자세한 내용은 Azure Monitor(미리 보기)의 사용자 지정 메트릭을 참조하세요.

사용자 지정 메트릭 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 단일 측정값 사전 집계된 메트릭
name Name 이 필드는 Application Insights 포털 및 UI에 표시하려는 메트릭의 이름입니다.
value Value 이 필드는 측정을 위한 단일 값입니다. 집계의 개별 측정값의 합계입니다. 미리 집계된 메트릭의 경우 Value 는 Sum과 같습니다.
Max Max 단일 측정 메트릭의 경우 Max 는 값과 같습니다. 이 필드는 집계된 메트릭의 최대값입니다. 측정을 위해 설정해서는 안 됩니다.
Min Min 단일 측정 메트릭의 경우 Min 은 값과 같습니다. 이 필드는 집계된 메트릭의 최소값입니다. 측정을 위해 설정해서는 안 됩니다.
Sum Sum 단일 측정 메트릭의 경우 Sum 은 값과 같습니다. 집계된 메트릭의 모든 값 합계입니다. 측정을 위해 설정해서는 안 됩니다.
Count Count 단일 측정 메트릭의 경우 Count 는 .입니다 1. 1분 집계 기간의 측정 수입니다. 측정을 위해 설정해서는 안 됩니다.

사용 가능한 모든 필드 목록은 AppMetrics를 참조하세요.

참고

평균을 계산하려면 합계 를 Count로 나눕니다.

페이지 뷰 원격 분석

애플리케이션 사용자가 모니터링되는 애플리케이션의 새 페이지를 열면 페이지 보기 원격 분석이 기록됩니다. 이 컨텍스트의 Page는 개발자가 애플리케이션 탭 또는 화면으로 정의한 논리적 단위이며 브라우저 웹 페이지 로드 또는 새로 고침 작업과 반드시 상관 관계가 있는 것은 아닙니다.

이러한 구분은 페이지 간 전환이 브라우저 페이지 작업에 연결되지 않은 SPA(단일 페이지 애플리케이션)의 컨텍스트에서 더 자세히 이해할 수 있습니다. pageViews.duration은 애플리케이션이 사용자에게 페이지를 표시하는 데 걸리는 시간입니다.

페이지 보기 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
name Name 사용자가 본 페이지 이름(예: "Home" 또는 "Shopping Cart")입니다.
url Url 본 페이지의 전체 URL입니다. 이 필드는 애플리케이션 전체에서 트래픽 및 사용자 동작을 분석하는 데 중요합니다.
duration DurationMs PageView 기간은 브라우저의 성능 타이밍 인터페이스인 PerformanceNavigationTiming.duration에서 가져옵니다.

PerformanceNavigationTiming을 사용할 수 있는 경우 해당 기간이 사용됩니다. 그렇지 않은 경우 사용되지 않는PerformanceTiming 인터페이스가 사용되고 NavigationStart과(와) LoadEventEnd 사이의 델타가 계산됩니다.

개발자는 PageView을 사용하여 사용자 지정 이벤트를 로깅할 때 기간 값을 지정합니다.

사용 가능한 모든 필드 목록은 AppPageViews를 참조하세요.

참고

  • 기본적으로 Application Insights JavaScript SDK는 각 브라우저 웹 페이지 로드 작업에서 단일 PageView 이벤트를 기록하며, pageViews.duration에는 브라우저 타이밍이 포함됩니다. 개발자는 PageView을 사용하여 이벤트의 추가 추적을 확장할 수 있습니다.

  • 기본 로그 보존 기간은 30일입니다. 더 긴 기간 동안 통계를 보려면 PageView 설정을 조정해야 합니다.

텔레메트리 요청

요청 원격 분석은 애플리케이션에 들어오는 HTTP 요청과 관련된 정보를 나타냅니다. 이러한 유형의 원격 분석은 애플리케이션의 웹 기반 서비스의 성능과 성공을 모니터링하는 데 도움이 됩니다. 요청 원격 분석 항목은 애플리케이션에 대한 외부 요청에 의해 트리거되는 논리적 실행 시퀀스를 나타냅니다. 모든 요청 실행은 모든 실행 매개 변수를 포함하는 고유한 id 및 url로 식별됩니다.

논리적 name으로 요청을 그룹화하고 이 요청의 source를 정의할 수 있습니다. 코드 실행은 success 또는 fail을 발생시킬 수 있으며 특정 duration가 있습니다. resultCode를 사용하여 성공 및 실패 실행을 추가로 그룹화할 수 있습니다. 봉투 (envelope) 수준에 정의된 요청 원격 분석의 시작 시간입니다. 요청 원격 분석은 사용자 지정 properties 및 measurements.를 사용하여 표준 확장성 모델을 지원합니다.

요청 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
id Id 요청과 다른 원격 분석 항목 간의 상관 관계에 사용되는 요청 호출 인스턴스의 고유 식별자입니다. ID는 전역적으로 고유해야 합니다. 자세한 내용은 Application Insights에서 원격 분석 상관 관계를 참조하세요.
source Source 출처는 요청의 원본입니다. 호출자의 계측 키 또는 호출자의 IP 주소를 예로 들 수 있습니다. 자세한 내용은 Application Insights에서 원격 분석 상관 관계를 참조하세요.
name Name 이 필드는 요청의 이름이며 요청을 처리하는 데 사용된 코드 경로를 나타냅니다. 더 나은 요청 그룹화를 허용하는 낮은 카디널리티 값입니다. HTTP 요청의 경우 HTTP 메서드 및 실제 GET /values/{id} 값이 없는 id와 같은 URL 경로 템플릿을 나타냅니다.
Application Insights 웹 SDK는 요청 이름을 대/소문자를 바꾸지 않고 “있는 그대로” 전송합니다. UI의 그룹화는 대/소문자를 구분하므로 GET /Home/Index와 GET /home/INDEX는 동일한 컨트롤러 및 작업 실행을 발생하더라도 다른 것으로 계산됩니다. 그 이유는 URL이 일반적으로 대/소문자를 구분하기 때문입니다. 대문자로 입력한 URL에 대해 모든 404 오류가 발생하는지 확인하고 싶을 수 있습니다. 블로그 게시물에서 ASP.NET Web SDK의 요청 이름 컬렉션에 대한 자세한 내용을 확인할 수 있습니다.
url Url URL은 모든 쿼리 문자열 매개 변수를 사용하는 요청 URL입니다.
success Success 성공은 호출이 성공했는지 또는 실패했는지를 나타냅니다. 이 필드는 필수 필드입니다. 명시적으로 false로 설정되지 않은 경우 요청이 성공으로 간주됩니다. 예외 또는 반환된 오류 결과 코드로 인해 작업이 중단된 경우 이 값을 false로 설정합니다.

웹 애플리케이션의 경우 응답 코드가 400보다 작거나 401과 같은 경우 Application Insights는 요청을 성공한 것으로 정의합니다. 그러나 기본 매핑이 애플리케이션의 의미 체계와 일치하지 않는 경우가 있습니다.

응답 코드 404는 정규 흐름의 일부일 수 있는 "기록 없음"을 나타낼 수 있습니다. 또한 끊어진 연결을 나타낼 수도 있습니다. 끊어진 연결의 경우 좀 더 고급 논리를 구현할 수도 있습니다. 끊어진 연결이 동일한 사이트에 있는 경우에만 URL 참조를 분석하여 실패로 표시할 수 있습니다. 회사의 모바일 애플리케이션에서 액세스할 때 이를 실패로 표시하도록 선택할 수 있습니다. 마찬가지로 301 및 302는 리디렉션을 지원하지 않는 클라이언트에서 액세스될 때 실패를 나타냅니다.

부분적으로 수락된 콘텐츠 206은 전체 요청의 실패를 나타낼 수 있습니다. 예를 들어 Application Insights 엔드포인트는 원격 분석 항목의 일괄 처리를 단일 요청으로 받습니다. 일괄 처리의 일부 항목이 성공적으로 처리되지 않으면 206을 반환합니다. 206 비율이 늘어나면 조사해야 하는 문제가 발생했음을 나타냅니다. 207 다중 상태에 대해서도 유사한 논리가 적용되며, 이 경우 성공이 별도의 응답 코드들 중 최악일 수 있습니다.
resultCode ResultCode 응답 코드는 요청 실행의 결과입니다. HTTP 요청에 대한 HTTP 상태 코드입니다. 다른 요청 형식에 대한 HRESULT 값 또는 예외 형식일 수 있습니다.
duration DurationMs 요청 기간의 형식은 DD.HH:MM:SS.MMMMMM입니다. 1000일보다 작은 양수여야 합니다. 요청 원격 분석은 처음과 끝이 있는 작업을 나타내므로 이 필드는 필수입니다.

사용 가능한 모든 필드 목록은 AppRequests를 참조하세요.

원격 분석 추적

추적 원격 분석은 텍스트 검색이 가능한 printf 스타일의 trace 문을 나타냅니다. Log4Net, NLog 및 기타 텍스트 기반 로그 파일 항목이 이 형식의 인스턴스로 변환됩니다. 추적에는 확장 기능으로 사용할 측정이 없습니다.

추적 관련 필드:

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
message Message 추적 메시지입니다.
severityLevel SeverityLevel 추적 심각도 수준입니다.

사용 가능한 모든 필드 목록은 AppTraces를 참조하세요.

참고

값 severityLevel 은 열거되고 플랫폼별로 다릅니다.

사용자 지정 속성 및 측정값

사용자 지정 속성

사용자 지정 속성의 이름-값 컬렉션: 이 컬렉션은 사용자 지정 크기로 표준 원격 분석을 확장하는 데 사용됩니다. 원격 분석을 생성하는 배포 슬롯 또는 주문 번호와 같은 원격 분석 항목 관련 속성을 예로 들 수 있습니다.

  • 최대 키 길이: 150
  • 최대 값 길이: 8,192

사용자 지정 측정

사용자 지정 측정 컬렉션: 이 컬렉션을 사용하여 원격 분석 항목과 연결된 명명된 측정값을 보고합니다. 일반적인 사용 사례는 다음과 같습니다.

  • 종속성 원격 분석 페이로드의 크기.
  • 요청 텔레메트리가 처리한 큐 항목 수입니다.
  • 고객이 이벤트 원격 분석을 완료하는 마법사 단계를 완료하는 데 걸린 시간.

애플리케이션 분석에서 사용자 지정 측정값을 쿼리할 수 있습니다.

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

참고

  • 사용자 지정 측정값은 현재 소속된 원격 분석 항목과 연결됩니다. 이들은 이러한 측정값이 포함된 원격 분석 항목을 사용하여 샘플링됩니다. 다른 원격 분석 유형과 독립적 관계에 있는 측정값을 추적하려면 메트릭 원격 분석을 사용합니다.
  • 사용자 지정 측정에는 문자열 값을 사용하지 마세요. 숫자 값만 지원됩니다.

최대 키 길이: 150

컨텍스트

모든 원격 분석 항목에는 엄격한 형식의 컨텍스트 필드를 가질 수 있습니다. 모든 필드는 특정 모니터링 시나리오를 지원합니다. 사용자 지정 속성 컬렉션을 사용하여 사용자 지정 또는 애플리케이션별 컨텍스트 정보를 저장합니다.

필드 이름
(애플리케이션 인사이트)		 필드 이름
로그 분석		 설명
account_ID user_AccountId 다중 테넌트 애플리케이션에서 계정 ID는 사용자가 작업하는 테넌트 계정 ID 또는 이름입니다. 사용자 ID와 인증된 사용자 ID가 충분하지 않을 때 더 많은 사용자 세분화에 사용됩니다. Azure Portal의 구독 ID 또는 블로깅 플랫폼의 블로그 이름을 예로 들 수 있습니다.
application_Version AppVersion 애플리케이션 컨텍스트 필드의 정보는 항상 원격 분석을 전송하는 애플리케이션과 관련이 있습니다. 애플리케이션 버전은 애플리케이션 동작 및 배포 상관 관계의 추세 변경을 분석하는 데 사용됩니다.
appId ResourceGUID 다양한 애플리케이션의 원격 분석을 구분하기 위한 Application Insights 리소스의 고유 식별자.
appName 해당 없음(N/A) Application Insights의 appName는 _ResourceId와 동일합니다.
client_Browser ClientBrowser 클라이언트에서 사용하는 웹 브라우저의 이름입니다.
client_City ClientCity 원격 분석이 수집되었을 때 클라이언트가 위치한 도시입니다(IP 지리적 위치 기반).
client_CountryOrRegion ClientCountryOrRegion 원격 분석이 수집되었을 때 클라이언트가 위치한 국가 또는 지역입니다(IP 지리적 위치에 따라).
client_IP ClientIP 클라이언트 디바이스의 IP 주소입니다. IPv4 및 IPv6이 지원됩니다. 원격 분석이 서비스에서 전송되는 경우 위치 컨텍스트는 서비스에서 작업을 시작한 사용자와 관련이 있습니다. Application Insights는 클라이언트 IP에서 지리적 위치 정보를 추출한 후, 그 정보를 절단합니다. 클라이언트 IP 자체는 사용자 식별 정보로 사용할 수 없습니다.
client_OS ClientOS 원격 분석 데이터를 생성한 클라이언트의 운영 체제를 나타냅니다.
client_StateorProvince ClientStateOrProvince 원격 분석이 수집될 당시 클라이언트가 위치했던 주 또는 도(IP 지리적 위치 기준)입니다.
client_Type ClientType 원격 분석을 보낸 클라이언트 디바이스의 유형(예: BrowserPC.)을 설명합니다.
cloud_RoleInstance AppRoleInstance 애플리케이션이 실행 중인 인스턴스의 이름입니다. 예를 들어, 온-프레미스의 컴퓨터 이름 또는 Azure의 인스턴스 이름입니다.
cloud_RoleName AppRoleName 애플리케이션이 속한 역할의 이름입니다. Azure에서 역할 이름에 직접 매핑됩니다. 단일 애플리케이션의 일부인 마이크로 서비스를 구별하는 데 사용될 수도 있습니다.
iKey IKey 원격 분석 데이터를 특정 Application Insights 리소스와 연결하는 데 사용되는 레거시 고유 식별자입니다.
itemId 해당 없음(N/A) 특정 원격 분석 항목에 대한 고유 식별자입니다.
itemCount ItemCount 단일 원격 분석 이벤트와 연결된 발생 횟수 또는 개수입니다.
operation_Id OperationId 루트 작업의 고유 식별자. 이 식별자를 사용하면 여러 구성 요소에서 원격 분석을 그룹화할 수 있습니다. 자세한 내용은 원격 분석 상관 관계를 참조하세요. 작업 ID는 요청 또는 페이지 보기에서 생성됩니다. 다른 모든 원격 분석은 이 필드를 포함 요청 또는 페이지 보기의 값으로 설정합니다.
operation_Name OperationName 작업의 이름(그룹)입니다. 작업 이름은 요청 또는 페이지 보기에서 생성됩니다. 다른 모든 원격 분석 항목은 이 필드를 포함 요청 또는 페이지 보기의 값으로 설정합니다. 작업 이름은 작업 그룹에 대한 모든 원격 분석 항목을 찾는 데 사용됩니다(예: GET Home/Index). 이 컨텍스트 속성은 이 페이지에서 발생하는 일반적인 예외와 같은 질문에 답변하는 데 사용됩니다.
operation_ParentId ParentId 원격 분석 항목의 직계 부모의 고유 식별자입니다. 자세한 내용은 원격 분석 상관 관계를 참조하세요.
operation_SyntheticSource SyntheticSource 합성 소스의 이름입니다. 애플리케이션의 원격 분석 중 일부는 합성 트래픽을 나타낼 수 있습니다. 웹 사이트를 인덱싱하는 웹 크롤러, 사이트 가용성 테스트 또는 Application Insights SDK 자체와 같은 진단 라이브러리의 추적일 수 있습니다.
sdkVersion SDKVersion 원격 분석 데이터를 보내는 Application Insights SDK의 버전입니다. 자세한 내용은 SDK 버전을 참조하세요.
session_Id SessionId 세션 ID는 사용자와 앱의 상호 작용 인스턴스입니다. 세션 컨텍스트 필드의 정보는 항상 사용자에 관한 것입니다. 원격 분석이 서비스에서 전송되는 경우 서비스 컨텍스트는 서비스에서 작업을 시작한 사용자와 관련이 있습니다.
user_AuthenticatedId UserAuthenticatedId 인증된 사용자 ID는 익명 사용자 ID와 반대입니다. 이 필드는 사용하기 쉬운 이름으로 사용자를 나타냅니다. 이 ID는 기본적으로 ASP.NET Framework SDK의 AuthenticatedUserIdTelemetryInitializer를 통해서만 수집됩니다.

Application Insights SDK를 사용하여 인증된 사용자 ID를 브라우저와 디바이스에서 지속적으로 사용자를 식별하는 값으로 초기화합니다. 이러한 방식으로 모든 원격 분석 항목은 해당 고유 ID에 귀속됩니다. 이 ID를 통해 특정 사용자에 대해 수집된 모든 원격 분석에 대해 쿼리할 수 있습니다(샘플링 구성 및 원격 분석 필터링에 따름).

사용자 ID를 세션 ID와 상호 참조하여 고유한 원격 분석 차원을 제공하고 세션 기간 동안 사용자 활동을 설정할 수 있습니다.
user_Id UserId 익명 사용자 ID는 애플리케이션의 사용자를 나타냅니다. 원격 분석이 서비스에서 전송되는 경우 사용자 컨텍스트는 서비스에서 작업을 시작한 사용자와 관련이 있습니다.

샘플링은 수집된 원격 분석의 양을 최소화하는 기술 중 하나입니다. 샘플링 알고리즘은 상관된 원격 분석 데이터를 선택적으로 포함하거나 제외하려고 시도합니다. 익명 사용자 ID는 샘플링 점수 생성에 사용되므로 익명 사용자 ID는 충분히 임의의 값이어야 합니다.

익명 사용자 ID의 수는 고유 애플리케이션 사용자의 수와 동일하지 않습니다. 익명 사용자 ID의 수는 일반적으로 사용자가 다른 디바이스나 브라우저에서 앱을 열거나 브라우저 쿠키를 정리할 때마다 새로운 고유한 익명 사용자 ID가 할당되기 때문에 더 높습니다. 이 계산으로 인해 동일한 실제 사용자가 여러 번 계산될 수 있습니다.

사용자 ID를 세션 ID와 상호 참조하여 고유한 원격 분석 차원을 제공하고 세션 기간 동안 사용자 활동을 설정할 수 있습니다.

익명 사용자 ID를 사용하여 사용자 이름을 저장하는 것은 필드를 잘못 사용하는 것입니다. 인증된 사용자 ID를 사용합니다.
_ResourceId _ResourceId 구독, 리소스 그룹 및 리소스 이름을 포함하는 Application Insights 구성 요소의 전체 Azure 리소스 ID입니다.

다음 단계