Log Analytics 작업 영역에서 데이터 보존 관리

Log Analytics 작업 영역 내에서 Analytics 테이블의 기본 분석 보존 기간을 설정하려면 다음을 수행합니다.

1. Azure Portal의 Log Analytics 작업 영역 메뉴에서 작업 영역을 선택합니다.

2. 설정 섹션의 왼쪽 창에서 사용량 및 예상 비용을 선택합니다.

3. 페이지 상단에서 데이터 보존 아이콘을 선택합니다.

   

4. 슬라이더를 이동하여 일 수를 늘리거나 줄인 다음 확인을 선택합니다.

Log Analytics 작업 영역 내에서 분석 테이블의 기본 분석 보존 기간을 설정하려면 작업 영역 - 만들기 또는 업데이트 API를 호출합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

요청 본문

요청 본문에는 다음 표의 값이 포함됩니다.

예제

이 예에서는 작업 영역의 보존을 작업 영역 기본값인 30일로 설정하고 데이터가 30일 후에 즉시 제거되어 복구할 수 없도록 보장합니다.

요청

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

{
  "properties": {
    "retentionInDays": 30,
    "features": {"immediatePurgeDataOn30Days": true}
    },
"___location": "australiasoutheast"
}

**Response**

Status code: 200

```http
{
  "properties": {
    ...
    "retentionInDays": 30,
    "features": {
      "legacy": 0,
      "searchVersion": 1,
      "immediatePurgeDataOn30Days": true,
      ...}
    },
    ...
}

Log Analytics 작업 영역 내에서 분석 테이블의 기본 분석 보존 기간을 설정하려면 az monitor log-analytics 작업 영역 업데이트 명령을 실행하고 매개 변수를 --retention-time 전달합니다.

이 예제에서는 테이블의 분석 보존 기간을 30일로 설정합니다.

az monitor log-analytics workspace update --resource-group myresourcegroup --retention-time 30 --workspace-name myworkspace

Set-AzOperationalInsightsWorkspace cmdlet을 사용하여 Log Analytics 작업 영역 내에서 Analytics 테이블의 기본 분석 보존 기간을 설정합니다. 다음은 기본 분석 보존 기간을 30일로 설정하는 예제입니다.

Set-AzOperationalInsightsWorkspace -ResourceGroupName "myResourceGroup" -Name "MyWorkspace" -RetentionInDays 30

Azure Portal에서 테이블에 대한 보존 설정을 수정하려면:

1. Log Analytics 작업 영역 메뉴에서 테이블을 선택합니다.

   테이블 화면에는 작업 영역의 모든 테이블이 나열됩니다.

2. 구성하려는 테이블의 바로 가기 메뉴를 선택하고 테이블 관리를 선택합니다.

   

3. 테이블 구성 화면의 데이터 보존 설정 섹션에서 분석 보존 및 총 보존 설정을 구성합니다.

   

테이블에 대한 보존 설정을 수정하려면 테이블 - 업데이트 API를 호출합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2022-10-01

PUT 또는 PATCH를 사용할 수 있으며 다음과 같은 차이가 있습니다.

• Null이 아닌 값을 설정하지 않은 경우 PUT API는 retentionInDays 및 totalRetentionInDays를 기본값으로 설정합니다.
• 값을 지정하지 않으면 PATCH API는 retentionInDays 또는 totalRetentionInDays 값을 변경하지 않습니다.

요청 본문

요청 본문에는 다음 표의 값이 포함됩니다.

예제

다음은 테이블의 분석 보존 기간을 작업 영역 기본값인 30일로 설정하고 총 보존 기간을 2년으로 설정하는 예제입니다. 즉, 장기 보존 기간은 23개월입니다.

요청

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/testRG/providers/Microsoft.OperationalInsights/workspaces/testWS/tables/CustomLog_CL?api-version=2022-10-01

요청 본문

{
    "properties": {
        "retentionInDays": null,
        "totalRetentionInDays": 730
    }
}

응답

상태 코드: 200

{
    "properties": {
        "retentionInDays": 30,
        "totalRetentionInDays": 730,
        "archiveRetentionInDays": 700,
        ...        
    },
   ...
}

테이블의 보존 설정을 수정하려면 az monitor log-analytics workspace table update 명령을 실행하고 --retention-time 및 --total-retention-time 매개 변수를 전달합니다.

다음은 테이블의 분석 보존 기간을 30일로 설정하고 총 보존 기간을 2년으로 설정하는 예제입니다. 즉, 장기 보존 기간은 23개월입니다.

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name AzureMetrics --retention-time 30 --total-retention-time 730

작업 영역의 기본 보존 값을 테이블에 다시 적용하고 총 보존 기간을 0으로 다시 설정하려면 az monitor log-analytics 작업 영역 테이블 업데이트 명령을 실행하고 --retention-time 매개 변수를 --total-retention-time 설정합니다-1.

예시:

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name Syslog --retention-time -1 --total-retention-time -1

Update-AzOperationalInsightsTable cmdlet을 사용하여 테이블의 보존 설정을 수정합니다. 다음은 테이블의 분석 보존 기간을 30일로 설정하고 총 보존 기간을 2년으로 설정하는 예제입니다. 즉, 장기 보존 기간은 23개월입니다.

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName AzureMetrics -RetentionInDays 30 -TotalRetentionInDays 730

작업 영역의 기본 보존 값을 테이블에 다시 적용하고 총 보존 기간을 0으로 다시 설정하려면 및 매개 변수가 설정된 Update-AzOperationalInsightsTable cmdlet -RetentionInDays-TotalRetentionInDays 을 -1실행합니다.

예시:

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName Syslog -RetentionInDays -1 -TotalRetentionInDays -1

이 샘플 ARM 템플릿 및 매개 변수 파일을 사용하여 특정 테이블의 보존 기간을 업데이트합니다.

템플릿 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "sampleWorkspace",
      "metadata": {
        "description": "The number of days to retain the data."
      }
    },
    "tableName": {
      "type": "string",
      "defaultValue": "sampleTable",
      "metadata": {
        "description": "The name of the Log Analytics table to modify."
      }
    },
    "retentionInDays": {
      "type": "int",
      "defaultValue": 30,
      "metadata": {
        "description": "The number of days to retain the data."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "2025-02-01",
      "name": "[parameters('workspaceName')]",
      "___location": "[resourceGroup().___location]",
      "resources": [
        {
          "type": "Microsoft.OperationalInsights/workspaces/tables",
          "apiVersion": "2025-02-01",
          "name": "[concat(parameters('workspaceName'), '/', parameters('tableName'))]",
          "properties": {
            "retentionInDays": "[parameters('retentionInDays')]"
          },
          "dependsOn": [ "[resourceId('Microsoft.OperationalInsights/workspaces/', parameters('workspaceName'))]" ]
        }
      ]
    }
  ]
}

매개 변수 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "value": "MyWorkspace"
    },
    "tableName": {
      "value": "AppRequests"
    },
    "retentionInDays": {
      "value": 120
    }
  }
}

Azure Portal에서 테이블의 보존 설정을 보려면 Log Analytics 작업 영역 메뉴에서 테이블을 선택합니다.

테이블 화면에는 작업 영역의 모든 테이블에 대한 분석 보존 및 총 보존 기간이 표시됩니다.

특정 테이블의 보존 설정(이 예제의 경우 SecurityEvent)을 가져오려면테이블 - Get API를 호출합니다.

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables/SecurityEvent?api-version=2022-10-01

작업 영역에서 모든 테이블 수준 보존 설정을 가져오려면 테이블 이름을 설정하지 마세요.

예시:

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables?api-version=2022-10-01

특정 테이블의 보존 설정을 가져오려면 az monitor log-analytics 작업 영역 테이블 표시 명령을 실행합니다.

예시:

az monitor log-analytics workspace table show --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name SecurityEvent

특정 테이블의 보존 설정을 가져오려면 Get-AzOperationalInsightsTable cmdlet을 실행합니다.

예시:

Get-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -tableName SecurityEvent