로그 에이전트 설치

로그 수집을 위해 에이전트를 설치합니다. 로그 에이전트는 클러스터 마다 설치 되어 컨테이너로그, 감사로그, 애플리케이션 로그를 수집하고 중앙 로그 서비스로 전달 합니다.

0. 사전 조건

---

칵테일 환경 변수 선언

칵테일 환경변수로 Cocktail Gateway URL이 선언 되어 있어야 합니다. 선언 되어 있지 않다면 log-agent 파드가 초기화 과정에서 실패 합니다. 칵테일 관리자에게 등록을 요청하여야 합니다.

1. 애드온 배포

---

클러스터 선택

애드온 배포

설치 하려는 클러스터의 애드온(인프라 - 클러스터 - 애드온) 화면으로 이동합니다. 배포 버튼을 클릭하여 목록으로 이동한 다음 cocktail-telemetry-collector 애드온을 선택합니다.

애드온 배포 목록

기본 설정 (Basic Settings)

칵테일 에이전트는 3가지 설치 옵션을 제공합니다.

Enable Container log Collecting

컨테이너 로그 수집 여부를 결정합니다. 컨테이너 로그를 수집하는 경우, 상세 설정에서 수집하려는 네임스페이스를 명시해 주어야 합니다. 자세한 내용은 상세 설정을 확인 하세요.

Enable Audit log Collecting

감사 로그 수집 여부를 결정합니다. 마스터 노드가 존재하지 않는 퍼블릭 클라우드에서는 미사용을 선택합니다. 쿠버네티스 환경에 따라 감사로그의 저장 위치가 다르기 때문에 상세 설정에서 마운트할 Path를 설정해 주어야 합니다. 자세한 내용은 상세 설정을 확인 하세요.

Single Cluster Mode

기본적으로 로그 서비스는 멀티 클러스터 환경에서 로그를 중앙 수집 하는 컨셉으로 제공되고 있습니다. 따라서 모든 수집 및 조회 서비스는 외부 연결 기능이 구현되어 있습니다. 하지만 하나의 클러스터에 로그 서비스와 로그 에이전트를 설치 할 수도 있습니다. 하나의 클러스터에 로그 서비스를 사용하는 경우 Single Cluster Mode를 Single로 설정하면, 내부 통신을 이용하여 로그를 수집 하게 됩니다.

로그 에이전트 기본 설정

상세 설정 (Advanced Settings)

컨테이너 로그 수집 네임스페이스 선언

모든 네임스페이스를 제외 처리 하고 있습니다. 수집하고자 하는 네임스페이스를 목록으로 선언 합니다.

# 수집 처리 네임스페이스 목록
# - 기본 설정은 모든 네임스페이스를 제외 처리 합니다.
includeNamespace:
  - tenant-root
  - my-namespace

감사 로그 저장 위치 선언

extraVolumes[0].hostPath.path 값을 감사로그 저장 위치로 선언합니다.

# Cluster Audit Log Mount
extraVolumes:
  - name: audit
    hostPath:
      path: /data/k8s-audit

감사로그 저장 위치는 보통 kube-system 네임스페이스 내 kube-apiserver 파드의 상세 설정에서 확인 할 수 있습니다. spec.volumes 내 k8s-audit 이름의 볼륨에 기록되어 있습니다.

감사로그 저장 위치

Troubleshooting

---

log-agent 파드의 초기화 실패 메시지 (Init: Signal: null)

설치된 애드온 인스턴스의 상태가 Init:Signal:null 인 경우, 칵테일 환경 변수 선언이 정상적이지 않아 실패하는 경우입니다. 파드의 초기화 컨테이너 로그와 함께 칵테일 관리자에게 환경 변수 설정을 요청 합니다.

# 파드의 초기화 컨테이너(config-pull)의 로그를 출력 합니다. 
kubectl -n cocktail-addon logs [POD FULL NAME] -c config-pull