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 仕様に追加します。

   以下の例は、正規表現に基づいてログレコードを削除するように 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")。1 つの test 設定に複数のフィールドパスを含めることができますが、テストに合格して drop フィルターを適用するには、すべてのフィールドパスが true と評価される必要があります。

   5

   正規表現を指定します。ログレコードがこの正規表現と一致する場合は、破棄されます。単一の field パスに対して matches または notMatches 条件のいずれかを設定できますが、両方を設定することはできません。

   6

   正規表現を指定します。ログレコードがこの正規表現に一致しない場合、破棄されます。単一の field パスに対して matches または notMatches 条件のいずれかを設定できますが、両方を設定することはできません。

   7

   drop フィルターが適用されるパイプラインを指定します。

2. 次のコマンドを実行して、ClusterLogForwarder CR を適用します。

   $ oc apply -f <filename>.yaml

手順

1. ClusterLogForwarder CR の input 仕様にフィルターの設定を追加します。

   以下の例は、ラベル式または一致したラベルキー/値に基づいてログを組み込むように 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 仕様に追加します。

   次の例は、フィールドパスに基づいてログレコードを削除するように 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