AWS Node.js용 람다 원시 추적

Node.js 에 대한 Instana AutoTrace 설정으로 AWS 람다 함수를 추적할 수 있는 방법은 Instana 람다 레이어와 사용자 정의 함수 핸들러를 사용하는 것입니다. 이 접근 방식은 람다 함수 코드를 수정할 필요가 없으며 설정을 통해 순전히 수행됩니다. 또한 자동화하거나 람다 배포 파이프라인에 포함시키기에 적합합니다.

Node.js 람다 함수 추적을 활성화하려면 다음 단계를 수행하세요:

1. 함수에 Instana Lambda 레이어를 추가합니다.

   1. Lambda 함수의 구성 페이지에서 상자를 Layers 클릭한 다음 을 Add a layer클릭하세요.
   2. 열리는 팝업에서 '레이어 버전 ARN 제공'을 선택하고, 해당 지역에 맞는 Instana Lambda 레이어의 ARN을 복사하여 붙여넣으세요. Instana Lambda 레이어의 올바른 ARN은 Instana Lambda 레이어 섹션에서 찾을 수 있습니다.

2. 람다 핸들러를 구성합니다. 를 사용하는 경우 핸들러를 instana-aws-lambda-auto-wrap.handler 로 설정합니다 CommonJS. 핸들러를 다음으로 설정하세요 instana-aws-lambda-auto-wrap-esm.handler ES 모듈( ES6 )을 사용하는 경우(레이어 버전 223부터 사용 가능).

   람다 핸들러의 설정을 변경하려면 구성 페이지에서 '기본 설정' 섹션을 참조하세요.

   

   편집을 클릭하고 '핸들러'라고 표시된 필드에 instana-aws-lambda-auto-wrap.handler 을 입력합니다.

   

   Instana 람다 계층은 기본 Node.js 런타임 핸들러 index.handler 를 자동으로 트리거합니다. 사용자 지정 핸들러를 사용하는 경우 환경 변수 LAMBDA_HANDLER에서 핸들러를 지정하여 Instana 람다 레이어에 알립니다. 설정해야 하는 모든 환경 변수는 다음 섹션을 참조하세요.

   Lambda 구성 페이지에 Lambda가 파일을 찾을 수 없음 instana-aws-lambda-auto-wrap.js 과 같은 경고가 표시될 수 있습니다. 이 경고는 나중에 구성 페이지로 돌아올 때도 표시될 수 있습니다. 이 경고에 현혹되지 마세요. 핸들러는 Instana 람다 레이어에 포함되어 있지만 AWS 람다 구성 페이지에서는 이를 고려하지 않습니다.

3. 환경 변수를 구성합니다. 다음 환경 변수를 추가하십시오.

   • INSTANA_ENDPOINT_URL: 서버리스 모니터링 엔드포인트입니다. https://serverless- 로 시작하는 지역에 맞는 올바른 값을 사용해야 합니다.
   • INSTANA_AGENT_KEY: 상담원 키.
   • LAMBDA_HANDLER: 사용자 지정 핸들러를 설정합니다. 기본 파일이 myHandler 함수를 내보내는 myModule.js 인 경우 환경 변수를 myModule.myHandler 로 설정합니다. 기본값은 index.handler입니다.

   다음 예시에서 원래 메인 람다 핸들러는 이므로 index.js, 환경 변수 LAMBDA_HANDLER 를 설정할 필요가 없습니다.

   다음 예시에서 원래 메인 람다 핸들러는 입니다 server.js. 따라서 환경 변수 LAMBDA_HANDLER를 로 설정해야 server.handler 합니다.

   Instana 설치로 이동하여 이러한 환경 변수에 대한 올바른 값을 얻을 수도 있습니다. 자세히 보기 -> 에이전트 -> Instana 에이전트 설치하기 -> 플랫폼: AWS -> 기술: AWS Lambda.

4. 람다 함수 정의를 저장합니다.

앞서 설명한 모든 단계는 AWS 웹 콘솔 또는 일반적인 AWS 관리 도구 중 하나를 통해 수행할 수 있습니다:

• aws 명령줄 인터페이스
• 서버리스 프레임워크 CLI
• AWS 클라우드 개발 키트

다음은 AWS 람다의 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 \
  --handler instana-aws-lambda-auto-wrap.handler \
  --environment ""Variables={INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}""
 

Instana 람다 레이어를 사용하는 대신 npm 패키지 @instana/aws-lambda 를 수동으로 설치하도록 선택할 수도 있습니다:

1. 프로젝트 디렉터리에서 npm install -S @instana/aws-lambda (또는 yarn add @instana/aws-lambda)을 실행하여 프로젝트에 @instana/aws-lambda 종속성을 추가합니다. 이렇게 하면 패키지가 node_modules 폴더에 추가되고 package.json 파일에 종속성이 저장됩니다.
2. 환경 변수 INSTANA_ENDPOINT_URL 및 INSTANA_AGENT_KEY 를 필요한 값으로 추가합니다.
3. 핸들러 수동 래핑하기 섹션에 따라 함수의 코드를 수정합니다.

팀에서 컨테이너 기반 Lambda 배포를 사용하는 경우 icr.io/instana/aws-lambda-nodejs 에서 기본 컨테이너를 사용하거나 Docker파일에 다음 스니펫을 포함시키고 빌드 시간 인수를 적절한 버전으로 설정할 수 있습니다.

Instana는 현재 x86_64 아키텍처만 지원합니다.

이 이미지는 FedRAMP-compliant 환경에서 사용하기 위한 것이 아닙니다.

# This is the container image that delivers Instana's monitoring capabilities.
# It will not become the base image for your Lambda container image, it just provides a few files.
FROM icr.io/instana/aws-lambda-nodejs:latest as instana-layer

# This is the actual base image for your Lambda container image. You can also use any other base image that is suitable
# for container image based Lambda functions.
FROM public.ecr.aws/lambda/nodejs:14

# Copy Instana's Node.js monitoring components into your Lambda container image.
COPY --from=instana-layer /opt/extensions/ /opt/extensions/
COPY --from=instana-layer /opt/nodejs/ /opt/nodejs/

# The remainder of your Dockerfile, as it was without adding the Instana layer. The following is just an example:
COPY index.js package.json package-lock.json /var/task/
WORKDIR /var/task
RUN npm install

# Override the CMD. This can also be done as a parameter override outside of the Dockerfile, for example in the AWS console.
# If you use ES modules, use CMD [ "instana-aws-lambda-auto-wrap-esm.handler" ] instead.
CMD [ "instana-aws-lambda-auto-wrap.handler" ]
 

예를 들어 icr.io/instana/aws-lambda-nodejs:latest 대신 @instana/aws-lambda 보다 크거나 같은 특정 버전의 Instana npm 모듈 1.137.2 ( 변경 로그 참조)을 사용할 수도 있습니다:

FROM icr.io/instana/aws-lambda-nodejs:1.140.1 as instana-layer
 

또는 메이저 버전만 고정하고 최신 마이너/패치 릴리스는 허용할 수 있습니다:

FROM icr.io/instana/aws-lambda-nodejs:1 as instana-layer
 

serverless.yml 을 편집하여 Instana 추적을 서버리스 프레임워크와 통합합니다. 다음 단계를 따르십시오.

1. 목록에서 레이어 ARN을 복사하고 대상 함수 정의의 레이어 섹션에 ARN을 추가합니다.

2. 환경 변수 INSTANA_AGENT_KEY, INSTANA_ENDPOINT_URL 및 LAMBDA_HANDLER 를 추가합니다. 자세한 내용은 Instana AutoTrace 설정을 참조하세요.

다음 예제 serverless.yml 를 참조하세요:

service: service-a

provider:
  name: aws
  runtime: nodejs16.x
  stage: dev
  region: us-east-2

functions:
  with-layer:
    environment:
      INSTANA_ENDPOINT_URL: INSTANA_ENDPOINT_URL
      INSTANA_AGENT_KEY: INSTANA_AGENT_KEY
      LAMBDA_HANDLER: src/index.handler
    layers:
      - arn:aws:lambda:us-east-2:410797082306:layer:instana-nodejs:111
    handler: instana-aws-lambda-auto-wrap.handler
 

지원되는 런타임에 나열된 Lambda 런타임에 대한 최신 버전의 AWS Lambda 레이어의 ARN은 지역별로 다음과 같습니다:

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

항상 최신 버전을 사용하고 사용 중인 레이어 버전을 정기적으로 업데이트하여 새 버전의 레이어를 게시할 때 제공하는 새로운 기능 및 수정 사항을 활용하세요.