로그 포함 또는 제외 여부 구성하기

구성된 경로 또는 파일 이름에 따라 로그를 수집에 포함할지 아니면 제외할지 지정할 수 있습니다.

경로 포함

포함된 경로를 지정하려면 다음 단계를 완료합니다:

  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 의 모든 하위 디렉토리에서 로그를 수집하려면 Path 매개변수에 /var/log/**/*.log 를 추가해야 합니다.

  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 매개변수는 포함할 두 개의 경로를 지정합니다:

    • /var/log/containers/logger-agent-ds-*.log
    • /path/to/your/logs/*.log
  • Exclude_Path 매개변수는 제외할 두 개의 추가 경로를 지정하는 데 사용됩니다:

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

Path 매개변수에 지정된 패턴과 일치하는 디렉터리 내의 모든 파일은 로깅 에이전트에 의해 수집되지만, Exclude_Path 에 지정된 패턴과 일치하는 파일은 제외됩니다.