ログを含めるか除外するかの設定

設定されたパスまたはファイル名に基づいて、ログを収集に含めるか除外するかを指定できます。

パスを含む

インクルード・パスを指定するには、以下の手順を実行する:

  1. クラスターにログインします。 詳細については 、「クラスタへのアクセス」 を参照してください。

  2. ロギング・エージェント コンフィグマップで、 input-kubernetes.conf。 次に、 Path パラメータを更新して、収集したいログソースを指定する。

    デフォルトでは、 ロギング・エージェントは、 /var/log/containers/ にある単一のソースからログを収集する。 Path パラメータに、必要なログソースパスを追加してください。 指定するパスは、それぞれコンマで区切ります。

    input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/*.log,/path/to/your/logs/*.log
        Path_Key          file
    

    追加のログソースを指定し、 Path パラメータでカンマで区切ることができる。

    デフォルトでは、 IBM Cloud Logs ロギング・エージェント は /var/log/containers/*.log ディレクトリからのログのみを収集します。 /var/log の下にあるすべてのサブディレクトリからログを収集したい場合は、 /var/log/**/*.logPath パラメータに追加する必要があります。

  3. エージェントポッドを再起動します。

    Kubernetes クラスタの場合は、実行する:

    kubectl -n ibm-observe rollout restart ds/logs-agent
    

    OpenShift クラスタの場合は、実行する:

    oc -n ibm-observe rollout restart ds/logs-agent
    

パスを除く

除外するパスを指定するには、以下の手順を実行する:

  1. クラスターにログインします。 詳細については 、「クラスタへのアクセス」 を参照してください。

  2. ロギング・エージェント コンフィグマップで、 input-kubernetes.conf。 次に、 Exclude_Path パラメータを更新して、収集から除外したいログソースを指定します。 このパラメータでは、 ロギング・エージェントが無視するパスを指定することができます。

    Exclude_Path パラメータはデフォルトでは存在しないかもしれないので、存在しない場合は追加する必要があるかもしれません。 このパラメータでは、 ロギング・エージェントが無視するパスを指定することができます。

    input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
        Path_Key          file
        Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log
    

    追加のログソースを指定し、 Exclude_Path パラメータでカンマで区切ることができる。

  3. エージェントポッドを再起動します。

    Kubernetes クラスタの場合は、実行する:

    kubectl -n ibm-observe rollout restart ds/logs-agent
    

    OpenShift クラスタの場合は、実行する:

    oc -n ibm-observe rollout restart ds/logs-agent
    

サンプルの

Exclude_Path を指定した次の例を考えてみよう:

例えば、あなたのディレクトリ構造が

/path/to/your/logs
                ├── app1.log
                ├── app2.log
                ├── exclude-1.log
                └── exclude-2.log

input-kubernetes.conf セクションは次のように修正できる:

input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
        Path_Key          file
        Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log

この例では、次のようになっています。

  • Path パラメータは、含めるパスを2つ指定します:

    • /var/log/containers/logger-agent-ds-*.log
    • /path/to/your/logs/*.log
  • Exclude_Path パラメータは、除外する追加のパスを2つ指定するために使われます:

    • /path/to/your/logs/exclude-1.log
    • /path/to/your/logs/exclude-2.log

Path パラメータで指定されたパターンにマッチするディレクトリ内のファイルは、Exclude_Path で指定されたパターンにマッチするものを除いて、ロギング・エージェントによって収集されます。