AWS Lambda 原生 Java 追蹤

這個頁面涵蓋以 Java 及其他 Java 虛擬機器型語言 (例如 Kotlin) 撰寫之 AWS Lambda 函數的 Instana AutoTrace 設定。

支援的執行時期

  • JVM 1.8.152-19

安裝

附註: 本文件說明如何設定在 Java 虛擬機器 (JVM) 內執行的 Lambda 函數追蹤。 請確定您也已執行 AWS 代理程式以進行 Lambda 監視 的設定,以確保收集 Instana 無法從 AWS Lambda 執行時期內部收集之版本及部分執行時期度量的必要資訊。

如果要啟用 Java 虛擬機器型 Lambda 函數的追蹤,請執行下列步驟:

  1. 將 Instana Lambda 層新增至您的函數。

    1. 在 Lambda 函數的配置頁面中,按一下 Layers 方框,然後按一下 Add a layer層
    2. 在開啟的蹦現畫面中,選取「提供層版本 ARN」,然後複製並貼上符合您地區之 Instana Lambda 層的 ARN; 您可以在 Instana Lambda 層 區段中找到 Instana Lambda 層的右側 ARN。 層選擇
  2. 配置環境變數。 新增下列環境變數:

    • JAVA_TOOL_OPTIONS: 固定值: -javaagent:/opt/instana/standalone-collector.jar
    • INSTANA_ENDPOINT_URL: 這是您的 無伺服器監視端點。 請務必對以 https://serverless-開頭的地區使用正確的值。
    • INSTANA_AGENT_KEY: 您的 代理程式金鑰

    您也可以移至 Instana 安裝架構,按一下「...」,以取得這些環境變數的正確值。 其他 "->" 代理程式 "->" 安裝 Instana 代理程式 "-> 平台:"AWS"-> 技術:"AWS Lambda "。

  3. 儲存 Lambda 函數定義。 儲存

上述所有步驟都可以透過 AWS Web 主控台或任何一般 AWS 管理工具來完成,例如:

如果您想要自動化 AWS Lambdas 的 Instana 整合,以下是可能作為起點的 aws CLI 指令範例:

# Do not copy and paste this verbatim!
# It will overwrite any previously defined collection of layers and
# environment variables.
aws --region $YOUR_REGION lambda update-function-configuration \
  --function-name $YOUR_LAMBDA_FUNCTION_NAME \
  --layers $INSTANA_LAYER_ARN \
  --environment ""Variables={JAVA_TOOL_OPTIONS=-javaagent:/opt/instana/standalone-collector.jar, INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}""

Instana Lambda 圖層

適用於 Java 的最新版本 AWS Lambda 層的 ARN 如下所示 (每個區域):

地區 ARN
af-south-1 arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:74
ap-east-1 arn:aws:lambda:ap-east-1:410797082306:layer:instana-java:1
ap-northeast-1 arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:74
ap-northeast-2 arn:aws:lambda:ap-northeast-2:410797082306:layer:instana-java:72
ap-northeast-3 arn:aws:lambda:ap-northeast-3:410797082306:layer:instana-java:1
ap-south-1 arn:aws:lambda:ap-south-1:410797082306:layer:instana-java:72
ap-south-2 arn:aws:lambda:ap-south-2:410797082306:layer:instana-java:1
ap-southeast-1 arn:aws:lambda:ap-southeast-1:410797082306:layer:instana-java:72
ap-southeast-2 arn:aws:lambda:ap-southeast-2:410797082306:layer:instana-java:72
ap-southeast-3 arn:aws:lambda:ap-southeast-3:410797082306:layer:instana-java:1
ap-southeast-4 arn:aws:lambda:ap-southeast-4:410797082306:layer:instana-java:1
ca-central-1 arn:aws:lambda:ca-central-1:410797082306:layer:instana-java:72
`cn-north-1' arn:aws-cn:lambda:cn-north-1:107998019096:layer:instana-java:1
`cn-northwest-1' arn:aws-cn:lambda:cn-northwest-1:107998019096:layer:instana-java:1
eu-central-1 arn:aws:lambda:eu-central-1:410797082306:layer:instana-java:72
eu-central-2 arn:aws:lambda:eu-central-2:410797082306:layer:instana-java:1
eu-north-1 arn:aws:lambda:eu-north-1:410797082306:layer:instana-java:72
eu-south-1 arn:aws:lambda:eu-south-1:410797082306:layer:instana-java:1
eu-south-2 arn:aws:lambda:eu-south-2:410797082306:layer:instana-java:1
eu-west-1 arn:aws:lambda:eu-west-1:410797082306:layer:instana-java:72
eu-west-2 arn:aws:lambda:eu-west-2:410797082306:layer:instana-java:72
eu-west-3 arn:aws:lambda:eu-west-3:410797082306:layer:instana-java:72
il-central-1 arn:aws:lambda:il-central-1:410797082306:layer:instana-java:1
me-central-1 arn:aws:lambda:me-central-1:410797082306:layer:instana-java:1
me-south-1 arn:aws:lambda:me-south-1:410797082306:layer:instana-java:1
sa-east-1 arn:aws:lambda:sa-east-1:410797082306:layer:instana-java:72
us-east-1 arn:aws:lambda:us-east-1:410797082306:layer:instana-java:72
us-east-2 arn:aws:lambda:us-east-2:410797082306:layer:instana-java:72
us-west-1 arn:aws:lambda:us-west-1:410797082306:layer:instana-java:72
us-west-2 arn:aws:lambda:us-west-2:410797082306:layer:instana-java:72

型樣是 arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} (或 arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} 適用於中國的 AWS 區域)。

請確保一律使用最新版本並定期更新您正在使用的層版本,以受益於我們在發佈新版本層時提供的新特性及修正程式。

配置

如需適用於 AWS Lambda 函數之 Instana 環境型設定的概觀,請參閱 Instana Lambda 追蹤器的其他配置