采集多集群 Agent Sandbox 控制面日志

更新时间:
复制 MD 格式

通过创建 AliyunLogConfig 采集配置(CR),可将 E2B SDK 链路下多集群 Agent Sandbox 控制面组件的日志采集到日志服务 SLS(Simple Log Service)。采集到的日志存储于日志库(Logstore),便于查询和排查问题。

计费说明

日志服务 SLS 开启后按量付费。更多信息,请参见按使用功能计费。

开启日志采集

该采集配置仅适用于 E2B SDK 链路下的多集群 Agent Sandbox,具体采集范围如下:

  • 组件范围:sandbox-system 和 envoy-gateway-system 命名空间下的控制面组件。

  • 日志类型:容器标准输出(stdout/stderr)日志。

以下 YAML 中的 project 字段用于指定存储日志的日志项目(Project),支持以下两种方式:

  • 不设置 project 字段(默认):日志控制器自动创建名为 k8s-log-<clusterid>(<clusterid> 为集群 ID)的日志项目,并在该项目下创建 Logstore,其名称由 logstore 字段指定(示例为 ackone-sandbox-logstore)。下文查询日志和删除 Logstore 的操作均以该示例名称为例;若自定义 logstore 字段,请使用该字段指定的实际 Logstore 名称。该 Logstore 用于存储多集群 Agent Sandbox 控制面的日志。

  • 设置 project 字段(自定义):日志控制器自动创建以该字段取值命名的日志项目。

创建 AliyunLogConfig CR:

cat << EOF | kubectl apply -f -
apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: ackone-sandbox-sls-config
  namespace: sandbox-system
spec:
  # 可使用以下字段指定日志项目。
  # project: ackone-sandbox
  # 日志保留 5 天,可根据需求配置。
  lifeCycle: 5
  logstore: ackone-sandbox-logstore
  logtailConfig:
    inputType: plugin
    configName: ackone-sandbox-sls-config
    inputDetail:
      plugin:
        inputs:
        - detail:
            Stderr: true
            Stdout: true
            K8sNamespaceRegex: ^(envoy-gateway-system|sandbox-system)$
          type: service_docker_stdout
EOF

YAML 中的主要字段说明如下:

字段

说明

project

可选。指定存储日志的日志项目。不设置时,日志控制器自动创建名为 k8s-log-<clusterid> 的日志项目。

lifeCycle

日志保留天数。示例取值 5,可根据需求调整。

logstore

Logstore 名称。示例为 ackone-sandbox-logstore。

configName

Logtail 采集配置名称。示例为 ackone-sandbox-sls-config。

K8sNamespaceRegex

限定采集命名空间范围的正则表达式。示例匹配 sandbox-system 和 envoy-gateway-system 两个命名空间。

Stdout / Stderr

是否采集容器标准输出(stdout/stderr)日志。示例均为 true。

命令执行后,登录日志服务控制台,进入对应日志项目下名为 ackone-sandbox-logstore 的 Logstore,即可查询采集到的控制面日志。

关闭日志采集

不再需要采集控制面日志时,按以下步骤关闭日志采集。

警告

删除 Logstore 后,其中已采集的日志不可恢复。删除前,确认日志无需继续留存。

  1. 删除 AliyunLogConfig CR。

    kubectl delete aliyunlogconfigs.log.alibabacloud.com ackone-sandbox-sls-config -n sandbox-system
  2. 登录日志服务控制台,删除名为 ackone-sandbox-logstore 的 Logstore。未自定义 project 字段时,该 Logstore 位于名为 k8s-log-<clusterid> 的日志项目中。