작업 영역 기반 Application Insights 리소스로 마이그레이션
이 문서에서는 클래식 Application Insights 리소스를 작업 영역 기반 리소스로 마이그레이션하는 과정을 안내합니다.
작업 영역 기반 리소스:
- Application Insights와 Log Analytics 간의 완전한 통합을 지원합니다.
- Application Insights 원격 분석을 공통 Log Analytics 작업 영역으로 보냅니다.
- 애플리케이션, 인프라 및 플랫폼 로그를 통합된 위치에 유지하면서 Azure Monitor의 최신 기능에 액세스할 수 있습니다.
- 리소스 전체에서 공통 Azure 역할 기반 액세스 제어를 사용하도록 설정합니다.
- 앱/워크스페이스 간 쿼리의 필요성을 제거합니다.
- 모든 상용 지역 및 Azure 미국 정부에서 사용 가능합니다.
- 클래식 리소스에서 마이그레이션한 후 계측 키를 변경할 필요가 없습니다.
Important
2024년 2월 29일에 연속 내보내기는 클래식 Application Insights 리소스 사용 중지의 일부로 사용 중지되었습니다.
작업 영역 기반 Application Insights 리소스는 연속 내보내기와 호환되지 않습니다. 작업 영역 기반 Application Insights로 전환하기 전에 클래식 Application Insights 리소스의 진단 설정으로 마이그레이션하는 것이 좋습니다. 이렇게 하면 진단 설정의 연속성과 호환성이 보장됩니다.
진단 설정 내보내기는 비용을 증가시킬 수 있습니다. 자세한 내용은 진단 설정 기반 내보내기를 참조하세요.
Warning
클래식 Application Insights 내 연속 내보내기는 2024년 5월 15일에 종료됩니다. 이 날짜 이후에는 연속 내보내기 구성을 더 이상 사용할 수 없습니다.
2024년 4월 29일부터 2024년 5월 1일까지 연속 내보내기는 종료에 대비하여 유지 관리를 진행합니다. 이 시간 동안에는 연속 내보내기를 사용할 수 없습니다. 이 기간 동안 내보냈을 모든 데이터는 2024년 5월 1일 유지 관리 기간이 끝나면 내보내집니다. 내보내는 데이터의 양에 따라 완전히 복구하는 데 최대 72시간이 걸릴 수 있습니다.
새로운 기능
작업 영역 기반 Application Insights 리소스를 사용하면 Azure Monitor 및 Log Analytics의 최신 기능을 활용할 수 있습니다.
- 고객 관리형 키는 사용자만 액세스할 수 있는 암호화 키를 사용하여 미사용 데이터 암호화를 제공합니다.
- Azure Private Link를 사용하면 프라이빗 엔드포인트를 사용하여 Azure PaaS(서비스 제공 플랫폼)를 가상 네트워크에 안전하게 연결할 수 있습니다.
- Profiler 및 스냅샷 디버거에 대한 BYOS(Bring Your Own Storage)를 사용하면 다음을 완전히 제어할 수 있습니다.
- 미사용 암호화 정책.
- 수명 관리 정책.
- Application Insights Profiler 및 스냅샷 디버거와 연결된 모든 데이터에 대한 네트워크 액세스.
- 약정 계층을 사용하면 종량제 가격에 비해 비용을 30%를 절약할 수 있습니다. 그렇지 않으면 Log Analytics의 종량제 데이터 수집 및 데이터 보존에 대한 청구는 Application Insights의 청구와 유사합니다.
- 데이터는 Log Analytics 스트리밍 수집을 통해 더 빠르게 수집됩니다.
참고 항목
작업 영역 기반 Application Insights 리소스로 마이그레이션한 후 여러 Application Insights 리소스의 원격 분석이 공통 Log Analytics 작업 영역에 저장될 수 있습니다. 로그 쿼리 이해 섹션에 설명된 대로 여전히 특정 Application Insights 리소스에서 데이터를 가져올 수 있습니다.
마이그레이션 프로세스
작업 영역 기반 리소스로 마이그레이션하면 클래식 리소스의 스토리지에서 새 작업 영역 기반 스토리지로 데이터가 전송되지 않습니다. 마이그레이션을 선택하면 클래식 리소스 데이터에 대한 액세스를 유지하면서 새 데이터가 Log Analytics 작업 영역에 기록되는 위치가 변경됩니다.
클래식 리소스 데이터는 지속되며 클래식 Application Insights 리소스의 보존 설정이 적용됩니다. 마이그레이션 후 수집되는 모든 새 데이터에는 연결된 Log Analytics 작업 영역의 보존 설정이 적용됩니다. 이는 데이터 형식에 따라 다른 보존 설정도 지원합니다.
마이그레이션 프로세스는 영구적이며 되돌릴 수 없습니다. 리소스를 작업 영역 기반 Application Insights로 마이그레이션하면 항상 작업 영역 기반 리소스가 됩니다. 마이그레이션한 후에는 필요에 따라 자주 대상 작업 영역을 변경할 수 있습니다.
기존 리소스를 마이그레이션할 필요가 없으며 대신 새 작업 영역 기반 Application Insights 리소스를 만들려는 경우에는 작업 영역 기반 리소스 생성 가이드를 사용합니다.
참고 항목
마이그레이션 프로세스는 애플리케이션 가동 중지 시간을 유발하지 않으며, 다시 시작되거나 기존 계측 키 또는 연결 문자열을 변경해서는 안 됩니다.
필수 조건
액세스 제어 모드가 리소스 또는 작업 영역 권한 사용으로 설정된 Log Analytics 작업 영역:
- 작업 영역 기반 Application Insights 리소스는 전용 작업 영역 기반 권한으로 설정된 작업 영역과 호환되지 않습니다. Log Analytics 작업 영역 액세스 제어에 대한 자세한 내용은 액세스 제어 모드 지침을 참조하세요.
- 기존 Log Analytics 작업 영역이 아직 없는 경우 Log Analytics 작업 영역 만들기 설명서를 참조하세요.
연속 내보내기는 작업 영역 기반 리소스와 호환되지 않으며 사용 중지해야 합니다. 마이그레이션이 완료되면 진단 설정을 사용하여 스토리지 계정에 대한 데이터 보관 또는 Azure Event Hubs로의 스트리밍을 구성할 수 있습니다.
주의
- 진단 설정은 연속 내보내기와 다른 내보내기 형식/스키마를 사용합니다. 마이그레이션하면 Azure Stream Analytics와의 기존 통합이 중단됩니다.
- 진단 설정 내보내기는 비용을 증가시킬 수 있습니다. 자세한 내용은 Application Insights에서 원격 분석 내보내기를 참조하세요.
Log Analytics 작업 영역의 설정>사용량 및 예상 비용>데이터 보관에서 현재 보관 설정을 확인합니다. 이 설정은 Application Insights 리소스를 마이그레이션한 후 새로 수집된 데이터가 저장되는 기간에 영향을 줍니다.
참고 항목
- 현재 기본 90일보다 더 오랫동안 Application Insights 데이터를 저장하고 마이그레이션 후 더 긴 보존 기간을 보존하려면 작업 영역 보존 설정을 조정합니다.
- 마이그레이션 전에 클래식 Application Insights 리소스에 수집된 데이터에 대해 90일 이상 데이터 보존을 선택한 경우 해당 데이터가 보존 기간을 초과할 때까지 해당 Application Insights 리소스를 통해 데이터 보존 요금이 계속 청구됩니다.
- 구성>사용량 및 예상 비용>데이터 보존에서 Application Insights 인스턴스에 대한 보존 설정을 사용하도록 설정한 경우, 해당 설정을 사용하여 클래식 리소스의 스토리지에 여전히 저장된 원격 분석 데이터의 보존 기간(일)을 제어합니다.
작업 영역 기반 Application Insights 사용량 및 비용을 이해합니다.
리소스 마이그레이션
클래식 Application Insights 리소스를 작업 영역 기반 리소스로 마이그레이션하려면 다음을 수행합니다.
Application Insights 리소스에서 왼쪽 메뉴의 구성 제목 아래에 있는 속성을 선택합니다.
작업 영역 기반으로 이전을 선택합니다.
향후에 수집되는 모든 Application Insights 원격 분석을 저장할 Log Analytics 작업 영역을 선택합니다. 동일한 구독 또는 동일한 Microsoft Entra 테넌트를 공유하는 다른 구독의 Log Analytics 작업 영역일 수 있습니다. Log Analytics 작업 영역은 Application Insights 리소스와 동일한 리소스 그룹에 있을 필요가 없습니다.
참고 항목
작업 영역 기반 리소스로 마이그레이션하는 데 최대 24시간이 걸릴 수 있지만 일반적으로 프로세스가 더 빠릅니다. 마이그레이션 프로세스가 완료될 때까지 기다리는 동안 Application Insights 리소스를 통해 데이터에 액세스합니다. 완료되면 Log Analytics 작업 영역 테이블에 저장된 새 데이터가 표시됩니다.
리소스가 마이그레이션되면 개요 창에 해당 작업 영역 정보가 표시됩니다.
파란색 링크 텍스트를 선택하면 새로운 통합 작업 영역 쿼리 환경을 활용할 수 있는 연결된 Log Analytics 작업 영역으로 이동합니다.
팁
작업 영역 기반 Application Insights 리소스로 마이그레이션한 후 작업 영역의 일별 한도를 사용하여 Application Insights의 한도 대신 수집 및 비용을 제한합니다.
로그 쿼리 이해
Application Insights 환경 내에서 Application Insights 클래식 리소스 쿼리, 통합 문서 및 로그 기반 경고에 대해 이전 버전과 완전히 호환됩니다.
새로운 작업 영역 기반 테이블 구조/스키마에 대한 쿼리를 작성하려면 먼저 Log Analytics 작업 영역으로 이동해야 합니다.
쿼리가 성공적으로 실행되도록 하려면 쿼리 필드가 새 스키마 필드와 일치하는지 유효성을 검사합니다.
하나의 Log Analytics 작업 영역에 원격 분석을 저장하는 Application Insights 리소스가 여러 개 있을 수 있지만 하나의 특정 Application Insights 리소스에서 데이터를 쿼리하려고 합니다. 이때 다음 두 가지 방법을 사용할 수 있습니다.
- Application Insights 리소스로 이동하여 로그 탭을 선택합니다. 이 탭의 모든 쿼리는 선택한 Application Insights 리소스에서 자동으로 데이터를 가져옵니다.
- Application Insights 원격 분석의 대상으로 구성한 Log Analytics 작업 영역으로 이동하여 로그 탭을 선택합니다. 특정 Application Insights 리소스에서 데이터를 쿼리하려면 모든 애플리케이션별 테이블에서 사용할 수 있는 기본 제공
_ResourceId속성을 필터링합니다.
Log Analytics 작업 영역에서 직접 쿼리하면 마이그레이션 후 수집된 데이터만 표시됩니다. 통합 쿼리 환경에서 마이그레이션 후 수집된 새 데이터와 클래식 Application Insights 데이터를 모두 보려면 마이그레이션된 Application Insights 리소스 내에서 로그 탭을 사용합니다.
참고 항목
작업 영역 기반 모델로 마이그레이션한 후 Application Insights 리소스의 이름을 바꾸면 더 이상 Application Insights 로그 탭에 이름 바꾸기 전에 수집된 원격 분석이 표시되지 않습니다. 연결된 Log Analytics 리소스의 로그 탭에서 이전 데이터와 새 데이터를 모두 볼 수 있습니다.
수집 형식별로 Application Insights 리소스 식별
다음 스크립트를 사용하여 수집 형식별로 Application Insights 리소스를 식별합니다.
예시
Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
if ([string]::IsNullOrEmpty($_.IngestionMode)) {
'Unknown'
} elseif ($_.IngestionMode -eq 'LogAnalytics') {
'Workspace-based'
} elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
'Classic'
} else {
'Unknown'
}
}}
프로그래매틱 리소스 마이그레이션
이 섹션은 리소스를 마이그레이션하는 데 도움이 됩니다.
Azure CLI
미리 보기 Application Insights Azure CLI 명령에 액세스하려면 먼저 다음을 실행해야 합니다.
az extension add -n application-insights
az extension add 명령을 실행하지 않으면 az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.라는 오류 메시지가 표시됩니다.
이제 다음 코드를 실행하여 Application Insights 리소스를 만들 수 있습니다.
az monitor app-insights component update --app
--resource-group
[--ingestion-access {Disabled, Enabled}]
[--kind]
[--query-access {Disabled, Enabled}]
[--retention-time]
[--workspace]
예시
az monitor app-insights component update --app your-app-insights-resource-name -g your_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"
이 명령에 대한 전체 Azure CLI 설명서는 Azure CLI 설명서를 참조하세요.
Azure PowerShell
Azure PowerShell 버전 8.0 이상부터 Update-AzApplicationInsights PowerShell 명령을 사용하여 클래식 Application Insights 리소스를 작업 영역 기반으로 마이그레이션할 수 있습니다.
이 cmdlet을 사용하려면 업데이트하려는 Application Insights 리소스의 이름과 리소스 그룹을 지정해야 합니다. 클래식 인스턴스를 작업 영역 기반으로 마이그레이션하려면 IngestionMode 및 WorkspaceResoruceId 매개 변수를 사용합니다. 이 cmdlet의 매개 변수 및 구문에 대한 자세한 내용은 Update-AzApplicationInsights를 참조하세요.
예시
# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId
# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId
Azure Resource Manager 템플릿
이 섹션에서는 템플릿을 제공합니다.
주의
마이그레이션 템플릿을 실행하기 전에 리소스에서 모든 연속 내보내기 설정을 제거했는지 확인합니다. 필수 조건을 참조하세요.
템플릿 파일
{
"$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"regionId": {
"type": "string"
},
"tagsArray": {
"type": "object"
},
"requestSource": {
"type": "string"
},
"workspaceResourceId": {
"type": "string"
}
},
"resources": [
{
"name": "[parameters('name')]",
"type": "microsoft.insights/components",
"location": "[parameters('regionId')]",
"tags": "[parameters('tagsArray')]",
"apiVersion": "2020-02-02-preview",
"properties": {
"ApplicationId": "[parameters('name')]",
"Application_Type": "[parameters('type')]",
"Flow_Type": "Redfield",
"Request_Source": "[parameters('requestSource')]",
"WorkspaceResourceId": "[parameters('workspaceResourceId')]"
}
}
]
}
매개 변수 파일
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"type": {
"value": "web"
},
"name": {
"value": "customresourcename"
},
"regionId": {
"value": "eastus"
},
"tagsArray": {
"value": {}
},
"requestSource": {
"value": "Custom"
},
"workspaceResourceId": {
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
}
}
}
연결된 작업 영역 수정
작업 영역 기반 Application Insights 리소스를 만든 후 연결된 Log Analytics 작업 영역을 수정할 수 있습니다.
Application Insights 리소스 창 내에서 속성>작업 영역 변경>Log Analytics 작업 영역을 선택합니다.
자주 묻는 질문
이 섹션에서는 일반적인 질문에 대한 답변을 제공합니다.
Application Insights 클래식 리소스를 작업 영역 기반 리소스로 마이그레이션하지 않으면 어떻게 되나요?
Microsoft는 2024년 5월부터 클래식 리소스를 작업 영역 기반 리소스로 마이그레이션하는 자동 단계별 접근 방식을 시작할 예정이며, 이 마이그레이션은 몇 달 동안 진행됩니다. 특정 리소스, 구독 또는 지역이 마이그레이션될 대략적인 날짜를 제공할 수 없습니다.
Azure Portal의 클래식 Application Insights 리소스 개요 창에서 사용 중지 알림 배너를 선택하여 시작되는 작업 영역 기반 리소스로의 수동 마이그레이션을 적극 권장합니다. 이 프로세스에는 일반적으로 애플리케이션 데이터를 저장하는 데 사용할 Log Analytics 작업 영역을 선택하는 단일 단계가 포함됩니다. 연속 내보내기를 사용하는 경우 먼저 진단 설정으로 추가로 마이그레이션하거나 기능을 사용하지 않도록 설정해야 합니다.
클래식 리소스를 작업 영역 기반 리소스로 자동 마이그레이션하지 않으려면 리소스를 삭제하거나 수동으로 마이그레이션할 수 있습니다.
마이그레이션 비용에 영향을 주나요?
일반적으로 두 가지 예외를 제외하고는 차이가 없습니다.
- 레거시 Application Insights 가격 책정 모델을 통해 매월 1GB를 무료로 받은 Application Insights 리소스는 더 이상 무료 데이터를 받지 않습니다.
- 2018년 4월 이전에 기본 가격 책정 계층에 있었던 Application Insights 리소스는 2018년 4월 이전과 동일한 비지역 가격 책정으로 계속 청구됩니다. 해당 시간 이후에 만들어지거나 작업 영역 기반으로 변환된 Application Insights 리소스에는 현재 셀이 있는 영역 가격 책정이 적용됩니다. 사용자의 통화 및 지역에 따른 현재 가격은 Application Insights 가격 책정을 참조하세요.
작업 영역 기반 Application Insights로의 마이그레이션은 Log Analytics 약정 계층, 전용 클러스터 및 기본 로그를 포함하여 추가로 비용 최적화를 위한 다양한 옵션을 제공합니다.
원격 분석 상한은 어떻게 작동하나요?
Log Analytics 작업 영역에서 일일 한도를 설정할 수 있습니다.
청구 한도는 엄격하지 않습니다.
수집 기반 샘플링은 어떻게 작동하나요?
수집 기반 샘플링은 변경되지 않습니다.
마이그레이션 중에 수집된 데이터에 간격이 있나요?
아니요. 쿼리 시간 동안 데이터가 병합됩니다.
이전 로그 쿼리가 계속 작동하나요?
예, 계속 작동합니다.
고정된 메트릭 및 로그 차트가 있는 대시보드가 마이그레이션 후에도 계속 작동할까요?
예, 계속 작동합니다.
마이그레이션이 데이터에 액세스하는 AppInsights API에 영향을 주나요?
아니요. 마이그레이션은 데이터에 대한 기존 API 액세스에 영향을 미치지 않습니다. 마이그레이션 후 약간 다른 스키마를 사용하여 작업 영역에서 직접 데이터에 액세스할 수 있습니다.
라이브 메트릭 또는 기타 모니터링 환경에 영향을 주나요?
아니요. 라이브 메트릭 또는 기타 모니터링 환경에는 영향을 주지 않습니다.
마이그레이션 후 연속 내보내기는 어떻게 되나요?
자동화된 내보내기를 계속하려면 작업 영역 기반 리소스로 마이그레이션하기 전에 진단 설정으로 마이그레이션해야 합니다. 진단 설정은 작업 영역 기반 Application Insights로 마이그레이션됩니다.
Terraform을 사용하여 App Insights 리소스를 성공적으로 마이그레이션하려면 어떻게 해야 하나요?
Terraform을 사용하여 Azure 리소스를 관리하는 경우 App Insights 리소스를 업그레이드하기 전에 최신 버전의 Terraform azurerm 공급자를 사용하는 것이 중요합니다. 버전 3.12와 같은 이전 버전의 공급자를 사용하면 대체 작업 영역 기반 Application Insights 리소스를 만들기 전에 클래식 구성 요소가 삭제될 수 있습니다. 이 경우 이전 데이터가 손실되고 모니터링되는 앱의 구성을 새 연결 문자열 및 계측 키 값으로 업데이트해야 할 수 있습니다.
이 문제를 방지하려면 모든 이전 데이터 및 연결 문자열/계측 키 값을 유지하면서 App Insights 클래식 리소스를 작업 영역 기반 리소스로 업그레이드하는 적절한 ARM 호출을 실행하여 적절한 마이그레이션 단계를 수행하는 최신 버전의 Terraform azurerm 공급자 버전 3.89 이상을 사용해야 합니다.
기존 API를 사용하여 프로그래밍 방식으로 Application Insights 리소스를 만들 수 있나요?
이전 버전과의 호환성을 위해 Application Insights 리소스를 만들기 위한 이전 API 호출은 계속 작동합니다. 이러한 각 호출은 결국 작업 영역 기반 Application Insights 리소스와 Log Analytics 작업 영역을 모두 만들어 데이터를 저장합니다.
리소스 만들기를 보다 효과적으로 제어하려면 새 API로 업데이트하는 것이 좋습니다.
작업 영역 기반 AI로 이동하기 전에 클래식 Application Insights에서 진단 설정을 마이그레이션해야 하나요?
예, 작업 영역 기반 Application Insights로 전환하기 전에 클래식 Application Insights 리소스에 대한 진단 설정을 마이그레이션하는 것이 좋습니다. 이렇게 하면 진단 설정의 연속성과 호환성이 보장됩니다.
문제 해결
이 섹션에서는 일반적인 문제에 대한 문제 해결 팁을 제공합니다.
액세스 모드
오류 메시지: "선택한 작업 영역은 작업 영역 기반 액세스 모드로 구성되어 있습니다. 일부 APM(애플리케이션 성능 모니터링) 기능이 영향을 받을 수 있습니다. 다른 작업 영역을 선택하거나 작업 영역 설정에서 리소스 기반 액세스를 허용합니다. CLI를 사용하여 이 오류를 재정의할 수 있습니다."
작업 영역 기반 Application Insights 리소스가 제대로 작동하도록 하려면 대상 Log Analytics 작업 영역의 액세스 제어 모드를 리소스 또는 작업 영역 권한 설정으로 변경해야 합니다. 이 설정은 Log Analytics 작업 영역 UI의 속성>액세스 제어 모드에 있습니다. 자세한 내용은 Log Analytics 액세스 제어 모드 구성 지침을 참조하세요. 액세스 제어 모드가 전용 작업 영역 권한 필요 설정으로 지정된 경우 포털 마이그레이션 환경을 통한 마이그레이션은 차단된 상태로 유지됩니다.
현재 대상 작업 영역에 대한 보안상의 이유로 액세스 제어 모드를 변경할 수 없는 경우 마이그레이션에 사용할 새 Log Analytics 작업 영역을 만듭니다.
연속 내보내기
오류 메시지: "계속하려면 연속 내보내기를 사용하지 않도록 설정해야 합니다. 마이그레이션 후 내보내기를 위해 진단 설정을 사용하세요."
작업 영역 기반 리소스에는 레거시 연속 내보내기 기능이 지원되지 않습니다. 마이그레이션하기 전에 진단 설정을 사용하도록 설정하고 연속 내보내기를 사용하지 않도록 설정해야 합니다.
클래식 Application Insights 리소스에서 진단 설정을 사용하도록 설정합니다.
Application Insights 리소스 보기의 구성 제목에서 연속 내보내기를 선택합니다.
사용 안 함을 선택합니다.
사용 안 함을 선택한 후 마이그레이션 UI로 돌아갈 수 있습니다. 연속 내보내기 편집 페이지에 설정이 저장되지 않았다는 메시지가 표시되면 확인을 선택합니다. 이 메시지는 연속 내보내기를 사용하지 않도록 설정하거나 사용하도록 설정하는 것과는 관련이 없습니다.
Application Insights 리소스를 작업 영역 기반으로 성공적으로 마이그레이션한 후 진단 설정을 사용하여 연속 내보내기에서 제공했던 기능을 대체할 수 있습니다. Application Insights 리소스에서 진단 설정>진단 설정 추가를 선택합니다. 모든 테이블 또는 테이블의 하위 집합을 선택하여 스토리지 계정에 보관하거나 Azure Event Hubs로 스트리밍할 수 있습니다. 진단 설정에 대한 자세한 내용은 Azure Monitor 진단 설정 지침을 참조하세요.
보존 설정
경고 메시지: "사용자 지정 Application Insights 보관 설정은 작업 영역으로 전송된 데이터에 적용되지 않습니다. 별도로 다시 구성해야 합니다."
마이그레이션하기 전에 변경할 필요가 없습니다. 이 메시지는 현재 Application Insights 보존 설정이 기본값 90일 보존 기간으로 설정되지 않음을 경고합니다. 이 경고 메시지는 마이그레이션하고 새 데이터 수집을 시작하기 전에 Log Analytics 작업 영역에 대한 보존 설정을 수정하는 것이 좋음을 의미합니다.
Log Analytics UI의 설정>사용 및 예상 비용>데이터 보존에서 Log Analytics의 현재 보존 설정을 확인할 수 있습니다. 이 설정은 Application Insights 리소스를 마이그레이션한 후 새로 수집된 데이터가 저장되는 기간에 영향을 줍니다.
작업 영역 기반 리소스 변경
Application Insights 데이터는 작업 영역 기반 Application Insights 리소스가 도입되기 전에 Azure Monitor의 다른 로그 데이터와 별도로 저장됩니다. 둘 다 Azure Data Explorer를 기반으로 하며 동일한 KQL(Kusto 쿼리 언어)을 사용합니다. 작업 영역 기반 Application Insights 리소스 데이터는 다른 모니터링 데이터 및 애플리케이션 데이터와 함께 Log Analytics 작업 영역에 저장됩니다. 이 배열은 구성을 간소화합니다. 여러 솔루션의 데이터를 보다 쉽게 분석하고 작업 영역의 기능을 사용할 수 있습니다.
클래식 데이터 구조
Log Analytics 작업 영역의 구조는 Log Analytics 작업 영역 개요에 설명되어 있습니다. 클래식 애플리케이션의 경우 데이터가 Log Analytics 작업 영역에 저장되지 않습니다. 동일한 쿼리 언어를 사용합니다. Azure Portal에서 동일한 Log Analytics 도구를 사용하여 쿼리를 만들고 실행합니다. 클래식 애플리케이션의 데이터 항목은 서로 별도로 저장됩니다. 테이블 이름과 열 이름이 서로 다르지만 일반적인 구조는 작업 영역 기반 애플리케이션과 동일합니다.
참고 항목
클래식 Application Insights 환경에는 리소스 쿼리, 통합 문서 및 로그 기반 경고에 대한 이전 버전과의 호환성이 포함됩니다. 새 작업 영역 기반 테이블 구조 또는 스키마에 대해 쿼리하거나 보려면 먼저 Log Analytics 작업 영역으로 이동합니다. 미리 보기 중에 Application Insights 창에서 로그를 선택하면 기존 Application Insights 쿼리 환경에 액세스할 수 있습니다. 자세한 내용은 쿼리 범위를 참조하세요.
테이블 구조
| 레거시 테이블 이름 | 새 테이블 이름 | 설명 |
|---|---|---|
| availabilityResults | AppAvailabilityResults | 가용성 테스트에 대한 요약 데이터입니다. |
| browserTimings | AppBrowserTimings | 들어오는 데이터를 처리하는 데 걸리는 시간 등, 클라이언트 성능에 대한 데이터입니다. |
| 종속성 | AppDependencies | 애플리케이션에서 TrackDependency()를 통해 기록된 다른 구성 요소(외부 구성 요소 포함)에 대한 호출입니다. 예를 들어, REST API, 데이터베이스 또는 파일 시스템에 대한 호출이 있습니다. |
| customEvents | AppEvents | 애플리케이션에서 생성된 사용자 지정 이벤트입니다. |
| customMetrics | AppMetrics | 애플리케이션에서 생성된 사용자 지정 메트릭입니다. |
| pageViews | AppPageViews | 브라우저 정보가 포함된 각 웹 사이트 보기에 대한 데이터입니다. |
| performanceCounters | AppPerformanceCounters | 애플리케이션을 지원하는 컴퓨팅 리소스의 성능 측정. Windows 성능 카운터를 예로 들 수 있습니다. |
| requests | AppRequests | 애플리케이션이 받은 요청입니다. 예를 들어, 웹앱이 수신하는 각 HTTP 요청에 대해 별도의 요청 레코드가 기록됩니다. |
| 예외 | AppExceptions | 애플리케이션 런타임에서 발생한 예외입니다. 서버 쪽 및 클라이언트 쪽(브라우저) 예외를 모두 캡처합니다. |
| traces | AppTraces | TrackTrace()를 통해 로그된 애플리케이션 코드/로깅 프레임워크를 통해 내보낸 자세한 로그(추적). |
주의
Log Analytics를 사용하기 전에 Log Analytics에서 새로운 원격 분석을 기다립니다. 마이그레이션을 시작한 후 원격 분석은 먼저 Classic Application Insights로 이동합니다. 원격 분석 수집은 24시간 이내에 Log Analytics로 전환됩니다. 완료되면 Log Analytics는 새로운 원격 분석만 캡처합니다.
테이블 스키마
다음 섹션에서는 클래식 속성 이름과 새 작업 영역 기반 Application Insights 속성 이름 간의 매핑을 보여 줍니다. 레거시 테이블을 사용하여 쿼리를 변환하려면 이 정보를 사용합니다.
대부분의 열은 대/소문자가 다른 동일한 이름을 갖습니다. KQL은 대/소문자를 구분하므로 기존 쿼리의 테이블 이름과 함께 각 열 이름을 변경해야 합니다. 대문자화 외에도 변경 내용이 있는 열은 강조 표시됩니다. 작업 영역 기반 리소스의 경우에도 Application Insights 리소스의 로그 창 내에서 기존 Application Insights 쿼리를 계속 사용할 수 있습니다. Log Analytics 작업 영역 환경의 컨텍스트 내에서 쿼리할 때 새 속성 이름이 필요합니다.
AppAvailabilityResults
레거시 테이블: availabilityResults
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| location | string | 위치 | string |
| message | string | 메시지 | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| size | real | 크기 | real |
| 성공 | string | Success | Bool |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppBrowserTimings
레거시 테이블: browserTimings
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | 날짜/시간 |
| networkDuration | real | NetworkDurationMs | real |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| processingDuration | real | ProcessingDurationMs | real |
| receiveDuration | real | ReceiveDurationMs | real |
| sdkVersion | string | SDKVersion | string |
| sendDuration | real | SendDurationMs | real |
| session_Id | string | 세션 ID | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| totalDuration | real | TotalDurationMs | real |
| url | string | Url | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppDependencies
레거시 테이블: 종속성
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| 데이터 | string | 데이터 | string |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| resultCode | string | ResultCode | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| 성공 | string | Success | Bool |
| target | string | 대상 | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| type | string | DependencyType | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppEvents
레거시 테이블: customEvents
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppMetrics
레거시 테이블: customMetrics
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| iKey | string | IKey | string |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
| value | real | (제거됨) | |
| valueCount | int | ItemCount | int |
| valueMax | real | ValueMax | real |
| valueMin | real | ValueMin | real |
| valueSum | real | ValueSum | real |
참고 항목
이전 버전의 Application Insights SDK는 메트릭 사전 집계에서 표준 편차(valueStdDev)를 보고하는 데 사용되었습니다. 메트릭 분석의 채택률이 낮았기 때문에 필드가 제거되었으며 더 이상 SDK에서 집계되지 않습니다. Application Insights 데이터 컬렉션 엔드포인트에서 값을 받으면 수집 중에 삭제되고 Log Analytics 작업 영역으로 전송되지 않습니다. 분석에서 표준 편차를 사용하려면 Application Insights 원시 이벤트에 대한 쿼리를 사용합니다.
AppPageViews
레거시 테이블: pageViews
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| url | string | Url | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppPerformanceCounters
레거시 테이블: performanceCounters
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| category | string | 범주 | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| counter | string | (제거됨) | |
| customDimensions | dynamic | 속성 | 동적 |
| iKey | string | IKey | string |
| 인스턴스 | string | 인스턴스 | string |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
| value | real | 값 | real |
AppRequests
레거시 테이블: 요청
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | 동적 |
| customMeasurements | dynamic | 측정값 | 동적 |
| duration | real | DurationMs | 실수 |
id |
string | Id |
문자열 |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | 문자열 |
| name | 문자열 | 이름 | 문자열 |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | 문자열 |
| resultCode | string | ResultCode | 문자열 |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| 원본 | string | 원본 | 문자열 |
| 성공 | string | Success | Bool |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| url | string | Url | 문자열 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppExceptions
레거시 테이블: 예외
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| assembly | string | 어셈블리 | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | dynamic |
| customMeasurements | dynamic | 측정값 | dynamic |
| details | dynamic | 세부 정보 | dynamic |
| handledAt | string | HandledAt | string |
| iKey | string | IKey | string |
| innermostAssembly | string | InnermostAssembly | string |
| innermostMessage | string | InnermostMessage | string |
| innermostMethod | string | InnermostMethod | string |
| innermostType | string | InnermostType | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | string |
| message | string | 메시지 | string |
| 메서드(method) | string | 메서드 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| outerAssembly | string | OuterAssembly | string |
| outerMessage | string | OuterMessage | string |
| outerMethod | string | OuterMethod | string |
| outerType | string | OuterType | string |
| problemId | string | ProblemId | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| severityLevel | int | SeverityLevel | int |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| type | string | ExceptionType | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |
AppTraces
레거시 테이블: 추적
| ApplicationInsights | Type | LogAnalytics | Type |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dynamic | 속성 | dynamic |
| customMeasurements | dynamic | 측정값 | dynamic |
| iKey | string | IKey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _ItemId | string |
| itemType | string | Type | string |
| message | string | 메시지 | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | OperationSyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | 세션 ID | string |
| severityLevel | int | SeverityLevel | int |
| timestamp | 날짜/시간 | TimeGenerated | 날짜/시간 |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | 사용자 ID | string |