【推荐】使用AliyunPipelineConfig管理采集配置

创建iLogtail采集配置

您需要创建AliyunPipelineConfig的CR，alibaba-log-controller会根据CR自动创建iLogtail采集配置。创建完成后，系统自动应用该iLogtail采集配置。

创建步骤：

1. 获取集群KubeConfig并通过kubectl工具连接集群。

2. 执行如下命令创建cube.yaml文件，请根据实际情况替换文件名。

vim cube.yaml

3. 在YAML文件中输入如下脚本，并根据实际情况设置其中的参数。CR结构的详细参数请参见CR参数说明。

apiVersion: telemetry.alibabacloud.com/v1alpha1 # 使用默认值，无需修改。
kind: ClusterAliyunPipelineConfig               # 使用默认值，无需修改。
metadata:
  name: test-config                             # 设置资源名，在当前Kubernetes集群内唯一。
spec:
  project:                                      # 设置目标Project名称。
    name: k8s-your-project                      
  config:                                       # 设置iLogtail采集配置。
    inputs:                                     # 设置iLogtail采集配置里的输入插件
      ...
    flushers:                                   # 设置iLogtail采集配置里的输出插件
      ...

4. 执行如下命令创建AliyunPipelineConfig的CR，alibaba-log-controller会根据该CR自动创建iLogtail采集配置，从而使iLogtail采集配置生效。iLogtail采集配置生效后，Logtail开始采集数据，并发送到日志服务中。cube.yaml为文件名，请根据实际情况替换。

kubectl apply -f cube.yaml

查看iLogtail采集配置

• 查看当前Kubernetes集群中所有由AliyunPipelineConfig创建的iLogtail采集配置。

  您可以执行以下命令，查看所有由AliyunPipelineConfig创建的iLogtail采集配置。

  kubectl get clusteraliyunpipelineconfigs

• 查看由AliyunPipelineConfig创建的iLogtail采集配置的详细信息和状态。

  您可以执行以下命令进行查看。其中，<config_name>为AliyunPipelineConfig的名称，请根据实际情况替换。

  kubectl get clusteraliyunpipelineconfigs <config_name> -o yaml

  返回结果参考如下所示，可以根据status查看iLogtail采集配置的应用情况。

  apiVersion: telemetry.alibabacloud.com/v1alpha1
  kind: ClusterAliyunPipelineConfig
  metadata:
    creationTimestamp: null
    finalizers:
      - finalizer.pipeline.alibabacloud.com
    name: example-config
  # 预期的配置
  spec:
    config:
      flushers:
        - Endpoint: cn-hangzhou-intranet.log.aliyuncs.com
          Logstore: example-config-logstore
          Region: cn-hangzhou
          TelemetryType: logs
          Type: flusher_sls
      inputs:
        - FilePaths:
            - /var/log/*.log
          Type: input_file
      processors:
        - SourceKey: content
          Type: processor_parse_json_native
    logstores:
      - name: example-config-logstore
    project:
      name: k8s-log-clusterid
  # 应用状态
  status:
    # CR 是否应用成功
    success: true
    # CR 当前的状态信息
    message: success
    # 当前 status 的更新时间
    lastUpdateTime: "2024-06-13T12:02:19.133422+08:00"
    # 上次成功应用的配置信息，该配置信息为填充默认值后实际生效的配置
    lastAppliedConfig:
      # 上次成功应用的时间
      appliedTime: "2024-06-13T12:02:19.133422+08:00"
      # 上次成功应用的配置详情
      config:
        configTags:
          sls.crd.cluster: clusterid
          sls.crd.kind: ClusterAliyunPipelineConfig
          sls.logtail.channel: CRD
        flushers:
          - Endpoint: cn-hangzhou-intranet.log.aliyuncs.com
            Logstore: example-config-logstore
            Region: cn-hangzhou
            TelemetryType: logs
            Type: flusher_sls
        global: null
        inputs:
          - FilePaths:
              - /var/log/*.log
            Type: input_file
        name: example-config
        processors:
          - SourceKey: content
            Type: processor_parse_json_native
      logstores:
        - appendMeta: true
          autoSplit: true
          encryptConf: {}
          maxSplitShard: 64
          name: example-config-logstore
          shardCount: 2
          ttl: 30
      machineGroups:
        - name: k8s-group-clusterid
      project:
        description: k8s log project, created by alibaba cloud log controller
        endpoint: cn-hangzhou.log.aliyuncs.com
        name: k8s-log-clusterid

更新iLogtail采集配置

您只需要修改已有的AliyunPipelineConfig的YAML文件并重新应用，就可以更新iLogtail采集配置。

1. 获取集群KubeConfig并通过kubectl工具连接集群。

2. 编辑已有的AliyunPipelineConfig文件。cube.yaml为文件名，请根据实际情况替换。

vim cube.yaml

3. 在YAML文件中修改配置参数。

4. 执行如下命令使iLogtail采集配置生效。cube.yaml为文件名，请根据实际情况替换。

kubectl apply -f cube.yaml

删除iLogtail采集配置

如果您要删除iLogtail采集配置，只需删除对应的CR即可。其中，<config_name>为AliyunPipelineConfig的名称，请根据实际情况替换。

kubectl delete clusteraliyunpipelineconfigs <config_name>