Java 를 기반으로 하는 AWS Lambda 함수에 대한 네이티브 추적 설정

Java 및 Kotlin 와 같이 Java 가상 머신( JVM )을 기반으로 하는 다른 언어로 작성된 AWS Lambda 함수의 경우, Instana ( AutoTrace )을 설정할 수 있습니다.

자세한 내용은 Instana AutoTrace 을 참조하십시오.

Java 를 기반으로 하는 AWS Lambda 함수에 네이티브 추적 기능을 설정하려면, 해당 Lambda 함수에 Instana Lambda 레이어를 추가해야 합니다. 추적 기능을 활성화하면, Instana UI에서 Java 기반의 AWS Lambda 함수와 관련된 모든 요청의 추적 정보를 확인할 수 있습니다.

지원되는 런타임

Instana JVM, 1.8 및 이후 버전을 지원합니다.

AWS Lambda 함수 설정

참고:
Lambda 모니터링을 위해 Instana AWS 에이전트를 설정하여 AWS Lambda 런타임 내부에서 버전 및 런타임 메트릭을 수집할 수 있도록 하십시오.

AWS 웹 콘솔 또는 다음 AWS 관리 도구를 통해 람다 기능의 추적을 사용으로 설정할 수 있습니다.

AWS 웹 콘솔을 통해 추적 기능 활성화

JVM 내에서 실행 중인 Lambda 함수의 추적을 활성화하려면, AWS Lambda UI에서 다음 단계를 수행하십시오:

  1. 함수에 ‘ Instana ’ 람다 레이어를 추가하세요:

    1. 람다 기능의 구성 탭에서 레이어 > 레이어 추가를 클릭하십시오.

      계층

    2. “함수에 레이어 추가” 창에서 “레이어 버전 ARN 제공”을 선택하고, 사용자의 리전과 일치하는 Instana Lambda 레이어의 Amazon Resource Name(ARN)을 복사하여 붙여넣으십시오. Instana 의 Lambda 레이어에 해당하는 ARN은 Instana 의 Lambda 레이어 섹션에서 확인할 수 있습니다.

      계층 선택

    3. 추가 를 클릭하십시오.

  2. 다음 환경 변수를 구성하십시오.

    환경 변수
    JAVA_TOOL_OPTIONS -javaagent:/opt/instana/standalone-collector.jar
    INSTANA_ENDPOINT_URL <serverless_instana_endpoint> `
    INSTANA_AGENT_KEY <your_instana_agent_key>
    참고:
    .로 시작하는 해당 지역의 올바른 값을 사용해야 합니다 https://serverless-. 자세한 내용은 ‘서버리스 모니터링용 엔드포인트’를 참조하세요.

    또한 Instana UI에서 이러한 환경 변수의 정확한 값을 확인할 수 있습니다. 이러한 환경 변수의 정확한 값을 확인하려면, ‘ Instana ’ UI에서 [더 보기 ] > [에이전트 ] > [에이전트 설치 ] > [플랫폼: AWS ] > [기술: AWS Lambda ]을 차례로 클릭하십시오.

  3. Ambda 함수 정의를 저장하십시오.

    저장

AWS 명령줄 인터페이스를 통해 추적 기능 활성화

AWS 의 Lambda 함수에 대한 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 람다 레이어

Java 용 최신 버전의 ‘ AWS Lambda ’ 레이어의 지역별 ARN은 다음과 같습니다:

지역 ARN
af-south-1 arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:143
ap-east-1 arn:aws:lambda:ap-east-1:410797082306:layer:instana-java:70
ap-northeast-1 arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:143
ap-northeast-2 arn:aws:lambda:ap-northeast-2:410797082306:layer:instana-java:141
ap-northeast-3 arn:aws:lambda:ap-northeast-3:410797082306:layer:instana-java:70
ap-south-1 arn:aws:lambda:ap-south-1:410797082306:layer:instana-java:141
ap-south-2 arn:aws:lambda:ap-south-2:410797082306:layer:instana-java:70
ap-southeast-1 arn:aws:lambda:ap-southeast-1:410797082306:layer:instana-java:141
ap-southeast-2 arn:aws:lambda:ap-southeast-2:410797082306:layer:instana-java:141
ap-southeast-3 arn:aws:lambda:ap-southeast-3:410797082306:layer:instana-java:70
ap-southeast-4 arn:aws:lambda:ap-southeast-4:410797082306:layer:instana-java:70
ca-central-1 arn:aws:lambda:ca-central-1:410797082306:layer:instana-java:141
cn-north-1 arn:aws-cn:lambda:cn-north-1:107998019096:layer:instana-java:36
cn-northwest-1 arn:aws-cn:lambda:cn-northwest-1:107998019096:layer:instana-java:45
eu-central-1 arn:aws:lambda:eu-central-1:410797082306:layer:instana-java:133
eu-central-2 arn:aws:lambda:eu-central-2:410797082306:layer:instana-java:59
eu-north-1 arn:aws:lambda:eu-north-1:410797082306:layer:instana-java:130
eu-south-1 arn:aws:lambda:eu-south-1:410797082306:layer:instana-java:59
eu-south-2 arn:aws:lambda:eu-south-2:410797082306:layer:instana-java:59
eu-west-1 arn:aws:lambda:eu-west-1:410797082306:layer:instana-java:130
eu-west-2 arn:aws:lambda:eu-west-2:410797082306:layer:instana-java:130
eu-west-3 arn:aws:lambda:eu-west-3:410797082306:layer:instana-java:130
il-central-1 arn:aws:lambda:il-central-1:410797082306:layer:instana-java:56
me-central-1 arn:aws:lambda:me-central-1:410797082306:layer:instana-java:null
me-south-1 arn:aws:lambda:me-south-1:410797082306:layer:instana-java:null
sa-east-1 arn:aws:lambda:sa-east-1:410797082306:layer:instana-java:122
us-east-1 arn:aws:lambda:us-east-1:410797082306:layer:instana-java:122
us-east-2 arn:aws:lambda:us-east-2:410797082306:layer:instana-java:122
us-west-1 arn:aws:lambda:us-west-1:410797082306:layer:instana-java:122
us-west-2 arn:aws:lambda:us-west-2:410797082306:layer:instana-java:122

패턴은 arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} (또는 중국의 AWS 지역의 경우 arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} ) 입니다.

참고:
Instana Lambda 레이어의 최신 버전을 항상 사용하도록 하십시오. 정기적으로 사용하는 계층 버전을 업데이트하여 계층의 새 버전에서 제공하는 기능 및 수정사항을 활용하십시오.