：接入阿里雲JavaAgent上報的Java程式效能資料

步驟二 下載Java Agent

• 中國地區

  wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/jvm/continuous-profile-collector-agent-1.9.0.jar

• 非中國地區

  wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/jvm/continuous-profile-collector-agent-1.9.0.jar

步驟三： 配置Java程式推送效能資料

• JVM參數方式

java \
-Dprofiling.app.name=your_service_name \
-Dprofiling.agent.upload.server="http://{host}:{port}" \
-Dprofiling.cpu.engine={engine} \
-javaagent:{path for javaagent} \
-jar demo.jar

參數	說明
profiling.app.name	服務名稱。
profiling.agent.upload.server	資料上傳地址。 如果是ECS，需配置為目標ECS的IP地址:4040。 如果是Kubernetes叢集，需配置為logtail-kubernetes-metrics.sls-monitoring:4040。 如果是其他雲廠商的伺服器和自建IDC，需配置為目標伺服器的IP地址:4040。
profiling.cpu.engine	CPU熱點剖析引擎，預設值：off，可選值：auto、async_profiler、jfr、off。 off表示不開啟CPU熱點剖析，其他值表示開啟。建議選擇auto。

• 環境變數方式

export PROFILING_APP_NAME="your_service_name"
export PROFILING_AGENT_UPLOAD_SERVER="http://{host}:{port}"
export PROFILING_CPU_ENGINE="{engine}"
export PROFILING_ALLOC_ENGINE="{engine}"

參數	說明
PROFILING_APP_NAME	服務名稱。
PROFILING_AGENT_UPLOAD_SERVER	資料上傳地址。 如果是ECS，需配置為目標ECS的IP地址:4040。 如果是Kubernetes叢集，需配置為logtail-kubernetes-metrics.sls-monitoring:4040。 如果是其他雲廠商的伺服器和自建IDC，需配置為目標伺服器的IP地址:4040。
PROFILING_CPU_ENGINE	CPU熱點剖析引擎，預設值：off，可選值：auto、async_profiler、jfr、off。 off表示不開啟CPU熱點剖析，其他值表示開啟。建議選擇auto。

備忘說明

JVM 參數	環境變數	說明
profiling.app.name	PROFILING_APP_NAME	應用程式名稱
profiling.agent.upload.server	PROFILING_AGENT_UPLOAD_SERVER	JFR檔案上傳伺服器位址，預設值：http://localhost:4040。 不以http開頭，系統將自動添加http首碼。 不以正斜線（/）結束，系統將自動添加正斜線（/）。
profiling.agent.timeout	PROFILING_AGENT_TIMEOUT	上傳JFR檔案時的網路逾時時間，預設值：10，單位：秒。
profiling.agent.ingest.max.tries	PROFILING_AGENT_INGEST_MAX_TRIES	上傳JFR檔案時的重試次數，預設值：2。
profiling.app.http.headers	PROFILING_APP_HTTP_HEADERS	上傳JFR檔案時的HTTP頭，預設值：空。例如 SESSION_ID=1111;XXX=YYY。
profiling.app.labels	PROFILING_APP_LABELS	上傳JFR檔案時的標籤，預設值：空。例如env=dev;lang=java;biz=member。
profiling.agent.log.level	PROFILING_AGENT_LOG_LEVEL	記錄層級，預設值：info，可選值：info、debug、error。
profiling.agent.log.file	PROFILING_AGENT_LOG_FILE	記錄檔路徑，預設值：輸出到Java的標準輸出，可選值：/path/to/profiling.log。
profiling.period	PROFILING_PERIOD	上傳周期，即每隔多久上傳一次剖析資料。預設值：1分鐘。
profiling.delay	PROFILING_DELAY	剖析延遲時間，預設值：0，啟動後馬上開始剖析。其中值表示延遲對應秒數再開啟剖析。
profiling.start.at.zero.second	PROFILING_START_AT_ZERO_SECOND	如果希望在每分鐘的0秒開始剖析，則設定為true。例如設定為true，且目前時間是30秒，則會自動等待30後後再開啟剖析。 預設值：false。
profiling.compression.mode	PROFILING_COMPRESSION_MODE	壓縮方式，預設值：none，可選值：gzip、none。 none：檔案尾碼為.jfr。 gzip：檔案尾碼為.jfr.gzip。
profiling.trigger.mode	PROFILING_TRIGGER_MODE	觸發模式，自動周期性觸發或者單次觸發。預設值：periodic， 可選值：periodic、api。 agent模式適合periodic。
profiling.output.format	PROFILING_OUTPUT_FORMAT	檔案格式，預設值：jfr，可選值：jfr、collapsed。
profiling.cpu.engine	PROFILING_CPU_ENGINE	CPU熱點剖析引擎，預設值：off，可選值：auto、async_profiler、jfr、off。 off表示不開啟CPU熱點剖析，其他值表示開啟。建議選擇auto。
profiling.cpu.interval	PROFILING_CPU_INTERVAL	CPU熱點剖析的間隔，值越小開銷越大。 預設值：10，單位：毫秒。
profiling.wallclock.engine	PROFILING_WALLCLOCK_ENGINE	牆鐘熱點剖析引擎，預設值：off，可選值：auto、async_profiler、off。 off表示不開啟牆鐘熱點剖析，其他值表示開啟，建議選擇off。
profiling.wallclock.interval	PROFILING_WALLCLOCK_INTERVAL	牆鐘熱點剖析的間隔，值越小開銷越大。預設值：20，單位：毫秒。
profiling.wallclock.thread.filter	PROFILING_WALLCLOCK_THREAD_FILTER	牆鐘熱點剖析的線程過濾器， 預設值0，不剖析任何線程。 可選值： 空："" 單個線程：123 多個線程：122，123 線程範圍：122-134。
profiling.wallclock.threads.per.tick	PROFILING_WALLCLOCK_THREADS_PER_TICK	牆鐘熱點剖析每次剖析的線程數上限，預設值：8。
profiling.alloc.engine	PROFILING_ALLOC_ENGINE	Alloc（記憶體申請）熱點剖析引擎，預設值：off，可選值：auto、async_profiler、jfr、off。 off表示不開啟Alloc熱點剖析，其他值表示開啟，建議選擇auto。
profiling.alloc.interval	PROFILING_ALLOC_INTERVAL	記憶體申請熱點剖析的間隔， 值越小開銷越大。預設值256，單位：kilo bytes。
profiling.jfr.max.size	PROFILING_JFR_MAX_SIZE	JFR檔案的體積上限，超過後自動丟棄資料，預設值64m，可選值：256k、10m。
profiling.jfr.max.age	PROFILING_JFR_MAX_AGE	JFR檔案的時間上限，超過後會會自動丟棄資料，預設值：10m，可選值：1m、1h、1d。
profiling.jfr.max.stack.depth	PROFILING_JFR_MAX_STACK_DEPTH	JFR採樣時的棧深度限制，預設值：64。