자바 애플리케이션 프로파일링

gcloud CLI

1. 워크스테이션에 Google Cloud CLI를 아직 설치하지 않은 경우 Google Cloud CLI 문서를 참조하세요.

2. 다음 명령어를 실행합니다.

   gcloud services enable cloudprofiler.googleapis.com
   

자세한 내용은 gcloud services를 참조하세요.

Google Cloud 콘솔

1. Enable the required API.

   Enable the API

2. API 사용 설정됨이 표시되어 있으면 API가 이미 사용 설정된 것입니다. 그렇지 않으면 사용 설정 버튼을 클릭합니다.

Compute Engine

1. Profiler 에이전트의 설치 디렉터리를 만듭니다(예: /opt/cprof).

    sudo mkdir -p /opt/cprof

2. storage.googleapis.com 저장소에서 에이전트 보관 파일을 다운로드하고 설치 디렉터리에 압축을 풉니다.

   wget -q -O- https://storage.googleapis.com/cloud-profiler/java/latest/profiler_java_agent.tar.gz \
   | sudo tar xzv -C /opt/cprof

GKE

Dockerfile을 수정하여 Profiler 에이전트의 설치 디렉터리를 만들고 에이전트 보관 파일을 다운로드한 후 설치 디렉터리에 압축을 풉니다.

Linux(glibc 기반 C 라이브러리):

다음 설치 명령어를 사용합니다.

RUN mkdir -p /opt/cprof && \
  wget -q -O- https://storage.googleapis.com/cloud-profiler/java/latest/profiler_java_agent.tar.gz \
  | tar xzv -C /opt/cprof

Linux Alpine(musl 기반 C 라이브러리):

다음 설치 명령어를 사용합니다.

wget -q -O- https://storage.googleapis.com/cloud-profiler/java/latest/profiler_java_agent_alpine.tar.gz \
| tar xzv -C /opt/cprof

가변형 환경

Google 자바 8 런타임 기본 이미지 또는 자바 9/Jetty 9 런타임 기본 이미지를 사용할 경우 Profiler 에이전트가 사전 설치되므로 에이전트를 설치하기 위한 추가 단계를 수행할 필요가 없습니다.

다른 모든 기본 이미지에서는 에이전트를 설치해야 합니다. 예를 들어 다음 Dockerfile은 openjdk:11-slim 이미지를 사용하고 Profiler 에이전트를 설치하라는 명령을 포함하며 애플리케이션을 시작할 때 사용할 기본 매개변수를 정의합니다.

FROM openjdk:11-slim

COPY . .
RUN  apt-get update \
     && apt-get install wget \
     && rm -rf /var/lib/apt/lists/*

RUN mkdir -p /opt/cprof && \
    wget -q -O- https://storage.googleapis.com/cloud-profiler/java/latest/profiler_java_agent.tar.gz \
    | tar xzv -C /opt/cprof

CMD ["java", "-agentpath:/opt/cprof/profiler_java_agent.so=OPTION1,OPTION2", "-jar", "PATH_TO_YOUR_JAR_FILE"]

App Engine 가변형 환경에서 이 Dockerfile을 사용하려면 다음을 수행해야 합니다.

• OPTION1 및 OPTION2를 애플리케이션에 필요한 에이전트 구성 값으로 바꾸고 PATH_TO_YOUR_JAR_FILE을 jar 파일 경로로 바꿉니다.
• Dockerfile을 app.yaml 파일과 동일한 디렉터리에 둡니다.
• app.yaml 파일을 수정하여 커스텀 런타임을 지정합니다. 자세한 내용은 커스텀 런타임 빌드를 참조하세요.

표준 환경

Java 런타임 환경을 사용할 경우 Profiler 에이전트가 사전 설치되므로 에이전트를 설치하기 위한 추가 단계를 수행할 필요가 없습니다. Java 버전 11 이상에서는 /opt/cprof에 사전 설치되어 있습니다.

Google Cloud 외부

1. Profiler 에이전트의 설치 디렉터리를 만듭니다(예: /opt/cprof).

    sudo mkdir -p /opt/cprof

2. storage.googleapis.com 저장소에서 에이전트 보관 파일을 다운로드하고 설치 디렉터리에 압축을 풉니다.

   wget -q -O- https://storage.googleapis.com/cloud-profiler/java/latest/profiler_java_agent.tar.gz \
   | sudo tar xzv -C /opt/cprof

Compute Engine

일반적으로 프로그램을 실행할 때처럼 자바를 시작하고 에이전트 구성 옵션을 추가합니다.

java \
    -agentpath:/opt/cprof/profiler_java_agent.so=-cprof_service=myapp,-cprof_service_version=1.0.0 \
    JAVA_OPTIONS -jar PATH_TO_YOUR_JAR_FILE PROGRAM_OPTIONS

GKE

Dockerfile 서비스 컨테이너를 수정하여 일반적으로 프로그램을 실행할 때처럼 자바를 시작하고 에이전트 구성 옵션을 추가합니다.

CMD ["java", \
    "-agentpath:/opt/cprof/profiler_java_agent.so=-cprof_service=myapp,-cprof_service_version=1.0.0", \
     "-jar", "PATH_TO_YOUR_JAR_FILE" ]
    

가변형 환경

app.yaml 구성 파일을 수정하여 PROFILER_ENABLE 환경 변수를 설정합니다. 그런 다음 평소처럼 프로그램을 시작합니다.

env_variables:
   PROFILER_ENABLE: true

자세한 내용은 환경 변수 정의를 참조하세요.

표준 환경

Java 21 런타임 환경

기존 번들 서비스를 사용하지 않는 경우 다음 방법 중 하나를 사용하여 agentpath 플래그를 지정하도록 app.yaml 파일을 수정하여 프로파일러 수집을 사용 설정합니다.

• JAVA_TOOL_OPTIONS 환경 변수를 설정합니다.

  runtime: java21
  env_variables:
    JAVA_TOOL_OPTIONS: "-agentpath:/opt/cprof/profiler_java_agent.so=-logtostderr,-cprof_enable_heap_sampling=true"
  

• entrypoint 요소를 사용하여 agentpath를 지정합니다.

  runtime: java21
  entrypoint: java \
    -agentpath:/opt/cprof/profiler_java_agent.so=-logtostderr,-cprof_enable_heap_sampling=true \
    Main.java
  

기존 번들 서비스를 사용하는 경우 다음 방법 중 하나를 사용하여 appengine-web.xml 파일을 수정하여 agentpath 플래그를 지정하여 프로파일러 수집을 사용 설정합니다.

• JAVA_USER_OPTS 환경 변수를 설정합니다.

  <?xml version="1.0" encoding="utf-8"?>
  <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <env-variables>
  <env-var name="JAVA_USER_OPTS" value="-agentpath:/opt/cprof/profiler_java_agent.so=-logtostderr,-cprof_enable_heap_sampling=true" />
  </env-variables>
  </appengine-web-app>

• CPROF_ENABLE 환경 변수를 설정합니다.

  <?xml version="1.0" encoding="utf-8"?>
  <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <env-variables>
  <env-var name="CPROF_ENABLE" value="-agentpath:/opt/cprof/profiler_java_agent.so=-logtostderr,-cprof_enable_heap_sampling=true" />
  </env-variables>
  </appengine-web-app>

• entrypoint 요소를 사용하여 agentpath를 지정합니다.

  <?xml version="1.0" encoding="utf-8"?>
  <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
    <entrypoint>
     java
     -agentpath:/opt/cprof/profiler_java_agent.so=-logtostderr,-cprof_enable_heap_sampling=true
    </entrypoint>
  </appengine-web-app>