Theory
인프라
Loki 공식 문서 번역
setup
로컬에 설치

Grafana Loki 로컬에 설치하기

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

💡

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

Grafana Loki로 이벤트를 기록하려면 Promtail과 Loki를 모두 다운로드하여 설치해야 합니다.

  • Loki는 로깅 엔진입니다.
  • Promtail은 Loki에 로그를 보냅니다.

이 구성은 Loki를 단일 바이너리로 실행합니다.

APT 또는 RPM 패키지 관리자를 사용하여 설치

  1. 연결된 지침에 따라 Grafana 고급 패키지 도구(APT) (opens in a new tab) 또는 RPM 패키지 관리자(RPM) (opens in a new tab) 패키지 리포지토리를 추가합니다.
  2. Loki 및 Promtail 설치
    • dnf 사용
      dnf update
      dnf install loki promtail
    • apt-get 사용
      apt-get update
      apt-get install loki promtail

수동으로 설치

  1. 릴리스 페이지 (opens in a new tab)로 이동합니다.
  2. 설치하려는 버전의 Assets 섹션을 찾습니다.
  3. 시스템에 해당하는 Loki 및 Promtail 아카이브 파일을 다운로드합니다. 이때 LogCLI 또는 Loki Canary는 다운로드하지 마십시오. LogCLI를 사용하면 명령줄 인터페이스에서 Loki 쿼리를 실행할 수 있습니다. Loki Canary는 Loki 성능을 감사하는 도구입니다.
  4. 패키지 내용을 동일한 디렉토리에 압축을 풉니다. 두 프로그램이 실행될 위치입니다.
  5. 명령줄에서 디렉토리를 Loki와 Promtail이 있는 디렉토리로 변경합니다(cd 대부분의 시스템에서). 명령줄에 다음 명령을 복사하여 붙여넣어 일반 구성 파일을 다운로드합니다. 다운로드한 Loki 버전과 일치하는 Git 참조를 사용하여 올바른 구성 파일을 가져옵니다. 예를 들어 Loki 버전 3.4.1을 사용하는 경우 https://raw.githubusercontent.com/grafana/loki/v3.4.1/cmd/loki/loki-local-config.yaml URL을 사용하여 구성 파일을 다운로드해야 합니다.
    wget https://raw.githubusercontent.com/grafana/loki/main/cmd/loki/loki-local-config.yaml
    wget https://raw.githubusercontent.com/grafana/loki/main/clients/cmd/promtail/promtail-local-config.yaml
  6. 다음 명령을 실행하여 Loki를 시작합니다. Windows
    .\loki-windows-amd64.exe --config.file=loki-local-config.yaml
    Linux
    ./loki-linux-amd64 -config.file=loki-local-config.yaml

Loki가 실행되고 명령줄과 http://localhost:3100/metrics에 (opens in a new tab) Loki 로그가 표시됩니다.

다음 단계는 Loki에 로그를 보내기 위해 에이전트를 실행하는 것입니다. Promtail로 이를 수행하려면 Promtail 구성을 참조하세요.

릴리스 바이너리 - openSUSE Linux 전용

모든 릴리스에는 Loki용 바이너리가 포함되어 있습니다. 릴리스 페이지 (opens in a new tab)에서 찾을 수 있습니다.

커뮤니티 openSUSE Linux 패키지

커뮤니티는 openSUSE Linux용 Loki 패키지를 제공합니다. 설치하려면:

  1. 시스템에 리포지토리 https://download.opensuse.org/repositories/security:/logging/을 추가합니다. 예를 들어 Leap 15.1을 사용하는 경우 다음을 실행합니다.
    sudo zypper ar https://download.opensuse.org/repositories/security:/logging/openSUSE_Leap_15.1/security:logging.repo
    sudo zypper ref
  2. Loki 패키지를 설치합니다.
    zypper in loki
  3. Loki 및 Promtail 서비스를 시작하고 활성화합니다.
    systemd start loki
    systemd enable loki
    systemd start promtail
    systemd enable promtail
  4. 필요에 따라 /etc/loki/promtail.yaml/etc/loki/loki.yaml 구성 파일을 수정합니다.