使用软件开发工具包 - AWS X-Ray

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

使用软件开发工具包

如果您想使用命令行界面,或者需要比中提供的功能更多的自定义跟踪、监控或日志记录功能,请使用 SDK AWS Management Console。您还可以使用 S AWS DK 开发使用 X-Ray API 的程序。你可以使用 AWS Distro for OpenTelemetry (ADOT) SDK 或 X-Ray SDK。

如果您使用 SDK,则可以在检测应用程序和配置采集器或代理时为工作流程添加自定义设置。您可以使用 SDK 来执行以下无法完成的任务 AWS Management Console:

  • 发布自定义指标-以低至 1 秒的高分辨率采样指标,使用多个维度添加有关指标的信息,并将数据点聚合到统计数据集中。

  • 自定义收集器-自定义收集器任何部分的配置,包括接收器、处理器、导出器和连接器。

  • 自定义您的工具-自定义区段和子细分,将自定义键值对添加为属性,并创建自定义指标。

  • 以编程方式创建和更新采样规则。

如果您想灵活地ADOT使用具有额外 AWS 安全性和优化层的标准化 OpenTelemetry SDK,请使用 SDK。 AWS Distro fo ADOT r OpenTelemetry () SDK 是一个与供应商无关的软件包,它允许与其他供应商和非AWS 服务的后端集成,而无需重新分析代码。

如果您已经在使用 X-Ray SDK,只与 AWS 后端集成,并且不想更改与 X-Ray 或应用程序代码的交互方式,请使用 X-Ray SDK。

有关每项功能的更多信息,请参阅在 AWS Distro for OpenTelemetry 和 X-Ray SDK 之间进行选择

使用ADOT软件开发工具包

S ADOT DK 是一组向后端服务发送数据的开源 API、库和代理。 ADOT由多个后端和代理支持 AWS,并与多个后端和代理集成,并提供大量由OpenTelemetry社区维护的开源库。使用 ADOT SDK 来检测您的应用程序并收集日志、元数据、指标和跟踪。您还可以ADOT使用监控服务并根据中的指标设置警报 CloudWatch。

如果您使用的是 ADOT SDK,则可以将以下选项与代理结合使用:

  • 将 ADOT SDK 与CloudWatch 代理一起使用 — 推荐。

  • 将 ADOT SDK 与 ADOTCollect or 配合使用 — 如果您想使用具有多 AWS 层安全性和优化的独立于供应商的软件,则建议使用。

要使用 S ADOT DK,请执行以下操作:

ADOT收集器收到您的数据后,会将其发送到您在ADOT配置中指定的后端。 ADOT可以将数据发送到多个后端,包括外部的供应商 AWS,如下图所示:

在检测应用程序并配置收集器时,可以自定义 ADOT 收集器。

AWS 定期更新ADOT以增加功能并与OpenTelemetry框架保持一致。更新和 future 开发ADOT计划是向公众开放的路线图的一部分。 ADOT支持多种编程语言,其中包括:

  • Go

  • Java

  • JavaScript

  • Python

  • .NET

  • Ruby

  • PHP

如果你使用的是 Python,ADOT可以自动检测你的应用程序。要开始使用ADOT,请参阅 Collecto OpenTelemetry r AWS 发行版简介和入门

使用X-Ray软件开发工具包

X-Ray SDK 是一组 AWS 用于向 AWS 后端服务发送数据的 API 和库。使用 X-Ray SDK 来检测您的应用程序并收集跟踪数据。您不能使用 X-Ray SDK 收集日志或指标数据。

如果您使用的是 X-Ray SDK,则可以将以下选项与代理结合使用:

  • 使用 X-Ray SDK 和 AWS X-Ray 守护程序 — 如果您不想更新应用程序代码,请使用此选项。

  • 将 X-Ray SDK 与 CloudWatch 代理一起使用 —(推荐) CloudWatch 代理与 X-Ray SDK 兼容。

要使用 X-Ray SDK,请执行以下操作:

  • 使用 X-Ray SDK 检测您的应用程序。

  • 配置收集器以告知其将收集的数据发送到何处。您可以使用 CloudWatch 代理或 X-Ray 守护程序来收集您的跟踪信息。

收集器或代理收到您的数据后,它会将其发送到您在代理配置中指定的 AWS 后端。X-Ray SDK 只能向 AWS 后端发送数据,如下图所示:

将 X-Ray SDK 与 CloudWatch 代理或 X-Ray 守护程序一起使用。

如果您正在使用Java,则可以使用 X-Ray SDK 自动检测您的应用程序。要开始使用 X-Ray SDK,请查看与以下编程语言相关的库: