Datadog Serverless Framework プラグインを使用すれば、Lambda を App and API Protection で自動的に構成、デプロイすることができます。
Datadog Serverless Framework プラグインをインストールして構成するには、
Datadog Serverless Framework プラグインをインストールします。
serverless plugin install --name serverless-plugin-datadog
serverless.yml を enableASM 構成パラメーターで更新して、App and API Protection を有効にします。
custom:
datadog:
appSecMode: on
全体として、新しい serverless.yml ファイルには少なくとも以下が含まれている必要があります。
custom:
datadog:
apiKeySecretArn: "{Datadog_API_Key_Secret_ARN}" # or apiKey
appSecMode: on
さらに Lambda の設定を構成する場合は、プラグインパラメーターの一覧も参照してください。
関数を再デプロイし、呼び出します。数分後、App and API Protection ビューに表示されます。
Datadog CLI は、既存の Lambda 関数の構成を修正し、新しいデプロイを必要とせずにインスツルメンテーションを可能にします。Datadog のサーバーレスモニタリングを素早く開始するための最適な方法です。
関数の初期トレースを設定する場合は、以下の手順を実行します。
Datadog CLI クライアントをインストールします。
npm install -g @datadog/datadog-ci
Datadog のサーバーレスモニタリングを初めて利用する場合は、Datadog CLI をインタラクティブモードで起動して初回インストールを案内します。その場合、以降のステップは省略できます。本番アプリケーションに Datadog を永続的にインストールするには、このステップをスキップし、残りのステップに従って、通常のデプロイ後に CI/CD パイプラインで Datadog CLI コマンドを実行します。
datadog-ci lambda instrument -i --appsec
AWS の認証情報を構成します。
Datadog CLI は AWS Lambda サービスへのアクセスを必要とし、AWS JavaScript SDK に依存して[認証情報を解決][1]します。AWS CLI を呼び出すときと同じ方法で、AWS 認証情報が構成されていることを確認してください。
Datadog サイトを構成します。
export DATADOG_SITE="<DATADOG_SITE>"
Replace <DATADOG_SITE> with (このページの右側で正しい Datadog サイト が選択されていることを確認します)。
Datadog API キーを構成します。
Datadog は、セキュリティのために Datadog API キーを AWS Secrets Manager に保存することを推奨します。キーはプレーンテキストの文字列として保存する必要があります (JSON ブロブではありません)。Lambda 関数に必要な secretsmanager:GetSecretValue IAM 権限があることを確認してください。
export DATADOG_API_KEY_SECRET_ARN="<DATADOG_API_KEY_SECRET_ARN>"
For testing purposes, you can also set the Datadog API key in plaintext:
export DATADOG_API_KEY="<DATADOG_API_KEY>"
Lambda 関数にインスツルメンテーションを適用します。
Lambda 関数をインスツルメントするには、次のコマンドを実行します。
datadog-ci lambda instrument --appsec -f <functionname> -f <another_functionname> -r <aws_region> -e 103
To fill in the placeholders:
- Replace `<functionname>` and `<another_functionname>` with your Lambda function names.
- Alternatively, you can use `--functions-regex` to automatically instrument multiple functions whose names match the given regular expression.
- Replace `<aws_region>` with the AWS region name.
**注**: まず、開発環境またはステージング環境で Lambda 関数にインスツルメンテーションを適用します。結果が満足できない場合は、同じ引数で `uninstrument` を実行して変更を元に戻してください。CLI が完了したら、App and API Protection を有効にするために、最新の `datadog-lambda-go` モジュールリリースに依存するようにソースコードを更新します。
Additional parameters can be found in the [CLI documentation][2].
[1]: https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html
[2]: https://docs.datadoghq.com/ja/serverless/serverless_integrations/cli
Datadog CDK コンストラクト は、Lambda レイヤーを使用して Datadog を関数に自動的にインストールし、Datadog Lambda 拡張機能を介してメトリクス、トレース、ログを Datadog に送信するように関数を構成します。
Datadog CDK コンストラクトライブラリをインストールします。
npm install datadog-cdk-constructs-v2 --save-dev
Lambda 関数をインスツルメントします。
import { Datadog, DatadogAppSecMode } from "datadog-cdk-constructs-v2";
const datadog = new Datadog(this, "Datadog", {
extension_layer_version: 103,
site: \"<DATADOG_SITE>\",
api_key_secret_arn: "<DATADOG_API_KEY_SECRET_ARN>", // or api_key
enable_asm: true,
datadog_app_sec_mode: DatadogAppSecMode.ON,
});
datadog.add_lambda_functions([<LAMBDA_FUNCTIONS>]);
To fill in the placeholders:
- Replace
<DATADOG_SITE> with (右側で正しいサイトが選択されていることを確認してください)。 <DATADOG_API_KEY_SECRET_ARN> を、Datadog API キーが安全に保存されている AWS シークレットの ARN に置き換えてください。キーはプレーンテキストの文字列として保存する必要があります (JSON ブロブではありません)。secretsmanager:GetSecretValue の権限が必要です。迅速なテストのために、代わりに apiKey を使用し、Datadog API キーをプレーンテキストで設定できます。
More information and additional parameters can be found on the Datadog CDK documentation.
最新の Go トレーサーを使用するように関数コードを更新します。
go get -u github.com/DataDog/datadog-lambda-go
以下のいずれかの形式の ARN を使用して、Lambda 関数のレイヤーを設定し、Datadog Lambda Extension をインストールします。<AWS_REGION>を、us-east-1 のような有効な AWS リージョンに置き換えてください。
# x86-based Lambda in AWS commercial regions
arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-Extension:103
# AWS 商用リージョンの arm64 ベースの Lambda
arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-Extension-ARM:103
# AWS GovCloud リージョンの x86 ベースの Lambda
arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:Datadog-Extension:103
# AWS GovCloud リージョンの arm64 ベースの Lambda
arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:Datadog-Extension-ARM:103
Enable App and API Protection by adding the following environment variables on your function deployment:
environment:
AWS_LAMBDA_EXEC_WRAPPER: /opt/datadog_wrapper
DD_SERVERLESS_APPSEC_ENABLED: true
関数を再デプロイし、呼び出します。数分後、[App and API Protection ビュー][1]に表示されます。
[1]: https://app.datadoghq.com/security/appsec?column=time&order=desc