6.7. Fluentd の設定

手順

1. openshift-logging プロジェクトでクラスターロギングのカスタムリソース (CR) を編集します。

   $ oc edit ClusterLogging instance

   Copy to Clipboard Toggle word wrap

   $ oc edit ClusterLogging instance
   
   apiVersion: "logging.openshift.io/v1"
   kind: "ClusterLogging"
   metadata:
     name: "instance"
   
   ....
   
   spec:
     collection:
       logs:
         fluentd:
           resources:
             limits: 

   1

   
               cpu: 250m
               memory: 1Gi
             requests:
               cpu: 250m
               memory: 1Gi

   Copy to Clipboard Toggle word wrap

   1

   必要に応じて CPU およびメモリー制限を指定します。表示される値はデフォルト値です。

1. fluentd daemonset で LOGGING_FILE_PATH パラメーターを編集します。特定のファイルまたは console を指定できます。

   spec:
     template:
       spec:
         containers:
             env:
               - name: LOGGING_FILE_PATH
                 value: console 

   1

   
   
   LOGGING_FILE_PATH= 

   2

   Copy to Clipboard Toggle word wrap

   1

   ログの出力方法を指定します。

   • console を使用して Fluentd のデフォルトの場所を使用します。oc logs [-f] <pod_name> コマンドでログを取得します。

   • <path-to-log/fluentd.log> を使用してログ出力を指定されたファイルに送信します。`oc exec <pod_name> — logs コマンドでログを取得します。これはデフォルトの設定です。

     または、CLI を使用します。

     oc -n openshift-logging set env daemonset/fluentd LOGGING_FILE_PATH=console

     Copy to Clipboard Toggle word wrap

手順

1. Fluentd を特定プロジェクトを制限するように設定するには、デプロイメント後に Fluentd ConfigMap でスロットル設定を編集します。

   $ oc edit configmap/fluentd

   Copy to Clipboard Toggle word wrap

   throttle-config.yaml キーの形式は、プロジェクト名と、各ノードでのログの読み取りに必要な速度が含まれる YAML ファイルです。デフォルトはノードごとに一度に 1000 行です。例:

1. 必要に応じてフィールドの処理方法を設定します。

   1. CDM_EXTRA_KEEP_FIELDS を使用して移動するフィールドを指定します。
   2. CSV 形式で CDM_KEEP_EMPTY_FIELDS パラメーターで保持する空のフィールドをすべて指定します。

2. 必要に応じて未定義フィールドの処理方法を設定します。

   1. CDM_USE_UNDEFINED を true に設定し、未定義のフィールドを最上位の undefined フィールドに移動します。
   2. CDM_UNDEFINED_NAME パラメーターを使用して、未定義フィールドの名前を指定します。
   3. CDM_UNDEFINED_MAX_NUM_FIELDS をデフォルトの -1 以外の値に設定し、単一レコードにおける未定義フィールド数の上限を設定します。
3. CDM_UNDEFINED_DOT_REPLACE_CHAR を指定して、未定義フィールド名のすべてのドット (.) 文字を別の文字に変更します。たとえば、CDM_UNDEFINED_DOT_REPLACE_CHAR=@@@ の場合で、foo.bar.baz という名前のフィールドがある場合、そのフィールドは foo@@@bar@@@baz に変換されます。
4. UNDEFINED_TO_STRING を true に設定し、未定義フィールドを JSON 文字列表現に変換します。