SDK 기반 측정, 물리

Go 언어 Lambda를 계측하려면:

1. Go 에이전트 패키지를 다운로드하고 함수와 동일한 디렉터리에 배치합니다.

   1. 다음을 실행하여 에이전트를 설치합니다.

      bash

      카피

      $
      go get -u github.com/newrelic/go-agent/v3/newrelic

   2. 다음을 실행하여 nrlambda 통합을 설치합니다.

      bash

      카피

      $
      go get -u github.com/newrelic/go-agent/v3/integrations/nrlambda

2. Lambda 코드에서 구성 요소를 가져오고 애플리케이션을 생성하고 Lambda를 시작하는 방법을 업데이트합니다. 계측 예를 참조하십시오.

   • 확장 저장소
   • 에이전트 리포지토리로 이동

3. 선택적으로 RecordCustomEvent API 를 사용하여 Lambda 호출과 연결할 사용자 지정 이벤트 를 추가합니다. 예를 들어:

   func handler(ctx context.Context) {
     if txn := newrelic.FromContext(ctx); nil != txn {
       txn.Application().RecordCustomEvent("MyEvent", map[string]interface{}{
         "zip": "zap",
       })
     }
     fmt.Println("hello world!")
   }

   카피

4. Lambda 함수를 빌드 및 압축하여 AWS에 업로드합니다.

   압축 및 업로드 권장 사항

   다음은 Lambda를 압축하고 업로드하기 위한 제안 사항입니다.

   1. Linux에서 실행할 바이너리를 빌드합니다. 그러면 main 이라는 바이너리 파일이 생성됩니다. 당신이 사용할 수있는:

      bash

      카피

      $
      GOOS=linux go build -o main

   2. 다음을 사용하여 바이너리를 배포 패키지에 압축합니다.

      bash

      카피

      $
      zip deployment.zip main

   3. AWS Lambda 콘솔 또는 AWS CLI를 사용하여 zip 파일을 AWS에 업로드합니다. 핸들러의 이름을 main 로 지정합니다(바이너리 빌드 중에 지정된 이름과 일치하도록).

5. 환경 변수를 구성합니다.

6. AWS Management Console의 설정 탭에서 Lambda 함수에 NR.Apm.Lambda.Mode: true 태그를 추가하세요.

7. Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.

   래퍼는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 그런 다음 해당 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .

Java의 AWS Lambda 모니터링은 APM Java 에이전트 를 사용하지 않습니다. 대신 다음 두 가지 OpenTracing 종속성을 사용합니다.

• AWS Lambda OpenTracing Java SDK: AWS Lambda RequestHandler 및 RequestStreamHandler용 OpenTracing 계측.

• AWS Lambda OpenTracing Tracer: AWS Lambda를 모니터링하도록 설계된 OpenTracing Tracer 구현입니다. 범위, 오류 이벤트, 트랜잭션 이벤트, 오류 추적을 생성하고 분산 추적 지원을 제공합니다.

  중요

  뉴렐릭 AWS Lamdba OpenTracing 서버 SDK 버전 3.0.0에서 AWS 의존성/종속성 버전이 변경되었습니다. 이제 다음 의존성/종속성이 사용됩니다:

  • com.amazonaws:aws-lambda-java-core:1.2.3 (이전 버전: 1.1.0)

  • com.amazonaws:aws-lambda-java-events:3.15.0 (이전 버전: 2.2.7)

  • software.amazon.awssdk:s3:2.31.43 (com.amazonaws:AWS-java-sdk-s3:1.12.771을 대체합니다)

  • software.amazon.awssdk:s3-event-notifications:2.31.43 (com.amazonaws:AWS-java-sdk-s3:1.12.771을 대체합니다)

    AWS Lambdba OpenTracing SDK를 활용하는 기능은 위에 언급된 것과 동일하거나 더 높은 버전의 기본 AWS 라이브러리를 사용하는 것이 좋습니다. 업그레이드할 수 없는 기능은 이 라이브러리의 2.2.0 버전에 남아 있어야 합니다.

  팁

  Supported OpenTracing Versions

  • OpenTracing 0.31.0:

    • 람다 추적기:com.newrelic.opentracing:newrelic-java-lambda:1.1.1
    • 람다 SDK: com.newrelic.opentracing:java-aws-lambda:1.0.0

  • OpenTracing 0.32.0, 0.33.0:

    • Lambda 트레이서: com.newrelic.opentracing:newrelic-java-lambda:2.2.3
    • Lambda SDK: com.newrelic.opentracing:java-AWS Lambda:2.1.1

  Java Lambda를 계측하려면:

1. 프로젝트의 build.gradle 파일에 OpenTracing AWS Lambda 트레이서 및 AWS Lambda OpenTracing SDK 의존성/종속성을 포함합니다.

   dependencies {
       compile("com.newrelic.opentracing:java-aws-lambda:2.1.1")
       compile("com.newrelic.opentracing:newrelic-java-lambda:2.2.3")
       compile("io.opentracing:opentracing-util:0.33.0")
   }

   카피

2. Java Lambda 예시 와 같이 AWS Lambda RequestHandler 인터페이스를 구현하고 doHandleRequest 메서드를 재정의합니다.

3. doHandleRequest 메서드에서 LambdaTracing.instrument(...) API를 호출하여 람다 함수의 실행을 추적할 루트 범위를 만듭니다. 여기에서 람다 함수에 대한 비즈니스 논리를 정의할 수도 있습니다.

4. Java Lambda 예시 와 같이 LambdaTracer.INSTANCE 을 OpenTracing Global tracer로 등록합니다.

5. ZIP 배포 패키지를 생성하고 AWS Lambda에 업로드합니다. 또는 다른 수단을 통해 배포합니다.

6. AWS Lambda 콘솔에서 핸들러를 설정합니다. 예제 Java Lambda 의 경우 핸들러는 com.handler.example.MyLambdaHandler::handleRequest 입니다. handleRequest 이 가정되기 때문에 com.handler.example.MyLambdaHandler 를 사용할 수도 있습니다.

7. 환경 변수를 구성합니다.

8. AWS Management Console의 설정 탭에서 Lambda 함수에 NR.Apm.Lambda.Mode: true 태그를 추가하세요.

9. Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.

   래퍼는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 그런 다음 해당 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .

   다음과 같은 일반적인 사용 사례를 보여주는 전체 프로젝트는 AWS Lambda 분산 추적 예제 를 참조하십시오.

• Lambda 함수 간의 분산 추적
• 수동 스팬 생성(커스텀 계측이라고도 함)
• 외부 통화 추적
• 스팬에 사용자 정의 속성(태그라고도 함) 추가

Node.js Lambda를 계측하려면:

1. Node.js 에이전트 패키지를 다운로드하고 함수와 동일한 디렉터리에 배치하여 에이전트가 node_modules 디렉터리에 종속 항목으로 설치되었는지 확인합니다. 노드 패키지 관리자를 사용합니다.

   bash

   카피

   $
   npm install newrelic --save

2. Lambda 코드에서 파일 맨 위에 에이전트 모듈을 요구하고 핸들러 함수를 newrelic setLambdaHandler 으로 래핑합니다. 예를 들어:

   • CommonJS에 대한 샘플 코드:

   const newrelic = require('newrelic');
   // Other module loads go under the require statement above
   
   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     // This is your handler function code
     console.log('Lambda executed');
     callback();
   });

   카피
   • ES 모듈의 샘플 코드:

   import newrelic from 'newrelic';
   // Other module loads go under the require statement above
   
   export const handler = newrelic.setLambdaHandler((event, context, callback) => {
     // This is your handler function code
     console.log('Lambda executed');
     callback();
   });

   카피

3. 선택 사항: recordCustomEvent API 를 사용하여 Lambda에 사용자 지정 이벤트 를 추가할 수도 있습니다. 예를 들어:

   • CommonJS의 샘플 코드:

   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
     console.log('Lambda executed');
     callback();
   });

   카피
   • ES 모듈의 샘플 코드:

   export const lambdaHandler = newrelic.setLambdaHandler((event, context, callback) => {
     newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
     console.log('Lambda executed');
     callback();
   });

   카피

4. Lambda 함수와 Node.js 에이전트 폴더를 함께 압축합니다. 요구 사항 및 권장 사항:

   • New Relic 에이전트 폴더 외부에 있는 New Relic 파일은 포함할 필요가 없습니다.
   • 예를 들어 Lambda 함수 파일 이름이 lambda_function.node 인 경우 zip 파일의 이름을 lambda_function.zip 로 지정하는 것이 좋습니다. 타르볼을 사용하지 마십시오.
   • Lambda 및 관련 모듈은 모두 zip 파일의 루트 디렉터리에 있어야 합니다. 즉, 파일이 포함된 폴더를 압축하면 작동하지 않습니다.

5. 압축된 파일을 AWS Lambda 계정에 업로드합니다.

6. 환경 변수를 구성합니다.

7. AWS Management Console의 설정 탭에서 Lambda 함수에 NR.Apm.Lambda.Mode: true 태그를 추가하세요.

8. HTML을 완료하려면 다음 단계 중 하나를 수행하여 스프레드시트 데이터를 뉴렐릭으로 보내세요.

   • 뉴렐릭 Lambda Extension layer 를 사용하세요. 최신 (NewRelicLambdaExtension) 레이어 arn을 가져올 수 있습니다. AWS CLI를 사용하여 계층을 설치하거나 Lambda에 수동으로 추가할 수 있습니다.
   bash

   카피

   $
   aws lambda update-function-configuration --function-name <your-lambda-function-name> --layers arn:aws:lambda:<aws-region>:451483290750:layer:NewRelicLambdaExtension:<version>

• newrelic-log-ingestion 을 사용하세요. 자세한 단계는 CloudWatch 폴백을 참조하세요.

Python Lambda를 계측하려면:

1. Python 에이전트와 Python 람다 래퍼 패키지를 모두 다운로드하고 함수 코드와 동일한 디렉터리에 배치합니다. 이렇게 하려면 pip를 사용하세요.

   bash

   카피

   $
   pip install -t . newrelic newrelic-lambda

   중요

   Homebrew를 사용하는 경우 다음 오류가 발생할 수 있습니다. DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both . 자세한 내용은 Homebrew GitHub 게시물 을 참조하십시오.

2. Lambda 코드에서 Python 에이전트 모듈과 Python 람다 래퍼 모듈을 모두 가져옵니다.

3. 뉴렐릭 데코레이터를 사용하여 핸들러 함수를 장식합니다. 뉴렐릭 패키지를 코드에서 먼저 가져와야 합니다. 예는 다음과 같습니다.

   import newrelic.agent
   from newrelic_lambda.lambda_handler import lambda_handler
   
   newrelic.agent.initialize()
   
   @lambda_handler()
   def handler(event, context):
     ...

   카피

4. 선택 사항: record_custom_event API 를 사용하여 Lambda에 사용자 지정 이벤트 를 추가할 수도 있습니다. 다음은 예입니다.

   @lambda_handler()
   def handler(event, context):
     newrelic.agent.record_custom_event('CustomEvent', {'foo': 'bar'})
     ...

   카피

5. 다음 가이드라인을 사용하여 lambda_function.py 및 newrelic/ 폴더를 함께 압축합니다.

   • newrelic/ 폴더 외부에 있는 New Relic 파일은 포함할 필요가 없습니다.
   • 예를 들어 Lambda 함수 파일 이름이 lambda_function.py 인 경우 zip 파일의 이름을 lambda_function.zip 로 지정합니다. 타르볼을 사용하지 마십시오.
   • Lambda 및 관련 모듈은 모두 zip 파일의 루트 디렉터리에 있어야 합니다. 즉, 파일이 포함된 폴더를 압축하면 작동하지 않습니다.

6. 압축된 파일을 AWS Lambda 계정에 업로드합니다.

7. 환경 변수를 구성합니다.

8. AWS Management Console의 설정 탭에서 Lambda 함수에 NR.Apm.Lambda.Mode: true 태그를 추가하세요.

9. Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.

   New Relic 데코레이터는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 그런 다음 해당 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .

대부분의 경우 .NET 에이전트는 자동으로 AWS Lambda 함수를 로그하고 "서버리스 모드"로 전환하여 뉴렐릭 및 기타 기능으로 직접 데이터 전송을 비활성화합니다. 뉴렐릭으로 데이터를 보내려면 뉴렐릭 Lambda 확장 또는 newrelic-log-ingestion 람다 메서드를 사용해야 합니다.

.NET Lambda를 리뷰하려면:

1. 프로젝트에 NewRelic.에이전트 nuget 패키지를 AWS Lambda 추가합니다. 자세한 내용은 설치 가이드를 참조하세요.
2. 환경 변수를 구성합니다.
3. AWS Management Console의 설정 탭에서 Lambda 함수에 NR.Apm.Lambda.Mode: true 태그를 추가하세요.
4. 프로젝트를 AWS Lambda 계정에 게시합니다.
5. 뉴렐릭 Lambda 확장 또는 newrelic-log-ingestion 람다를 구성합니다 .
6. Lambda를 한 번 이상 호출하여 오류를 확인하고 뉴렐릭 UI 에 데이터가 표시되는지 확인하세요.