2.4. 配置日志转发

流程

1. 为收集器创建服务帐户。如果要将日志写入需要令牌进行身份验证的存储，则必须在服务帐户中包含令牌。

2. 将适当的集群角色绑定到服务帐户：

   绑定命令示例

   $ oc adm policy add-cluster-role-to-user <cluster_role_name> system:serviceaccount:<namespace_name>:<service_account_name>

流程

1. 将过滤器的配置添加到 ClusterLogForwarder CR 中的 filters spec 中。

   以下示例演示了如何配置 ClusterLogForwarder CR，以根据正则表达式丢弃日志记录：

   ClusterLogForwarder CR 示例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
   # ...
   spec:
     serviceAccount:
       name: <service_account_name>
     filters:
     - name: <filter_name>
       type: drop 1
       drop: 2
       - test: 3
         - field: .kubernetes.labels."foo-bar/baz" 4
           matches: .+ 5
         - field: .kubernetes.pod_name
           notMatches: "my-pod" 6
     pipelines:
     - name: <pipeline_name> 7
       filterRefs: ["<filter_name>"]
   # ...

   1

   指定过滤器的类型。drop 过滤器丢弃与过滤器配置匹配的日志记录。

   2

   指定应用 drop 过滤器的配置选项。

   3

   指定用于评估是否丢弃日志记录的测试配置。

   • 如果为测试指定的所有条件都为 true，则测试会通过，记录将被丢弃。
   • 当为 drop 过滤器配置指定多个测试时，如果有任何测试通过，则会丢弃记录。
   • 如果评估条件时出错，例如，被评估的日志记录中缺少该字段，则条件评估为 false。

   4

   指定点分隔的字段路径，它是日志记录中字段的路径。该路径可以包含字母数字字符和下划线 (a-zA-Z0-9_)，例如 .kubernetes.namespace_name。如果网段包含此范围之外的字符，段必须放在引号内，例如，.kubernetes.labels."foo.bar-bar/baz"。您可以在单个 test 配置中包含多个字段路径，但它们都必须评估为 true 才能通过测试以及要应用的 drop 过滤器。

   5

   指定正则表达式。如果日志记录与此正则表达式匹配，它们将被丢弃。您可以为单个 field 路径设置 matches 或 notMatches 条件，但不能同时设置这两个条件。

   6

   指定正则表达式。如果日志记录与此正则表达式不匹配，它们将被丢弃。您可以为单个 field 路径设置 matches 或 notMatches 条件，但不能同时设置这两个条件。

   7

   指定 drop 过滤器应用到的管道。

2. 运行以下命令来应用 ClusterLogForwarder CR：

   $ oc apply -f <filename>.yaml

流程

1. 将过滤器的配置添加到 ClusterLogForwarder CR 中的 input spec 中。

   以下示例演示了如何配置 ClusterLogForwarder CR，使其包含基于标签表达式或匹配的标签键/值的日志：

   ClusterLogForwarder CR 示例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   # ...
   spec:
     serviceAccount:
       name: <service_account_name>
     inputs:
       - name: mylogs
         application:
           selector:
             matchExpressions:
             - key: env 1
               operator: In 2
               values: ["prod", "qa"] 3
             - key: zone
               operator: NotIn
               values: ["east", "west"]
             matchLabels: 4
               app: one
               name: app1
         type: application
   # ...

   1

   指定要匹配的标签键。

   2

   指定 operator。有效值包括： In,NotIn,Exists, 和 DoesNotExist。

   3

   指定字符串值的数组。如果 operator 值为 Exists 或 DoesNotExist，则值数组必须为空。

   4

   指定准确的键或值映射。

2. 运行以下命令来应用 ClusterLogForwarder CR：

   $ oc apply -f <filename>.yaml

流程

1. 将过滤器的配置添加到 ClusterLogForwarder CR 中的 prune spec 中。

   以下示例演示了如何配置 ClusterLogForwarder CR，以根据字段路径修剪日志记录：

   重要

   如果指定了这两个信息，则首先根据 notIn 数组修剪记录，这优先于 in 数组。在使用 notIn 数组修剪记录后，会使用 in 数组来修剪这些记录。

   ClusterLogForwarder CR 示例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
   # ...
   spec:
     serviceAccount:
       name: <service_account_name>
     filters:
     - name: <filter_name>
       type: prune 1
       prune: 2
         in: [.kubernetes.annotations, .kubernetes.namespace_id] 3
         notIn: [.kubernetes,.log_type,.message,."@timestamp"] 4
     pipelines:
     - name: <pipeline_name> 5
       filterRefs: ["<filter_name>"]
   # ...

   1

   指定过滤器的类型。prune 过滤器根据配置的字段修剪日志记录。

   2

   指定应用 prune 过滤器的配置选项。in 和 notIn 字段被指定为点分隔字段路径的数组，它们是日志记录中字段的路径。这些路径可以包含字母数字字符和下划线 (a-zA-Z0-9_)，例如 .kubernetes.namespace_name。如果网段包含此范围之外的字符，段必须放在引号内，例如，.kubernetes.labels."foo.bar-bar/baz"。

   3

   可选：此阵列中指定的任何字段都会从日志记录中删除。

   4

   可选：没有在此阵列中指定的任何字段都会从日志记录中删除。

   5

   指定 prune 过滤器应用到的管道。

   注意

   过滤器显示 log_type、.log_source 和 .message 字段。

2. 运行以下命令来应用 ClusterLogForwarder CR：

   $ oc apply -f <filename>.yaml