Docker 또는 Docker Compose로 Loki 설치하기

원본: https://grafana.com/docs/loki/latest/setup/install/docker/ (opens in a new tab)

💡

Grafana Cloud를 사용하면 자체 Grafana Loki 인스턴스를 설치, 유지 관리 및 확장할 필요가 없습니다. 무료 계정을 만들어 시작 (opens in a new tab)하세요. 여기에는 10k 메트릭, 50GB 로그, 50GB 추적, 500VUh k6 테스트 등에 대한 영구 무료 액세스가 포함됩니다.

Loki를 평가, 테스트 또는 개발하는 경우 Docker 또는 Docker Compose를 사용하여 Loki와 Promtail을 설치할 수 있습니다. 프로덕션 환경에서는 Helm 또는 Tanka를 사용하여 설치하는 것이 좋습니다.

이러한 설치 지침과 관련된 구성 파일은 Loki를 단일 바이너리로 실행합니다.

전제 조건

Docker (opens in a new tab)
Docker Compose (opens in a new tab) (선택 사항, Docker Compose 설치 방법에만 필요)

Linux에서 Docker로 설치

loki라는 디렉토리를 만듭니다. loki를 현재 작업 디렉토리로 만듭니다.
```
mkdir loki
cd loki
```

명령줄에 다음 명령을 복사하여 붙여넣어 loki-local-config.yaml 및 promtail-docker-config.yaml을 loki 디렉토리로 다운로드합니다.

wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/cmd/loki/loki-local-config.yaml -O loki-config.yaml
wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml

명령줄에 다음 명령을 복사하여 붙여넣어 이전 단계에서 다운로드한 구성 파일을 사용하여 Docker 컨테이너를 시작합니다.
```
docker run --name loki -d -v $(pwd):/mnt/config -p 3100:3100 grafana/loki:3.4.1 -config.file=/mnt/config/loki-config.yaml
docker run --name promtail -d -v $(pwd):/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.4.1 -config.file=/mnt/config/promtail-config.yaml
```
참고: 이미지는 기본적으로 UID 10001 및 GID 10001을 가진 loki 사용자로 실행되도록 구성되어 있습니다. 특히 바인드 마운트를 사용하는 경우 docker run 명령으로 UID를 지정하고 필요에 맞는 숫자 UID와 함께 --user=UID를 사용하여 다른 사용자를 사용할 수 있습니다.

컨테이너가 실행 중인지 확인합니다.

docker container ls

다음과 유사한 내용이 표시되어야 합니다.

CONTAINER ID   IMAGE                    COMMAND                  CREATED          STATUS          PORTS                                       NAMES
9485de9ad351   grafana/promtail:3.4.1   "/usr/bin/promtail -…"   About a minute ago   Up About a minute                                               promtail
cece1df84519   grafana/loki:3.4.1       "/usr/bin/loki -conf…"   About a minute ago   Up About a minute   0.0.0.0:3100->3100/tcp, :::3100->3100/tcp   loki

Loki가 실행 중인지 확인합니다.
- 준비 상태를 보려면 http://localhost:3100/ready (opens in a new tab)로 이동합니다.
- 메트릭을 보려면 http://localhost:3100/metrics (opens in a new tab)로 이동합니다.

Windows에서 Docker로 설치

명령줄에 다음 명령을 복사하여 붙여넣어 loki-local-config.yaml 및 promtail-docker-config.yaml을 loki 디렉토리로 다운로드합니다. 명령에서 <local-path>를 로컬 경로로 바꿔야 합니다.

cd "<local-path>"
wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/cmd/loki/loki-local-config.yaml -O loki-config.yaml
wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml

명령줄에 다음 명령을 복사하여 붙여넣어 이전 단계에서 다운로드한 구성 파일을 사용하여 Docker 컨테이너를 시작합니다. 명령에서 <local-path>를 로컬 경로로 바꿔야 합니다.

docker run --name loki -v <local-path>:/mnt/config -p 3100:3100 grafana/loki:3.4.1 --config.file=/mnt/config/loki-config.yaml
docker run -v <local-path>:/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.4.1 --config.file=/mnt/config/promtail-config.yaml

Loki가 실행 중인지 확인합니다.
- 준비 상태를 보려면 http://localhost:3100/ready (opens in a new tab)로 이동합니다.
- 메트릭을 보려면 http://localhost:3100/metrics (opens in a new tab)로 이동합니다.

Docker Compose로 설치

명령줄에서 다음 명령을 실행합니다. Windows 또는 Linux 시스템에서 작동합니다.

loki라는 디렉토리를 만듭니다. loki를 현재 작업 디렉토리로 만듭니다.
```
mkdir loki
cd loki
```

명령줄에 다음 명령을 복사하여 붙여넣어 docker-compose 파일을 다운로드합니다.

wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/production/docker-compose.yaml -O docker-compose.yaml

loki가 현재 작업 디렉토리인 상태에서 다음 docker-compose 명령을 실행합니다.

docker-compose -f docker-compose.yaml up

다음과 유사한 내용이 표시되어야 합니다.

✔ Container loki-loki-1 Started 0.0s
✔ Container loki-grafana-1 Started 0.0s
✔ Container loki-promtail-1 Started 0.0s

Loki가 실행 중인지 확인합니다.
- 준비 상태를 보려면 http://localhost:3100/ready (opens in a new tab)로 이동합니다.
- 메트릭을 보려면 http://localhost:3100/metrics (opens in a new tab)로 이동합니다.

Tanka를 사용하여 설치 로컬에 설치