๐Ÿ“œ Grafana + Loki ๋กœ๊ทธ์ˆ˜์ง‘ ๋ฐ์ดํ„ฐ ์‹œ๊ฐํ™”

Dev96ยท2025๋…„ 4์›” 22์ผ
post-thumbnail

๐Ÿ”น ์‹œ์ž‘ํ•˜๊ธฐ์•ž์„œ

์ด์ „๊ธ€์—์„œ Docker Compose๋ฅผ ํ™œ์šฉํ•˜์—ฌ Loki + Grafana ๊ตฌ์ถ•ํ•˜๋Š” ๊ธ€์„ ๋ณด๊ณ  ์˜ค๋Š”๊ฑธ ์ฐธ๊ณ ํ•˜๊ธธ ๋ฐ”๋ž€๋‹ค.

https://velog.io/@dev-hsl-960221/Docker-Compose%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-PrometheusLokiGrafana-%EA%B5%AC%EC%B6%95-%EB%B0%8F-%EC%84%9C%EB%B9%84%EC%8A%A4-%EC%9A%B4%EC%98%81

1๏ธโƒฃ Grafana + Loki ์—ฐ๋™



ํ˜ธ์ŠคํŠธ์ฃผ์†Œ๊ฐ€ ์•„๋‹Œ loki ํ‚ค์›Œ๋“œ๋กœ ์‚ฌ์šฉโ“

โ€ป Docker Compose์—์„œ ์—ฌ๋Ÿฌ ์„œ๋น„์Šค๋ฅผ ์ •์˜ํ•  ๋•Œ, ๊ฐ™์€ ๋„คํŠธ์›Œํฌ์— ์†ํ•œ ์ปจํ…Œ์ด๋„ˆ๋ผ๋ฆฌ๋Š” ์„œ๋น„์Šค ์ด๋ฆ„์œผ๋กœ ์„œ๋กœ๋ฅผ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


2๏ธโƒฃ ๋Œ€์‹œ๋ณด๋“œ ์ƒ์„ฑ





3๏ธโƒฃ Query ๋ฐ ์‹œ๊ฐํ™”


โœ… ์•ฑ ์„œ๋น„์Šค๋“ค์— ๋Œ€ํ•œ ํ™˜๊ฒฝ๋ณ€์ˆ˜๋ฅผ app์œผ๋กœ ์„ค์ •


๐Ÿท๏ธ Label Filters (๋ผ๋ฒจ ํ•„ํ„ฐ)

* Loki๋Š” ๋กœ๊ทธ๋ฅผ ๋ผ๋ฒจ(label)๋กœ ๊ตฌ๋ถ„ํ•ด์„œ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค.

* appName="$app"์€ ํŠน์ • ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜(app)์— ํ•ด๋‹นํ•˜๋Š” ๋กœ๊ทธ๋งŒ ํ•„ํ„ฐ๋งํ•ด์„œ ์กฐํšŒํ•˜๊ฒ ๋‹ค๋Š” ์˜๋ฏธ์ž…๋‹ˆ๋‹ค.

* ์—ฌ๊ธฐ์„œ $app์€ Grafana์—์„œ ์ •์˜ํ•œ ๋ณ€์ˆ˜(variable)์ด๋ฉฐ, ๋Œ€์‹œ๋ณด๋“œ ์ƒ๋‹จ์—์„œ ์„ ํƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ” Logfmt ํŒŒ์„œ ์„ค์ •

* logfmt๋Š” key=value ํ˜•์‹์˜ ๋กœ๊ทธ๋ฅผ ๊ตฌ์กฐํ™”๋œ ํ˜•ํƒœ๋กœ ํŒŒ์‹ฑํ•ฉ๋‹ˆ๋‹ค.

* ํŒŒ์‹ฑ๋œ ํ‚ค๋Š” Grafana์—์„œ ํ•„ํ„ฐ๋ง, ํ…Œ์ด๋ธ” ์ถœ๋ ฅ, ์‹œ๊ฐํ™” ๋“ฑ์— ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์–ด์š”.

โš™๏ธ ์ถ”๊ฐ€ ์˜ต์…˜ ์„ค๋ช…

Strict

์ฒดํฌ ์‹œ logfmt ํŒŒ์‹ฑ ์˜ค๋ฅ˜๊ฐ€ ์žˆ๋Š” ๋กœ๊ทธ๋Š” ๋ฌด์‹œํ•ฉ๋‹ˆ๋‹ค.

Keep empty

๊ฐ’์ด ๋น„์–ด ์žˆ๋Š” ํ‚ค๋„ ์œ ์ง€ํ•ด์„œ ํŒŒ์‹ฑํ•ฉ๋‹ˆ๋‹ค. (์˜ˆ: traceId=)

+ Expression

ํŒŒ์‹ฑ๋œ ํ•„๋“œ๋ฅผ ์กฐ๊ฑด์œผ๋กœ ์ถ”๊ฐ€ ํ•„ํ„ฐ๋ง์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.


4๏ธโƒฃ Grafana ์‹œ๊ฐํ™” ๊ฒฐ๊ณผ


๐Ÿ”น ๊ฒฐ๋ก 

โญ ๋กœ๊ทธ ์‹œ๊ฐํ™” ํ†ตํ•ฉ

โญ ์ธ๋ฑ์‹ฑ์ด ๊ฑฐ์˜ ์—†๊ธฐ ๋•Œ๋ฌธ์— ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰์ด ์ ๊ณ , ์ €์žฅ ๋น„์šฉ๋„ ๋‚ฎ์Œ.

โญ ์šด์˜ ์ค‘์ธ ์‹œ์Šคํ…œ์—์„œ ๋กœ๊ทธ ๊ธฐ๋ฐ˜ ์ด๋ฒคํŠธ๋ฅผ ๋น ๋ฅด๊ฒŒ ๊ฐ์ง€ํ•˜๊ณ  ๋Œ€์‘ํ•  ์ˆ˜ ์žˆ์Œ.

profile
๋‹ค์–‘ํ•œ ๊ฒฝํ—˜๊ณผ ์‹ค๋ฌด์˜ ๊นŠ์ด๋กœ ํ‰๊ฐ€๋ฐ›๊ณ  ์‹ถ์€ ์‚ฌ๋žŒ๋“ค์„ ์œ„ํ•ด ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค. ์‹ค๋ฌด์—์„œ ๋ถ€๋”ชํžˆ๋ฉฐ ๋ฐฐ์šด ๊ฒƒ๋“ค์ด ๊ฐ€์žฅ ์˜ค๋ž˜ ๋‚จ๋Š”๋‹ค๊ณ  ๋ฏฟ์Šต๋‹ˆ๋‹ค.

0๊ฐœ์˜ ๋Œ“๊ธ€