AWS Lambda¶

AWS Lambda の表示メトリクスには、コールドスタート時間、実行時間、同時実行数、メモリ使用量が含まれ、これらは Lambda 関数の応答速度、スケーラビリティ、リソース使用状況を示します。

設定¶

Func のインストール¶

Guance の統合 - 拡張 - マネージド版 Func を有効にすることを推奨します。前提条件はすべて自動でインストールされるため、引き続きスクリプトのインストールを行ってください。

Func を自前でデプロイする場合は、Func の自前デプロイ を参照してください

スクリプトのインストール¶

ヒント: 要件を満たす AWS の AK を事前に用意してください。簡単のため、CloudWatch の読み取り専用権限 CloudWatchReadOnlyAccess を直接付与してもかまいません。

マネージド版の有効化スクリプト¶

1. Guance コンソールにログインします
2. 【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
3. 【クラウドアカウントの追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順は省略できます
4. 【テスト】をクリックし、成功したら【保存】をクリックします。失敗した場合は関連設定が正しいか確認してから再度テストしてください
5. 【クラウドアカウント管理】一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
6. クラウドアカウント詳細ページの【統合】ボタンをクリックし、未インストール 一覧で AWS Lambda を見つけて【インストール】をクリックすると、インストール画面が表示されます

手動有効化スクリプト¶

1. Func コンソールにログインし、【スクリプトマーケット】をクリックして、Guance スクリプトマーケットに入り、integration_aws_lambda を検索します

2. 【インストール】をクリックし、必要なパラメータとして AWS AK ID、AK Secret、およびアカウント名を入力します

3. 【デプロイして起動スクリプトを有効化】をクリックすると、システムが自動的に Startup スクリプトセットを作成し、対応する起動スクリプトを自動で設定します

4. 有効化後は、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。しばらくすると、実行タスクの記録と対応するログを確認できます

検証¶

1. 「管理 / 自動トリガー設定」で対応するタスクに自動トリガー設定が存在するか確認し、あわせてタスク記録とログを見て異常がないか確認します
2. Guance の「インフラストラクチャ / カスタム」でアセット情報が存在するか確認します
3. Guance の「メトリクス」で対応する監視データがあるか確認します

メトリクス¶

AWS CloudWatch を設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます:

Amazon CloudWatch Lambda メトリクスの詳細

呼び出しメトリクス¶

パフォーマンスメトリクス¶

パフォーマンスメトリクスは、単一の関数呼び出しのパフォーマンス詳細を提供します。たとえば、Duration メトリクスは、関数がイベントの処理に費やした時間をミリ秒単位で示します。関数がイベントをどれだけ速く処理しているかを把握するには、Average または Max の統計値でこれらのメトリクスを確認します。

同時実行メトリクス¶

Lambda は、関数、バージョン、エイリアス、または AWS リージョンをまたいでイベントを処理しているインスタンス数の合計を、同時実行メトリクスとして報告します。同時実行上限にどれだけ近いかを確認するには、Max の統計値でこれらのメトリクスを確認します。

非同期呼び出しメトリクス¶

非同期呼び出しメトリクスは、イベントソースからの非同期呼び出しと直接呼び出しの詳細を提供します。しきい値とアラートを設定して、特定の変化を通知できます。たとえば、処理待ちのイベント数が予期せず増加したとき（AsyncEventsReceived）や、イベントの処理完了までに長時間待機したとき（AsyncEventAge）です。

Lambda で S3 データを収集¶

AWS 上の Lambda を使って、AWS 上の S3 データを収集し、Guance に報告します

ELB ログの有効化方法については AWS ELB ログ収集 を参照してください

1. コンソールで Lambda 関数を作成する¶

1. Lamba コンソールの関数ページを開きます。

2. 関数の作成を選択します

3. 一から作成を選択します

4. 関数名を入力します

5. ランタイム オプションを Python 3.10 に設定します

6. Execution Role（実行ロール）で、Create a new role with basic Lambda permissions（基本的な Lambda 権限を持つ新しいロールを作成）を選択します。必要な権限の一覧は付録を参照してください。最小権限のロールがすでにある場合は、そのロールを直接使用できます。Lambda は実行ロールを作成し、そのロールに、関数が Amazon CloudWatch Logs へログをアップロードする権限を付与します。関数の呼び出し時、Lambda 関数は実行ロールを引き受け、その実行ロールを使用して Amazon SDK の認証情報を作成し、イベントソースからデータを読み取ります

7. 関数の作成をクリックします

8. GitHub から同期コードを取得し、下のコードソースにある lambda-forward.py の内容を lambda-function.py にコピーします

9. lambda-function.py と同じディレクトリに setting.py、datakit.py、dataway.py を新規作成し、GitHub 上の対応するファイルのコードをコピーします

10. 環境変数を追加します

    1. DATAKIT_IP：datakit がデプロイされている IP アドレス。送信先データソースは datakit。必須です
    2. DATAKIT_PORT：datakit のサービスポート。送信先データソースは datakit。任意です。既定値は 9529
    3. DATAWAY_URL: dataway の URL (Eg: https://xx-openway.xxx.com) 送信先データソースは dataway
    4. WORKSPACE_TOKEN：プラットフォームのワークスペース Token。送信先データソースは dataway

    注意：送信先データソースは datakit と dataway のどちらか一方を必ず設定してください。datakit を選ぶ場合は DATAKIT_IP を設定し、dataway を選ぶ場合は DATAWAY_URL と WORKSPACE_TOKEN を設定してください

11. datakit のポートが既定の 9529 ではない場合は、環境変数 DATAKIT_PORT を追加し、正しいポート番号を入力します（この変数は必須ではありません）

12. Deploy をクリックして公開します

2. Lambda トリガーを設定する¶

1. トリガーを追加 をクリックします

2. ソースの選択 を S3 に設定します

3. 監視したい bucket を選択します

4. Lambda 関数をトリガーするイベント Event types を選択します

5. 入力と出力に同じ S3 bucket を使うことは推奨されず、この設定は再帰呼び出し、Lambda 使用量の増加、コスト増加につながる可能性があることを承諾します

6. 追加をクリックします

ELB でログを生成する¶

ELB 上のアプリケーションにアクセスすると、ELB は生成されたログを S3 にアップロードし、Lambda 関数がそれを収集して Guance に送信します

オブジェクト¶

収集された AWS Lambda オブジェクトのデータ構造。オブジェクトデータは「インフラストラクチャ - カスタム」で確認できます

{
  "measurement": "aws_lambda",
  "tags": {
    "account_name"      :"AWS_Lambda",
    "class"             :"aws_lambda",
    "cloud_provider"    :"aws",
    "FunctionName"      :"dataflux-alb",
    "name"              :"dataflux-alb",
    "PackageType"       :"Zip",
    "RegionId"          :"cn-northwest-1",
    "RevisionId"        :"5e52ff51-615a-4ecb-96b7-40083a7b4b62",
    "Role"              :"arn:aws-cn:iam::294654068288:role/service-role/s3--xxxx-role-3w34zo42",
    "Runtime"           :"python3.7",
    "Version"           :"$LATEST"
  },
  "fields": {
    "CreatedTime"         : "2022-03-09T06:13:31Z",
    "ListenerDescriptions": "{JSON データ}",
    "AvailabilityZones"   : "{アベイラビリティゾーンの JSON データ}",
    "message"             : "{インスタンスの JSON データ}"
  }
}

注意: tags と fields のフィールドは、今後の更新で変更される可能性があります

ヒント 1: tags.account_name の値はインスタンス ID で、固有識別子として使用されます