sendgridのeventdataをS3に送るやつです
構成
SendGridのエラーをS3に格納するfunctionを実行する構成です。
各サービスの役割とポイントとなる設定についてみていきましょう。 S3→Lambda→APIGateway→SendGridの順にみていきましょう〜〜〜
S3
- eventdataの保存先にS3を使用します。bucketを用意してlifecycleで保存期間を設定して終わりです。
AWS Lambda
- API Gatewayで受けたeventdataをS3に保存するために、AWS Lambdaを使います。公式ドキュメントをみるとイベントデータはJSON配列で送信されるようです。今回はPython3でfunctionを書きました。forで回して1件ずつ処理してS3に格納していきます。内容をざっと見ると、timestampのunixstampをJSTに変換しログ名にもいれて、dict型からstr型bytes型に変換しioモジュールでファイルに書き出し、それをboto3でアップロードさせました。Lambda関数のコード抜粋を載せます。
# configure with env vars BUCKET_NAME = os.environ['LOG_S3_BUCKET'] def put_to_s3(data: dict, bucket: str, key: str): xray_recorder.begin_subsegment('s3 upload') strdata = json.dumps(data) bindata = strdata.encode() try: with io.BytesIO(bindata) as data_fileobj: s3_results = s3.upload_fileobj(data_fileobj, bucket, key) logger.info(f"S3 upload errors: {s3_results}") except S3UploadFailedError as e: logger.error("Upload failed. Error:") logger.error(e) import traceback traceback.print_stack() raise xray_recorder.end_subsegment() def handler(event, context): logger.info(event) data_list = event['body'] data_dicts = json.loads(data_list) logger.info(data_dicts) for _, data in enumerate(data_dicts): unix_timestamp = data['timestamp'] jst_time = datetime.fromtimestamp(unix_timestamp) key = data['event'] + "/" + jst_time.strftime("%Y-%m/%d/%H/%Y-%m-%d-%H:%M:%S-") + "-" + data['sg_event_id'] + ".log" put_to_s3(data, BUCKET_NAME, key)
eventに何が受け取るのか最初わからずハマりました。文字列がきていたのでjson.loadsでdictに変更して値がとれるようになりました。 Lambda関数には、S3へのUpload権限を与えるのを忘れないようにしてください。
公式ドキュメントのここらへんが参考になりそう。
functionのzip化はarchive_fileを使うでもいいと思います。
Pythonのコードはとりあえず、ここらへんから参考に育てていきました。あとここらへんとかも。
- Event WebhookのHTTPリクエストをLambda Proxyを経由してAPI Gatewayで受けます。API Gatewayはリソースを作成後、ANYメソッドを作成します。プロキシリソースとの Lambda プロキシ統合を参考に設定します。設定内容としては、greedy パス変数 {proxy+} を使用してプロキシリソースを作成します。そしてプロキシリソースに ANY メソッドを設定します。API Gateway REST API の AWS_PROXYで指定されるLambda プロキシ統合は、バックエンドの Lambda 関数と統合するために使用します。Lambda プロキシ統合を使うと何がよいかなのですが、API Gatewayがリクエストとレスポンスのマッピング設定をよしなに設定してくれるので、マッピングテンプレートを書かなくなることです。以上でAPI Gatewayの設定は完了です。最後にAPIをterraformでapplyしてデプロイしてAPI Gatewayの設定は完了です。こっちのドキュメントも参照した方がいいと思います。 この記事も見やすかったです。
SendGrid
- Event WebhookはSendGridダッシュボードの「Settings > Mail Settings > Event Notification」で設定します。HTTP POST URLにAPI GatewayのエンドポイントのURLを設定します。SELECT ACTIONSで受け取りたいイベントのチェックボックスをONにして設定を保存します。今回はエラーを受け取りたいのでDropped, Deffered, Bouncedに✅を入れます。Event Notification設定画面で「Test Your Integration」ボタンを選択して、S3にテストデータが保存されていることが確認できれば設定は完了です。ここらへんに書いてあります。
まとめ
いかがでしたか?SendgridのeventdataをAWSを利用して保存する方法をみてきました。S3は耐障害性が高く、Lifecycleでログ保存期間についても簡単に設定することができます。今回の構成をeventdataの保存を考える際に参考にしてみてください。