Amazon X-Ray 守护程序 - Amazon X-Ray
下载守护程序验证守护程序存档的签名运行守护程序授予守护程序向 X-Ray 发送数据的权限X-Ray 守护程序
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon X-Ray 守护程序

Amazon X-Ray 守护程序是一个软件应用程序，它侦听 UDP 端口 2000 上的流量，收集原始分段数据，并将其中继到 Amazon X-Ray API。该守护程序与Amazon X-Ray SDK 协同工作，并且必须处于运行状态，这样 SDK 发送的数据才能到达 X-Ray 服务。

注意

X-Ray 守护程序是一个开源项目。你可以关注该项目并在以下网址提交问题和请求 GitHub：github.com/aws/aws-xray-daemon

在Amazon Lambda和上Amazon Elastic Beanstalk，使用这些服务与 X-Ray 的集成来运行守护程序。每当为样本请求调用函数时，Lambda 都会自动运行守护程序。在 Elastic Beanstalk 上，使用XRayEnabled配置选项在环境中的实例上运行守护程序。

要在本地、本地或其他Amazon服务上运行 X-Ray 守护程序，请下载并运行该守护程序，然后授予其将分段文档上传到 X-Ray 的权限。

下载守护程序

您可以从 Amazon S3、Docker Hub 或 Amazon ECR 下载守护程序，然后在本地运行，或者在启动时将其安装在 Amazon EC2 实例上。

Amazon S3
X-Ray 守护程序安装程序和可执行文件

这些链接始终指向守护程序的最新 3.x 版本。要下载特定版本，请将 3.x 替换为版本号。例如，2.1.0。

X-Ray 资产会被复制到每个支持区域的存储桶中。要使用最接近您或您的 Amazon 资源的存储桶，请将上述链接中的区域替换为您的区域。

https://aws-xray-assets.cn-north-1.s3.cn-north-1.amazonaws.com.cn/xray-daemon/aws-xray-daemon-3.x.rpm
注意

可用的本地区域为 cn-north-1 和 cn-northwest-1。

Amazon ECR

从 3.2.0 版开始，该守护程序可以在亚马逊 ECR 上找到。在提取映像之前，您应该在 Amazon ECR 公共注册表中对您的 docker 客户端进行身份验证。

使用get-login-password (Amazon CLI) 运行以下命令对公共 ECR 注册表进行身份验证：

aws ecr-public get-login-password --region us-east-1 | docker login --username Amazon --password-stdin public.ecr.aws

通过运行以下命令提取最新发布的 3.x 版本标签：

docker pull public.ecr.aws/xray/aws-xray-daemon:3.x

之前的版本或 alpha 版本可以通过3.x替换为alpha或特定版本号来下载。不建议在生产环境中使用带有 alpha 标签的守护程序映像。

Docker Hub

该守护程序可以在 Docker Hub 上找到。要下载最新发布的 3.x 版本，请运行以下命令：

docker pull amazon/aws-xray-daemon:3.x

可以通过替换为所需版本来发布守护程序3.x的先前版本。

验证守护程序存档的签名

以 ZIP 存档格式压缩的守护程序资产会附带 GPG 签名文件。公有密钥在这里：aws-xray.gpg。

您可以使用公有密钥来验证守护程序的 ZIP 存档是原始的且未经过修改。首先，使用 GnuPG 导入公有密钥。

导入公有密钥

  1. 下载公有密钥。

    $ BUCKETURL=https://aws-xray-assets.cn-north-1.s3.cn-north-1.amazonaws.com.cn/
$ wget $BUCKETURL/xray-daemon/aws-xray.gpg

  2. 将公有密钥导入到您的密钥环中。

    $ gpg --import aws-xray.gpg
gpg: /Users/me/.gnupg/trustdb.gpg: trustdb created
gpg: key 7BFE036BFE6157D3: public key "AWS X-Ray <aws-xray@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

使用导入的密钥来验证守护程序 ZIP 存档的签名。

验证存档的签名

  1. 下载存档和签名文件。

    $ BUCKETURL=https://aws-xray-assets.cn-north-1.s3.cn-north-1.amazonaws.com.cn/
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.0.0.zip
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.0.0.zip.sig

  2. 运行 gpg --verify 来验证签名。

    $ gpg --verify aws-xray-daemon-linux-3.0.0.zip.sig aws-xray-daemon-linux-3.0.0.zip
gpg: Signature made Wed 19 Apr 2017 05:06:31 AM UTC using RSA key ID FE6157D3
gpg: Good signature from "AWS X-Ray <aws-xray@amazon.com>"
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: EA6D 9271 FBF3 6990 277F  4B87 7BFE 036B FE61 57D3

请注意有关信任的警告。只有当您或您信任的某个人对文件进行了签名，密钥才是可信的。这并不意味着签名无效，只是您尚未验证公有密钥而已。

运行守护程序

在本地从命令行运行守护程序。使用 -o 选项以本地模式运行，-n 选项设置区域。

~/Downloads$ ./xray -o -n us-east-2

有关特定于平台的详细说明，请参阅下列主题：

您可以使用命令行选项或配置文件进一步自定义守护程序的行为。有关详细信息，请参阅配置Amazon X-Ray守护进程。

授予守护程序向 X-Ray 发送数据的权限

X-Ray 守护程序使用Amazon SDK 将跟踪数据上传到 X-Ray，它需要有权限的Amazon凭据才能执行此操作。

在 Amazon EC2 上，守护程序自动使用实例的实例配置文件角色。有关在本地运行守护程序所需的证书的信息，请参阅在本地运行应用程序。

如果您在多个位置 (凭证文件、实例配置文件或环境变量) 指定凭证，开发工具包会提供证书链，决定使用哪个凭证。有关向 SDK 提供凭证的更多信息，请参阅 SDK for Go 开发者指南中的指定证书。Amazon

守护程序的凭证所属的 IAM 角色或用户必须有权代表您写入数据到服务。

  • 要在 Amazon EC2 上使用守护程序，请创建新的实例配置文件角色或将托管策略添加到现有角色中。

  • 要在 Elastic Beanstalk 上使用守护程序，请将托管策略添加到 Elastic Beanstalk 默认实例配置文件角色。

  • 要在本地运行守护程序，请参阅在本地运行应用程序。

有关更多信息，请参阅适用于 Amazon X-Ray 的 Identity and Access Management：

X-Ray 守护程序

守护程序输出有关其当前配置和发送到 Amazon X-Ray 的分段的信息。

2016-11-24T06:07:06Z [Info] Initializing Amazon X-Ray daemon 2.1.0
2016-11-24T06:07:06Z [Info] Using memory limit of 49 MB
2016-11-24T06:07:06Z [Info] 313 segment buffers allocated
2016-11-24T06:07:08Z [Info] Successfully sent batch of 1 segments (0.123 seconds)
2016-11-24T06:07:09Z [Info] Successfully sent batch of 1 segments (0.006 seconds)

默认情况下，守护程序将日志输出到 STDOUT。如果您在后台运行守护程序，请使用 --log-file 命令行选项或配置文件来设置日志文件的路径。您也可以设置日志级别并禁用日志轮换。有关说明，请参阅配置Amazon X-Ray守护进程：

在 Elastic Beanstalk 上，该平台设置守护程序日志的位置。有关详细信息，请参阅在上运行 X-Ray 守护程序Amazon Elastic Beanstalk。