• /
  • EnglishEspaรฑolFranรงaisๆ—ฅๆœฌ่ชžํ•œ๊ตญ์–ดPortuguรชs
  • ใƒญใ‚ฐใ‚คใƒณไปŠใ™ใ้–‹ๅง‹

Java agent release notesRSS

April 8
Java agent v9.2.0

์ด ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”

์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ๋ฐ ๊ฐœ์„  ์‚ฌํ•ญ

  • ์ž๋ฐ” 26 ์ง€์› ์ถ”๊ฐ€ 2734
  • ์ž๋ฐ” ์—์ด์ „ํŠธ๋ฅผ ์‚ฌ์šฉํ•œ AWS Lambda ๋ชจ๋‹ˆํ„ฐ๋ง์„ ์œ„ํ•œ Serverless ๋ชจ๋“œ๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
  • ์ƒˆ application_logging.forwarding.log_level_denylist ๊ตฌ์„ฑ์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2764
  • ๋ฆฌ์ „ ์ธ์‹ ์ด๋ฒคํŠธ/๋ฉ”ํŠธ๋ฆญ ์ˆ˜์ง‘ URI ๊ตฌํ˜„ 2749 2790
  • enable_auto_app_naming ์ด(๊ฐ€) true ์ผ ๋•Œ ๋กœ๊ทธ๋ฅผ ํ•ด๋‹น ์—”ํ‹ฐํ‹ฐ์— ์—ฐ๊ฒฐํ•˜๋Š” ๊ธฐ๋Šฅ ์ง€์› ์ถ”๊ฐ€ 2627
  • OpenTelemetry 1.59.0+์šฉ opentelemetry-sdk-extension-autoconfigure-1.59.0 ๊ณ„์ธก ์ถ”๊ฐ€ 2786
  • enable_auto_app_naming ์ด(๊ฐ€) true ์ผ ๋•Œ Adaptive Sampler๋ฅผ ํ•ด๋‹น ์—”ํ‹ฐํ‹ฐ์— ์—ฐ๊ฒฐํ•˜๊ธฐ ์œ„ํ•œ ์ง€์› ์ถ”๊ฐ€ 2805
  • enable_auto_app_naming ์ด(๊ฐ€) true ์ผ ๋•Œ ์ƒ์„ฑ๋œ ๊ฐ ์—”ํ‹ฐํ‹ฐ์— ๋Œ€ํ•œ ์ง€์› ๊ฐ€๋Šฅ์„ฑ ๋ฉ”ํŠธ๋ฆญ์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2808
  • ํด๋ผ์šฐ๋“œ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ํ”„๋ก์‹œ ์šฐํšŒ ์„ค์ • ๊ตฌํ˜„ 2791
  • ์—์ด์ „ํŠธ์—์„œ ์—ฌ๋Ÿฌ ๋ฒ„์ „์˜ Caffeine์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2807
  • SQL ์–ด๋ ˆ์ด๋ฅผ ํ™œ์šฉํ•˜๋Š” ์„ค๋ช… ๊ณ„ํš์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2815
  • ์ผ๋ฐ˜ 'Queue'๋ฅผ ์ „์†ก ์œ ํ˜•์œผ๋กœ ์ถ”๊ฐ€ 2820
  • Reactor Netty Http ํด๋ผ์ด์–ธํŠธ ํ˜ธ์ถœ ์ง€์›์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2817

์ˆ˜์ • ์‚ฌํ•ญ

  • NR ํŽ˜์ด๋กœ๋“œ์˜ sampled ํ•„๋“œ์— ์•ก์„ธ์Šคํ•  ๋•Œ ์ž˜๋ชป๋œ ํ˜•์‹์˜ ํŽ˜์ด๋กœ๋“œ๋กœ ์ธํ•ด NPE๊ฐ€ ๋ฐœ์ƒํ•˜๋Š” ์—ฃ์ง€ ์ผ€์ด์Šค๋ฅผ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค 2762
  • Reactive ๊ตฌ๋…์ด ์ทจ์†Œ๋  ๋•Œ ํ† ํฐ์„ ๋งŒ๋ฃŒํ•ฉ๋‹ˆ๋‹ค 2798
  • ๋ฉ”๋ชจ๋ฆฌ ๋ˆ„์ˆ˜๋ฅผ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด TheadTracker ์บ์‹œ์—์„œ ๋ฐ๋“œ ์Šค๋ ˆ๋“œ๋ฅผ ์ˆ˜๋™์œผ๋กœ ์ œ๊ฑฐํ•˜๋Š” ๋กœ์ง์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค 2811
  • ์ˆ˜์ง‘ ์Šค๋ ˆ๋“œ์™€ JVM ์ข…๋ฃŒ ์Šค๋ ˆ๋“œ ๊ฐ„์˜ ๊ต์ฐฉ ์ƒํƒœ๋ฅผ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค 2539

์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ

ํ˜„์žฌ ์‚ฌ์šฉ ์ค‘์ธ Java ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ์‹๋ณ„ํ•˜๋ ค๋ฉด java -jar newrelic.jar -v ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. Java ์—์ด์ „ํŠธ ๋ฒ„์ „์ด ์ฝ˜์†”์— ์ธ์‡„๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋Ÿฐ ๋‹ค์Œ ์ตœ์‹  Java ์—์ด์ „ํŠธ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด ๋‹ค์Œ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  1. ์ „์ฒด Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฅผ ๋‹ค๋ฅธ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ํ•ด๋‹น ๋””๋ ‰ํ† ๋ฆฌ์˜ ์ด๋ฆ„์„ NewRelic_Agent#.#.# ์œผ๋กœ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ #.#.# ์€ ์—์ด์ „ํŠธ ๋ฒ„์ „ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.
  2. ์—์ด์ „ํŠธ๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.
  3. ์ƒˆ ์—์ด์ „ํŠธ ๋‹ค์šด๋กœ๋“œ ํŒŒ์ผ์˜ ์••์ถ•์„ ํ‘ผ ๋‹ค์Œ newrelic-api.jar ๋ฐ newrelic.jar ์„ ์›๋ž˜ Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ ์— ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
  4. ์ด์ „ newrelic.yml ์„ zip์—์„œ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•œ newrelic.yml ๊ณผ ๋น„๊ต ํ•˜๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค .
  5. Java ๋””์ŠคํŒจ์ฒ˜๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์‹ญ์‹œ์˜ค.

Java ์—์ด์ „ํŠธ ์—…๋ฐ์ดํŠธ ํ›„ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ๋ฐฑ์—…๋œ New Relic ์—์ด์ „ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋ณต์›ํ•˜์‹ญ์‹œ์˜ค.

์—์ด์ „ํŠธ ๊ตฌ์„ฑ ์ฐจ์ด์  ์—…๋ฐ์ดํŠธ

์—์ด์ „ํŠธ์˜ ์ƒˆ ๋ฒ„์ „์„ ์ถœ์‹œํ•  ๋•Œ newrelic.yml ์— ์ƒˆ ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.diff ๋˜๋Š” ๋‹ค๋ฅธ diffing ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ์‚ฌํ•ญ์„ ํ™•์ธํ•˜๊ณ  ์ด์ „ ํŒŒ์ผ์— ์ƒˆ ๊ตฌ์„ฑ ์„ค์ •์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.๋ผ์ด์„ผ์Šค ํ‚ค, ์•ฑ ์ด๋ฆ„ ๋˜๋Š” ๊ธฐ๋ณธ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ๊ณผ ๊ฐ™์ด ํŒŒ์ผ์— ๋Œ€ํ•ด ์ˆ˜ํ–‰ํ•œ ์‚ฌ์šฉ์ž ์ •์˜๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ํ•˜์‹ญ์‹œ์˜ค.

์˜ˆ๋ฅผ ๋“ค์–ด, ื™ืื ื™ ๋ฒ„์ „ 7.10.0 ๋ฐ 7.11.0์— ๋Œ€ํ•œ ๊ธฐ๋ณธ newrelic.yml ํŒŒ์ผ์„ diff ํ•˜๋Š” ๊ฒฝ์šฐ ์ฝ˜์†”์— ์ธ์‡„๋œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

โžœ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
> # Whether the log events should include context from loggers with support for that.
> context_data:
>
> # When true, application logs will contain context data.
> enabled: false
>
> # A comma separated list of attribute keys whose values should be sent to New Relic.
> #include:
>
> # A comma separated list of attribute keys whose values should not be sent to New Relic.
> #exclude:
>
125a138
>
128c141
< enabled: false
---
> enabled: true
...

์ด ์˜ˆ์—์„œ ์ด๋Ÿฌํ•œ ์ค„์€ ื™ืื ๋ฒ„์ „ 7.11.0์˜ ๊ธฐ๋ณธ newrelic.yml ์— ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 7.11.0 ์ด์ƒ์œผ๋กœ ์ด๋™ํ•˜๋Š” ๊ฒฝ์šฐ ์›๋ž˜ newrelic.yml ์— ์ด๋Ÿฌํ•œ ์ƒˆ ์ค„์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ง€์ง€ ์„ฑ๋ช…:

  • ๋‰ด๋ ๋ฆญ์€ ์—์ด์ „ํŠธ๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ์ตœ์‹  ๊ธฐ๋Šฅ๊ณผ ์„ฑ๋Šฅ ์ด์ ์„ ์–ป์„ ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ, ์ด์ „ ๋ฆด๋ฆฌ์Šค๋Š” ์ง€์› ์ข…๋ฃŒ ์‹œ์  ์— ๋” ์ด์ƒ ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

February 12
Java agent v9.1.0

์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ๋ฐ ๊ฐœ์„  ์‚ฌํ•ญ

  • ์ž๋ฐ” ํ•˜์ด๋ธŒ๋ฆฌ๋“œ ๋ณ€ํ™˜๊ธฐ: ๋‰ด๋Ÿด๋ฆญ์˜ ์‹ฌ์ธต์ ์ธ ๊ฐ€์‹œ์„ฑ๊ณผ OpenTelemetry API ํ˜ธํ™˜์„ฑ์„ ๊ฒฐํ•ฉํ•˜์—ฌ "๋‘ ๊ฐ€์ง€ ์žฅ์ ์„ ๋ชจ๋‘ ๊ฐ–์ถ˜" ๊ฒฝํ—˜์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฒˆ ๋ฆด๋ฆฌ์Šค์—๋Š” OpenTelemetry Tracing, ์ง€ํ‘œ, ๋กœ๊ทธ API๋Š” ๋ฌผ๋ก  ๋…๋ฆฝ ์‹คํ–‰ํ˜• ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฐ ๋„ค์ดํ‹ฐ๋ธŒ ํ”„๋ ˆ์ž„์›Œํฌ ์ธก์ •, ๋กœ๊ทธ API์— ๋Œ€ํ•œ ํฌ๊ด„์ ์ธ ์ง€์›์ด ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ์ŠคํŒฌ ๋งํฌ ๋ฐ ์ŠคํŒฌ ์ด๋ฒคํŠธ์™€ ๊ฐ™์€ ์ฃผ์š” ๊ฐœ์„  ์‚ฌํ•ญ์ด ์ด์ œ ์ œ๊ณต๋˜์–ด ํ˜ผํ•ฉ ๋ชจ๋“œ ํ™˜๊ฒฝ์—์„œ ์›ํ™œํ•œ ์ƒํ˜ธ ์šด์šฉ์„ฑ์„ ๋ณด์žฅํ•ฉ๋‹ˆ๋‹ค.
    • @jasonjkeller๊ฐ€ 2711๋ฒˆ ์ด์Šˆ์—์„œ ๋ฐœํ‘œํ•œ ํ•˜์ด๋ธŒ๋ฆฌ๋“œ ์—์ด์ „ํŠธ OpenTelemetry API ์ง€์›
  • @dhilpipre๊ฐ€ 2726๋ฒ„์ „์—์„œ ์ฝ”๋ฃจํ‹ด ๋ฌด์‹œ ๊ธฐ๋Šฅ์„ ๊ฐœ์„ ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ์—์ด์ „ํŠธ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์ถ”๊ฐ€ ์ž‘์—… - @mvicknr 2732 2745

์ˆ˜์ • ์‚ฌํ•ญ

  • @jasonjkeller๊ฐ€ 2299์—์„œ w3c ํ—ค๋”๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊นจ์ง„ ํŠธ๋žœ์Šค ์ „ํŒŒ๋ฅผ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2720๋ฒ„์ „์—์„œ @jtduffy ๋‹˜์ด ๋ฉ€ํ‹ฐํ˜ธ์ŠคํŠธ ํ™˜๊ฒฝ์„ค์ • ๊ตฌ์„ฑ์„ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2663 ๋ฒ„์ „์—์„œ @dhilpipre๊ฐ€ suspend ignores๋ฅผ ์ฝ์ง€ ๋ชปํ•˜๋Š” ๋ฌธ์ œ๋ฅผ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.

์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ

ํ˜„์žฌ ์‚ฌ์šฉ ์ค‘์ธ Java ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ์‹๋ณ„ํ•˜๋ ค๋ฉด java -jar newrelic.jar -v ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. Java ์—์ด์ „ํŠธ ๋ฒ„์ „์ด ์ฝ˜์†”์— ์ธ์‡„๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋Ÿฐ ๋‹ค์Œ ์ตœ์‹  Java ์—์ด์ „ํŠธ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด ๋‹ค์Œ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  1. ์ „์ฒด Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฅผ ๋‹ค๋ฅธ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ํ•ด๋‹น ๋””๋ ‰ํ† ๋ฆฌ์˜ ์ด๋ฆ„์„ NewRelic_Agent#.#.# ์œผ๋กœ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ #.#.# ์€ ์—์ด์ „ํŠธ ๋ฒ„์ „ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.
  2. ์—์ด์ „ํŠธ๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.
  3. ์ƒˆ ์—์ด์ „ํŠธ ๋‹ค์šด๋กœ๋“œ ํŒŒ์ผ์˜ ์••์ถ•์„ ํ‘ผ ๋‹ค์Œ newrelic-api.jar ๋ฐ newrelic.jar ์„ ์›๋ž˜ Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ ์— ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
  4. ์ด์ „ newrelic.yml ์„ zip์—์„œ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•œ newrelic.yml ๊ณผ ๋น„๊ต ํ•˜๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค .
  5. Java ๋””์ŠคํŒจ์ฒ˜๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์‹ญ์‹œ์˜ค.

Java ์—์ด์ „ํŠธ ์—…๋ฐ์ดํŠธ ํ›„ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ๋ฐฑ์—…๋œ New Relic ์—์ด์ „ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋ณต์›ํ•˜์‹ญ์‹œ์˜ค.

์—์ด์ „ํŠธ ๊ตฌ์„ฑ ์ฐจ์ด์  ์—…๋ฐ์ดํŠธ

์—์ด์ „ํŠธ์˜ ์ƒˆ ๋ฒ„์ „์„ ์ถœ์‹œํ•  ๋•Œ newrelic.yml ์— ์ƒˆ ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.diff ๋˜๋Š” ๋‹ค๋ฅธ diffing ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ์‚ฌํ•ญ์„ ํ™•์ธํ•˜๊ณ  ์ด์ „ ํŒŒ์ผ์— ์ƒˆ ๊ตฌ์„ฑ ์„ค์ •์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.๋ผ์ด์„ผ์Šค ํ‚ค, ์•ฑ ์ด๋ฆ„ ๋˜๋Š” ๊ธฐ๋ณธ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ๊ณผ ๊ฐ™์ด ํŒŒ์ผ์— ๋Œ€ํ•ด ์ˆ˜ํ–‰ํ•œ ์‚ฌ์šฉ์ž ์ •์˜๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ํ•˜์‹ญ์‹œ์˜ค.

์˜ˆ๋ฅผ ๋“ค์–ด, ื™ืื ื™ ๋ฒ„์ „ 7.10.0 ๋ฐ 7.11.0์— ๋Œ€ํ•œ ๊ธฐ๋ณธ newrelic.yml ํŒŒ์ผ์„ diff ํ•˜๋Š” ๊ฒฝ์šฐ ์ฝ˜์†”์— ์ธ์‡„๋œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

โžœ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
> # Whether the log events should include context from loggers with support for that.
> context_data:
>
> # When true, application logs will contain context data.
> enabled: false
>
> # A comma separated list of attribute keys whose values should be sent to New Relic.
> #include:
>
> # A comma separated list of attribute keys whose values should not be sent to New Relic.
> #exclude:
>
125a138
>
128c141
< enabled: false
---
> enabled: true
...

์ด ์˜ˆ์—์„œ ์ด๋Ÿฌํ•œ ์ค„์€ ื™ืื ๋ฒ„์ „ 7.11.0์˜ ๊ธฐ๋ณธ newrelic.yml ์— ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 7.11.0 ์ด์ƒ์œผ๋กœ ์ด๋™ํ•˜๋Š” ๊ฒฝ์šฐ ์›๋ž˜ newrelic.yml ์— ์ด๋Ÿฌํ•œ ์ƒˆ ์ค„์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ง€์ง€ ์„ฑ๋ช…:

  • ๋‰ด๋ ๋ฆญ์€ ์—์ด์ „ํŠธ๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ์ตœ์‹  ๊ธฐ๋Šฅ๊ณผ ์„ฑ๋Šฅ ์ด์ ์„ ์–ป์„ ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ, ์ด์ „ ๋ฆด๋ฆฌ์Šค๋Š” ์ง€์› ์ข…๋ฃŒ ์‹œ์  ์— ๋” ์ด์ƒ ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

January 14
Java agent v9.0.0

์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ๋ฐ ๊ฐœ์„  ์‚ฌํ•ญ

  • @jtduffy๊ฐ€ 2676๋ฒˆ ์ด์Šˆ์—์„œ ์ถ”๊ฐ€ํ•œ, ์‹œ์ž‘ ์‹œ ์˜ค๋ž˜๋œ ์—์ด์ „ํŠธ ์ž„์‹œ JAR ํŒŒ์ผ์„ ์‚ญ์ œํ•˜๋Š” ์„ค์ • ์ถ”๊ฐ€
  • 2638์—์„œ ์„ ํƒ์ ์œผ๋กœ ์ œ์ž‘๋œ @jtduffy์— ๋Œ€ํ•œ ์ œ์™ธ ์„ค์ •์„ ๋ณด์™„ํ•˜๊ธฐ ์œ„ํ•ด "inclusion" ์˜ต์…˜์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
    • ์ด ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ํ™˜๊ฒฝ ๋ณ€์ˆ˜ NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES ๋˜๋Š” ์‹œ์Šคํ…œ ์†์„ฑ newrelic.config.startup_java_artifact_includes ์„ ์„ค์ •ํ•˜์‹ญ์‹œ์˜ค. ๊ณ„์ธกํ•ด์•ผ ํ•  ์•„ํ‹ฐํŒฉํŠธ๋ฅผ ์‰ผํ‘œ๋กœ ๊ตฌ๋ถ„๋œ ๋ชฉ๋ก์œผ๋กœ ์ง€์ •ํ•˜์‹ญ์‹œ์˜ค.

์ˆ˜์ • ์‚ฌํ•ญ

  • @jtduffy๊ฐ€ 2503์—์„œ S3AsyncClient_Instrumentation์—์„œ ๋ž˜ํผ ํด๋ž˜์Šค๋ฅผ ์ œ๊ฑฐํ•˜์—ฌ IllegalAccessError๋ฅผ ํ•ด๊ฒฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2594์˜ @jasonjkeller๊ฐ€ logback-classic-1.5.20์—์„œ ๋กœ๊ทธ ์ด๋ฒคํŠธ์— ๋Œ€ํ•œ ์ž˜๋ชป ๋ ˆ์ด๋ธ”์ด ์ง€์ •๋œ ์ธก์ •, ๋กœ๊ทธ ์ด๋ฒคํŠธ ๋ฒ„์ „์„ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jeffalder ๋‹˜์ด 2680๋ฒ„์ „์—์„œ ์ตœ๋Œ€ ์†์„ฑ ๊ฐ’์— ๋Œ€ํ•œ ๋กœ๊น… ๋ฉ”์‹œ์ง€๋ฅผ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2583์—์„œ ์ˆ˜์ •ํ•œ ํŠธ๋ ˆ์ด์Šค ๋น„์œจ ์ƒ˜ํ”Œ๋Ÿฌ ์šฐ์„ ์ˆœ์œ„

์ด์‚ฌ

  • @obenkenobi๊ฐ€ 2572๋ฒ„์ „์—์„œ ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” jdbc-inet-* ๋ชจ๋“ˆ์„ ์ œ๊ฑฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” java.completable-future-jdk8์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. ์ธก์ •, 2562๋…„ @obenkenobi ์ž‘์„ฑ
  • 2567๋…„@obenkenobi์˜ AWS ๋žฉ ์ธก์ •, ๋กœ๊ทธ ์ œ๊ฑฐ
  • @obenkenobi๊ฐ€ 2614์—์„œ jdbc-sybase-6 ๋ชจ๋“ˆ์„ ์ œ๊ฑฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2568๋…„@obenkenobi์˜ play 2.3 ์ธก์ •, ๋ฆฌ์†Œ์Šค ์ œ๊ฑฐ
  • ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” thrift-0.8์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. @obenkenobi๊ฐ€ 2569์— ๋งŒ๋“  ๋ชจ๋“ˆ
  • @obenkenobi๊ฐ€ 2570๋ฒ„์ „์—์„œ ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” Solr 4.0 ๋ฐ 5.0 ๋ชจ๋“ˆ์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.
  • ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” ๋ชจ๋“ˆ grails-1.3์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. @obenkenobi ๋‹˜์ด 2573๋…„์— ์ž‘์„ฑํ•จ
  • ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” hibernate-3.3 ๋ชจ๋“ˆ์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. @obenkenobi ๋‹˜์ด 2574๋…„์— ์ž‘์„ฑํ•จ
  • 2620๋…„์— @sharvath-newrelic์ด ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ๋ฐ”๋‹ฅ API ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.
  • @obenkenobi๊ฐ€ 2561๋ฒ„์ „์—์„œ ์ œ๊ฑฐํ•œ, ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” Struts 1 ํฌ์ธํŠธ์ปท์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.
  • @sharvath-newrelic์ด 2575๋ฒ„์ „์—์„œ ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” ๋ชจ๋“ˆ glassfish-3์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.
  • @obenkenobi๊ฐ€ 2571๋ฒ„์ „์—์„œ ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” rabbit-amqp ๋ชจ๋“ˆ 2.5.0, 2.4.1, 1.7.2๋ฅผ ์ œ๊ฑฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2589๋ฒ„์ „์—์„œ ๋ฐฐํฌ ๋งˆ์ปค ๊ธฐ๋Šฅ์„ ์ œ๊ฑฐํ–ˆ์Šต๋‹ˆ๋‹ค.

์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ

ํ˜„์žฌ ์‚ฌ์šฉ ์ค‘์ธ Java ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ์‹๋ณ„ํ•˜๋ ค๋ฉด java -jar newrelic.jar -v ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. Java ์—์ด์ „ํŠธ ๋ฒ„์ „์ด ์ฝ˜์†”์— ์ธ์‡„๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋Ÿฐ ๋‹ค์Œ ์ตœ์‹  Java ์—์ด์ „ํŠธ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด ๋‹ค์Œ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  1. ์ „์ฒด Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฅผ ๋‹ค๋ฅธ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ํ•ด๋‹น ๋””๋ ‰ํ† ๋ฆฌ์˜ ์ด๋ฆ„์„ NewRelic_Agent#.#.# ์œผ๋กœ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ #.#.# ์€ ์—์ด์ „ํŠธ ๋ฒ„์ „ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.
  2. ์—์ด์ „ํŠธ๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.
  3. ์ƒˆ ์—์ด์ „ํŠธ ๋‹ค์šด๋กœ๋“œ ํŒŒ์ผ์˜ ์••์ถ•์„ ํ‘ผ ๋‹ค์Œ newrelic-api.jar ๋ฐ newrelic.jar ์„ ์›๋ž˜ Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ ์— ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
  4. ์ด์ „ newrelic.yml ์„ zip์—์„œ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•œ newrelic.yml ๊ณผ ๋น„๊ต ํ•˜๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค .
  5. Java ๋””์ŠคํŒจ์ฒ˜๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์‹ญ์‹œ์˜ค.

Java ์—์ด์ „ํŠธ ์—…๋ฐ์ดํŠธ ํ›„ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ๋ฐฑ์—…๋œ New Relic ์—์ด์ „ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋ณต์›ํ•˜์‹ญ์‹œ์˜ค.

์—์ด์ „ํŠธ ๊ตฌ์„ฑ ์ฐจ์ด์  ์—…๋ฐ์ดํŠธ

์—์ด์ „ํŠธ์˜ ์ƒˆ ๋ฒ„์ „์„ ์ถœ์‹œํ•  ๋•Œ newrelic.yml ์— ์ƒˆ ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.diff ๋˜๋Š” ๋‹ค๋ฅธ diffing ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ์‚ฌํ•ญ์„ ํ™•์ธํ•˜๊ณ  ์ด์ „ ํŒŒ์ผ์— ์ƒˆ ๊ตฌ์„ฑ ์„ค์ •์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.๋ผ์ด์„ผ์Šค ํ‚ค, ์•ฑ ์ด๋ฆ„ ๋˜๋Š” ๊ธฐ๋ณธ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ๊ณผ ๊ฐ™์ด ํŒŒ์ผ์— ๋Œ€ํ•ด ์ˆ˜ํ–‰ํ•œ ์‚ฌ์šฉ์ž ์ •์˜๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ํ•˜์‹ญ์‹œ์˜ค.

์˜ˆ๋ฅผ ๋“ค์–ด, ื™ืื ื™ ๋ฒ„์ „ 7.10.0 ๋ฐ 7.11.0์— ๋Œ€ํ•œ ๊ธฐ๋ณธ newrelic.yml ํŒŒ์ผ์„ diff ํ•˜๋Š” ๊ฒฝ์šฐ ์ฝ˜์†”์— ์ธ์‡„๋œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

โžœ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
> # Whether the log events should include context from loggers with support for that.
> context_data:
>
> # When true, application logs will contain context data.
> enabled: false
>
> # A comma separated list of attribute keys whose values should be sent to New Relic.
> #include:
>
> # A comma separated list of attribute keys whose values should not be sent to New Relic.
> #exclude:
>
125a138
>
128c141
< enabled: false
---
> enabled: true
...

์ด ์˜ˆ์—์„œ ์ด๋Ÿฌํ•œ ์ค„์€ ื™ืื ๋ฒ„์ „ 7.11.0์˜ ๊ธฐ๋ณธ newrelic.yml ์— ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 7.11.0 ์ด์ƒ์œผ๋กœ ์ด๋™ํ•˜๋Š” ๊ฒฝ์šฐ ์›๋ž˜ newrelic.yml ์— ์ด๋Ÿฌํ•œ ์ƒˆ ์ค„์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ง€์ง€ ์„ฑ๋ช…:

  • ๋‰ด๋ ๋ฆญ์€ ์—์ด์ „ํŠธ๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ์ตœ์‹  ๊ธฐ๋Šฅ๊ณผ ์„ฑ๋Šฅ ์ด์ ์„ ์–ป์„ ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ, ์ด์ „ ๋ฆด๋ฆฌ์Šค๋Š” ์ง€์› ์ข…๋ฃŒ ์‹œ์  ์— ๋” ์ด์ƒ ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

December 17, 2025
Java agent v8.25.1

์ˆ˜์ • ์‚ฌํ•ญ

  • Kotlin ์ฝ”๋ฃจํ‹ด์—์„œ ํƒ€์‚ฌ ๊ตฌํ˜„ ๊ด€๋ จ ์˜ค๋ฅ˜๋ฅผ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค. CancellableContinuation

์‚ฌ์šฉ ์ค‘๋‹จ

  • aws-wrap-0.7.0
  • java.completable-future-jdk8
  • play-2.3
  • netty-3.4
  • Struts v1
  • spring-3.0.0
  • thrift-0.8
  • solr-4.0.0
  • solr-5.0.0
  • jdbc-inet-merlia
  • jdbc-inet-oranxo
  • grails-1.3
  • rabbit-amqp-1.7.2
  • rabbit-amqp-2.4.1
  • rabbit-amqp-2.5.0
  • rabbit-amqp-2.7.0
  • glassfish-3
  • hibernate-3.3
  • hibernate-3.5
  • jdbc-jtds

์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ

ํ˜„์žฌ ์‚ฌ์šฉ ์ค‘์ธ Java ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ์‹๋ณ„ํ•˜๋ ค๋ฉด java -jar newrelic.jar -v ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. Java ์—์ด์ „ํŠธ ๋ฒ„์ „์ด ์ฝ˜์†”์— ์ธ์‡„๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋Ÿฐ ๋‹ค์Œ ์ตœ์‹  Java ์—์ด์ „ํŠธ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด ๋‹ค์Œ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  1. ์ „์ฒด Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฅผ ๋‹ค๋ฅธ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ํ•ด๋‹น ๋””๋ ‰ํ† ๋ฆฌ์˜ ์ด๋ฆ„์„ NewRelic_Agent#.#.# ์œผ๋กœ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ #.#.# ์€ ์—์ด์ „ํŠธ ๋ฒ„์ „ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.
  2. ์—์ด์ „ํŠธ๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.
  3. ์ƒˆ ์—์ด์ „ํŠธ ๋‹ค์šด๋กœ๋“œ ํŒŒ์ผ์˜ ์••์ถ•์„ ํ‘ผ ๋‹ค์Œ newrelic-api.jar ๋ฐ newrelic.jar ์„ ์›๋ž˜ Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ ์— ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
  4. ์ด์ „ newrelic.yml ์„ zip์—์„œ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•œ newrelic.yml ๊ณผ ๋น„๊ต ํ•˜๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค .
  5. Java ๋””์ŠคํŒจ์ฒ˜๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์‹ญ์‹œ์˜ค.

Java ์—์ด์ „ํŠธ ์—…๋ฐ์ดํŠธ ํ›„ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ๋ฐฑ์—…๋œ New Relic ์—์ด์ „ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋ณต์›ํ•˜์‹ญ์‹œ์˜ค.

์—์ด์ „ํŠธ ๊ตฌ์„ฑ ์ฐจ์ด์  ์—…๋ฐ์ดํŠธ

์—์ด์ „ํŠธ์˜ ์ƒˆ ๋ฒ„์ „์„ ์ถœ์‹œํ•  ๋•Œ newrelic.yml ์— ์ƒˆ ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.diff ๋˜๋Š” ๋‹ค๋ฅธ diffing ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ์‚ฌํ•ญ์„ ํ™•์ธํ•˜๊ณ  ์ด์ „ ํŒŒ์ผ์— ์ƒˆ ๊ตฌ์„ฑ ์„ค์ •์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.๋ผ์ด์„ผ์Šค ํ‚ค, ์•ฑ ์ด๋ฆ„ ๋˜๋Š” ๊ธฐ๋ณธ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ๊ณผ ๊ฐ™์ด ํŒŒ์ผ์— ๋Œ€ํ•ด ์ˆ˜ํ–‰ํ•œ ์‚ฌ์šฉ์ž ์ •์˜๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ํ•˜์‹ญ์‹œ์˜ค.

์˜ˆ๋ฅผ ๋“ค์–ด, ื™ืื ื™ ๋ฒ„์ „ 7.10.0 ๋ฐ 7.11.0์— ๋Œ€ํ•œ ๊ธฐ๋ณธ newrelic.yml ํŒŒ์ผ์„ diff ํ•˜๋Š” ๊ฒฝ์šฐ ์ฝ˜์†”์— ์ธ์‡„๋œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

โžœ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
> # Whether the log events should include context from loggers with support for that.
> context_data:
>
> # When true, application logs will contain context data.
> enabled: false
>
> # A comma separated list of attribute keys whose values should be sent to New Relic.
> #include:
>
> # A comma separated list of attribute keys whose values should not be sent to New Relic.
> #exclude:
>
125a138
>
128c141
< enabled: false
---
> enabled: true
...

์ด ์˜ˆ์—์„œ ์ด๋Ÿฌํ•œ ์ค„์€ ื™ืื ๋ฒ„์ „ 7.11.0์˜ ๊ธฐ๋ณธ newrelic.yml ์— ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 7.11.0 ์ด์ƒ์œผ๋กœ ์ด๋™ํ•˜๋Š” ๊ฒฝ์šฐ ์›๋ž˜ newrelic.yml ์— ์ด๋Ÿฌํ•œ ์ƒˆ ์ค„์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ง€์ง€ ์„ฑ๋ช…:

  • ๋‰ด๋ ๋ฆญ์€ ์—์ด์ „ํŠธ๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ์ตœ์‹  ๊ธฐ๋Šฅ๊ณผ ์„ฑ๋Šฅ ์ด์ ์„ ์–ป์„ ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ, ์ด์ „ ๋ฆด๋ฆฌ์Šค๋Š” ์ง€์› ์ข…๋ฃŒ ์‹œ์  ์— ๋” ์ด์ƒ ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

November 12, 2025
Java agent v8.25.0

์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ๋ฐ ๊ฐœ์„  ์‚ฌํ•ญ

  • 2512๋…„์— @deleonenriqueta๊ฐ€ 25 ์ง€์›์„ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2535์— Logback-1.5.20์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2490๋…„์— call ๋ฐ exec SQL ํŒŒ์„œ ์ •๊ทœ ํ‘œํ˜„์‹ ์‹คํ–‰์„ ๋น„ํ™œ์„ฑํ™”ํ•˜๋Š” ๊ตฌ์„ฑ ์˜ต์…˜์„ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.
  • @dhilpipre๊ฐ€ 2454๋…„์— Kotlin Coroutines v1.4+์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @dhilpipre๊ฐ€ 2456๋…„์— Kotlin Coroutines ์™ธ๋ถ€์—์„œ ์ƒ์„ฑํ•œ Kotlin Coroutines Suspend ํ•จ์ˆ˜์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  • @jbedell-newrelic์ด 2508๋…„์— ๋ฐ์ดํ„ฐ์Šคํ† ์–ด๋ฅผ ๊ฐ์ง€ํ•˜๋Š” ๋™์•ˆ ์—ฌ๋Ÿฌ ํ˜ธ์ŠคํŠธ์— ๋Œ€ํ•œ ๊ธฐ๋ณธ ์„ค์ • ๊ตฌ์„ฑ์„ ๋„์ž…ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2509๋…„์— ์•„ํ‹ฐํŒฉํŠธ ๊ฑด๋„ˆ๋›ฐ๊ธฐ ๊ธฐ๋Šฅ์„ ๊ตฌ์„ฑํ•˜๊ธฐ ์œ„ํ•œ ์‹œ์Šคํ…œ ์†์„ฑ์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  • @sharvath-newrelic์ด 2532๋…„์— ์ปจํŠธ๋กค๋Ÿฌ ํด๋ž˜์Šค ์ด๋ฆ„๊ณผ ๋ฉ”์„œ๋“œ ์ด๋ฆ„์„ ์‚ฌ์šฉํ•˜์—ฌ Spring Controller ํŠธ๋žœ์žญ์…˜์˜ ์ด๋ฆ„์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜๋Š” ์„ค์ • ์˜ต์…˜์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  • @jasonjkeller๊ฐ€ 2529๋…„์— ๋ชจ๋“  distributed_tracing.sampler ๊ตฌ์„ฑ์„ SamplerConfig ๋กœ ์ค‘์•™ํ™”ํ•˜์—ฌ SamplerConfig๋ฅผ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2516๋…„@sharvath-newrelic์˜ W3C Trace Context ์ง€์›๊ณผ ํ•จ๊ป˜ ํ˜„๋Œ€์ ์ธ ๋ณ€ํ™˜๊ธฐ ์ถ”์  API๋ฅผ ์‚ฌ์šฉํ•˜๋„๋ก kafka-clients-spans-0.11.0.0 ์ƒ์‚ฐ์ž ์ธก์ •, ํŠธ๋žœ์žญ์…˜์„ ์—…๋ฐ์ดํŠธํ–ˆ์Šต๋‹ˆ๋‹ค.

์ˆ˜์ • ์‚ฌํ•ญ

  • 2497๋…„@sharvath-newrelic์˜ ์˜ค๋ฅ˜ ํด๋ž˜์Šค ์ด๋ฆ„ ๊ตฌ๋ฌธ ๋ถ„์„์„ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • @jtduffy๊ฐ€ 2498๋…„์— ์˜ค๋ฅ˜ ๋กœ๊น…์—์„œ ์ง€๋‚˜์น˜๊ฒŒ ํฐ ์Šคํƒ ์ถ”์ ์œผ๋กœ ์ธํ•ด ๋ฐœ์ƒํ•œ ์ž ์žฌ์ ์ธ ๋ฉ”๋ชจ๋ฆฌ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • 2501๋…„ @sharvath-newrelic์— ์˜ํ•œ ๋งž์ถคํ˜• ๋Œ€์‹œ๋ณด๋“œ ๋ฐ ๋กœ๊น… ์ด๋ฒคํŠธ์˜ ์œ ํšจํ•˜์ง€ ์•Š์€ ์†์„ฑ์— ๋Œ€ํ•œ ๋กœ๊น… ๋ฉ”์‹œ์ง€๋ฅผ ๋ช…ํ™•ํžˆ ํ–ˆ์Šต๋‹ˆ๋‹ค.

์‚ฌ์šฉ ์ค‘๋‹จ

๋‹ค์Œ ์ธก์ •, ๊ณ„์ธก ๋ชจ๋“ˆ์€ ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š์œผ๋ฉฐ ๋‹ค์Œ ์ฃผ์š” ๋ฆด๋ฆฌ์Šค์—์„œ ์ œ๊ฑฐ๋  ์˜ˆ์ •์ž…๋‹ˆ๋‹ค.

  • aws-wrap-0.7.0
  • java.completable-future-jdk8
  • play-2.3
  • netty-3.4
  • Struts v1
  • spring-3.0.0
  • thrift-0.8
  • solr-4.0.0
  • solr-5.0.0
  • jdbc-inet-merlia
  • jdbc-inet-oranxo
  • grails-1.3
  • rabbit-amqp-1.7.2
  • rabbit-amqp-2.4.1
  • rabbit-amqp-2.5.0
  • rabbit-amqp-2.7.0
  • glassfish-3
  • hibernate-3.3
  • hibernate-3.5
  • jdbc-jtds

์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ

ํ˜„์žฌ ์‚ฌ์šฉ ์ค‘์ธ Java ์—์ด์ „ํŠธ ๋ฒ„์ „์„ ์‹๋ณ„ํ•˜๋ ค๋ฉด java -jar newrelic.jar -v ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. Java ์—์ด์ „ํŠธ ๋ฒ„์ „์ด ์ฝ˜์†”์— ์ธ์‡„๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋Ÿฐ ๋‹ค์Œ ์ตœ์‹  Java ์—์ด์ „ํŠธ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด ๋‹ค์Œ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  1. ์ „์ฒด Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฅผ ๋‹ค๋ฅธ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ํ•ด๋‹น ๋””๋ ‰ํ† ๋ฆฌ์˜ ์ด๋ฆ„์„ NewRelic_Agent#.#.# ์œผ๋กœ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ #.#.# ์€ ์—์ด์ „ํŠธ ๋ฒ„์ „ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.
  2. ์—์ด์ „ํŠธ๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.
  3. ์ƒˆ ์—์ด์ „ํŠธ ๋‹ค์šด๋กœ๋“œ ํŒŒ์ผ์˜ ์••์ถ•์„ ํ‘ผ ๋‹ค์Œ newrelic-api.jar ๋ฐ newrelic.jar ์„ ์›๋ž˜ Java ์—์ด์ „ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ ์— ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค.
  4. ์ด์ „ newrelic.yml ์„ zip์—์„œ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•œ newrelic.yml ๊ณผ ๋น„๊ต ํ•˜๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค .
  5. Java ๋””์ŠคํŒจ์ฒ˜๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์‹ญ์‹œ์˜ค.

Java ์—์ด์ „ํŠธ ์—…๋ฐ์ดํŠธ ํ›„ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ๋ฐฑ์—…๋œ New Relic ์—์ด์ „ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋ณต์›ํ•˜์‹ญ์‹œ์˜ค.

์—์ด์ „ํŠธ ๊ตฌ์„ฑ ์ฐจ์ด์  ์—…๋ฐ์ดํŠธ

์—์ด์ „ํŠธ์˜ ์ƒˆ ๋ฒ„์ „์„ ์ถœ์‹œํ•  ๋•Œ newrelic.yml ์— ์ƒˆ ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.diff ๋˜๋Š” ๋‹ค๋ฅธ diffing ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ์‚ฌํ•ญ์„ ํ™•์ธํ•˜๊ณ  ์ด์ „ ํŒŒ์ผ์— ์ƒˆ ๊ตฌ์„ฑ ์„ค์ •์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.๋ผ์ด์„ผ์Šค ํ‚ค, ์•ฑ ์ด๋ฆ„ ๋˜๋Š” ๊ธฐ๋ณธ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ๊ณผ ๊ฐ™์ด ํŒŒ์ผ์— ๋Œ€ํ•ด ์ˆ˜ํ–‰ํ•œ ์‚ฌ์šฉ์ž ์ •์˜๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ํ•˜์‹ญ์‹œ์˜ค.

์˜ˆ๋ฅผ ๋“ค์–ด, ื™ืื ื™ ๋ฒ„์ „ 7.10.0 ๋ฐ 7.11.0์— ๋Œ€ํ•œ ๊ธฐ๋ณธ newrelic.yml ํŒŒ์ผ์„ diff ํ•˜๋Š” ๊ฒฝ์šฐ ์ฝ˜์†”์— ์ธ์‡„๋œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

โžœ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
> # Whether the log events should include context from loggers with support for that.
> context_data:
>
> # When true, application logs will contain context data.
> enabled: false
>
> # A comma separated list of attribute keys whose values should be sent to New Relic.
> #include:
>
> # A comma separated list of attribute keys whose values should not be sent to New Relic.
> #exclude:
>
125a138
>
128c141
< enabled: false
---
> enabled: true
...

์ด ์˜ˆ์—์„œ ์ด๋Ÿฌํ•œ ์ค„์€ ื™ืื ๋ฒ„์ „ 7.11.0์˜ ๊ธฐ๋ณธ newrelic.yml ์— ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค. 7.11.0 ์ด์ƒ์œผ๋กœ ์ด๋™ํ•˜๋Š” ๊ฒฝ์šฐ ์›๋ž˜ newrelic.yml ์— ์ด๋Ÿฌํ•œ ์ƒˆ ์ค„์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ง€์ง€ ์„ฑ๋ช…:

  • ๋‰ด๋ ๋ฆญ์€ ์—์ด์ „ํŠธ๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ์ตœ์‹  ๊ธฐ๋Šฅ๊ณผ ์„ฑ๋Šฅ ์ด์ ์„ ์–ป์„ ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ, ์ด์ „ ๋ฆด๋ฆฌ์Šค๋Š” ์ง€์› ์ข…๋ฃŒ ์‹œ์  ์— ๋” ์ด์ƒ ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

Copyright ยฉ 2026 New Relicๆ ชๅผไผš็คพใ€‚

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.