AWS X-Ray 入门

创建 Elastic Beanstalk 环境

1. 通过以下预配置链接打开 Elastic Beanstalk 管理控制台：https://console.amazonaws.cn/elasticbeanstalk/#/newApplication?applicationName=scorekeep&solutionStackName=Java

2. 选择 Create application 创建一个应用程序以及运行 Java 8 SE 平台的环境。

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

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

将 X-Ray、Amazon S3 和 DynamoDB 权限添加到您的 Elastic Beanstalk 环境

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

2. 选择附加策略。

3. 将 AWSXrayFullAccess、AmazonS3FullAccess 和 AmazonDynamoDBFullAccess 附加到角色。

   注意

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

部署源代码

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

2. Open the Elastic Beanstalk console.

3. Navigate to the management console for your environment.

4. 选择 Upload and Deploy。

5. 上传 eb-java-scorekeep-xray-gettingstarted-v1.3.zip，然后选择 Deploy (部署)。

生成跟踪数据

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. 选择名为 SNS 的节点。Service details panel (服务详细信息面板) 随即在右侧打开。

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

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

   

4. 选择红色的状态图标以打开 SNS 子分段的 Exceptions 页面。

   

5. X-Ray 开发工具包会自动捕获由已分析的 AWS 开发工具包客户端引发的异常并记录堆栈跟踪。

   

为 Scorekeep 配置 Amazon SNS 通知

1. Open the Elastic Beanstalk console.

2. Navigate to the management console for your environment.

3. Choose Configuration.

4. 选择 Software Configuration。

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

   
   注意

   默认值使用 AWS CloudFormation 函数来检索存储在配置文件中的参数（在这种情况下为虚值）。

6. 选择 Apply。

标识您的 Amazon S3 资源

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

2. 在 Resource type (资源类型) 下，按 AWS S3 Bucket (AWS 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. 打开 AWS Config 控制台的“Resources”（资源）页面。

2. 在 Resource type (资源类型) 下，按 AWS DynamoDB Table (AWS DynamoDB 表) 进行筛选，以找到您的应用程序使用的 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. 选择查看策略。

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

7. 选择 Create policy。

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

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

终止 Elastic Beanstalk 环境

1. Open the Elastic Beanstalk console.

2. Navigate to the management console for your environment.

3. 选择 Actions。

4. 选择 Terminate Environment。

5. 选择 Terminate。