你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将表的日志数据计划设置为基本或分析

Azure Monitor 日志提供两个日志数据计划，可降低日志引入和保留成本，并根据需要利用 Azure Monitor 的高级功能和分析功能：

• 默认的“分析”日志数据计划提供完整的分析功能，并使日志数据可用于查询、Azure Monitor 功能（如警报）以及供其他服务使用。
• “基本”日志数据计划可以节省在日志分析工作区中引入和存储大量详细日志的成本，以用于调试、故障排除和审核，但不用于分析和警报。

本文介绍了 Azure Monitor 的日志数据计划，并解释了如何在日志分析工作区中配置表的日志数据计划。

重要

每周可以切换表计划一次。
“基本日志”功能不适用于旧定价层中的工作区。

比较“基本”与“分析”日志数据计划

下表概述了这两个计划。

类别	分析	基本
引流	数据引入产生的开销。	降低了数据引入产生的开销。
日志查询	无额外费用。 完整的查询功能。	额外费用。 查询功能的子集。
保留	配置从 30 天到 730 天的保留期。	保留时间固定为八天。
警报	支持。	不支持。

备注

“基本日志”数据计划不适用于旧定价层中的工作区。

何时应使用基本日志？

是否为基本日志配置表的决定基于以下条件：

• 该表当前支持基本日志。
• 表的数据保留期不超过 8 天。
• 只需要使用有限版本的查询语言对数据进行基本查询。
• 一个月内数据引入的成本节省超过了任何预期查询的预期成本

哪些表支持基本日志？

默认情况下，Log Analytics 工作区中的所有表都是可用于查询和警报的分析表。 目前，可以为基本日志配置以下表：

表	详细信息
自定义表	使用基于数据收集规则 (DCR) 的日志引入 API 创建的或迁移到该 API 的所有自定义表。
ACSCallAutomationIncomingOperations	通信服务传入请求调用。
ACSCallRecordingSummary	通信服务记录摘要日志。
ACSRoomsIncomingOperations	通信服务室传入请求操作。
AppTraces	Application Insights 自由格式跟踪。
AMSLiveEventOperations	Azure 媒体服务编码器连接、断开连接或终止。
AMSKeyDeliveryRequests	有关密钥或许可证获取的 Azure 媒体服务 HTTP 请求详细信息。
AMSMediaAccountHealth	Azure 媒体服务帐户运行状况。
AMSStreamingEndpointRequests	有关流式处理终结点请求的 Azure 媒体服务信息。
ContainerAppConsoleLogs	Azure 容器应用日志，在容器应用程序环境中生成。
ContainerLogV2	用于容器见解，其中包括基于文本的详细日志记录。
DevCenterDiagnosticLogs	与开发人员中心资源相关的数据平面审核；例如，开发箱和环境停止、启动、删除。

注意

使用数据收集器 API 创建的表不支持基本日志。

设置表的日志数据计划

Portal

若要在 Azure 门户中为基本日志或分析日志配置表，请执行以下操作：

1. 从“Log Analytics 工作区”菜单中，选择“表”。

   “表”屏幕列出了工作区中的所有表。

2. 选择要配置的表的上下文菜单，然后选择“管理表”。

   

3. 从表配置屏幕上的“表计划”下拉菜单中，选择“基本”或“分析”。

   仅对支持基本日志的表启用“表计划”下拉菜单。

   

4. 选择“保存”。

API

若要为基本日志或分析日志配置表，请调用“表 - 更新”API：

PATCH https://management.azure.com/subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/tables/<tableName>?api-version=2021-12-01-preview

重要

使用持有者令牌进行身份验证。 详细了解如何使用持有者令牌。

请求正文

名称	类型	说明
properties.plan	字符串	表计划。 可能的值为 Analytics 和 Basic。

示例

此示例为基本日志配置 ContainerLogV2 表。

容器见解默认使用 ContainerLog。 若要切换为使用容器见解 ContainerLogV2，请先启用 ContainerLogV2 架构，然后再将表转换为基本日志。

示例请求

PATCH https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview

使用此请求正文更改为“基本日志”：

{
    "properties": {
        "plan": "Basic"
    }
}

使用此请求正文更改为“分析日志”：

{
    "properties": {
        "plan": "Analytics"
    }
}

示例响应

此示例是更改为“基本日志”的表的响应：

状态代码：200

{
    "properties": {
        "retentionInDays": 8,
        "totalRetentionInDays": 30,
        "archiveRetentionInDays": 22,
        "plan": "Basic",
        "lastPlanModifiedDate": "2022-01-01T14:34:04.37",
        "schema": {...}        
    },
    "id": "subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace",
    "name": "ContainerLogV2"
}

CLI

若要配置表以获取基本日志或 Analytics Logs，请运行 az monitor log-analytics workspace table update 命令，并将 --plan 参数设置为 Basic 或 Analytics。

例如：

• 若要设置基本日志，请运行：

  az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG  --workspace-name ContosoWorkspace --name ContainerLogV2  --plan Basic
  

• 若要设置 Analytics Logs，请运行：

  az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG  --workspace-name ContosoWorkspace --name ContainerLogV2  --plan Analytics
  

查看表的日志数据计划

Portal

若要检查 Azure 门户中的表配置，可以打开表配置屏幕，如设置表配置中所述。

也可使用以下命令：

1. 从“Azure Monitor”菜单中选择“日志”，然后选择你的工作区作为范围。 有关演练，请参阅 Log Analytics 教程。

2. 打开“表”选项卡，其中列出了工作区中的所有表。

   基本日志表具有唯一图标：

   

   还可以将鼠标悬停在表信息视图的表名上，这将指示该表是否配置为“基本日志”：

   

API

若要检查表的配置，请调用“表 - 获取”API：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2021-12-01-preview

响应正文

名称	类型	说明
properties.plan	字符串	表计划。 Analytics 或 Basic。
properties.retentionInDays	integer	表的数据保留期（以天表示）。 在 Basic Logs 中，该值为 8 天，固定值。 在“Analytics Logs”中，该值介于 7 天到 730 天之间。
properties.totalRetentionInDays	integer	表的数据保留期还包括存档期。
properties.archiveRetentionInDays	integer	表的存档期（只读、已计算）。
properties.lastPlanModifiedDate	String	上次为此表设置计划的时间。 如果从未对默认设置进行任何更改，则为 NULL（只读）。

示例请求

GET https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview

示例响应

状态代码：200

{
    "properties": {
        "retentionInDays": 8,
        "totalRetentionInDays": 8,
        "archiveRetentionInDays": 0,
        "plan": "Basic",
        "lastPlanModifiedDate": "2022-01-01T14:34:04.37",
        "schema": {...},
        "provisioningState": "Succeeded"        
    },
    "id": "subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace",
    "name": "ContainerLogV2"
}

CLI

若要检查表的配置，请运行 az monitor log-analytics workspace table show 命令。

例如：

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

保留和存档基本日志

Analytics 表根据所设置的保留和存档策略保留数据。

基本日志表将数据保留 8 天。 将现有表的计划更改为“基本日志”时，Azure 会将超过八天但仍在表的原始保留期内的数据存档。

后续步骤

• 在基本日志中查询数据
• 集保留和存档策略