grafana/loki

어떤 프로젝트인가요?

핵심 기능

• 01로그 전체 텍스트 대신 로그 스트림별 레이블 집합만 인덱싱합니다.
• 02Prometheus와 동일한 레이블 모델을 사용해 메트릭과 로그 간에 쉽게 전환할 수 있습니다.
• 03의존성 없이 단일 바이너리로 실행하거나, 수평 확장 가능한 마이크로서비스로 실행할 수 있습니다.
• 04테넌트별 런타임 재정의를 지원하는 멀티 테넌트 배포를 지원합니다.
• 05쿼리용 LogCLI와 로그 누락 감지용 Loki Canary를 포함합니다.
• 06컨테이너 로그를 Loki로 직접 전송하는 Docker 플러그인을 제공합니다.

활용 사례

• Pod 메타데이터의 레이블을 활용해 Kubernetes Pod 로그를 수집하고 조회하기.
• Grafana 대시보드와 연동하는 비용 효율적인 중앙 집중식 로깅 스택 구축하기.
• 공유 레이블을 사용해 애플리케이션 로그와 Prometheus 메트릭 연관 짓기.
• 팀마다 로그를 분리해 관리하는 멀티 테넌트 로그 플랫폼 운영하기.

빠른 시작

1. 1

   소스 코드 저장소를 클론합니다

   git clone https://github.com/grafana/loki
2. 2

   프로젝트 디렉터리로 이동합니다

   cd loki
3. 3

   Go로 Loki 바이너리를 빌드합니다

   go build ./cmd/loki
4. 4

   로컬 설정 파일로 Loki를 실행합니다

   ./loki -config.file=./cmd/loki/loki-local-config.yaml

사용 전 알아둘 점

• !소스에서 빌드하려면 최신 Go 툴체인이 필요합니다.
• !GEL 사용자가 아닌 경우를 위한 Helm chart 유지 관리는 별도 저장소로 이전 중입니다.

토픽

자주 묻는 질문

loki은(는) 무엇인가요?

Grafana Labs가 만든 수평 확장형 멀티 테넌트 로그 집계 시스템으로, 로그 내용이 아닌 레이블만 인덱싱합니다. Loki는 Prometheus에서 영감을 받은 로그 집계 시스템입니다. 모든 로그 라인을 전문 검색용으로 인덱싱하는 대신, 압축된 비정형 로그를 저장하고 각 로그 스트림에 대해 레이블 집합만 인덱싱합니다. 덕분에 스토리지 및 운영 비용을 낮추고, Prometheus 메트릭에 사용하는 것과 같은 레이블 모델로 로그를 조회할 수 있습니다.

loki은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

loki은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

loki은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. loki의 마지막 커밋은 2026년 10월 21일입니다.

loki은(는) 어디에 사용할 수 있나요?

Pod 메타데이터의 레이블을 활용해 Kubernetes Pod 로그를 수집하고 조회하기. Grafana 대시보드와 연동하는 비용 효율적인 중앙 집중식 로깅 스택 구축하기. 공유 레이블을 사용해 애플리케이션 로그와 Prometheus 메트릭 연관 짓기. 팀마다 로그를 분리해 관리하는 멀티 테넌트 로그 플랫폼 운영하기.

loki는 어떻게 설치하나요?

소스 코드 저장소를 클론합니다: git clone https://github.com/grafana/loki 프로젝트 디렉터리로 이동합니다: cd loki Go로 Loki 바이너리를 빌드합니다: go build ./cmd/loki 로컬 설정 파일로 Loki를 실행합니다: ./loki -config.file=./cmd/loki/loki-local-config.yaml

loki은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/grafana/loki