Datadog는 서버리스 애플리케이션을 구축하기 위해 서버리스 프레임워크를 사용하는 개발자가 서버리스 프레임워크 플러그인을 쓰는 것을 권장합니다. 플러그인은 다음 방법으로 메트릭, 트레이스와 로그를 수집하기 위해 애플리케이션 계측을 활성화합니다.

• Datadog 람다 라이브러리를 람다 레이어로 람다 함수에 설치
• 람다 레이어로 람다 함수에 Datadog 람다 확장 설치(addExtension) 또는 람다 함수의 로그 그룹에 Datadog 포워더(Forwarder) 구독(forwarderArn)
• 람다 함수에 환경 변수 또는 추가 트레이싱 레이어 추가 등 필수 구성 변경 사항 적용

시작하기

빠르게 시작하려면 파이썬(Python), Node.js, 루비(Ruby), 자바(Java), 고(Go) 또는 .NET 애플리케이션 지침을 따르고 Datadog에서 함수의 향상된 메트릭, 트레이스와 로그를 봅니다.

설치가 완료된 후 모니터링 요구 사항에 맞춰 고급 옵션을 설정합니다.

업그레이드

플러그인의 각 버전은 구체적인 Datadog 람다 레이어 버전으로 게시됩니다. 최신 버전의 Datadog 람다 레이어가 제공하는 새로운 기능과 버그 수정 사항으로 업데이트하려면, 서버리스 프레임워크 플러그인을 업그레이드하세요. 프로덕션 애플리케이션에 적용하기 전 새 버전을 테스트합니다.

설정 파라미터

플러그인을 추가로 구성하려면 serverless.yml에서 다음 사용자 지정 파라미터를 사용합니다.

이 파라미터를 사용하려면 이 예시와 유사한 serverless.yml에 custom > datadog 섹션을 추가합니다.

custom:
  datadog:
    apiKeySecretArn: "{Datadog_API_Key_Secret_ARN}"
    enableXrayTracing: false
    enableDDTracing: true
    enableDDLogs: true
    subscribeToAccessLogs: true
    forwarderArn: arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder
    exclude:
      - dd-excluded-function

웹팩

웹팩과 같은 번들러를 사용하는 경우 서버리스 트레이싱 및 웹팩을 참조합니다.

TypeScript

누락 유형 정의 오류가 발생할 수 있습니다. 오류를 해결하려면 프로젝트의 package.json devDependencies 목록에 datadog-lambda-js 및 dd-trace를 추가합니다.

serverless-typescript를 사용하는 경우 serverless.yml에서 serverless-datadog가 serverless-typescript 항목 위에 있도록 합니다. 플러그인은 자동으로 .ts 파일을 감지합니다.

plugins:
  - serverless-plugin-datadog
  - serverless-typescript

특정 환경을 위한 플러그인 비활성화

환경 기준으로(--stage 통과) 플러그인을 끄려면 아래 예시와 비슷하게 구성할 수 있습니다.

provider:
  stage: ${self:opt.stage, 'dev'}

custom:
  staged: ${self:custom.stageVars.${self:provider.stage}, {}}

  stageVars:
    dev:
      dd_enabled: false

  datadog:
    enabled: ${self:custom.staged.dd_enabled, true}

서버리스 모니터

사전 설정된 기본값이 있는 7가지 권장 모니터입니다.

권장 서버리스 모니터를 활성화하고 설정하는 방법

권장 모니터를 생성하려면 해당 서버리스 모니터 ID를 사용해야 합니다. 또한 환경에서 DATADOG_API_KEY 및 DATADOG_APP_KEY를 설정해야 함을 참고하세요.

추가로 권장 모니터에 대한 파라미터를 설정하려면 아래 서버리스 모니터 ID 아래 파라미터 값을 직접 정의할 수 있습니다. 권장 모니터에 지정되지 않은 파라미터에는 기본 권장 값이 사용됩니다. 권장 모니터의 query 파라미터는 직접 수정할 수 없으며 기본적으로 위에 정의된 query 값이 사용됩니다. 하지만 options 파라미터 내에서 재정의하여 query의 임계값을 변경할 수 있습니다. 모니터를 삭제하려면 serverless.yml 템플릿에서 모니터를 제거합니다. 모니터 파라미터를 설정하는 방법에 대한 추가 설명서는 Datadog 모니터 API를 참조하세요.

함수가 배포된 후 모니터 생성이 발생합니다. 모니터가 생성에 실패하는 경우에도 함수는 여전히 성공적으로 배포됩니다.

기본값을 포함하는 권장 모니터를 생성하는 방법

파라미터 ㄱ밧을 지정하지 않고 적절한 서버리스 모니터 ID를 정의합니다.

custom:
  datadog:
    addLayers: true
    monitors:
      - high_error_rate:

권장 모니터를 설정하는 방법

custom:
  datadog:
    addLayers: true
    monitors:
      - high_error_rate:
          name: "High Error Rate with Modified Warning Threshold"
          message: "More than 10% of the function’s invocations were errors in the selected time range. Notify @data.dog@datadoghq.com @slack-serverless-monitors"
          tags: ["modified_error_rate", "serverless", "error_rate"]
          require_full_window: true
          priority: 2
          options:
            include_tags: true
            notify_audit: true
            thresholds:
              ok: 0.025
              warning: 0.05
              critical: 0.1

모니터를 삭제하는 방법

서버리스 모니터 ID와 파라미터를 제거하면 모니터가 삭제됩니다.

커스텀 모니터를 활성화하고 설정하는 방법

커스텀 모니터를 정의하려면 고유한 서버리스 모니터 ID를 정의하고 환경에 있는 API 키 및 애플리케이션 키, DATADOG_API_KEY 및 DATADOG_APP_KEY에서 허용해야 합니다. query 파라미터는 필수이지만 다른 모든 파라미터는 부수적입니다. 고유한 서버리스 모니터 ID 문자열을 정의하고 아래에서 필수 파라미터를 지정합니다. 모니터 파라미터에 대한 추가 설명서는 Datadog 모니터 API를 참조하세요.

custom:
  datadog:
    addLayers: true
    monitors:
      - custom_monitor_id:
          name: "Custom Monitor"
          query: "max(next_1w):forecast(avg:system.load.1{*}, 'linear', 1, interval='60m', history='1w', model='default') >= 3"
          message: "Custom message for custom monitor. Notify @data.dog@datadoghq.com @slack-serverless-monitors"
          tags: ["custom_monitor", "serverless"]
          priority: 3
          options:
            enable_logs_sample: true
            require_full_window: true
            include_tags: false
            notify_audit: true
            notify_no_data: false
            thresholds:
              ok: 1
              warning: 2
              critical: 3

변경 사항 중단

v5.0.0

• Datadog 확장과 함께 사용하면 이 플러그인은 람다 리소스 태그 대신 환경 변수를 통해 service 및 env 태그를 설정합니다.
• enableTags 파라미터는 새로운 service, env 파라미터를 대체합니다.

v4.0.0

• Datadog 람다 확장은 이제 텔레메트리를 Datadog에 전송하기 위한 기본 메커니즘입니다.

오프닝 이슈

이 패키지에서 버그를 발견한 경우 이슈를 작성하여 알려주세요! 새로운 이슈를 시작하기 전 기존 이슈를 검색하여 중복을 피해 주세요.

이슈를 시작할 때 가능한 경우 서버리스 프레임워크 버전, 파이썬/Node.js 버전 및 스택 트레이스를 포함하세요. 또한 적절한 경우 재현을 위한 단계를 포함해 주세요.

기능 요청에 대한 이슈를 열 수도 있습니다.

기여하기

이 패키지에 대한 이슈와 수정 사항을 찾은 경우 다음 절차에 따라 풀 요청을 시작하세요.

커뮤니티

제품 피드백 및 질문은 슬랙의 Datadog 커뮤니티의 #serverless에 가입하세요.

라이센스

달리 명시적으로 나와 있지 않은 한 이 리포지토리의 모든 파일은 Apache 라이선스 버전 2.0에 따라 라이선스가 부여되어 있습니다.

이 제품은 Datadog((https://www.datadoghq.com/). Copyright 2021 Datadog, Inc.)에서 개발된 소프트웨어를 포함합니다.