<commit_before>---

copyright:
  years: 2016
lastupdated: "2016-06-10"

---

{:new_window: target="_blank"}
{:codeblock: .codeblock}

# Dynatrace 사용
{: #using_dynatrace}

Dynatrace는 앱에 대한 모니터링을 제공하는 써드파티 서비스입니다. 

Dynatrace 서비스에서 제공하는 기능에 대한 자세한 정보는 [Dynatrace 애플리케이션 모니터링](http://www.dynatrace.com/en/products/application-monitoring.html)을 참조하십시오.

Liberty 애플리케이션이 Dynatrace를 사용하도록 구성될 때 기본 동작은 Liberty 런타임이 Dynatrace 사이트에서
Dynatrace 에이전트 jar 파일을 요구하고 해당 Dyntrace 에이전트를 사용자의 앱으로 실행하는 것입니다. 이러한 기본 동작에서 Dynatrace를 사용하기 위한 최소 필수 구성은 Dynatrace 콜렉터를 가리키는 사용자 제공 서비스를 작성하는 것입니다.

## Dynatrace 콜렉터를 가리키는 사용자 제공 서비스 작성

먼저, Dynatrace 콜렉터를 설정해야 합니다. 그런 다음 Dynatrace 콜렉터에 연결할 Dynatrace 에이전트에 대한 정보를 전달하는 사용자 제공 서비스를 작성해야 합니다. Dynatrace 컴포넌트 간의 관계에 대해 자세히 보려면 [Dynatrace 아키텍처](https://community.dynatrace.com/community/display/DOCDT63/Architecture)를 참조하십시오. 

<ol>
<li>Dynatrace 콜렉터를 설정하십시오. <ul>
  <li>Dynatrace 콜렉터 다운로드 및 설정에 대한 지시사항은 [Dynatrace 커뮤니티 웹 사이트](https://community.dynatrace.com/community/display/EVAL/Step+3+-+Connect+Agent+to+Dynatrace)를 참조하십시오. </li>
  <li>Bluemix의 앱에서 실행 중인 Dynatrace 에이전트에 액세스할 수 있는 위치에 콜렉터가 설치되었는지 확인하십시오. </li>
  </ul>
</li>
<li>실행 중인 Dynatrace 콜렉터를 가리키는 사용자 제공 서비스를 작성하십시오. <b>참고</b> 사용자 제공 서비스의 이름에는 <b>dynatrace</b>가 포함되어야 합니다. 예를 들어 다음과 같은 명령을 사용하십시오.
<pre>
$ cf cups my-dynatrace-collector -p '{"server":"DynatraceCollectorIPaddress","profile":"Monitoring"}'
  </pre>
  {: codeblock}

이 예에서 my-dynatrace-collector는 서비스에 지정된 이름이고, DynatraceCollectorIPaddress는 구성한 Dynatrace 콜렉터의 IP 주소이며, profile은 이 모니터되는 앱과 연관된 선택적 Dynatrace 프로파일 이름입니다. 기본 profile 값은 Monitoring입니다. 다음 예에서와 같이 선택적 매개변수를 지정할 수 있습니다.


  <pre>
  $ cf cups my-dynatrace-collector -p '{"server":"DynatraceCollectorIPaddress","profile":"Monitoring",
                                        "options" : {"dynatrace-parameter-1": "value",
                                                     "dynatrace-parameter-2": "value"}}'
  </pre>
  {: codeblock}

사용 가능한 옵션에 대한 자세한 정보는 Dynatrace 커뮤니티에서 [에이전트 구성의 에이전트 설정 섹션](https://community.dynatrace.com/community/display/DOCDT62/Agent+Configuration)을 참조하십시오. 예를 들어 제외 옵션을 사용하면 Dynatrace에서 모니터되지 않도록 클래스를 제외시킬 수 있습니다. 사용자 제공 서비스 구성에 대한 자세한 정보는 [DynaTrace 에이전트 프레임워크](https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack/blob/master/docs/framework-dynatrace-agent.md)를 참조하십시오. 
</li>
<li>Bluemix에 앱을 푸시한 후 앱에 작성한 사용자 제공 서비스를 바인드하십시오. 예를 들어 다음 명령을 사용하십시오.
<pre>
  $ cf bs myApp my-dynatrace-collector
  </pre>  
  {: codeblock}

**참고**: 서비스를 바인드한 후 애플리케이션을 다시 스테이징해야 합니다. 
</li>
</ol>

## 선택적 구성
{: #optional_configuration}

Dynatrace 에이전트 jar 파일을 직접 획득하여 호스트할 수 있습니다. 이 경우 다음과 같은 추가 구성 단계가 필요합니다. 
1. Liberty 빌드팩에서 다운로드할 수 있도록 Dynatrace 에이전트 jar 파일을 획득하여 호스트하십시오. 
2. Liberty 앱이 Dynatrace 에이전트를 다운로드할 수 있도록 Liberty 앱을 구성하십시오. 

### Dynatrace 에이전트 호스트
{: #hosting_dynatrace_agent}
Dynatrace 에이전트는 웹 서버에 호스트되어야 하며, Liberty 빌드팩이 서버에서 에이전트 jar 파일을 다운로드할 수 있어야 합니다. 서버는 에이전트 jar 파일에 대한 세부사항을 지정하는 index.yml 파일로 구성되어야 합니다. Dynatrace 에이전트를 설정하려면 다음 단계를 완료하십시오. 
  1. Dynatrace 에이전트 jar를 다운로드하십시오. Dynatrace 에이전트 jar 다운로드에 대한 지시사항은 Dynatrace 커뮤니티 웹 사이트에서 [Dynatrace 서버 플랫폼 설치 프로그램](https://community.dynatrace.com/community/display/EVAL/Step+1+-+Download+and+install+Dynatrace)을 참조하십시오. Bluemix에서 실행하기에 적절한 에이전트 jar 파일은 **dynatrace-agent-unix.jar** 버전 **6.+**입니다.
  2. Liberty 빌드팩이 다운로드할 수 있는 위치에 에이전트 jar 파일이 호스트되도록 하십시오. 사용 가능한 서버 기능을 사용하여 Bluemix 자체에서 이 파일을 호스트하거나, 일부 공용 사용 가능 위치에서 호스트할 수 있습니다. 
     * 호스트 위치에서 index.yml 파일을 제공하는지 확인하십시오. index.yml 파일에는 에이전트 jar 파일의 버전 ID(뒤에 콜론이 붙음)와 에이전트 jar 위치의 완전한 URL로 구성된 항목이 포함되어야 합니다. 예: 
```
      ---
      6.3.0: https://my-dynatrace-agent.mybluemix.net/dynatrace-agent-6.3.0-unix.jar
```  
{: codeblock}
     * **dynatrace-agent-6.3.0-unix.jar** 파일은 index.yml 파일에 지정된 위치에 있어야 합니다. jar 파일과 index.yml 파일의 위치가 동일한 디렉토리일 수 있습니다. 

### Liberty 앱 구성
{: #configuring_liberty_app}

이전에 설정한 에이전트 jar를 호스트하는 서버를 찾으려면 모니터할 Liberty 앱이 구성되어야 합니다. **JBP_CONFIG_DYNATRACEAGENT** 환경 변수를 사용하여 앱을 구성할 수 있습니다. **JBP_CONFIG_DYNATRACEAGENT** 환경 변수는 Dynatrace 에이전트를 다운로드할 소스 빌드팩을 알려줍니다. 이 환경 변수를 설정하려면 다음 단계를 완료하십시오. 
<ol>
   <li> **JBP_CONFIG_DYNATRACEAGENT** 변수에
*"repository_root: URL_of_server_hosting_index.yml"* 값을 설정하십시오. 예를 들어 애플리케이션을 푸시한 후 다음 명령을 실행하십시오.
  
  <pre>   
$ cf se myApp JBP_CONFIG_DYNATRACEAGENT 'repository_root: https://my-dynatrace-agent-host.mybluemix.net'
  </pre>
  {: codeblock}

  이 예에서 *my-dynatrace-agent-host.mybluemix.net*은 이전에 구성된 서버에 호스트된 index.yml 파일의 URL입니다. 
  </li>
  <li> 환경 변수를 설정한 후 앱을 다시 스테이징하십시오. Liberty 앱의 staging_task.log는 에이전트 호스트 서버에서 Dynatrace 에이전트를 다운로드했음을 알리는 메시지를 발행합니다. 예:
<pre>
Downloading dynatrace-agent-6.3.0-unix.jar 6.3.0 from https://my-dynatrace-agent-host.mybluemix.net/dynatrace-agent-6.3.0-unix.jar (17.8s)
  </pre>
  {: codeblock}

</li>
<li>staging_task.log를 보려면 다음 명령을 실행하십시오.
<pre>
$ cf files myAppName logs/staging_task.log
  </pre>  
  {: codeblock}

</li>
</ol>

# 관련 링크
{: #rellinks}
## 일반<commit_msg>Updated env var to JBP_CONFIG_DYNATRACEAPPMONAGENT<commit_after>---

copyright:
  years: 2016
lastupdated: "2016-06-10"

---

{:new_window: target="_blank"}
{:codeblock: .codeblock}

# Dynatrace 사용
{: #using_dynatrace}

Dynatrace는 앱에 대한 모니터링을 제공하는 써드파티 서비스입니다. 

Dynatrace 서비스에서 제공하는 기능에 대한 자세한 정보는 [Dynatrace 애플리케이션 모니터링](http://www.dynatrace.com/en/products/application-monitoring.html)을 참조하십시오.

Liberty 애플리케이션이 Dynatrace를 사용하도록 구성될 때 기본 동작은 Liberty 런타임이 Dynatrace 사이트에서
Dynatrace 에이전트 jar 파일을 요구하고 해당 Dyntrace 에이전트를 사용자의 앱으로 실행하는 것입니다. 이러한 기본 동작에서 Dynatrace를 사용하기 위한 최소 필수 구성은 Dynatrace 콜렉터를 가리키는 사용자 제공 서비스를 작성하는 것입니다.

## Dynatrace 콜렉터를 가리키는 사용자 제공 서비스 작성

먼저, Dynatrace 콜렉터를 설정해야 합니다. 그런 다음 Dynatrace 콜렉터에 연결할 Dynatrace 에이전트에 대한 정보를 전달하는 사용자 제공 서비스를 작성해야 합니다. Dynatrace 컴포넌트 간의 관계에 대해 자세히 보려면 [Dynatrace 아키텍처](https://community.dynatrace.com/community/display/DOCDT63/Architecture)를 참조하십시오. 

<ol>
<li>Dynatrace 콜렉터를 설정하십시오. <ul>
  <li>Dynatrace 콜렉터 다운로드 및 설정에 대한 지시사항은 [Dynatrace 커뮤니티 웹 사이트](https://community.dynatrace.com/community/display/EVAL/Step+3+-+Connect+Agent+to+Dynatrace)를 참조하십시오. </li>
  <li>Bluemix의 앱에서 실행 중인 Dynatrace 에이전트에 액세스할 수 있는 위치에 콜렉터가 설치되었는지 확인하십시오. </li>
  </ul>
</li>
<li>실행 중인 Dynatrace 콜렉터를 가리키는 사용자 제공 서비스를 작성하십시오. <b>참고</b> 사용자 제공 서비스의 이름에는 <b>dynatrace</b>가 포함되어야 합니다. 예를 들어 다음과 같은 명령을 사용하십시오.
<pre>
$ cf cups my-dynatrace-collector -p '{"server":"DynatraceCollectorIPaddress","profile":"Monitoring"}'
  </pre>
  {: codeblock}

이 예에서 my-dynatrace-collector는 서비스에 지정된 이름이고, DynatraceCollectorIPaddress는 구성한 Dynatrace 콜렉터의 IP 주소이며, profile은 이 모니터되는 앱과 연관된 선택적 Dynatrace 프로파일 이름입니다. 기본 profile 값은 Monitoring입니다. 다음 예에서와 같이 선택적 매개변수를 지정할 수 있습니다.


  <pre>
  $ cf cups my-dynatrace-collector -p '{"server":"DynatraceCollectorIPaddress","profile":"Monitoring",
                                        "options" : {"dynatrace-parameter-1": "value",
                                                     "dynatrace-parameter-2": "value"}}'
  </pre>
  {: codeblock}

사용 가능한 옵션에 대한 자세한 정보는 Dynatrace 커뮤니티에서 [에이전트 구성의 에이전트 설정 섹션](https://community.dynatrace.com/community/display/DOCDT62/Agent+Configuration)을 참조하십시오. 예를 들어 제외 옵션을 사용하면 Dynatrace에서 모니터되지 않도록 클래스를 제외시킬 수 있습니다. 사용자 제공 서비스 구성에 대한 자세한 정보는 [DynaTrace 에이전트 프레임워크](https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack/blob/master/docs/framework-dynatrace-agent.md)를 참조하십시오. 
</li>
<li>Bluemix에 앱을 푸시한 후 앱에 작성한 사용자 제공 서비스를 바인드하십시오. 예를 들어 다음 명령을 사용하십시오.
<pre>
  $ cf bs myApp my-dynatrace-collector
  </pre>  
  {: codeblock}

**참고**: 서비스를 바인드한 후 애플리케이션을 다시 스테이징해야 합니다. 
</li>
</ol>

## 선택적 구성
{: #optional_configuration}

Dynatrace 에이전트 jar 파일을 직접 획득하여 호스트할 수 있습니다. 이 경우 다음과 같은 추가 구성 단계가 필요합니다. 
1. Liberty 빌드팩에서 다운로드할 수 있도록 Dynatrace 에이전트 jar 파일을 획득하여 호스트하십시오. 
2. Liberty 앱이 Dynatrace 에이전트를 다운로드할 수 있도록 Liberty 앱을 구성하십시오. 

### Dynatrace 에이전트 호스트
{: #hosting_dynatrace_agent}
Dynatrace 에이전트는 웹 서버에 호스트되어야 하며, Liberty 빌드팩이 서버에서 에이전트 jar 파일을 다운로드할 수 있어야 합니다. 서버는 에이전트 jar 파일에 대한 세부사항을 지정하는 index.yml 파일로 구성되어야 합니다. Dynatrace 에이전트를 설정하려면 다음 단계를 완료하십시오. 
  1. Dynatrace 에이전트 jar를 다운로드하십시오. Dynatrace 에이전트 jar 다운로드에 대한 지시사항은 Dynatrace 커뮤니티 웹 사이트에서 [Dynatrace 서버 플랫폼 설치 프로그램](https://community.dynatrace.com/community/display/EVAL/Step+1+-+Download+and+install+Dynatrace)을 참조하십시오. Bluemix에서 실행하기에 적절한 에이전트 jar 파일은 **dynatrace-agent-unix.jar** 버전 **6.+**입니다.
  2. Liberty 빌드팩이 다운로드할 수 있는 위치에 에이전트 jar 파일이 호스트되도록 하십시오. 사용 가능한 서버 기능을 사용하여 Bluemix 자체에서 이 파일을 호스트하거나, 일부 공용 사용 가능 위치에서 호스트할 수 있습니다. 
     * 호스트 위치에서 index.yml 파일을 제공하는지 확인하십시오. index.yml 파일에는 에이전트 jar 파일의 버전 ID(뒤에 콜론이 붙음)와 에이전트 jar 위치의 완전한 URL로 구성된 항목이 포함되어야 합니다. 예: 
```
      ---
      6.3.0: https://my-dynatrace-agent.mybluemix.net/dynatrace-agent-6.3.0-unix.jar
```  
{: codeblock}
     * **dynatrace-agent-6.3.0-unix.jar** 파일은 index.yml 파일에 지정된 위치에 있어야 합니다. jar 파일과 index.yml 파일의 위치가 동일한 디렉토리일 수 있습니다. 

### Liberty 앱 구성
{: #configuring_liberty_app}

이전에 설정한 에이전트 jar를 호스트하는 서버를 찾으려면 모니터할 Liberty 앱이 구성되어야 합니다. **JBP_CONFIG_DYNATRACEAPPMONAGENT** 환경 변수를 사용하여 앱을 구성할 수 있습니다. **JBP_CONFIG_DYNATRACEAPPMONAGENT** 환경 변수는 Dynatrace 에이전트를 다운로드할 소스 빌드팩을 알려줍니다. 이 환경 변수를 설정하려면 다음 단계를 완료하십시오. 
<ol>
   <li> **JBP_CONFIG_DYNATRACEAPPMONAGENT** 변수에
*"repository_root: URL_of_server_hosting_index.yml"* 값을 설정하십시오. 예를 들어 애플리케이션을 푸시한 후 다음 명령을 실행하십시오.
  
  <pre>   
$ cf se myApp JBP_CONFIG_DYNATRACEAPPMONAGENT 'repository_root: https://my-dynatrace-agent-host.mybluemix.net'
  </pre>
  {: codeblock}

  이 예에서 *my-dynatrace-agent-host.mybluemix.net*은 이전에 구성된 서버에 호스트된 index.yml 파일의 URL입니다. 
  </li>
  <li> 환경 변수를 설정한 후 앱을 다시 스테이징하십시오. Liberty 앱의 staging_task.log는 에이전트 호스트 서버에서 Dynatrace 에이전트를 다운로드했음을 알리는 메시지를 발행합니다. 예:
<pre>
Downloading dynatrace-agent-6.3.0-unix.jar 6.3.0 from https://my-dynatrace-agent-host.mybluemix.net/dynatrace-agent-6.3.0-unix.jar (17.8s)
  </pre>
  {: codeblock}

</li>
<li>staging_task.log를 보려면 다음 명령을 실행하십시오.
<pre>
$ cf files myAppName logs/staging_task.log
  </pre>  
  {: codeblock}

</li>
</ol>

# 관련 링크
{: #rellinks}
## 일반
{'fraction_non_alphanumeric': 0.10741224982399677, 'fraction_numerical': 0.009252740621542794, 'mean_word_length': 3.6229660622966064, 'pattern_counts': {'":': 12, '<': 79, '<?xml version=': 0, '>': 79, 'https://': 16, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 10, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6183445', 'n_tokens_mistral': 6637, 'n_tokens_neox': 8277, 'n_words': 1203}