Lambda 모니터링을 위한 레거시 수동 계측

이 페이지에서는 수동으로 람다 함수를 계측하는 방법을 배웁니다. 런타임 언어별로 구성되어 있습니다.

Go 언어 Lambda를 계측하려면:

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
```
Lambda 코드에서 구성 요소를 가져오고 애플리케이션을 생성하고 Lambda를 시작하는 방법을 업데이트합니다. 계측 예를 참조하십시오.
- 확장 저장소
- 에이전트 리포지토리로 이동
선택적으로 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!")
}
```
Lambda 함수를 빌드 및 압축하여 AWS에 업로드합니다.
다음은 Lambda를 압축하고 업로드하기 위한 제안 사항입니다.
Linux에서 실행할 바이너리를 빌드합니다. 그러면 main 이라는 바이너리 파일이 생성됩니다. 당신이 사용할 수있는:
bash
$GOOS=linux go build -o main
다음을 사용하여 바이너리를 배포 패키지에 압축합니다.
bash
$zip deployment.zip main
AWS Lambda 콘솔 또는 AWS CLI를 사용하여 zip 파일을 AWS에 업로드합니다. 핸들러의 이름을 main 로 지정합니다(바이너리 빌드 중에 지정된 이름과 일치하도록).
다음 환경 변수는 Lambda 모니터링이 작동하는 데 필요하지 않지만 Lambda 함수를 분산 추적에 포함하려는 경우에는 필요합니다. 분산 추적 을 활성화하려면 AWS 콘솔에서 다음 환경 변수 를 설정하십시오.
- NEW_RELIC_ACCOUNT_ID. 귀하의 계정 ID
- NEW_RELIC_TRUSTED_ACCOUNT_KEY. 이것은 또한 귀하의 계정 ID 입니다. 계정이 하위 계정인 경우 루트/상위 계정의 계정 ID입니다.
선택적으로 로깅을 구성하려면 Go 에이전트 로깅 을 참조하십시오.
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 구현입니다. 범위, 오류 이벤트, 트랜잭션 이벤트, 오류 추적을 생성하고 분산 추적 지원을 제공합니다.
팁
지원되는 OpenTracing 버전
- 오픈트레이싱 0.31.0 :
  - 람다 추적기:com.newrelic.opentracing:newrelic-java-lambda:1.1.1
  - 람다 SDK: com.newrelic.opentracing:java-aws-lambda:1.0.0
- 오픈트레이싱 0.32.0, 0.33.0 :
  - 람다 추적기: com.newrelic.opentracing:newrelic-java-lambda:2.2.1
  - 람다 SDK: com.newrelic.opentracing:java-aws-lambda:2.1.0
Java Lambda를 계측하려면:

프로젝트의 build.gradle 파일에 OpenTracing AWS Lambda Tracer 및 AWS Lambda OpenTracing SDK 종속성을 포함합니다.

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

Java Lambda 예시 와 같이 AWS Lambda RequestHandler 인터페이스를 구현하고 doHandleRequest 메서드를 재정의합니다.
doHandleRequest 메서드에서 LambdaTracing.instrument(...) API를 호출하여 람다 함수의 실행을 추적할 루트 범위를 만듭니다. 여기에서 람다 함수에 대한 비즈니스 논리를 정의할 수도 있습니다.
Java Lambda 예시 와 같이 LambdaTracer.INSTANCE 을 OpenTracing Global tracer로 등록합니다.
ZIP 배포 패키지를 생성하고 AWS Lambda에 업로드합니다. 또는 다른 수단을 통해 배포합니다.
AWS Lambda 콘솔에서 핸들러를 설정합니다. 예제 Java Lambda 의 경우 핸들러는 com.handler.example.MyLambdaHandler::handleRequest 입니다. handleRequest 이 가정되기 때문에 { com.handler.example.MyLambdaHandler 를 사용할 수도 있습니다.
Lambda 함수를 분산 추적 에 포함하려면 다음 AWS 콘솔 환경 변수 가 필요합니다. 이것은 권장됩니다.
- NEW_RELIC_ACCOUNT_ID. 귀하의 계정 ID
- NEW_RELIC_PRIMARY_APPLICATION_ID. 이것은 또한 귀하의 계정 ID 입니다.
- NEW_RELIC_TRUSTED_ACCOUNT_KEY. 이것은 또한 귀하의 계정 ID 입니다. 계정이 하위 계정인 경우 루트/상위 계정의 계정 ID여야 합니다.
선택 사항: Lambda 콘솔에서 다음 환경 변수를 추가하여 디버그 로깅을 활성화합니다. NEW_RELIC_DEBUG is true .
Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.
래퍼는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 그런 다음 해당 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .
다음과 같은 일반적인 사용 사례를 보여주는 전체 프로젝트는 AWS Lambda 분산 추적 예제 를 참조하십시오.

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

.NET Core 기반 AWS Lambda 함수 모니터링은 표준 .NET Core APM 에이전트 를 사용하지 않습니다. 대신 NuGet 패키지를 사용합니다.

.NET Core Lambda를 계측하려면:

Lambda 함수 프로젝트에서 NewRelic.OpenTracing.AmazonLambda.Tracer NuGet 패키지를 설치합니다.
참고: NewRelic.OpenTracing.AmazonLambda.Tracer 은(는) Amazon.Lambda.APIGatewayEvent NuGet 패키지의 버전 1.2.0 이상에 따라 다릅니다. 환경에서 이미 Amazon.Lambda.APIGatewayEvent 의 낮은 버전을 사용하는 경우 New Relic 패키지는 System.MissingMethodException 과 같은 오류를 생성할 수 있습니다.
NuGet 패키지 및 OpenTracing 유틸리티를 가져옵니다.
```
using OpenTracing.Util;
using NewRelic.OpenTracing.AmazonLambda;
```

다음 예와 같이 함수를 계측합니다.

public class Function
{
  static Function()
  {
    // Register The NewRelic Lambda Tracer Instance
    GlobalTracer.Register(NewRelic.OpenTracing.AmazonLambda.LambdaTracer.Instance);
  }

  public object FunctionWrapper(ILambdaContext context)
  {
    // Instantiate NewRelic TracingWrapper and pass your FunctionHandler as
    // an argument
    return new TracingRequestHandler().LambdaWrapper(FunctionHandler, context);
  }

  /// <summary>
  /// A simple function that takes a string and does a ToUpper
  /// </summary>
  /// <param name="input"></param>
  /// <param name="context"></param>
  /// <returns></returns>
  public object FunctionHandler(ILambdaContext context)
  { ... }

}

팁

FunctionWrapper 에 전달된 인수는 FunctionHandler 의 서명과 일치해야 합니다.

핸들러 함수가 작업을 반환하면 Lambda 래퍼는 완료될 때까지 반환 작업을 차단하므로 기간을 측정하고 예외가 있는 경우 예외를 캡처할 수 있습니다. 또한 APIGatewayProxyFunction 에서 상속할 수도 있습니다.

예를 들어 아래를 참조하십시오.

public async Task<int> FunctionHandlerAsync(ILambdaContext lambdaContext)
{
  return await new TracingRequestHandler().LambdaWrapper(
                        ActualFunctionHandlerAsync, lambdaContext);
}

public async Task<APIGatewayProxyResponse> ActualFunctionHandlerAsync(ILambdaContext
lambdaContext)
{ 
  // Function can make other async operations here
  ...
}

public class LambdaFunction : APIGatewayProxyFunction
{
  static LambdaFunction()
  {
    // Register The NewRelic Lambda Tracer Instance
    OpenTracing.Util.GlobalTracer.Register(NewRelic.OpenTracing.AmazonLambda.LambdaTracer.Instance);
  }

  public override Task<APIGatewayProxyResponse> FunctionHandlerAsync(APIGatewayProxyRequest request, ILambdaContext lambdaContext)
  {
    Task<APIGatewayProxyResponse> task = new TracingRequestHandler().LambdaWrapper(ActualFunctionHandlerAsync, request, lambdaContext);
    return task;
  }

  public Task<APIGatewayProxyResponse> ActualFunctionHandlerAsync(APIGatewayProxyRequest request, ILambdaContext lambdaContext)
  {
    return base.FunctionHandlerAsync(request, lambdaContext);
  }
}

SQS 및 SNS에 대한 선택 사항: .NET Lambda Tracer 버전 1.0부터 SQS 및 SNS에 대한 분산 추적 지원이 추가되었습니다. SQS 또는 SNS에 대한 분산 추적을 활성화하려면 이 단계의 항목을 완료하고 이 단계 다음 단계에서 환경 변수를 설정해야 합니다.

중요

SQS 및 SNS에 대한 분산 추적 지원을 활성화하면 SQS 및 SNS 모두에 대한 자동 계측이 비활성화되고 이러한 래퍼를 사용하여 계측해야 합니다.

NEW_RELIC_USE_DT_WRAPPER 환경 변수를 true 로 설정합니다.
SQS 및 SNS 호출을 계측하려면 제공된 래퍼를 사용해야 합니다.

SQS 래퍼는 다음 메서드 래핑을 지원합니다.

Amazon.SQS.AmazonSQSClient.SendMessageAsync(...)

Amazon.SQS.AmazonSQSClient.SendMessageBatchAsync(...)

예

// SQS Client
AmazonSQSClient client = new AmazonSQSClient("AWS_SECRET_ACCESS_KEY", AWS_REGION);

// SendMessageRequest
SendMessageRequest sendRequest = new SendMessageRequest("QUEUE_URI_STRING", "An SQS Message");
Task<SendMessageResponse> responseOne = SQSWrapper.WrapRequest(client.SendMessageAsync, sendRequest);

// String-based
Task<SendMessageResponse> responseTwo = SQSWrapper.WrapRequest(client.SendMessageAsync, "QUEUE_URI_STRING", "Another SQS Message");

// SendMessageBatchRequest
List<SendMessageBatchRequestEntry> batchEntries = new List<SendMessageBatchRequestEntry>();
batchEntries.Add(new SendMessageBatchRequestEntry("id1", "First SQS Message"));
batchEntries.Add(new SendMessageBatchRequestEntry("id2", "Second SQS Message"));
batchEntries.Add(new SendMessageBatchRequestEntry("id3", "Third SQS Message"));
SendMessageBatchRequest sendBatchRequest = new SendMessageBatchRequest(QUEUE_URI, batchEntries);
Task<SendMessageBatchResponse> response = SQSWrapper.WrapRequest(client.SendMessageBatchAsync, sendBatchRequest);

// SendMessageBatchRequestEntry List
List<SendMessageBatchRequestEntry> moreBatchEntries = new List<SendMessageBatchRequestEntry>();
batchEntries.Add(new SendMessageBatchRequestEntry("id4", "Fourth SQS Message"));
batchEntries.Add(new SendMessageBatchRequestEntry("id5", "Fifth SQS Message"));
batchEntries.Add(new SendMessageBatchRequestEntry("id6", "Sixth SQS Message"));
Task<SendMessageBatchResponse> response = SQSWrapper.WrapRequest(client.SendMessageBatchAsync, moreBatchEntries);

SNS 래퍼는 다음 메서드 래핑을 지원합니다.

Amazon.SimpleNotificationService.AmazonSimpleNotificationServiceClient.PublishAsync(...)

예

// SNS Client
AmazonSimpleNotificationServiceClient client = new Amazon.SimpleNotificationService.AmazonSimpleNotificationServiceClient("AWS_SECRET_ACCESS_KEY", AWS_REGION);

// PublishRequest - Phone Number
PublishRequest phonePublishRequest = new PublishRequest();
phonePublishRequest.PhoneNumber = +1XXX5555100;
phonePublishRequest.Message = "An SNS Message for phones";
Task<PublishResponse> phoneResponse = SNSWrapper.WrapRequest(client.PublishAsync, phonePublishRequest);

// PublishRequest - ARN
PublishRequest publishRequest = new PublishRequest("TOPIC_ARN", "An SNS Message");
Task<PublishResponse> publishResponse = SNSWrapper.WrapRequest(client.PublishAsync, publishRequest);

// String-based without subject
Task<PublishResponse> responseOne = SNSWrapper.WrapRequest(client.PublishAsync, "TOPIC_ARN", "Another SNS Message");

// String-based with subject
Task<PublishResponse> responseTwo = SNSWrapper.WrapRequest(client.PublishAsync, "TOPIC_ARN", "Yet Another SNS Message", "A Subject");

다음 환경 변수는 Lambda 모니터링이 작동하는 데 필요하지 않지만 Lambda 함수를 분산 추적에 포함하려는 경우에는 필요합니다. 분산 추적 을 활성화하려면 AWS Lambda 콘솔 에서 다음 환경 변수를 설정하십시오.
- NEW_RELIC_ACCOUNT_ID: Lambda가 보고하는 계정 ID 입니다.
- NEW_RELIC_TRUSTED_ACCOUNT_KEY: 이것은 계정 ID 이기도 합니다. 계정이 하위 계정인 경우 루트/상위 계정의 계정 ID여야 합니다.
래퍼 함수(위의 예에서 FunctionWrapper )가 함수 핸들러로 설정되어 있는지 확인합니다.
Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.
래퍼는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 다음 으로 이러한 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .

Node.js Lambda를 계측하려면:

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

Lambda 코드에서 파일 상단에 에이전트 모듈을 요구하고 핸들러 함수를 래핑합니다. 예를 들어:

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();
});

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

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

Lambda 함수와 Node.js 에이전트 폴더를 함께 압축합니다. 요구 사항 및 권장 사항:
- New Relic 에이전트 폴더 외부에 있는 New Relic 파일은 포함할 필요가 없습니다.
- 예를 들어 Lambda 함수 파일 이름이 lambda_function.node 인 경우 zip 파일의 이름을 lambda_function.zip 로 지정하는 것이 좋습니다. 타르볼을 사용하지 마십시오.
- Lambda 및 관련 모듈은 모두 zip 파일의 루트 디렉터리에 있어야 합니다. 즉, 파일이 포함된 폴더를 압축하면 작동하지 않습니다.
압축된 파일을 AWS Lambda 계정에 업로드합니다.
AWS 콘솔에서 다음 환경 변수 를 설정합니다.
- NEW_RELIC_NO_CONFIG_FILE. 구성 파일을 사용하지 않는 경우 true 으로 설정합니다.
- NEW_RELIC_APP_NAME: 귀하의 애플리케이션 이름.
- NEW_RELIC_ACCOUNT_ID. 귀하의 계정 ID
- NEW_RELIC_TRUSTED_ACCOUNT_KEY. 이것은 또한 귀하의 계정 ID 입니다. 계정이 하위 계정인 경우 루트/상위 계정의 계정 ID여야 합니다.
선택 사항: 로컬 환경에서 AWS 외부의 서버리스 모드로 에이전트를 실행하려면 환경 변수 NEW_RELIC_SERVERLESS_MODE_ENABLED 를 true 로 설정합니다. (AWS Lambda 환경에서 실행할 때 에이전트는 자동으로 서버리스 모드에서 실행됩니다. AWS에서 실행 중인 경우 이 변수를 사용하지 마십시오 .)
선택 사항: 서버리스 모드에서 로깅을 활성화하려면 다음 환경 변수를 설정합니다.
- NEW_RELIC_LOG_ENABLED 을 true 로 설정합니다.
- CloudWatch로 출력하려면 NEW_RELIC_LOG 를 stdout 로 설정하거나 쓰기 가능한 파일 위치로 설정합니다.
- NEW_RELIC_LOG_LEVEL 기본적으로 info 으로 설정되며 Lamba에서 기능 로그를 보낼 때만 사용됩니다. 다른 로그 수준 을 참조하십시오.
Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.
래퍼는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 다음 으로 이러한 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .
Lambda를 사용하여 함수 로그를 보내는 방법에 대해 자세히 알아보십시오.

Python Lambda를 계측하려면:

Python 에이전트 패키지를 다운로드하여 함수와 동일한 디렉터리에 배치합니다. 이렇게 하려면 pip를 사용합니다.
bash
```
$pip install -t . newrelic
```
중요
Homebrew를 사용하는 경우 다음 오류가 발생할 수 있습니다. DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both . 자세한 내용은 Homebrew GitHub 게시물 을 참조하십시오.
Lambda 코드에서 Python 에이전트 모듈을 가져오고 New Relic 데코레이터를 사용하여 핸들러 함수를 장식합니다. New Relic 패키지는 코드에서 먼저 가져와야 합니다. 다음은 예입니다.
```
import newrelic.agent
newrelic.agent.initialize()
@newrelic.agent.lambda_handler()
def handler(event, context):
...
```
선택 사항: record_custom_event API 를 사용하여 Lambda에 사용자 지정 이벤트 를 추가할 수도 있습니다. 다음은 예입니다.
```
@newrelic.agent.lambda_handler()
def handler(event, context):
newrelic.agent.record_custom_event('CustomEvent', {'foo': 'bar'})
...
```
다음 가이드라인을 사용하여 lambda_function.py 및 newrelic/ 폴더를 함께 압축합니다.
- newrelic/ 폴더 외부에 있는 New Relic 파일은 포함할 필요가 없습니다.
- 예를 들어 Lambda 함수 파일 이름이 lambda_function.py 인 경우 zip 파일의 이름을 lambda_function.zip 로 지정합니다. 타르볼을 사용하지 마십시오.
- Lambda 및 관련 모듈은 모두 zip 파일의 루트 디렉터리에 있어야 합니다. 즉, 파일이 포함된 폴더를 압축하면 작동하지 않습니다.
압축된 파일을 AWS Lambda 계정에 업로드합니다.
AWS 콘솔에서 다음 환경 변수 를 설정합니다.
- NEW_RELIC_SERVERLESS_MODE_ENABLED. 로 설정 true
다음 환경 변수는 Lambda 모니터링이 작동하는 데 필요하지 않지만 Lambda 함수를 분산 추적에 포함하려는 경우에는 필요합니다. 분산 추적 을 활성화하려면 AWS 콘솔에서 다음 환경 변수 를 설정하십시오.
- NEW_RELIC_DISTRIBUTED_TRACING_ENABLED. 참으로 설정합니다.
- NEW_RELIC_ACCOUNT_ID. 귀하의 계정 ID
- NEW_RELIC_TRUSTED_ACCOUNT_KEY. 이것은 또한 귀하의 계정 ID 입니다. 계정이 하위 계정인 경우 루트/상위 계정의 계정 ID여야 합니다.
선택 사항: 로깅을 구성하려면 AWS 콘솔에서 NEW_RELIC_LOG 및 NEW_RELIC_LOG_LEVEL 환경 변수 를 사용합니다.
Lambda를 한 번 이상 호출합니다. 그러면 다음 단계가 작동하기 위해 있어야 하는 CloudWatch 로그 그룹이 생성됩니다.
New Relic 데코레이터는 Lambda 실행에 대한 데이터를 수집하고 JSON 메시지를 생성하여 CloudWatch Logs에 기록합니다. 그런 다음 해당 로그를 New Relic 으로 보내도록 CloudWatch를 구성합니다 .

사용자의 편의를 위해 제공되는 기계 번역입니다.

Lambda 모니터링을 위한 레거시 수동 계측

가다

압축 및 업로드 권장 사항

자바

팁

.NET Core

팁

비동기 처리기 기능

APIGatewayProxyFunction에서 상속

중요

SQS 래퍼 사용

SNS 래퍼 사용

노드.js

파이썬

중요