翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # でサーバーレスアプリケーションをモニタリングする AWS SAM サーバーレスアプリケーションをデプロイしたら、それをモニタリングしてオペレーションに関するインサイトを提供し、異常を検出できます。これはトラブルシューティングに役立ちます。このセクションでは、サーバーレスアプリケーションをモニタリングする方法について説明します。これには、Amazon CloudWatch が異常を検出したときに通知を行うよう設定する方法に関する情報が含まれます。また、エラーの強調表示やログの表示、フィルタリング、フェッチ、テーリングログなど、ログの操作に関する情報も提供されます。 **Topics** + [CloudWatch Application Insights を使用して AWS SAM サーバーレスアプリケーションをモニタリングする](monitor-app-insights.md) + [でのログの使用 AWS SAM](serverless-sam-cli-logging.md) # CloudWatch Application Insights を使用して AWS SAM サーバーレスアプリケーションをモニタリングする Amazon CloudWatch Application Insights は、アプリケーション内の AWS リソースをモニタリングして潜在的な問題を特定するのに役立ちます。 AWS リソースデータを分析して問題の兆候がないか確認し、自動ダッシュボードを構築して可視化できます。 AWS Serverless Application Model (AWS SAM) アプリケーションで使用するように CloudWatch Application Insights を設定できます。CloudWatch Application Insights の詳細については、「Amazon CloudWatch ユーザーガイド」の「[Amazon CloudWatch Application Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html)」を参照してください。 **Topics** + [を使用した CloudWatch Application Insights の設定 AWS SAM](#monitor-app-insights-configure) + [次の手順](#monitor-app-insights-next) ## を使用した CloudWatch Application Insights の設定 AWS SAM コマンドラインインターフェイス (AWS SAM CLI) AWS SAM または AWS SAM テンプレートを使用して、 AWS SAM アプリケーションの CloudWatch Application Insights を設定します。 ### AWS SAM CLI による設定 **sam init** でアプリケーションを初期化するときは、インタラクティブフローまたは **--application-insights** オプションを使用して CloudWatch Application Insights を有効にします。 AWS SAM CLI のインタラクティブフローで CloudWatch Application Insights を有効にするには、プロンプトが表示されたら **y** と入力します。 ``` Would you like to enable monitoring using CloudWatch Application Insights? For more info, please view https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html [y/N]: ``` **--application-insights** オプションで CloudWatch Application Insights を有効にするには、次の操作を行います。 ``` sam init --application-insights ``` **sam init** コマンドを使用する場合の詳細については、「[sam init](sam-cli-command-reference-sam-init.md)」を参照してください。 ### AWS SAM テンプレートを使用して を設定する AWS SAM テンプレートで `AWS::ResourceGroups::Group`および `AWS::ApplicationInsights::Application`リソースを定義して、CloudWatch Application Insights を有効にします。 ``` AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 ... Resources: ApplicationResourceGroup: Type: AWS::ResourceGroups::Group Properties: Name: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName ResourceQuery: Type: CLOUDFORMATION_STACK_1_0 ApplicationInsightsMonitoring: Type: AWS::ApplicationInsights::Application Properties: ResourceGroupName: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName AutoConfigurationEnabled: 'true' DependsOn: ApplicationResourceGroup ``` + `AWS::ResourceGroups::Group` – 多数の AWS リソースのタスクを一度に管理および自動化するために、リソースを整理するグループを作成します。ここでは、CloudWatch Application Insights で使用するリソースグループを作成します。このリソースタイプの詳細については、「AWS CloudFormation ユーザーガイド」の「[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html)」を参照してください。 + `AWS::ApplicationInsights::Application` — リソースグループの CloudWatch Application Insights を設定します。このリソースタイプの詳細については、「AWS CloudFormation ユーザーガイド」の「[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationinsights-application.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationinsights-application.html)」を参照してください。 両方のリソースは、アプリケーションのデプロイ CloudFormation 時に に自動的に渡されます。 AWS SAM テンプレートの CloudFormation 構文を使用して、CloudWatch Application Insights をさらに設定できます。詳細については、*Amazon CloudWatch * [ユーザーガイド」の CloudFormation 「テンプレート](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-cloudformation.html)の使用」を参照してください。 **sam init --application-insights** コマンドを使用すると、これらのリソースの両方が AWS SAM テンプレートで自動的に生成されます。生成されたテンプレートの例を示します。 ``` AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Description: > sam-app-test Sample SAM Template for sam-app-test # More info about Globals: https://github.com/awslabs/serverless-application-model/blob/master/docs/globals.rst Globals: Function: Timeout: 3 MemorySize: 128 Resources: HelloWorldFunction: Type: AWS::Serverless::Function # More info about Function Resource: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction Properties: CodeUri: hello_world/ Handler: app.lambda_handler Runtime: python3.9 Architectures: - x86_64 Events: HelloWorld: Type: Api # More info about API Event Source: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#api Properties: Path: /hello Method: get ApplicationResourceGroup: Type: AWS::ResourceGroups::Group Properties: Name: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName ResourceQuery: Type: CLOUDFORMATION_STACK_1_0 ApplicationInsightsMonitoring: Type: AWS::ApplicationInsights::Application Properties: ResourceGroupName: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName AutoConfigurationEnabled: 'true' DependsOn: ApplicationResourceGroup Outputs: # ServerlessRestApi is an implicit API created out of Events key under Serverless::Function # Find out more about other implicit resources you can reference within SAM # https://github.com/awslabs/serverless-application-model/blob/master/docs/internals/generated_resources.rst#api HelloWorldApi: Description: API Gateway endpoint URL for Prod stage for Hello World function Value: !Sub "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/hello/" HelloWorldFunction: Description: Hello World Lambda Function ARN Value: !GetAtt HelloWorldFunction.Arn HelloWorldFunctionIamRole: Description: Implicit IAM Role created for Hello World function Value: !GetAtt HelloWorldFunctionRole.Arn ``` ## 次の手順 CloudWatch Application Insights を設定したら、**sam build** を使用してアプリケーションを構築し、**sam deploy** を使用してデプロイします。CloudWatch Application Insights がサポートするリソースはすべてモニタリング対象に設定されます。 + サポートされているリソースのリストについては、「Amazon CloudWatch ユーザーガイド」の「[サポートされているログとメトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-logs-and-metrics.html)」を参照してください。 + CloudWatch Application Insights へのアクセス方法の詳細については、「Amazon CloudWatch ユーザーガイド」の「[CloudWatch Application Insights へのアクセス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-accessing.html)」を参照してください。 # でのログの使用 AWS SAM トラブルシューティングをシンプル化するため、 AWS SAM CLI には `sam logs` というコマンドがあります。このコマンドを使用すると、コマンドラインから Lambda 関数によって生成されたログを取得できます。 **注記** `sam logs` コマンドは、 を使用してデプロイする AWS Lambda 関数だけでなく、すべての関数で機能します AWS SAM。 ## CloudFormation スタックによるログの取得 関数が CloudFormation スタックの一部である場合は、関数の論理 ID を使用してログを取得できます。 ``` sam logs -n HelloWorldFunction --stack-name mystack ``` ## Lambda 関数名によるログの取得 または、関数の名前を使用してログを取得することもできます。 ``` sam logs -n mystack-HelloWorldFunction-1FJ8PD ``` ## ログ終端の表示 `--tail` オプションを追加して、新しいログを待機し、到着するたびにそれらを表示します。これは、デプロイ中、または実稼働問題のトラブルシューティング時に役立ちます。 ``` sam logs -n HelloWorldFunction --stack-name mystack --tail ``` ## 特定時間範囲のログの表示 `-s` および `-e` オプションを使用して、特定の時間範囲のログを表示できます。 ``` sam logs -n HelloWorldFunction --stack-name mystack -s '10min ago' -e '2min ago' ``` ## ログのフィルタリング `--filter` オプションを使用して、ログイベントの語句、フレーズ、または値が一致するログをすばやく検索します。 ``` sam logs -n HelloWorldFunction --stack-name mystack --filter "error" ``` 出力では、 AWS SAM CLI が「error」という単語のすべての出現箇所に下線を追加するので、ログ出力内のフィルターキーワードを簡単に見つけることができます。 ## エラーの強調表示 Lambda 関数がクラッシュまたはタイムアウトすると、 AWS SAM CLI がタイムアウトメッセージを赤色でハイライトします。これは、ログ出力の巨大なストリーム内で、タイムアウトしている特定の実行を簡単に見つけるために役立ちます。 ## JSON の整形出力 ログメッセージが JSON 文字列で出力表示される場合、 AWS SAM CLI は、JSON を視覚的に解析して理解できるように、JSON を自動的に整形出力します。