Loki 로고

Loki: Prometheus처럼, 그러나 로그를 위한 것.

Loki는 Prometheus에서 영감을 받은 수평 확장 가능, 고가용성, 멀티 테넌트 로그 집계 시스템입니다. 비용 효율이 매우 높고 운영이 쉬운 것이 특징입니다. 로그 내용을 인덱싱하지 않고, 각 로그 스트림에 대한 레이블 집합만 인덱싱합니다.

다른 로그 집계 시스템과 비교하여 Loki는 다음과 같습니다:

로그에 대한 전체 텍스트 인덱싱을 수행하지 않습니다. 압축된 비정형 로그를 저장하고 메타데이터만 인덱싱하므로 Loki는 운영이 더 간단하고 실행 비용이 더 저렴합니다.
Prometheus에서 이미 사용하고 있는 동일한 레이블을 사용하여 로그 스트림을 인덱싱하고 그룹화하므로, 이미 사용 중인 동일한 레이블로 메트릭과 로그 사이를 원활하게 전환할 수 있습니다.
Kubernetes Pod 로그를 저장하는 데 특히 적합합니다. Pod 레이블과 같은 메타데이터는 자동으로 수집되어 인덱싱됩니다.
Grafana에서 기본 지원됩니다 (Grafana v6.0 필요).

Loki 기반 로깅 스택은 3가지 구성 요소로 이루어져 있습니다:

Alloy는 에이전트로, 로그를 수집하여 Loki로 보내는 역할을 담당합니다.
Loki는 메인 서비스로, 로그 저장과 쿼리 처리를 담당합니다.
Grafana는 로그 쿼리 및 표시를 담당합니다.

스택에서 Alloy가 Promtail을 대체했습니다. Promtail은 기능이 완성된 것으로 간주되며, 로그 수집에 대한 향후 개발은 Grafana Alloy에서 진행될 예정입니다.

Loki는 Prometheus와 유사하지만 로그를 위한 것입니다: 우리는 다차원 레이블 기반 인덱싱 방식을 선호하며, 단일 바이너리, 의존성 없이 운영하기 쉬운 시스템을 원합니다. Loki는 메트릭 대신 로그에 초점을 맞추고, pull 방식 대신 push 방식으로 로그를 전달한다는 점에서 Prometheus와 다릅니다.

시작하기

⚠️ Helm 차트 마이그레이션

2026년 3월 16일부터 Grafana Loki Helm 차트는 새 저장소 grafana-community/helm-charts로 포크됩니다. Loki 저장소의 차트는 GEL 사용자를 위해서만 계속 유지 관리됩니다. 자세한 내용은 #20705를 참조하세요.

업그레이드

Loki 업그레이드

문서

최신 릴리스
다가오는 릴리스, main 브랜치의 최신 커밋 기준

자주 사용되는 섹션:

API 문서 - Loki로 로그를 전송하기 위한 문서.
레이블
운영
Docker Driver Client는 Docker 컨테이너에서 Loki로 로그를 직접 전송하기 위한 Docker 플러그인입니다.
LogCLI는 로그를 쿼리하기 위한 명령줄 인터페이스를 제공합니다.
Loki Canary는 Loki 설치 환경에서 누락된 로그를 모니터링합니다.
문제 해결은 오류 메시지 처리에 대한 도움을 제공합니다.
Grafana의 Loki는 Grafana에서 Loki 데이터 소스를 설정하는 방법을 설명합니다.

도움 받기

Loki에 관한 질문이나 피드백이 있다면:

Grafana Labs 커뮤니티 포럼에서 Loki에 대한 기존 스레드를 검색하세요: https://community.grafana.com
Loki Slack 채널에 질문하세요. Grafana Slack에 초대받으려면 https://slack.grafana.com/을 방문하여 #loki 채널에 가입하세요.
버그, 문제 및 기능 제안은 이슈 등록을 하세요.
[email protected]으로 이메일을 보내거나 웹 인터페이스를 사용하세요.
UI 문제는 Grafana에 직접 등록해야 합니다.

피드백은 언제나 환영합니다.

추가 자료

Loki의 원본 설계 문서는 동기와 설계 결정에 대한 논의를 위한 좋은 자료입니다.
Callum Styan의 2019년 3월 DevOpsDays Vancouver 발표 "Grafana Loki: 사고 조사를 위한 로그 집계".
Grafana Labs 블로그 게시물 "마이크로서비스와 모놀리스 모두에서 쉽게 작동하도록 Loki를 설계한 방법".
Tom Wilkie의 2019년 초 CNCF Paris/FOSDEM 발표 "Grafana Loki: Prometheus처럼, 그러나 로그를 위한 것" (슬라이드, 비디오).
David Kaltschmidt의 KubeCon 2018 발표 "Grafana로 완전한 관찰 가능성을 향한 OSS 경로" (슬라이드, 비디오)는 Loki가 클라우드 네이티브 환경에 어떻게 적합한지에 관한 것입니다.
Goutham Veeramachaneni의 블로그 게시물 "Loki: 클라우드 네이티브를 위한 Prometheus에서 영감을 받은 오픈 소스 로깅"은 Loki 아키텍처에 대한 세부 정보를 다룹니다.
David Kaltschmidt의 블로그 게시물 "Loki를 위한 Grafana 사용자 인터페이스 자세히 살펴보기"은 로깅 사용자 인터페이스에 적용된 아이디어에 관한 것입니다.

기여하기

CONTRIBUTING.md를 참조하세요.

소스에서 빌드하기

Loki는 다음 명령을 사용하여 단일 호스트에서 의존성 없는 모드로 실행할 수 있습니다.

최신 버전의 Go가 필요합니다. Makefile에 있는 버전을 사용하는 것을 권장합니다.

# Checkout source code
$ git clone https://github.com/grafana/loki
$ cd loki

# Build binary
$ go build ./cmd/loki

# Run executable
$ ./loki -config.file=./cmd/loki/loki-local-config.yaml

또는 Unix 시스템에서는 make를 사용하여 바이너리를 빌드할 수 있습니다. go build 명령에 추가 인수를 더합니다.

# Build binary
$ make loki

# Run executable
$ ./cmd/loki/loki -config.file=./cmd/loki/loki-local-config.yaml

로컬에서 여러 Loki 테넌트를 실행하려면 auth_enabled가 true로 설정되어 있는지 확인하고 테넌트별 재정의가 포함된 런타임 구성을 제공하세요.

# Build binary
$ make loki

# Run executable
./loki -config.file=./cmd/loki/loki-local-multi-tenant-config.yaml -runtime-config.file=./cmd/loki/loki-overrides.yaml

채택 기관

현재 Loki를 사용하는 일부 조직은 ADOPTERS.md를 참조하세요. 조직을 목록에 추가하려면 PR을 열어 목록에 추가해 주세요.

라이선스

Grafana Loki는 AGPL-3.0-only에 따라 배포됩니다. Apache-2.0 예외 사항은 LICENSING.md를 참조하세요.

loki

인기