APM 설치

본 기능은 엔터프라이즈 전용 기능입니다.

💻 Platform : 💡 Supported Version :

환경 구성

---

Cocktail APM을 사용하기 위해서는 컴포넌트 별도 설치가 필요합니다. 자세한 내용은 서비스기술팀에 문의하세요.

권장 사양

---

초기 운영을 위한 기초 사용량을 가이드 합니다. 실제 운영하면서 발생하는 데이터의 양과 조회되는 데이터 유형에 따라서 조정하는 것을 권장합니다.

Type	CPU (Request/Limt)	Memory (Request/Limit)
ClickHouse	7 Core / 14 Core	14 Gi / 28 Gi
VictoriMetrics	8 Core / 8 Core	4 Gi / 7 Gi
Cocktail (APM workload)	100m / 500m	1Gi / 2Gi

Collector 설치

---

메트릭, 트레이스, 로그 수집을 위한 Collector를 설치 합니다. 클러스터 마다 애드온으로 설치 되어 데이터에 맞는 저장소로 전달 합니다.

애드온 배포

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

애드온 배포 목록

기본 설정 (Basic Settings)

cocktail-telemetry-collector's "Basic Settins"

Log Feature

로그 수집 기능 활성화 여부를 결정합니다. 비활성화 하면 로그 수집 기능이 비활성화 됩니다. 이 기능을 이용하기 위해서는 칵테일 로그 서비스가 설치 되어 있어야 합니다.

Enable Container log Collecting

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

Enable Audit log Collecting

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

Metric Feature

메트릭 수집 기능을 활성화 합니다. Metric Backend(VictoriaMetrics)가 설치 되어 있어야 합니다. 자세한 내용은 환경 구성을 확인하세요.

Metric Endpoint

메트릭 저장소의 주소를 입력하세요. 설치 방식에 따라 URL이 달라 질 수 있습니다. 일반적으로 노드 포트를 이용하고, 다음과 같은 형식으로 입력 합니다.

http://{NODE_IP}:{메트릭 저장소 서비스의 NODE PORT}

Metric Backend Bearer Token

메트릭 저장소에 발급된 인증 토큰을 입력합니다. 서비스 기술팀에 문의하여 발급 받으시면 됩니다.

Enable Trace

트레이스 (추적) 수집 기능을 활성화 합니다. Trace Backend(ClickHouse)가 설치 되어 있어야 합니다. 자세한 내용은 환경 구성을 확인하세요.

Trace Endpoint

트레이스 저장소의 주소를 입력하세요. 설치 방식에 따라 주소가 달라질 수 있습니다. 일반적으로 노드포트를 이용하고 다음과 같은 형식으로 입력합니다. (http 없이 입력하여야 합니다.)

{NODE IP}:{트레이스 저장소 서비스의 NODE PORT:30318}

상세 설정 (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 이름의 볼륨에 기록되어 있습니다.

감사로그 저장 위치

Trace Backend 인증 정보 변경

설치 하면서 Trace Backend(ClickHouse)의 사용자 정보를 변경하였다면 상세 설정에서 정보를 변경해 주어야 합니다.

# Trace Backend 설정
trace:
  username: "new-user"
  password: "new-password"