연결 문자열

  • 아티클

이 문서에서는 연결 문자열을 사용하는 방법을 보여 줍니다.

개요

참고 항목

다음 설명서는 Application Insights 클래식 API를 사용합니다. Application Insights에 대한 장기 플랜은 OpenTelemetry를 사용하여 데이터를 수집하는 것입니다. 자세한 내용은 .NET, Node.js, Python 및 Java 애플리케이션에 대해 Azure Monitor OpenTelemetry 사용을 참조하세요.

연결 문자열은 원격 분석 데이터를 보낼 위치를 정의합니다.

키-값 쌍은 사용자가 각 Application Insights 서비스 또는 제품에 대한 접두사 접미사 조합을 정의할 수 있는 쉬운 방법을 제공합니다.

참고 항목

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

시나리오 개요

이 변경의 가장 큰 영향을 받는 시나리오는 다음과 같습니다.

  • 방화벽 예외 또는 프록시 리디렉션:

    인트라넷 웹 서버를 모니터링해야 하는 경우 이전 솔루션에서 개별 서비스 엔드포인트를 구성에 추가하도록 요청했습니다. 자세한 내용은 인트라넷 웹 서버를 모니터링할 수 있나요?를 참조하세요. 연결 문자열은 이 작업을 단일 설정으로 줄여 더 나은 대안을 제공합니다. 간단한 접두사, 접미사 수정은 모든 엔드포인트를 올바른 서비스로 자동 채우기 및 리디렉션할 수 있습니다.

  • 소버린 또는 하이브리드 클라우드 환경

    사용자는 정의된 Azure Government 영역으로 데이터를 보낼 수 있습니다. 연결 문자열을 사용하여 인트라넷 서버 또는 하이브리드 클라우드 설정에 대한 엔드포인트 설정을 정의할 수 있습니다.

시작하기

시작하려면 다음 섹션을 검토합니다.

연결 문자열 찾기

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

Screenshot that shows the Application Insights overview and connection string.

스키마

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

최대 길이

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

키-값 쌍

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

구문

  • 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>

  • 접두사: 서비스를 정의합니다.
  • Suffix: 공통 도메인 이름을 정의합니다.
유효한 접미사
  • applicationinsights.azure.cn
  • applicationinsights.us

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

유효한 접두사

연결 문자열은 비밀인가요?

연결 문자열에는 수집 서비스에서 원격 분석을 특정 Application Insights 리소스에 연결하는 데 사용하는 고유 식별자인 iKey가 포함되어 있습니다. 이러한 ikey 고유 식별자는 보안 토큰 또는 보안 키가 아닙니다. AI 리소스를 오용으로부터 보호하려는 경우 수집 엔드포인트는 Microsoft Entra ID를 기반으로 하는 인증된 원격 분석 수집 옵션을 제공합니다.

참고 항목

Application Insights JavaScript SDK를 사용하려면 초기화 및 구성 중에 연결 문자열을 전달해야 합니다. 클라이언트 브라우저에서 일반 텍스트로 볼 수 있습니다. 브라우저 원격 분석에 Microsoft Entra ID 기반 인증을 사용하는 쉬운 방법은 없습니다. 서비스 원격 분석을 보호해야 하는 경우 브라우저 원격 분석을 위한 별도의 Application Insights 리소스를 만드는 것이 좋습니다.

연결 문자열 예제

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

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

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

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

  • 권한 부여 체계의 기본값은 "ikey"입니다.
  • 계측 키: 00000000-0000-0000-0000-000000000000
  • 지역 서비스 URI는 제공된 엔드포인트 접미사를 기반으로 합니다.
    • 수집: https://dc.ai.contoso.com
    • 라이브 메트릭: https://live.ai.contoso.com
    • 프로파일러: 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/
    • 프로파일러: 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

연결 문자열 설정

연결 문자열은 다음 SDK 버전에서 지원됩니다.

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

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

환경 변수

연결 문자열:APPLICATIONINSIGHTS_CONNECTION_STRING

샘플 코드

  1. appsettings.json 파일에서 연결 문자열을 설정합니다.

    {
  "ApplicationInsights": {
    "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
    }
}

  2. ApplicationInsightsTelemetry 서비스를 등록할 때 Program.cs에서 연결 문자열을 검색합니다.

    var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
builder.Services.AddApplicationInsightsTelemetry(options: options);

자주 묻는 질문

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

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

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

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

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

다음 단계

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

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