使用 Azure Monitor 日志进行容器组和实例日志记录

Log Analytics 工作区提供了一个集中的位置，用于存储和查询来自 Azure 资源、本地资源以及其他云中的资源的日志数据。 Azure 容器实例提供内置支持，支持将日志和事件数据发送到 Azure Monitor 日志。

若要将容器组日志和事件数据发送到 Azure Monitor 日志，请在配置容器组时指定现有 Log Analytics 工作区 ID 和工作区密钥。

以下部分介绍如何创建启用了日志记录的容器组以及如何查询日志。 还可以使用工作区 ID 和工作区密钥更新容器组以启用日志记录。

先决条件

若要在容器实例中启用日志记录，需具备以下条件：

• Log Analytics 工作区

• Azure CLI

获取 Log Analytics 凭据

Azure 容器实例需要权限才能向 Log Analytics 工作区发送数据。 若要授予该权限并启用日志记录，必须在创建容器组时提供 Log Analytics 工作区 ID 和一个密钥（主密钥或辅助密钥）。

若要获取 Log Analytics 工作区 ID 和主密钥，请执行以下操作：

1. 在 Azure 门户中导航到 Log Analytics 工作区
2. 在“设置”下，选择“代理管理”
3. 记下以下内容：
   • 工作区 ID
   • 主密钥

创建容器组

有了 Log Analytics 工作区 ID 和主密钥以后，即可创建启用日志记录的容器组。

下面的示例演示了创建包含单个 fluentd 容器的容器组的两种方式：Azure CLI 和带有 YAML 模板的 Azure CLI。 fluentd 容器在其默认配置中生成多行输出。 由于该输出发送到 Log Analytics 工作区，因此适用于演示如何查看和查询日志。

使用 Azure CLI 进行部署

若要使用 Azure CLI 进行部署，请在 az container create 命令中指定 --log-analytics-workspace 和 --log-analytics-workspace-key 参数。 在运行下面的命令之前，请将两个工作区值替换为在前面的步骤中获得的值（并更新资源组名称）。

az container create \
    --resource-group myResourceGroup \
    --name mycontainergroup001 \
    --image fluent/fluentd \
    --log-analytics-workspace <WORKSPACE_ID> \
    --log-analytics-workspace-key <WORKSPACE_KEY>

使用 YAML 进行部署

如果喜欢使用 YAML 部署容器组，请使用此方法。 下面的 YAML 定义包含单个容器的容器组。 将 YAML 复制到一个新文件中，然后将 LOG_ANALYTICS_WORKSPACE_ID 和 LOG_ANALYTICS_WORKSPACE_KEY 替换为在前面的步骤中获得的值。 将该文件保存为 deploy-aci.yaml。

apiVersion: 2019-12-01
location: chinaeast2
name: mycontainergroup001
properties:
  containers:
  - name: mycontainer001
    properties:
      environmentVariables: []
      image: fluent/fluentd
      ports: []
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
  osType: Linux
  restartPolicy: Always
  diagnostics:
    logAnalytics:
      workspaceId: LOG_ANALYTICS_WORKSPACE_ID
      workspaceKey: LOG_ANALYTICS_WORKSPACE_KEY
tags: null
type: Microsoft.ContainerInstance/containerGroups

接下来，执行下面的命令，以部署该容器组。 将 myResourceGroup 替换为订阅中的资源组（或者先创建名为“myResourceGroup”的资源组）：

az container create --resource-group myResourceGroup --name mycontainergroup001 --file deploy-aci.yaml

在发出命令以后，很快就会收到来自 Azure 的响应，其中包含部署详细信息。

查看日志

部署容器组以后，可能需要等待数分钟（最多 10 分钟），第一个日志条目才会显示在 Azure 门户中。

若要查看 ContainerInstanceLog_CL 表中的容器组日志，请执行以下操作：

1. 在 Azure 门户中导航到 Log Analytics 工作区
2. 在“常规”下，选择“日志”
3. 键入以下查询：ContainerInstanceLog_CL | limit 50
4. 选择“运行”

此时应看到查询显示了多个结果。 如果起初没有看到任何结果，请等待几分钟，然后选择“运行”按钮，再次执行查询。 默认情况下会以“表”的形式显示日志条目。 然后即可展开某一行来查看单个日志条目的内容。

查看事件

还可以在 Azure 门户中查看容器实例的事件。 事件包括实例的创建时间和启动时间。 若要查看 ContainerEvent_CL 表中的事件数据，请执行以下操作：

1. 在 Azure 门户中导航到 Log Analytics 工作区
2. 在“常规”下，选择“日志”
3. 键入以下查询：ContainerEvent_CL | limit 50
4. 选择“运行”

此时应看到查询显示了多个结果。 如果起初没有看到任何结果，请等待几分钟，然后选择“运行”按钮，再次执行查询。 默认情况下会以“表”的形式显示条目。 然后即可展开某一行来查看单个条目的内容。

查询容器日志

Azure Monitor 日志包含全面的查询语言，用于从可能有数千行的日志输出中拉取信息。

查询的基本结构是一个源表（在本文中为 ContainerInstanceLog_CL 或 ContainerEvent_CL），后跟一系列以竖线字符 (|) 分隔的运算符。 可以将多个运算符链接起来以优化结果和执行高级函数。

若要查看示例查询结果，请将以下查询粘贴到查询文本框中，然后选择“运行”按钮以执行该查询。 此查询显示其“消息”字段包含“warn”一词的所有日志条目：

ContainerInstanceLog_CL
| where Message contains "warn"

此外还支持更复杂的查询。 例如，以下查询仅显示“mycontainergroup001”容器组在过去一小时生成的那些日志条目：

ContainerInstanceLog_CL
| where (ContainerGroup_s == "mycontainergroup001")
| where (TimeGenerated > ago(1h))

日志架构

ContainerInstanceLog_CL

列	类型​​	说明
Computer	string	空
ContainerGroup_s	字符串	与记录关联的容器组的名称
ContainerID_s	字符串	与记录关联的容器的唯一标识符
ContainerImage_s	字符串	与记录关联的容器映像的名称
Location_s	字符串	与记录关联的资源的位置
消息	string	容器中的消息（如果适用）
OSType_s	字符串	容器所基于的操作系统的名称
RawData	string	空
ResourceGroup	字符串	记录所关联的资源组的名称
Source_s	字符串	日志记录组件“LoggingAgent”的名称
SubscriptionId	字符串	与记录关联的订阅的唯一标识符
TimeGenerated	datetime	由处理与事件对应的请求的 Azure 服务生成事件时的时间戳
类型	字符串	表的名称
_ResourceId	字符串	与记录关联的资源的唯一标识符
_SubscriptionId	字符串	与记录关联的订阅的唯一标识符

ContainerEvent_CL

列	类型​​	说明
Computer	string	空
ContainerGroupInstanceId_g	字符串	与记录关联的容器组的唯一标识符
ContainerGroup_s	字符串	与记录关联的容器组的名称
ContainerName_s	字符串	与记录关联的容器的名称
Count_d	real	自上次轮询后事件发生的次数
FirstTimestamp_t	datetime	第一次发生事件时的时间戳
Location_s	字符串	与记录关联的资源的位置
消息	string	容器中的消息（如果适用）
OSType_s	字符串	容器所基于的操作系统的名称
RawData	string	空
Reason_s	string	容器组的当前状态
ResourceGroup	字符串	记录所关联的资源组的名称
SubscriptionId	字符串	与记录关联的订阅的唯一标识符
TimeGenerated	datetime	由处理与事件对应的请求的 Azure 服务生成事件时的时间戳
类型	字符串	表的名称
_ResourceId	字符串	与记录关联的资源的唯一标识符
_SubscriptionId	字符串	与记录关联的订阅的唯一标识符

使用诊断设置

容器组的诊断设置是一项预览功能，可通过 Azure 门户中的预览功能选项启用。 为订阅启用此功能后，诊断设置可以应用于容器组。 应用诊断设置将导致容器组重启。

例如，下面介绍如何使用 New-AzDiagnosticSetting 命令将诊断设置对象应用于容器组。

$log = @()
$log += New-AzDiagnosticSettingLogSettingsObject -Enabled $true -Category ContainerInstanceLog -RetentionPolicyDay 7 -RetentionPolicyEnabled $true

New-AzDiagnosticSetting -Name test-setting -ResourceId <container-group-resource-id> -WorkspaceId <log-analytics-workspace-id> -Log $log

后续步骤

Azure Monitor 日志

若要详细了解如何在 Azure Monitor 日志中查询日志和配置警报，请参阅：

• 了解 Azure Monitor 日志中的日志搜索
• Azure Monitor 中的统一警报

监视容器 CPU 和内存

若要了解如何监视容器实例 CPU 和内存资源，请参阅：

• 监视 Azure 容器实例中的容器资源。