• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

스칼라 계측

|View as Markdown (English)

New Relic Java 에이전트는 Scala와 호환되며 New Relic API 호출, 주석 및 사용자 정의 계측 을 지원합니다. 아래의 모든 정보는 New Relic의 Java 에이전트 설치 지침 을 보완합니다.

팁

Heroku의 경우 Heroku에서 Scala를 사용하는 Java 에이전트를 참조하세요.

스칼라 프레임워크

프레임워크 가 기본적으로 New Relic에서 지원되지 않거나 추가 모니터링을 설정하려는 경우 사용자 지정 계측 은 애플리케이션을 더 깊이 파고들 수 있는 좋은 방법입니다.

Scala API로 Scala 계측

New Relic Scala 에이전트 API를 사용하면 관용적인 Scala 코드를 사용하여 APM Java 에이전트의 기능을 제어, 사용자 지정 및 확장할 수 있습니다. New Relic Java API 와 함께 사용할 수 있을 뿐만 아니라 사용자가

  • 동기 및 비동기 익명 함수에 대한 세그먼트 만들기
  • 동기 및 비동기 코드 블록에 대한 세그먼트 생성
  • 트랜잭션이 아직 시작되지 않은 경우 생성

중요

API를 사용할 때 최상의 결과를 얻으려면 최신 Java 에이전트 릴리스가 있는지 확인하십시오. New Relic Scala API를 사용하려면 Java 에이전트 7.1.0 이상이 필요합니다.

스칼라 API 사용

API 클래스에 액세스하려면 Scala 구성 파일에 다음 정보를 추가하십시오.

지원되는 Scala 버전은 2.10, 2.11, 2.12 및 2.13입니다. Scala 3.0 사용자는 2.13 jar를 사용할 수 있습니다. jar는 Maven Central에 배포되며 New Relic Java 에이전트의 설치 zip 파일에도 있습니다. Java 에이전트가 실행되고 있지 않을 때 API를 호출할 수 있습니다. 기본 API 메서드는 스텁일 뿐입니다. Java 에이전트가 실행 중일 때 구현이 추가됩니다.

세그먼트

동기 코드 블록에 대한 세그먼트를 생성하려면 TraceOps.trace 을 사용합니다. 예를 들어:

import com.newrelic.scala.api.TraceOps.trace
trace("statement segment") {
val i = 1
val j = 2
println(i + j)
}
// trace can also be used as an expression
val x: Int = trace("expression segment") {
val i = 1
val j = 2
i + j
}
println(x) // 2

trace 이해를 위해 Scala에서도 사용할 수 있습니다.

import scala.concurrent.{ExecutionContext, Future}
import com.newrelic.scala.api.TraceOps.trace
// implicit execution
implicit val ec: ExecutionContext = ???
val x: Option[Int] = for {
one <- trace("segment one")(Option(1))
two <- trace("segment two")(Option(one + 1))
three <- trace("segment three")(Option(two + 1))
} yield three
println(x) // Some(3)

Scala Future를 포함하는 비동기 코드 블록에 대한 세그먼트를 생성하려면 TraceOps.asyncTrace 을 사용합니다. 이렇게 하면 세그먼트의 타이밍에 Future가 완료되는 데 걸리는 시간이 포함됩니다.

아래 예에서 세그먼트 시간은 래핑된 Future에서 생성된 지연으로 인해 5초 이상입니다.

import scala.concurrent.{ExecutionContext, Future}
import com.newrelic.scala.api.TraceOps.asyncTrace
// implicit execution
implicit val ec: ExecutionContext = ???
val x: Future[Int] = asyncTrace("segment name")(Future {
Thread.sleep(5000)
1
})
x.foreach(println) // prints 1 on completion of Future

asyncTrace 이해를 위해 Scala에서도 사용할 수 있습니다.

import scala.concurrent.{ExecutionContext, Future}
import com.newrelic.scala.api.TraceOps.asyncTrace
// implicit execution
implicit val ec: ExecutionContext = ???
val x: Future[Int] = for {
one <- asyncTrace("segment one")(Future(1))
two <- asyncTrace("segment two")(Future(one + 1))
three <- asyncTrace("segment three")(Future(two + 1))
} yield three
x.foreach(println) // prints 3 on completion of Future

동기식 익명 함수에 대한 세그먼트를 생성하려면 TraceOps.traceFun 을 사용합니다. 예를 들어:

import com.newrelic.scala.api.TraceOps.traceFun
val x: Option[Int] = Option(1)
.map(traceFun("statement segment")(i => i + 1))
println(x) //Some(2)

Scala Future를 반환하는 비동기 함수에 대한 세그먼트를 생성하려면 TraceOps.asyncTraceFun 을 사용합니다. 이렇게 하면 세그먼트의 타이밍에 기능이 완료되는 데 걸리는 시간이 포함됩니다.

아래 예에서 세그먼트 시간은 래핑된 Future에서 생성된 지연으로 인해 5초 이상입니다.

import scala.concurrent.{ExecutionContext, Future}
import com.newrelic.scala.api.TraceOps.asyncTraceFun
// implicit execution
implicit val ec: ExecutionContext = ???
val x: Future[Int] = Future(1)
.flatMap(asyncTraceFun("statement segment")(i => Future(i + 1)))
x.foreach(println) // prints 2 on completion of Future

업무

TraceOps.txn 메소드를 사용하여 트랜잭션을 생성할 수 있습니다. 예를 들어:

import com.newrelic.scala.api.TraceOps.txn
txn {
val i = 1
val j = 2
println(i + j)
}

txn 진술(위와 같이) 또는 표현식으로 사용할 수 있습니다.

import com.newrelic.scala.api.TraceOps.txn
val i: Int = txn(1 + 2) //transaction created
println(i) // 3

txn 모든 TraceOp 메서드와 함께 사용하여 세그먼트를 만들 수 있습니다. 아래 예에서는 3개의 세그먼트가 있는 트랜잭션을 생성합니다.

import scala.concurrent.{ExecutionContext, Future}
import com.newrelic.scala.api.TraceOps.{txn, asyncTrace}
// implicit execution
implicit val ec: ExecutionContext = ???
val x: Future[Int] = txn(
for {
one <- asyncTrace("segment one")(Future(1))
two <- asyncTrace("segment two")(Future(one + 1))
three <- asyncTrace("segment three")(Future(two + 1))
} yield three
)
x.foreach(println) // prints 3 on completion of Future

선물

뉴렐릭은 실행자에게 제출될 때 Scala 퓨처를 처리하는데, 이로 인해 예상과 다른 결과가 발생할 수 있습니다. 이 섹션의 예제는 이것이 어떻게 작동하는지 명확하게 설명하여 무엇을 기대해야 할지 알 수 있도록 해줍니다.

이 예는 미래를 실행으로 삼고 두 번째 미래에 바인딩하는 소니 블록을 호출하고 있습니다.

def chainFutures(f: Future[Unit]) = txn {
f.flatMap( _ => Future{ Thread.sleep(2000) })
}
val f = Future { Thread.sleep(5000) } // future is submitted here
chainFutures(f)

이 예에서 chainFutures 이 7초 동안 지속되는 메시지를 생성할 것으로 예상할 수 있습니다. 대신 뉴렐릭 UI 프로세서가 즉시 종료되는 것을 보여줍니다.

이 예에서 미래 f 트랜잭션이 존재하기 전에 생성될 때 Future.apply() 메서드에 의해 제출됩니다. f 트랜잭션 외부에 제출되므로 실행 중에 생성된 스레드 홉은 서로 연결되지 않습니다. 다운스트림 미래 Future{ Thread.sleep(2000) } 도 추적되지 않습니다. 이는 트랜잭션 컨텍스트가 이미 사라진 후 콜백에 제출되었기 때문입니다.

두 가지 미래의 타이밍을 포착하기 위해 할 수 있는 몇 가지 방법이 있습니다.

  • f 이 제출되는 시점을 변경할 수는 없지만 asyncTrace 메서드를 사용하여 시간을 정할 수 있습니다. 트랜잭션이 시작된 순간부터 f 곱합니다(하지만 f 에 의해 만들어진 스레드 홉은 추적하지 않습니다).
  • 스레드 홉 중에 트랜잭션 컨텍스트를 보존하기 위해 토큰을 사용하여 콜백을 트랜잭션에 연결할 수 있습니다.
  • 두 번째 미래의 시간을 측정하기 위해 asyncTrace 추가할 수 있습니다.

이 예를 통해 뉴렐릭 UI 약 7초 동안 지속되는 aC를 보여주며, 두 세그먼트는 "첫 번째 미래"와 "두 번째 미래"로 명명되었습니다.

def chainFutures(f: Future[Unit]) = txn {
val t = NewRelic.getAgent.getTransaction.getToken
asyncTrace("future one" )(f) //asyncTrace times the first future
.flatMap(_ => {
t.linkAndExpire() //token links across potential threadhops
asyncTrace("future two"){ Future { Thread.sleep(2000) } } //asyncTrace times the second future
})
}
val f = Future { Thread.sleep(5000) }
chainFutures(f)

Java 에이전트 API로 Scala 계측

New Relic API 클래스 또는 주석 을 사용하도록 Scala를 계측합니다.

  1. Scala 구성 파일에 다음 정보를 추가합니다.

  2. NewRelic 클래스를 가져와 애플리케이션에서 사용합니다.

    import com.newrelic.api.agent.NewRelic
    ...
    NewRelic.setTransactionName(null, "/myTransaction");

더 많은 API 기능

Java 에이전트 API 및 해당 기능에 대한 자세한 내용은 Java 에이전트 API 소개 를 참조하십시오.

XML 인스트루먼테이션이 있는 인스트루먼트 스칼라

XML 계측은 Java 에이전트와 함께 실행되는 모든 Scala 애플리케이션에서 사용할 수 있습니다. 코드를 변경하지 않고 계측을 추가할 수 있습니다.

자세한 내용 은 XML을 통한 Java 계측을 참조하세요.

추가 계측

카몬을 사용하신다면 뉴레릭 카몬 리포터 를 참고하세요.

Copyright © 2026 New Relic Inc.

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