Promtail
로컬 시스템 또는 클러스터 리소스에 저장된 로그를 실시간으로 조회하여 가공 후 Loki로 전송하는 컴포넌트입니다.
Promtail은 로그 파일이 존재하는 서버(각 노드)에 설치되어 로그 파일을 관리하는 서버(Loki 등)로 로그를 전송하는 Agent입니다. 일반적으로 모니터링이 필요한 애플리케이션이 있는 서버에 설치되어야 하기에 쿠버네티스 클러스터의 경우 DaemonSet 형태로 배포됩니다.
일반적인 동작은 다음과 같습니다.
- 전송해야 할 데이터 대상을 정합니다.
- 로그 스트림을 생성하고 해당 스트림에 레이블을 추가합니다.
- Loki 등의 로그 관리 서버로 보냅니다.
압축 파일 또한 수집할 수 있으며 다른 Promtail 또는 Loki 클라이언트로부터 로그를 수집할 수도 있습니다.
보통 PLG (Promtail, Loki, Grafana) 스택이라고 불리는 구성으로 구축하며 ELK에 비해 가볍게 구축할 수 있습니다.
Turaco에서는 몇가지의 간단한 설정만으로 클러스터내에 Promtail을 배포할 수 있습니다.
본 챕터에서는 Promtail 컴포넌트의 사용법에 대해 설명합니다.
--
컴포넌트 배치
Promtail 컴포넌트는 아키텍처 설계 화면 (이하 디자이너 화면)에서 좌측에 위치한 컴포넌트 목록에서 '수집 및 분석' 카테고리에 있습니다.
- 설계화면 왼쪽 컴포넌트 리스트 화면에서 Promtail 컴포넌트를 선택 후 디자이너 화면으로 드래그 & 드롭합니다.
- 배치된 Promtail 컴포넌트에 대한 이름과 설명을 입력 후 확인 버튼을 클릭합니다.
이름과 설명은 필수 입력값이며 입력하지 않으면 확인 버튼이 활성화되지 않습니다.
포트 설정
원하는 포트 번호를 입력할 수 있으며
설정된 포트는 쿠버네티스의 서비스로 외부에 노출됩니다.
환경 설정
Promtail 환경 설정은 아래와 같이 두 부분만 설정합니다.
- 로그 레벨
- 실행 환경
로그레벨 설정
로그 레벨은 아래와 같이 4개 항목을 선택할 수 있으며 기본값은 'info'로 설정되어 있습니다.
- debug
- info
- warn
- error
로그 레벨 설정을 위해 아래와 같이 설정합니다.
- 드롭 다운 버튼을 클릭합니다.
- 표시된 내용에서 원하는 로그 레벨을 선택합니다.
실행 환경
-
환경 설정을 위한 아이콘을 클릭합니다.
-
드롭다운 아이콘을 클릭합니다.
-
드롭다운 메뉴에서 Configuration를 항목을 선택합니다.
선택 시, Configuration 설정 내용이 팝업창에 표시됩니다. -
적용 버튼을 클릭합니다.
-
Configuration에서 선택한 내용이 환경 설정 입력창에 반영됩니다.
Promtail에 대한 자세한 설정은 여기를 참고하세요.