Application Insights의 연결 문자열

연결 문자열은 계측된 애플리케이션이 원격 분석 데이터를 보내야 하는 Application Insights 리소스를 지정합니다. 연결 문자열 각각 키-값 쌍으로 표시되고 세미콜론으로 구분된 여러 설정으로 구성됩니다. 이 통합 구성 방법은 여러 프록시 설정이 필요하지 않은 설정 프로세스를 간소화합니다.

Important

연결 문자열에는 수집 서비스에서 원격 분석을 특정 Application Insights 리소스에 연결하는 데 사용하는 고유 식별자인 iKey가 포함되어 있습니다. Ikey 고유 식별자는 보안 토큰 또는 보안 키가 아니며 비밀로 간주되지 않습니다.

Application Insights 리소스를 오용으로부터 보호하려는 경우 수집 엔드포인트는 Microsoft Entra ID를 기반으로 인증된 원격 분석 수집 옵션을 제공합니다.

참고 항목

2025년 3월 31일에 계측 키 수집에 대한 지원이 종료됩니다. 계측 키 수집은 계속 작동하지만 더 이상 기능에 대한 업데이트 또는 지원을 제공하지 않습니다. 연결 문자열로 전환하여 새로운 기능을 활용합니다.

연결 문자열 기능

• 신뢰성: 연결 문자열은 전역 수집 엔드포인트에 대한 종속성을 제거하여 원격 분석 수집을 보다 안정적으로 만듭니다.
• 보안: 연결 문자열은 Application Insights용 Microsoft Entra 인증을 사용하여 인증된 원격 분석 수집을 허용합니다.
• 사용자 지정된 엔드포인트(소버린 또는 하이브리드 클라우드 환경): 엔드포인트 설정을 사용하면 특정 Azure Government 지역으로 데이터를 보낼 수 있습니다. (예제를 참조하세요.)
• 개인 정보(지역 엔드포인트): 연결 문자열은 데이터를 지역 엔드포인트로 전송하여 데이터가 지리적 지역을 벗어나지 않도록 하여 개인 정보 문제를 완화합니다.

연결 문자열 찾기

연결 문자열은 Application Insights 리소스의 개요 섹션에 나타납니다.

스키마

스키마 요소는 다음 섹션에서 설명합니다.

최대 길이

연결의 지원되는 최대 길이는 4,096자입니다.

키-값 쌍

연결 문자열은 키-값 쌍으로 표시된 설정 목록으로 key1=value1;key2=value2;key3=value3과 같이 세미콜론으로 구분됩니다.

팁

구성 가능한 키-값 쌍은 이 문서에서 다룹니다. 일부 키-값 쌍은 구성할 수 없으며 다음과 같이 ApplicationId자동으로 설정됩니다. 사용자 환경에서 관찰되는 경우 이를 무시해도 됩니다.

구문

• InstrumentationKey(예를 들어 00000000-0000-0000-0000-000000000000입니다). InstrumentationKey은(는) 필수 필드입니다.

• Authorization(예: ikey). 이 설정은 현재 ikey 권한 부여만 지원하기 때문에 선택 사항입니다.

• EndpointSuffix(예: applicationinsights.azure.cn). 엔드포인트 접미사를 설정하면 연결할 Azure 클라우드가 있는 SDK에 지시합니다. SDK는 개별 서비스에 대한 나머지 엔드포인트를 조합합니다.

• 명시적 엔드포인트. 모든 서비스는 연결 문자열에서 명시적으로 재정의될 수 있습니다.

  • IngestionEndpoint(예: https://dc.applicationinsights.azure.com)
  • LiveEndpoint(예: https://live.applicationinsights.azure.com)
  • ProfilerEndpoint(예: https://profiler.monitor.azure.com)
  • SnapshotEndpoint(예: https://snapshot.monitor.azure.com)

엔드포인트 스키마

<prefix>.<suffix>

• 접두사: 서비스를 정의합니다.
• 접미사: 공통 도메인 이름을 정의합니다.

유효한 접미사

• applicationinsights.azure.cn
• applicationinsights.us

자세한 내용은 엔드포인트 수정이 필요한 지역을 참조하세요.

유효한 접두사

• 원격 분석 수집: dc
• 라이브 메트릭: live
• .NET용 프로파일러: profiler
• 스냅샷: snapshot

연결 문자열 예제

다음은 연결 문자열의 몇 가지 예입니다.

엔드포인트 접미사가 있는 연결 문자열

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

이 예제에서 연결 문자열은 엔드포인트 접미사를 지정하고 SDK는 서비스 엔드포인트를 형성합니다.

• 권한 부여 체계의 기본값은 "ikey"입니다.
• 계측 키: 00000000-0000-0000-0000-000000000000
• 지역 서비스 URI(Uniform Resource Identifier)는 제공된 엔드포인트 접미사를 기반으로 합니다.
  • 수집: https://dc.ai.contoso.com
  • 라이브 메트릭: https://live.ai.contoso.com
  • .NET용 프로파일러: https://profiler.ai.contoso.com
  • 디버거: https://snapshot.ai.contoso.com

명시적 엔드포인트 재정의를 포함하는 연결 문자열

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

이 예제에서 연결 문자열은 모든 서비스에 대한 명시적 재정의를 지정합니다. SDK는 수정 없이 제공되는 정확한 엔드포인트를 사용합니다.

• 권한 부여 체계의 기본값은 "ikey"입니다.
• 계측 키: 00000000-0000-0000-0000-000000000000
• 지역 서비스 URI는 명시적 재정의 값을 기반으로 합니다.
  • 수집: https://custom.com:111/
  • 라이브 메트릭: https://custom.com:222/
  • .NET용 프로파일러: https://custom.com:333/
  • 디버거: https://custom.com:444/

명시적 영역이 있는 연결 문자열

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

이 예제에서 연결 문자열은 미국 중남부 지역을 지정합니다.

• 권한 부여 체계의 기본값은 "ikey"입니다.
• 계측 키: 00000000-0000-0000-0000-000000000000
• 지역 서비스 URI는 명시적 재정의 값을 기반으로 합니다.
  • 수집: https://southcentralus.in.applicationinsights.azure.com/

사용 가능한 지역을 나열하려면 Azure CLI에서 다음 명령을 실행합니다.

az account list-locations -o table

연결 문자열 설정

모든 OpenTelemetry 제품 및 다음 SDK 버전은 연결 문자열 지원합니다.

• .NET v2.12.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0

환경 변수 또는 구성 파일을 사용하여 코드에서 연결 문자열 설정할 수 있습니다.

환경 변수

연결 문자열:APPLICATIONINSIGHTS_CONNECTION_STRING

코드 샘플

언어	Classic API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exporter
Java	해당 사항 없음	Java 에이전트
JavaScript	JavaScript(웹) SDK 로더 스크립트	해당 사항 없음
Node.js	Application Insights SDK	AzMon OTel Distro
Python	OpenCensus Python SDK	AzMon OTel Distro

자주 묻는 질문

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

새 Azure 지역에서 연결 문자열을 사용해야 하나요?

새 Azure 지역에서는 계측 키 대신 연결 문자열을 사용해야 합니다. 연결 문자열은 원격 분석 데이터와 연결할 리소스를 식별합니다. 또한 리소스가 원격 분석의 대상으로 사용할 엔드포인트를 수정할 수 있습니다. 연결 문자열을 복사하여 애플리케이션 코드나 환경 변수에 추가합니다.

연결 문자열 또는 계측 키를 사용해야 하나요?

계측 키 대신 연결 문자열을 사용하는 것이 좋습니다.

다음 단계

다음을 사용하여 런타임에 시작하세요.

• Azure VM(Virtual Machine) 및 Azure Virtual Machine Scale Sets IIS 호스팅 앱
• IIS(인터넷 정보 서버) 서버
• Azure App Service의 Web Apps 기능

다음을 사용하여 개발 시에 시작하세요.

• ASP.NET Core
• ASP.NET
• Java
• Node.JS
• Python