Surveillez vos applications sans serveur avec CloudWatch Application Insights

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 dans le guide de CloudWatch l'utilisateur Amazon.

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 avecsam init, activez CloudWatch Application Insights via le flux interactif ou en utilisant l'--application-insightsoption.

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.

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 AWS::ResourceGroups::Group 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 AWS::ApplicationInsights::Application dans le Guide de l'utilisateur AWS CloudFormation .

Les deux ressources sont automatiquement transmises au AWS CloudFormation moment du déploiement de l'application. Vous pouvez utiliser la AWS CloudFormation syntaxe de votre AWS SAM modèle pour configurer davantage CloudWatch Application Insights. Pour plus d'informations, consultez la section Utiliser AWS CloudFormation des modèles 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 en charge dans le guide de CloudWatch l'utilisateur Amazon.

• Pour savoir comment accéder à CloudWatch Application Insights, consultez Access CloudWatch Application Insights dans le guide de CloudWatch l'utilisateur Amazon.