<p align="center"><img src="https://raw.githubusercontent.com/grafana/loki/HEAD/docs/sources/logo_and_name.png" alt="Loki 로고"></p>
<a href="https://github.com/grafana/loki/actions/workflows/check.yml"><img src="https://github.com/grafana/loki/actions/workflows/check.yml/badge.svg" alt="Check" /></a>
<a href="https://goreportcard.com/report/github.com/grafana/loki"><img src="https://goreportcard.com/badge/github.com/grafana/loki" alt="Go Report Card" /></a>
<a href="https://slack.grafana.com/"><img src="https://img.shields.io/badge/join%20slack-%23loki-brightgreen.svg" alt="Slack" /></a>
Fuzzing Status
Loki: 로그를 위한 Prometheus와 같다.
Loki는 Prometheus에서 영감을 받은, 수평적으로 확장 가능하고 고가용성을 갖춘 다중 테넌트(multi-tenant) 로그 집계 시스템입니다.
이는 비용 효율적이고 운영하기 쉽도록 설계되었습니다.
로그의 내용을 인덱싱하는 것이 아니라, 각 로그 스트림에 대한 레이블 세트를 인덱싱합니다.
다른 로그 집계 시스템과 비교했을 때 Loki는 다음과 같은 특징을 가집니다:
- 로그에 대해 전체 텍스트(full text) 인덱싱을 수행하지 않습니다. 압축된 비정형 로그를 저장하고 메타데이터만 인덱싱하기 때문에, Loki는 운영이 더 간단하고 실행 비용이 저렴합니다.
- Prometheus에서 이미 사용하고 있는 것과 동일한 레이블을 사용하여 로그 스트림을 인덱싱하고 그룹화할 수 있어, 기존에 사용하던 레이블을 통해 메트릭(metrics)과 로그 간의 전환을 원활하게 할 수 있습니다.
- Kubernetes Pod 로그를 저장하는 데 특히 적합합니다. Pod 레이블과 같은 메타데이터가 자동으로 스크랩되고 인덱싱됩니다.
- Grafana에서 네이티브 지원(Grafana v6.0 필요)을 제공합니다.
Loki 기반의 로깅 스택은 3가지 구성 요소로 이루어집니다:
- Alloy는 로그를 수집하여 Loki로 전송하는 역할을 하는 에이전트입니다.
- Loki는 로그를 저장하고 쿼리를 처리하는 주요 서비스입니다.
- Grafana는 로그를 쿼리하고 표시하는 데 사용됩니다.
참고: Promtail이 기능적으로 완성되었다고 간주되며, 향후 로그 수집 개발은 Grafana Alloy에서 이루어질 것이기 때문에, 스택에서 Promtail 대신 Alloy를 사용한다는 점에 유의하십시오.
Loki는 Prometheus와 같지만 로그용입니다: 우리는 인덱싱을 위해 다차원 레이블 기반 접근 방식을 선호하며, 의존성이 없고 운영하기 쉬운 단일 바이너리 시스템을 원합니다. Loki는 메트릭(metrics) 대신 로그에 초점을 맞추고, 풀(pull) 방식 대신 푸시(push) 방식으로 로그를 전달한다는 점에서 Prometheus와 다릅니다.
시작하기 (Getting started)
⚠️ Helm 차트 마이그레이션 (Helm Chart Migration)
2026년 3월 16일부로, Grafana Loki Helm 차트는 새로운 저장소 grafana-community/helm-charts로 포크됩니다. Loki 저장소의 차트는 GEL 사용자에게만 계속 유지 관리될 것입니다. 자세한 내용은 #20705를 참조하십시오.
업그레이드 (Upgrading)
문서화 (Documentation)
도움 받기 (Getting Help)
Loki에 대해 질문이나 피드백이 있는 경우:
귀하의 피드백은 항상 환영받습니다.
추가 자료 (Further Reading)
기여 (Contributing)
CONTRIBUTING.md를 참조하세요.
소스 코드에서 빌드하기 (Building from source)
다음 명령어를 사용하여 Loki를 단일 호스트, 의존성 없는 모드(no-dependencies mode)로 실행할 수 있습니다.
최신 버전의 Go가 필요하며, 저희 Makefile에 있는 버전을 사용하는 것을 권장합니다.
$ git clone https://github.com/grafana/loki
$ cd loki
...
대안으로, Unix 시스템에서는 make를 사용하여 바이너리를 빌드할 수 있으며, 이 과정에서 go build 명령어에 추가 인수가 적용됩니다.
여러 Loki 테넌트(tenant)를 로컬에서 실행하려면, auth_enabled가 true로 설정되어 있는지 확인하고 모든 테넌트에 대한 특정 오버라이드를 포함하는 런타임 구성을 제공해야 합니다.
사용자 (Adopters)
현재 Loki를 사용하고 있는 일부 조직은 ADOPTERS.md에서 확인하실 수 있습니다.
귀사도 목록에 추가하고 싶으시면, PR을 열어 목록에 추가해 주십시오.
라이선스 (License)
Grafana Loki는 AGPL-3.0-only 하에 배포됩니다. Apache-2.0 예외 사항은 LICENSING.md를 참조하십시오.
