Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Utilisation d' CloudWatch Application Insights pour surveiller vos applications AWS SAM sans serveur Amazon CloudWatch Application Insights vous aide à surveiller les AWS ressources de vos applications afin d'identifier les problèmes potentiels. Il peut analyser les données relatives aux AWS ressources pour détecter les signes de problèmes et créer des tableaux de bord automatisés pour les visualiser. Vous pouvez configurer CloudWatch Application Insights pour l'utiliser avec vos AWS Serverless Application Model (AWS SAM) applications. Pour en savoir plus sur CloudWatch Application Insights, consultez [Amazon CloudWatch Application Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html) dans le *guide de CloudWatch l'utilisateur Amazon*. **Topics** + [Configuration d' CloudWatch Application Insights avec AWS SAM](#monitor-app-insights-configure) + [Étapes suivantes](#monitor-app-insights-next) ## Configuration d' CloudWatch Application Insights avec AWS SAM Configurez CloudWatch Application Insights pour vos AWS SAM applications via l'interface de ligne de AWS SAM commande (AWS SAMCLI) ou via vos AWS SAM modèles. ### Configurer via la CLI  AWS SAM Lorsque vous initialisez votre application avec**sam init**, activez CloudWatch Application Insights via le flux interactif ou en utilisant l'**--application-insights**option. Pour activer CloudWatch Application Insights via le flux AWS SAMCLI interactif, entrez **y** lorsque vous y êtes invité. ``` 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]: ``` Pour activer CloudWatch Application Insights avec **--application-insights** cette option, procédez comme suit. ``` sam init --application-insights ``` Pour en savoir plus sur l'utilisation de la commande **sam init**, consultez [sam init](sam-cli-command-reference-sam-init.md). ### Configuration à l'aide AWS SAM de modèles Activez CloudWatch Application Insights en définissant les `AWS::ApplicationInsights::Application` ressources `AWS::ResourceGroups::Group` et les ressources dans vos AWS SAM modèles. ``` 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`— Crée un groupe pour organiser vos AWS ressources afin de gérer et d'automatiser des tâches sur un grand nombre de ressources à la fois. Ici, vous créez un groupe de ressources à utiliser avec CloudWatch Application Insights. Pour plus d'informations sur ce type de ressource, veuillez consulter [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) dans le *Guide de l'utilisateur AWS CloudFormation *. + `AWS::ApplicationInsights::Application`— Configure CloudWatch Application Insights pour le groupe de ressources. Pour plus d'informations sur ce type de ressource, veuillez consulter [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) dans le *Guide de l'utilisateur AWS CloudFormation *. Les deux ressources sont automatiquement transmises au CloudFormation moment du déploiement de l'application. Vous pouvez utiliser la CloudFormation syntaxe de votre AWS SAM modèle pour configurer davantage CloudWatch Application Insights. Pour plus d'informations, consultez la section [Utiliser CloudFormation des modèles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-cloudformation.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Lorsque vous utilisez la **sam init --application-insights** commande, ces deux ressources sont automatiquement générées dans votre AWS SAM modèle. Voici un exemple de modèle généré. ``` 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 ``` ## Étapes suivantes Après avoir configuré CloudWatch Application Insights, utilisez-le **sam build** pour **sam deploy** créer et déployer votre application. Toutes les ressources prises en charge par CloudWatch Application Insights seront configurées pour la surveillance. + Pour obtenir la liste des ressources prises en charge, consultez la section [Journaux et métriques pris](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-logs-and-metrics.html) en charge dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour savoir comment accéder à CloudWatch Application Insights, consultez [Access CloudWatch Application Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-accessing.html) dans le *guide de CloudWatch l'utilisateur Amazon*.