Grafana Logs Drilldown 접근 또는 설치
Grafana Logs Drilldown 접근 또는 설치 (Access or install Grafana Logs Drilldown)
Grafana Logs Drilldown으로 로그 데이터를 보려면 Grafana Cloud에서 접근하거나 자신의 Grafana 인스턴스에 설치할 수 있어요. Grafana와 Grafana Cloud에 기본 설치되어 있어 즉시 사용할 수 있어요.
출처: 문서
본문
Grafana Logs Drilldown으로 로그 데이터를 보려면 Grafana Cloud에서 접근하거나 자신의 Grafana 인스턴스에 설치할 수 있어요.
Grafana Play에서 실용적인 예시를 배우며 탐색하고 작동 방식을 확인할 수 있어요. 이 기능은 Grafana Play 사이트에서 볼 수 있어요.
Grafana 및 Grafana Cloud에서 접근 (Access in Grafana and Grafana Cloud)
Logs Drilldown은 Grafana와 Grafana Cloud 모두에 기본 설치돼요. Logs Drilldown에 접근하려면:
- 웹 브라우저에서 Grafana 스택을 열어요.
- 메인 메뉴에서 Drilldown > Logs를 선택해요.
Grafana v12 이상에서 Grafana는 모든 Drilldown 앱을 같은 Drilldown 섹션에 기본 포함해요.
설치 (Installation)
Logs Drilldown은 현재 Grafana 릴리스에 기본 설치돼요. 이전 설치를 업그레이드한다면 플러그인을 수동으로 설치해야 할 수 있어요.
Plugins 카탈로그로 설치 (Install via Plugins catalog)
Enterprise 및 OSS Grafana 사용자는 Grafana Plugins catalog로 Logs Drilldown을 설치할 수 있어요.
- 웹 브라우저에서 https://grafana.com/grafana/plugins/grafana-lokiexplore-app/을 열어요.
- Installation 탭을 클릭해요.
- 지침에 따라 앱을 설치해요.
Loki 구성에서 활성화 (Enable in Loki configuration)
다음 Loki 및 Grafana 버전과 구성이 필요해요:
- Grafana v11.6.11 이상
- Loki v3.2.0 이상
- Note: 실험 기능을 포함한 최신 기능을 얻으려면 Loki 3.5.0 이상으로 업그레이드해요.
- Loki 구성 파일에서
pattern_ingester.enabled를true로 설정해 패턴 수집(pattern ingestion)을 활성화해요. - Loki 구성 파일에서
allow_structured_metadata를true로 설정해 구조화된 메타데이터를 활성화해요. - Loki 구성 파일에서
volume_enabled를true로 설정해 volume 엔드포인트를 활성화해요. - Loki 구성 파일에서
discover_log_levels를true로 설정해 로그 레벨 감지를 활성화해요.
pattern_ingester:
enabled: true
limits_config:
allow_structured_metadata: true
volume_enabled: true
discover_log_levels: true
환경 변수로 설치 (Install via environment variable)
Docker 컨테이너에 앱을 설치하려면 다음 환경 변수를 구성해야 해요:
GF_INSTALL_PLUGINS="https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/release/main/any/grafana-lokiexplore-app-main.zip;grafana-lokiexplore-app"
Grafana CLI로 설치 (Install using Grafana CLI)
Grafana CLI를 사용해 자신의 Grafana 인스턴스에 Logs Drilldown을 설치할 수 있어요. 자세한 내용은 Grafana CLI 문서를 참고해요.
다음 명령을 실행해요:
grafana cli plugins install --pluginUrl=https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/release/main/any/grafana-lokiexplore-app-main.zip grafana-lokiexplore-app
권한 (Permissions)
모든 Grafana Drilldown 앱은 Grafana에서 datasources:explore 권한이 필요해요.
Docker Compose로 테스트 (Test with Docker Compose)
다음 명령으로 Grafana, Loki, Logs Drilldown App을 띄워 앱을 테스트할 수 있어요:
curl -L https://github.com/grafana/explore-logs/raw/main/scripts/run.sh | sh
이 명령은 run.sh 파일을 다운로드해 실행해요. 이 셸 파일은 몇 가지 구성 파일을 /tmp/explore-logs 디렉터리에 다운로드하고 docker compose로 그곳에서 Docker 컨테이너를 시작해요.
Docker 컨테이너가 시작되면 http://localhost:3000/a/grafana-lokiexplore-app/explore로 이동해 Logs Drilldown에 접근해요.
문제가 있나요? (Having trouble?)
일반적인 문제를 해결하는 팁은 troubleshooting guide를 참고해요.
다음은 무엇인가요? (What next?)
Logs Drilldown을 사용하려면 관리자가 Loki 데이터 소스를 구성해 Logs Drilldown에서 로그에 접근해야 해요. 지침은 Loki 데이터 소스 문서를 참고해요. 설치 후 시간 범위, 데이터 소스, 표시 필드 같은 기본 설정을 커스터마이즈할 수 있어요. 자세한 내용은 Configure Logs Drilldown을 참고해요.