ステップ 1: CloudFormation テンプレートをダウンロードする

Sumo 提供の CloudFormation テンプレート loggroup-lambda-cft.json をダウンロードします。このテンプレートは、LogGroup Lambda コネクタのデプロイを自動化します。 

ステップ 2: スタックを作成する

このステップでは、AWS CloudFormation コンソールを使用してスタックを作成します。

1. AWS マネジメント コンソールにログインします。
2. [Management Tool (マネジメント ツール)] で、[CloudFormation] を選択します。
3. [Create Stack (スタックの作成)] をクリックして新しいスタックを作成します。
4. [Select Template (テンプレートの選択)] ウィンドウで、[Upload a template to Amazon S3 (テンプレートを Amazon S3 にアプロード)] を選択して loggroup-lambda-cft.json をアップロードします。
   
   
5. [Next (次へ)] をクリックします。
6. スタック名を指定して、[Next (次へ)] をクリックします。[Specify Details (詳細の指定)] ウィンドウが表示されます。
   
   
7. [Specify Details (詳細の指定)] ウィンドウで、このセクションで説明しているようにパラメータを設定します。
8. [Options (オプション)] ウィンドウで、もう一度 [Next (次へ)] をクリックします。
9. [Review (確認)] ウィンドウで、テンプレートによって IAM リソースが作成されることを理解したことを認めるチェックボックスをクリックして、[Create (作成)] をクリックします。数分後に、[Status (ステータス)] 列に「CREATE_COMPLETE」と表示されます。
10. 既存のログ グループの自動サブスクライブを続行します。
11. Lambda 関数をテストします。

Lambda 関数をテストするには、次の手順を実行します。

1. LogGroupPattern について指定した正規表現に一致する名前でログ グループを作成します。 

数秒後に、ARN を LAMBDA_ARN 環境変数で指定した Lambda 関数にログ グループがサブスクライブされます。

2. Lambda 関数のログを表示します。 
   SumoLogGroupLambdaConnector-<unique_string> によって生成されたログは /aws/lambda/SumoLogGroupLambdaConnector-<unique_string> ログ グループの CloudWatch で表示できます。
3. (省略可能) コネクタのトラブルシューティングを続行します。

権限エラー 

Lambda 関数で権限エラーが発生した場合、Lambda 関数を呼び出すための CloudWatchLogs 権限を付与する必要がある場合があります。

次のエラー メッセージは、CloudWatch Logs に Lambda 関数を呼び出す権限がないことを示しています。

{
    "errorMessage": "Could not execute the lambda function. Make sure you have given CloudWatch Logs permission to execute your function.",
    "errorType": "InvalidParameterException",
    "stackTrace": [
        "Request.extractError (/var/runtime/node_modules/aws-sdk/lib/protocol/json.js:48:27)",
        "Request.callListeners (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:105:20)",
        "Request.emit (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:77:10)",
        "Request.emit (/var/runtime/node_modules/aws-sdk/lib/request.js:683:14)",
        "Request.transition (/var/runtime/node_modules/aws-sdk/lib/request.js:22:10)",
        "AcceptorStateMachine.runTo (/var/runtime/node_modules/aws-sdk/lib/state_machine.js:14:12)",
        "/var/runtime/node_modules/aws-sdk/lib/state_machine.js:26:10",
        "Request.<anonymous> (/var/runtime/node_modules/aws-sdk/lib/request.js:38:9)",
        "Request.<anonymous> (/var/runtime/node_modules/aws-sdk/lib/request.js:685:12)",
        "Request.callListeners (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:115:18)"
    ]
}

Lambda 関数を呼び出すための CloudWatch Logs 権限を付与するには、次の AWS CLI コマンドを実行します。

aws lambda add-permission --function-name "<function_name>" --statement-id "lambdapermission" --principal "logs.<region>.amazonaws.com" --action "lambda:InvokeFunction" --source-arn "arn:aws:logs:<region>:<account_id>:log-group:*:*" --source-account "<account_id>" --region=<region>

各パラメータの説明

• <function_name> はターゲット lambda 関数の FunctionName 属性です
• <region> は関数がデプロイされる AWS リージョンです
• <account> は aws アカウントの AWS アカウント ID です

AWS CLI のインストールおよび設定の詳細については、「AWS Command Line Interface をインストールする」を参照してください。

ログ グループが生成元の Lambda 関数に属する

ログ グループが生成元の Lambda 関数に属する場合、関数によって次の例外が発生します。 

{ "errorMessage": "The log group provided is reserved for the function logs of the 
destination function.", "errorType": "InvalidParameterException", "stackTrace": 
[ 
"Request.extractError (/var/runtime/node_modules/aws-sdk/lib/protocol/json.js:48:27)", 
"Request.callListeners (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:105:20)", 
"Request.emit (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:77:10)", 
"Request.emit (/var/runtime/node_modules/aws-sdk/lib/request.js:683:14)", 
"Request.transition (/var/runtime/node_modules/aws-sdk/lib/request.js:22:10)", 
"AcceptorStateMachine.runTo (/var/runtime/node_modules/aws-sdk/lib/state_machine.js:14:12)", 
"/var/runtime/node_modules/aws-sdk/lib/state_machine.js:26:10", 
"Request.<anonymous> (/var/runtime/node_modules/aws-sdk/lib/request.js:38:9)", 
"Request.<anonymous> (/var/runtime/node_modules/aws-sdk/lib/request.js:685:12)", 
"Request.callListeners (/var/runtime/node_modules/aws-sdk/lib/sequential_executor.js:115:18)" 
] }