Log Analytics 작업 영역에서 보조 계획을 사용하여 테이블 설정(미리 보기)
보조 테이블 계획을 사용하면 저렴한 비용으로 Log Analytics 작업 영역에서 데이터를 수집하고 보존할 수 있습니다. Azure Monitor 로그는 현재 Azure Monitor 에이전트 또는 로그 수집 API를 사용하여 수집한 데이터를 보내는 DCR(데이터 수집 규칙) 기반 사용자 지정 테이블에 대한 보조 테이블 계획을 지원합니다.
이 문서에서는 Log Analytics 작업 영역에서 보조 계획을 사용하여 사용자 지정 테이블을 만들고 이 테이블에 데이터를 보내는 데이터 수집 규칙을 설정하는 방법을 설명합니다.
보조 테이블 계획의 사용 및 이점 중 일부를 설명하는 동영상입니다.
Important
보조 테이블 및 데이터 수집 규칙과 관련된 지원 지역 및 제한 사항은 공개 미리 보기 제한 사항을 참조하세요.
필수 조건
사용자 지정 테이블을 만들고 로그 데이터를 수집하려면 다음이 필요합니다.
- 최소한 기여자 권한이 있는 Log Analytics 작업 영역.
- DCE(데이터 수집 엔드포인트).
- Log Analytics 작업 영역의 모든 테이블에는
TimeGenerated라는 열이 있습니다. 원시 로그 데이터에TimeGenerated속성이 있는 경우 Azure Monitor는 이 값을 사용하여 레코드 만들기 시간을 식별합니다. 보조 계획이 있는 테이블의 경우TimeGenerated열은 현재 ISO8601 형식만 지원합니다.TimeGenerated형식에 대한 자세한 내용은 지원되는 ISO 8601 날짜/시간 형식을 참조하세요.
보조 계획으로 사용자 지정 테이블 만들기
사용자 지정 테이블을 만들려면 다음 명령을 사용하여 테이블 - 만들기 또는 업데이트 API를 호출합니다.
https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.OperationalInsights/workspaces/{workspace_name}/tables/{table name_CL}?api-version=2023-01-01-preview
Important
현재 API 버전 2023-01-01-preview에서만 보조 테이블 계획을 설정할 수 있습니다.
이 페이로드를 제공합니다. 테이블 이름을 업데이트하고 테이블 스키마에 따라 열을 조정합니다.
{
"properties": {
"schema": {
"name": "table_name_CL",
"columns": [
{
"name": "TimeGenerated",
"type": "datetime"
},
{
"name": "StringProperty",
"type": "string"
},
{
"name": "IntProperty",
"type": "int"
},
{
"name": "LongProperty",
"type": "long"
},
{
"name": "RealProperty",
"type": "real"
},
{
"name": "BooleanProperty",
"type": "boolean"
},
{
"name": "GuidProperty",
"type": "real"
},
{
"name": "DateTimeProperty",
"type": "datetime"
}
]
},
"totalRetentionInDays": 365,
"plan": "Auxiliary"
}
}
보조 계획을 사용하여 테이블에 데이터 보내기
현재 보조 계획을 사용하여 사용자 지정 테이블에 데이터를 수집하는 방법에는 두 가지가 있습니다.
Azure Monitor 에이전트를 사용하여 텍스트 파일에서 로그 수집 / Azure Monitor 에이전트를 사용하여 JSON 파일에서 로그 수집.
이 방법을 사용하는 경우 사용자 지정 테이블에는 두 개의 열(
TimeGenerated및RawData(string형식))만 있어야 합니다. 데이터 수집 규칙은 수집한 각 로그 항목 전체를RawData열로 보내고, Azure Monitor 로그는 로그가 수집된 시간으로TimeGenerated열을 자동으로 채웁니다.Logs 수집 API를 사용하여 Azure Monitor에 데이터를 보냅니다.
이 방법을 사용하려면:
이 문서에 설명된 대로 보조 계획을 사용하여 사용자 지정 테이블을 만듭니다.
자습서: 로그 수집 API를 사용하여 Azure Monitor에 데이터 보내기에 설명된 단계를 수행하여 다음을 수행합니다.
- Microsoft Entra 애플리케이션을 만듭니다.
- 이 ARM 템플릿을 사용하여 데이터 수집 규칙을 만듭니다.
{ "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentTemplate.json#", "contentVersion": "1.0.0.0", "parameters": { "dataCollectionRuleName": { "type": "string", "metadata": { "description": "Specifies the name of the data collection rule to create." } }, "location": { "type": "string", "metadata": { "description": "Specifies the region in which to create the data collection rule. The must be the same region as the destination Log Analytics workspace." } }, "workspaceResourceId": { "type": "string", "metadata": { "description": "The Azure resource ID of the Log Analytics workspace in which you created a custom table with the Auxiliary plan." } } }, "resources": [ { "type": "Microsoft.Insights/dataCollectionRules", "name": "[parameters('dataCollectionRuleName')]", "location": "[parameters('location')]", "apiVersion": "2023-03-11", "kind": "Direct", "properties": { "streamDeclarations": { "Custom-table_name_CL": { "columns": [ { "name": "TimeGenerated", "type": "datetime" }, { "name": "StringProperty", "type": "string" }, { "name": "IntProperty", "type": "int" }, { "name": "LongProperty", "type": "long" }, { "name": "RealProperty", "type": "real" }, { "name": "BooleanProperty", "type": "boolean" }, { "name": "GuidProperty", "type": "real" }, { "name": "DateTimeProperty", "type": "datetime" } ] } }, "destinations": { "logAnalytics": [ { "workspaceResourceId": "[parameters('workspaceResourceId')]", "name": "myworkspace" } ] }, "dataFlows": [ { "streams": [ "Custom-table_name_CL" ], "destinations": [ "myworkspace" ] } ] } } ], "outputs": { "dataCollectionRuleId": { "type": "string", "value": "[resourceId('Microsoft.Insights/dataCollectionRules', parameters('dataCollectionRuleName'))]" } } }여기서
myworkspace는 Log Analytics 작업 영역의 이름입니다.table_name_CL은 테이블의 이름입니다.columns에는 보조 계획으로 사용자 지정 테이블 만들기에서 설정한 것과 동일한 열이 포함됩니다.
공개 미리 보기 제한 사항
공개 미리 보기 중에는 다음과 같은 제한 사항이 적용됩니다.
보조 계획은 점차적으로 모든 지역에 출시되고 있으며 현재 다음 지역에서 지원됩니다.
지역 위치 아메리카 캐나다 중부 미국 중부 미국 동부 미국 동부 2 미국 서부 미국 중남부 미국 중북부 아시아 태평양 오스트레일리아 동부 오스트레일리아 남동부 유럽 동아시아 북유럽 영국 남부 독일 중서부 스위스 북부 프랑스 중부 중동 이스라엘 중부 테이블 - 만들기 또는 업데이트 API, 버전
2023-01-01-preview를 사용하여 만든 데이터 수집 규칙 기반 사용자 지정 테이블에만 보조 계획을 설정할 수 있습니다.보조 계획이 포함된 테이블:
- 현재 요금이 청구되지 않습니다. 현재 수집, 쿼리, 검색 작업, 장기 보존에는 요금이 부과되지 않습니다.
- 동적 데이터가 포함된 열을 지원하지 않습니다.
- 총 보존 기간은 365일로 고정됩니다.
- ISO 8601 날짜/시간 형식만 지원합니다.
보조 계획이 있는 테이블에 데이터를 보내는 데이터 수집 규칙:
- 단일 테이블에만 데이터를 보낼 수 있습니다.
- 변환을 포함할 수 없습니다.
보조 테이블에 대한 수집 데이터는 현재 Azure Monitor 로그 사용 테이블에서 사용할 수 없습니다. 데이터 수집량을 예상하려면 다음 쿼리를 사용하여 보조 테이블의 레코드 수를 계산할 수 있습니다.
MyTable_CL | summarize count()이러한 기능은 현재 지원되지 않습니다.
기능 세부 정보 Log Analytics 작업 영역 복제 Azure Monitor는 보조 계획이 있는 테이블의 데이터를 보조 작업 영역에 복제하지 않습니다. 따라서 이 데이터는 지역별 장애 발생 시 데이터 손실로부터 보호되지 않으며 보조 작업 영역으로 전환할 때 사용할 수 없습니다. 고객 관리형 키 보조 계획이 있는 테이블의 데이터는 자체 암호화 키를 사용하여 Log Analytics 작업 영역의 나머지 부분에 있는 데이터를 보호하더라도 Microsoft 관리형 키로 암호화됩니다. Microsoft Azure에 대한 고객 Lockbox 고객이 시작한 지원 티켓 또는 Microsoft에서 식별한 문제에 대한 응답으로 고객 데이터 액세스 요청을 검토하고 승인하거나 거부할 수 있는 Lockbox 인터페이스는 보조 계획이 있는 테이블에는 적용되지 않습니다.
다음 단계
자세히 알아보기: