Amazon X-Ray 入门

要创建 Elastic Beanstalk 环境

1. 使用下面的预配置链接打开 Elastic Beanstalk 管理控制台：https://console.aws.amazon.com/elasticbeanstalk/#/newApplication?applicationName=scorekeep

2. 在平台部分中，设置平台到Java和平台分支到Corretto 8 running on 64bit Amazon Linux 2.

   注意

   这些区域有：xray-gettingstartedScorekeep 应用程序的分支目前不支持 Corretto 11。

3. 选择创建应用程序以创建一个应用程序以及运行 Corretto 8 平台的环境。

4. 当您的环境准备就绪后，控制台会将您重定向到环境控制面板。

5. 单击页面顶部的 URL 以打开站点。

向 Elastic Beanstalk 环境中添加 X-Ray、Amazon S3 和 DynamoDB 权限

1. 在 IAM 控制台中打开 Elastic Beanstalk 实例配置文件：aws-elasticbeanstalk-ec2-role。

2. 选择附加策略。

3. AttachAWSXrayFullAccess、AmazonS3FullAccess、AmazonDynamoDBFullAccess, 和AmazonSNSFullAccess如果他们尚未出现，请参阅角色。

   注意

   完全访问权限策略不是适合一般使用的最佳做法。有关配置具有最低权限的策略以减少安全风险的说明，请参阅可选：权限最低策略.

部署源代码

1. 下载示例应用程序：eb-java-scorekeep-xray-gettingstarted-v2.zip

2. 打开Elastic Beanstalk 控制台.

3. 导航到管理控制台您的环境。

4. 选择 Upload and Deploy。

5. 上传 eb-java-scorekeep-xray-gettingstarted-v2.zip，然后选择部署.

生成跟踪数据

1. 在环境控制面板中，单击相应的 URL 以打开 Web 应用程序。

2. 选择 Create 来创建用户和会话。

3. 键入 game name，将 Rules 设置为 Tic Tac Toe，然后选择 Create 创建一个游戏。

4. 选择 Play 以启动游戏。

5. 选择平铺可进行移动和更改游戏状态。

要使用 X-Ray 控制台

1. 打开服务地图页面X-Ray 控制台.

2. 控制台将显示该服务的图形表示形式，这是 X-Ray 根据应用程序发送的跟踪数据生成的。

查找错误原因

1. 选择名为的节点Amazon SNS. 此时将显示节点详细信息面板。

2. 选择查看跟踪以访问 Trace 概述屏幕。

3. 从 Trace list 中选择跟踪。该跟踪没有方法或 URL，因为它是在启动期间记录的，而不是对传入请求的响应。

   

4. 选择页面底部的 Amazon SNS 区段中的错误状态图标以打开例外SNS 子区段的页面。

   

5. X-Ray 软件开发工具包会自动捕获由分析引发Amazon开发工具包客户端并记录堆栈跟踪。

   

要配置 Amazon SNS 通知以保持记分

1. 打开Elastic Beanstalk 控制台.

2. 导航到管理控制台您的环境。

3. 选择 Configuration。

4. 选择 Software Configuration。

5. 在 Environment Properties 下，用您的电子邮件地址替换默认值。

   

6. 选择 Apply（应用）。

标识 Amazon S3 资源

1. 打开 Amazon Config 控制台的“Resources”（资源）页面。

2. UNDER资源类型，按筛选方式Amazon S3 存储桶要找到您的应用程序使用的 Amazon S3 存储桶的 ARN。

3. 选择资源标识符挂载到elasticbeanstalk.

4. 记录其完整的亚马逊资源名称。

5. 将 ARN 插入到以下 IAM 策略中。

   {
      "Version": "2012-10-17",
      "Statement": [
      {
         "Sid": "ScorekeepS3",
         "Action": [
            "s3:GetObject",
            "s3:PutObject"
         ],
         "Effect": "Allow",
         "Resource": "arn:aws:s3:::elasticbeanstalk-region-0987654321"
      }
      ]
   }

标识 DynamoDB 资源

1. 打开 Amazon Config 控制台的“Resources”（资源）页面。

2. UNDER资源类型，按筛选方式AmazonDynamoDB 表要找到您的应用程序使用的 DynamoDB 表的 ARN。

3. 选择资源标识符这是附加到其中一个scorekeep表格。

4. 记录其完整的亚马逊资源名称。

5. 将 ARN 插入到以下 IAM 策略中。

   {
      "Version": "2012-10-17",
      "Statement": [
      {
         "Sid": "ScorekeepDynamoDB",
         "Effect": "Allow",
         "Action": [
            "dynamodb:PutItem",
            "dynamodb:UpdateItem",
            "dynamodb:DeleteItem",
            "dynamodb:GetItem"
         ],
         "Resource": "arn:aws:dynamodb:region:1234567890:table/scorekeep-*"
      }
      ]
   }

   应用程序创建的表遵循一致的命名约定。您可以使用 scorekeep-* 格式来表明所有表均遵循该约定。

要更改 IAM 策略

1. 在 IAM 控制台中打开 Elastic Beanstalk 实例配置文件：aws-elasticbeanstalk-ec2-role。

2. 从角色中删除 AmazonS3FullAccess 和 AmazonDynamoDBFullAccess 策略。

3. 选择 Attach policies (附加策略)，然后选择 Create policy (创建策略)。

4. 选择 JSON 并粘贴之前创建的某个策略。

5. 选择 Review policy (审核策略)。

6. 对于 Name (名称)，指定一个名称。

7. 选择 Create policy（创建策略）。

8. 将新创建的策略分配给 aws-elasticbeanstalk-ec2-role。

9. 对之前创建的第二个策略重复此操作。

终止 Elastic Beanstalk 环境

1. 打开Elastic Beanstalk 控制台.

2. 导航到管理控制台您的环境。

3. 选择 Actions。

4. 选择 Terminate Environment。

5. 选择 Terminate (终止)。