Application Insights 계측 키에서 연결 문자열로 마이그레이션

2024-10-10

Application Insights는 전역 수집 엔드포인트에서 추가 기능을 제공하는 연결 문자열을 사용하는 지역 엔드포인트로 변경 되고 있습니다.

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

방화벽 예외 또는 프록시 리디렉션 - 인트라넷 웹 서버에 대한 모니터링이 필요한 경우 이전 솔루션에서 구성에 개별 서비스 엔드포인트를 추가하도록 요청했습니다. 자세한 내용은 인트라넷 웹 서버를 모니터링할 수 있나요?를 참조하세요. 연결 문자열은 이러한 노력을 단일 설정으로 줄여 더 나은 대안을 제공합니다. 간단한 접두사 접미사 수정을 사용하면 모든 엔드포인트를 올바른 서비스로 자동 모집단 및 리디렉션할 수 있습니다.
소버린 또는 하이브리드 클라우드 환경 - 사용자는 정의된 Azure Government 지역으로 데이터를 보낼 수 있습니다. 연결 문자열을 사용하여 인트라넷 서버 또는 하이브리드 클라우드 설정에 대한 엔드포인트 설정을 정의할 수 있습니다.

이 문서에서는 계측 키에서 연결 문자열로 마이그레이션하는 방법을 안내합니다.

필수 조건

마이그레이션

Application Insights 리소스의 개요 창으로 이동합니다.
오른쪽에 표시된 연결 문자열 을 찾습니다.
연결 문자열을 마우스로 가리키고 클립보드에 복사 아이콘을 선택합니다.
연결 문자열을 설정하는 방법에 따라 Application Insights SDK를 구성합니다.

중요합니다

연결 문자열과 계측 키를 모두 사용하지 마세요. 후자의 한 집합은 다른 집합을 대체하고 포털에 원격 분석이 표시되지 않을 수 있습니다. 누락된 데이터를 확인합니다.

대규모 마이그레이션

환경 변수를 사용하여 Application Insights SDK 또는 에이전트에 연결 문자열을 전달합니다.

환경 변수를 통해 연결 문자열을 설정하려면 연결 문자열의 값을 명명 APPLICATIONINSIGHTS_CONNECTION_STRING된 환경 변수에 배치합니다.

이 프로세스 는 Azure 배포에서 자동화할 수 있습니다. 예를 들어 다음 Azure Resource Manager 템플릿은 Azure App Service 배포에 올바른 연결 문자열을 자동으로 포함할 수 있는 방법을 보여줍니다. 앱에 필요한 다른 앱 설정을 포함해야 합니다.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

지원되는 SDK 버전

.NET 및 .NET Core v2.12.0 이상
Java v2.5.1 및 Java 3.0 이상
JavaScript v2.3.0 이상
NodeJS v1.5.0 이상
Python v1.0.0 이상

문제 해결

이 섹션에서는 문제 해결 솔루션을 제공합니다.

경고: "데이터 수집에 연결 문자열 사용으로 전환"

이 문서의 마이그레이션 단계에 따라 이 경고를 해결합니다.

누락된 데이터

지원되는 SDK 버전을 사용하고 있는지 확인합니다. 다른 Azure 제품 제품에서 Application Insights 통합을 사용하는 경우 연결 문자열을 올바르게 구성하는 방법에 대한 설명서를 확인합니다.
계측 키와 연결 문자열을 동시에 설정하지 않는지 확인합니다. 구성에서 계측 키 설정을 제거해야 합니다.
연결 문자열이 Azure Portal에 제공된 것과 정확히 일치하는지 확인합니다.

환경 변수가 작동하지 않음

애플리케이션 코드에서 계측 키를 하드 코딩하는 경우 해당 프로그래밍이 환경 변수보다 우선할 수 있습니다.

자주 묻는 질문

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

내 연결 문자열은 어디에서 찾을 수 있나요?

연결 문자열은 필드 이름 ConnectionString아래에 Application Insights 리소스에 대한 Resource Manager 리소스 속성에도 포함됩니다.

이는 자동 도구화에 어떤 영향을 미치나요?

자동 계측 시나리오는 영향을 받지 않습니다.

자동 계측 기능과 함께 Microsoft Entra 인증을 사용할 수 있나요?

자동 계측 시나리오에는 Microsoft Entra 인증을 사용하도록 설정할 수 없습니다. 향후 이러한 제한 사항을 해결할 계획입니다.

전역 및 지역 처리의 차이점은 무엇인가요?

전역 수집은 이 데이터가 저장되는 위치에 관계없이 모든 원격 분석 데이터를 단일 엔드포인트로 보냅니다. 지역 수집을 사용하면 데이터 수집을 위해 지역당 특정 엔드포인트를 정의할 수 있습니다. 이 기능은 처리 및 스토리지 중에 데이터가 특정 지역 내에 유지되도록 합니다.

연결 문자열이 청구에 어떤 영향을 주나요?

청구는 영향을 받지 않습니다.

Microsoft Q&A

답변 포럼에 질문을 게시합니다.