1.4. ClusterLogForwarder の構造

手順

1. 既存の ClusterLogForwarder 設定を抽出し、ローカルファイルとして保存します。

   $ oc get clusterlogforwarder <name> -n <namespace> -o yaml > <filename>.yaml

   Copy to Clipboard Toggle word wrap

   詳細は、以下のようになります。

   • <name > は、設定する ClusterLogForwarder インスタンスの名前です。
   • <namespace > は、ClusterLogForwarder インスタンスを作成した namespace です（例： openshift-logging ）。
   • <filename& gt; は、設定を保存するローカルファイルの名前です。

2. 不要なログレコードを ClusterLogForwarder CR の filter 仕様 に ドロップする設定を追加します。

   ClusterLogForwarder CR の例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: instance
     namespace: openshift-logging
   spec:
     # ...
     filters:
     - name: drop-filter
       type: drop 

   1

   
       drop: 

   2

   
       - test: 

   3

   
         - field: .kubernetes.labels."app.version-1.2/beta" 

   4

   
           matches: .+ 

   5

   
         - field: .kubernetes.pod_name
           notMatches: "my-pod" 

   6

   
     pipelines:
     - name: my-pipeline 

   7

   
       filterRefs:
       - drop-filter
     # ...

   Copy to Clipboard Toggle word wrap

   1

   フィルターのタイプを指定します。drop フィルターは、フィルター設定に一致するログレコードをドロップします。

   2

   ドロップ フィルターの設定オプションを指定します。

   3

   フィルターがログレコードをドロップするかどうかを評価するための条件を指定します。

   4

   ログレコードのフィールドへのドットで区切られたパスを指定します。

   • 各パスのセグメントには、英数字とアンダースコア、a-z、A-Z、0-9、_ を含めることができます（例： .kubernetes.namespace_name ）。
   • セグメントに異なる文字が含まれる場合、セグメントは引用符で囲む必要があります（例： .kubernetes.labels."app.version-1.2/beta "）。
   • 単一の テスト設定に複数のフィールドパスを含めることができますが、テスト に合格し、ドロップ フィルターを適用するには、すべて true と評価する必要があります。

   5

   正規表現を指定します。ログレコードがこの正規表現と一致する場合は、破棄されます。

   6

   正規表現を指定します。ログレコードがこの正規表現に一致しない場合、破棄されます。

   7

   ドロップ フィルターを使用するパイプラインを指定します。

   注記

   単一の field パスに対して matches または notMatches 条件のいずれかを設定できますが、両方を設定することはできません。

   優先度の高いログレコードのみを保持する設定例

   # ...
   filters:
   - name: important
     type: drop
     drop:
     - test:
       - field: .message
         notMatches: "(?i)critical|error"
       - field: .level
         matches: "info|warning"
   # ...

   Copy to Clipboard Toggle word wrap

   複数のテストを使用した設定例

   # ...
   filters:
   - name: important
     type: drop
     drop:
     - test: 

   1

   
       - field: .kubernetes.namespace_name
         matches: "openshift.*"
     - test: 

   2

   
       - field: .log_type
         matches: "application"
       - field: .kubernetes.pod_name
         notMatches: "my-pod"
   # ...

   Copy to Clipboard Toggle word wrap

   1

   フィルターは、openshift で始まる namespace を含むログを破棄します。

   2

   フィルターは、Pod 名に my-pod を持たないアプリケーションログを破棄します。

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

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

手順

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
   # ...

   Copy to Clipboard Toggle word wrap

   1

   照合するラベルキーを指定します。

   2

   Operator を指定します。有効な値には、In、NotIn、Exists、DoesNotExist などがあります。

   3

   文字列値の配列を指定します。Operator 値が Exists または DoesNotExist のいずれかの場合、値の配列は空である必要があります。

   4

   正確なキーまたは値のマッピングを指定します。

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

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

手順

1. 既存の ClusterLogForwarder 設定を抽出し、ローカルファイルとして保存します。

   $ oc get clusterlogforwarder <name> -n <namespace> -o yaml > <filename>.yaml

   Copy to Clipboard Toggle word wrap

   詳細は、以下のようになります。

   • <name > は、設定する ClusterLogForwarder インスタンスの名前です。
   • <namespace > は、ClusterLogForwarder インスタンスを作成した namespace です（例： openshift-logging ）。
   • <filename& gt; は、設定を保存するローカルファイルの名前です。

2. ログレコードを ClusterLogForwarder CR の filters 仕様にプルーニングする設定を追加します。

   重要

   in および notIn パラメーターの両方を指定すると、プルーニング時に notIn 配列が優先されます。notIn 配列を使用してレコードがプルーニングされると、それらは in 配列を使用してプルーニングされます。

   ClusterLogForwarder CR の例

   apiVersion: observability.openshift.io/v1
   kind: ClusterLogForwarder
   metadata:
     name: instance
     namespace: openshift-logging
   spec:
     serviceAccount:
       name: my-account
     filters:
     - name: prune-filter
       type: prune 

   1

   
       prune: 

   2

   
         in: [.kubernetes.annotations, .kubernetes.namespace_id] 

   3

   
         notIn: [.kubernetes,.log_type,.message,."@timestamp",.log_source] 

   4

   
     pipelines:
     - name: my-pipeline 

   5

   
       filterRefs: ["prune-filter"]
     # ...

   Copy to Clipboard Toggle word wrap

   1

   フィルターのタイプを指定します。prune フィルターでは、設定されたフィールドでログレコードをプルーニングします。

   2

   プルーニング フィルターの設定オプションを指定します。

   • in フィールドおよび notIn フィールドは、ログレコードのフィールドへのドットで区切られたパスの配列です。
   • 各パスのセグメントには、英数字とアンダースコア、a-z、A-Z、0-9、_ を含めることができます（例： .kubernetes.namespace_name ）。
   • セグメントに異なる文字が含まれる場合、セグメントは引用符で囲む必要があります（例： .kubernetes.labels."app.version-1.2/beta "）。

   3

   オプション：ログレコードから削除するフィールドを指定します。ログコレクターは他のすべてのフィールドを保持します。

   4

   オプション：ログレコードに保持するフィールドを指定します。ログコレクターは、他のすべてのフィールドを削除します。

   5

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

   重要

   • フィルターはログレコードから .log_type、.log_source、.message フィールドを削除できません。これらは notIn フィールドに含める必要があります。
   • googleCloudLogging 出力を使用する場合は、notIn フィールドに .hostname を含める必要があります。

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

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap