Java 에이전트 및 Heroku

Heroku 는 Java를 포함한 다양한 에이전트 언어로 웹 애플리케이션을 호스팅하기 위한 PaaS(Platform as a Service) 솔루션입니다. New Relic을 사용하면 APM 또는 브라우저 모니터링 의 메트릭으로 Heroku를 확장할 수 있습니다.

팁

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

호환성 및 요구 사항

자바 7 이상
Maven 3 이상(Maven을 사용하는 경우)
최신 New Relic Java 에이전트 버전

1. Heroku에서 New Relic 에이전트 애드온 활성화

요구 사항을 충족 하는지 확인한 후 Heroku에서 New Relic 에이전트 추가 기능을 활성화합니다.

주의

New Relic 에이전트 추가 기능을 활성화하기 전에 최소한 앱 배포 단계를 통해 Heroku 지침에 따라 Heroku에 Java 앱을 배포 해야 합니다.

Heroku 계정에 로그인합니다.
APM 추가 기능 페이지 에서 구독 계획을 선택합니다.
APM 설치 를 선택한 다음 드롭다운에서 대상 앱을 선택합니다.

추가 기능을 설치하면 자동으로 New Relic 계정이 생성되고 Heroku 서버에 대한 액세스가 구성됩니다.

2. jar 파일의 경로 제공

New Relic 에이전트 추가 기능을 활성화 한 후 javaagent 플래그를 java 프로세스에 전달하고 Procfile 를 편집하여 jar 파일의 경로를 제공합니다.

Heroku에 배포하는 경우 Maven 및 수동 구성 모두에 대한 jar 파일의 위치는 newrelic 디렉토리에 있는 앱의 루트 폴더에 있습니다.

예시:

web: java -javaagent:/app/newrelic/newrelic.jar -jar target/HELLOWORLD.jar

로컬로 배포하는 경우 jar 파일이 다른 디렉터리에 있을 수 있습니다. 그렇다면 PATH/TO/NEWRELIC.JAR 로컬 디렉터리의 jar 파일 경로로 바꿉니다.

예시:

web: java -javaagent:PATH/TO/NEWRELIC.JAR -jar target/HELLOWORLD.jar

3. New Relic을 위한 Heroku 환경 구성

jar 파일에 대한 경로를 제공 한 후 플랫폼에 따라 New Relic에 대한 Heroku 환경을 구성합니다.

이 Heroku 도구 벨트 명령을 사용하여 앱에 의미 있는 이름 을 지정하십시오.
bash
```
$heroku config:set NEW_RELIC_APP_NAME="APP_NAME"
```
추가 :
bash
```
$heroku config:set NEW_RELIC_LICENSE_KEY="LICENSE_KEY"
```
pom.xml 에서 X.Y.Z 를 최신 자바 에이전트 버전 으로 대체하여 newrelic-agent 종속성을 추가합니다. 권장 사항: 적절한 형식이 적용되고 콘텐츠에 민감한 정보가 포함되지 않도록 하려면 http://codebeautify.org/xmlviewer 를 사용하여 구문 형식을 지정하십시오.
```
<dependency> 

    <groupId>com.newrelic.agent.java</groupId>
    <artifactId>newrelic-java</artifactId>
    <version>X.Y.Z</version>
    <scope>provided</scope>
    <type>zip</type>

</dependency>
```

pom.xml 의 <build> 요소에서 에이전트를 다운로드하도록 빌드를 사용자 지정합니다.

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.0.2</version>
    <executions>
        <execution>
          <id>unpack-newrelic</id>
          <phase>package</phase>
          <goals>
              <goal>unpack-dependencies</goal>
          </goals>
          <configuration>
              <includeGroupIds>com.newrelic.agent.java</includeGroupIds>
              <includeArtifactIds>newrelic-java</includeArtifactIds>
              <overWriteReleases>false</overWriteReleases>
              <overWriteSnapshots>false</overWriteSnapshots>
              <overWriteIfNewer>true</overWriteIfNewer>
              <outputDirectory>${project.basedir}</outputDirectory>
              <destFileName>newrelic</destFileName>
          </configuration>
        </execution>
    </executions>
</plugin>

4. 변경 사항을 푸시하고 앱을 엽니다.

New Relic에 대한 Heroku 환경을 구성한 후 변경 사항을 푸시하고 앱을 열어 New Relic으로 모니터링하십시오.

이 Heroku toolbelt 명령을 사용하여 변경 사항을 dyno에 푸시합니다.
bash
```
$git add .
$git commit -m 'YOUR COMMIT MESSAGE'
$git push heroku master
```
다음 Heroku 도구 벨트 명령을 사용하여 브라우저에서 앱을 엽니다.
bash
```
$heroku open
```
앱에 약간의 트래픽을 생성하고 몇 분 정도 기다리십시오.
앱을 선택한 다음 New Relic 추가 기능을 선택하여 Heroku에서 앱의 성능을 확인하십시오.

데이터가 표시되지 않거나 문제가 있는 경우 문제 해결 팁을 따르십시오.

문제 해결

다음은 문제 해결에 도움이 되는 몇 가지 팁입니다.

트래픽을 생성한 후 New Relic 추가 기능이 표시되지 않으면 Heroku로 이동하여 추가 추가 기능 찾기 를 선택하고 APM 추가 기능을 추가하십시오.
몇 분 동안 기다린 후에도 데이터가 나타나지 않으면 Heroku(Java)에 대한 문제 해결 절차를 따르십시오.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

팁

호환성 및 요구 사항

1. Heroku에서 New Relic 에이전트 애드온 활성화

주의

2. jar 파일의 경로 제공

Heroku에 배포

로컬로 배포

3. New Relic을 위한 Heroku 환경 구성

메이븐 구성

수동 구성

4. 변경 사항을 푸시하고 앱을 엽니다.

문제 해결