启用开发工具包指标 - Amazon SDK for .NET
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

是否要将 .NET 应用程序部署到Amazon通过几个简单点击即可? 尝试我们的新.NET CLI 工具为了简化部署体验!阅读我们的博客帖子然后提交反馈GitHub

有关更多信息,请参阅部署工具

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

启用开发工具包指标

Amazon SDK Metrics for Enterprise Support(SDK 指标)使企业客户能够从Amazon主机和客户端上的 SDK 共享Amazon企业级 Support。开发工具包指标提供的信息有助于在加速检测和诊断在连接到Amazon服务Amazon企业级 Support 客户。

在每个主机上收集遥测数据时,它通过 UDP 中继到 127.0.0.1(也称为 localhost),在此处 Amazon CloudWatch 代理会汇总数据并将其发送到开发工具包指标服务。因此,要接收指标,需要将 CloudWatch 代理添加到您的实例。

设置开发工具包指标的以下步骤适用于为正在使用的客户端应用程序运行 Amazon Linux 的 Amazon EC2 实例。Amazon SDK for .NET. 如果在配置时启用了,则开发工具包指标也可用于您的生产环境Amazon SDK for .NET.

要使用开发工具包指标,请运行最新版本的 CloudWatch 代理。了解如何为软件开发工具包指标配置 CloudWatch 代理

要设置 SDK 指标,请使用Amazon SDK for .NET请按照以下说明执行操作:

  1. 使用 Amazon SDK for .NET 客户端创建应用程序以使用 Amazon 服务。

  2. 在 Amazon EC2 实例上或您的本地环境中托管您的项目。

  3. 安装并使用最新版本的Amazon SDK for .NET。

  4. 在 EC2 实例上或您的本地环境中安装和配置 CloudWatch 代理。

  5. 授权开发工具包指标收集和发送指标。

  6. 为启用开发工具包指标Amazon SDK for .NET.

有关更多信息,请参阅下列内容:

为启用开发工具包指标Amazon SDK for .NET

默认情况下,开发工具包指标处于禁用状态,并且端口设置为 31000。下面是默认参数。

//default values [ 'enabled' => false, 'port' => 31000, ]

启用 SDK Metrics 与配置凭证以使用 Amazon 服务无关。

您可以通过设置环境变量或使用 Amazon 共享配置文件来启用 SDK Metrics。

选项 1:设置环境变量

如果未设置 AWS_CSM_ENABLED,则开发工具包首先会检查 AWS_PROFILE 下的环境变量中指定的配置文件,以确定是否已启用 SDK Metrics。默认情况下,该选项设置为 false

要打开 SDK Metrics,请将以下内容添加到环境变量中。

export AWS_CSM_ENABLED=true

其他配置设置可用。

注意:启用 SDK Metrics 不会将您的凭证配置为使用 Amazon 服务。

选项 2:Amazon 共享配置文件

如果在环境变量中未找到任何 SDK Metrics 配置,则开发工具包会查看您的默认 Amazon 配置文件字段。如果 AWS_DEFAULT_PROFILE 设置为默认值之外的其他值,请更新该配置文件。要启用 SDK Metrics,请将 csm_enabled 添加到位于 ~/.aws/config 的共享配置文件。

[default] csm_enabled = true [profile aws_csm] csm_enabled = true

其他配置设置可用。

注意

启用开发工具包指标与配置凭证以使用Amazon服务。您可以使用其他配置文件进行身份验证。

更新 CloudWatch 代理

要更改端口,您需要设置值,然后重新启动任何Amazon当前处于活动状态的作业。

选项 1:设置环境变量

大多数服务都使用默认端口。但是,如果您的服务需要唯一的端口 ID,请将 AWS_CSM_PORT=[port_number] 添加到主机的环境变量。

export AWS_CSM_ENABLED=true export AWS_CSM_PORT=1234

选项 2:Amazon共享的配置文件

大多数服务都使用默认端口。但是,如果您的服务需要唯一的端口 ID,请将 csm_port = [port_number] 添加到 ~/.aws/config

[default] csm_enabled = false csm_port = 1234 [profile aws_csm] csm_enabled = false csm_port = 1234

重启开发工具包指标

要重新启动作业,请运行以下命令。

amazon-cloudwatch-agent-ctl –a stop; amazon-cloudwatch-agent-ctl –a start;

禁用开发工具包指标

要关闭 SDK 指标,请将已启用 csm_enabled在环境变量中或您的Amazon共享的配置文件位于~/.aws/config. 然后重新启动您的 CloudWatch 代理,以使更改生效。

环境变量

export AWS_CSM_ENABLED=false

Amazon 共享的配置文件

Remove已启用 csm_enabled中的配置文件Amazon共享的配置文件位于~/.aws/config.

注意

环境变量覆盖Amazon共享的配置文件。如果已在环境变量中启用开发工具包指标,则开发工具包指标保持启用状态。

[default] csm_enabled = false [profile aws_csm] csm_enabled = false

要禁用开发工具包指标,请使用以下命令停止您的 CloudWatch 代理。

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a stop && echo "Done"

如果您正在使用其他 CloudWatch 功能,请使用以下命令重新启动 CloudWatch。

amazon-cloudwatch-agent-ctl –a start;

重启开发工具包指标

要重新启动作业,请运行以下命令。

amazon-cloudwatch-agent-ctl –a stop; amazon-cloudwatch-agent-ctl –a start;

开发工具包指标的定义

您可以使用以下开发工具包指标描述来解释您的结果。通常,这些指标可在常规业务审核期间与您的技术客户经理进行审核。AmazonSupport 资源和您的技术客户经理应该有权访问开发工具包指标数据以帮助您解决案例,但如果您发现的数据令人困惑或是意外数据,但似乎不会对您的应用程序的性能产生负面影响,那么最好是在预定的业务期间审核该数据。审核。

指标 CallCount

定义

从您的代码向Amazon服务

使用方法

将它用作基准与其他指标(如错误或限制)相关联。

指标 ClientErrorCount

定义

失败且出现客户端错误(4xx HTTP 响应代码)的 API 调用数量。示例:限制、拒绝访问、S3 存储桶不存在,以及参数值无效。

使用方法

除了在某些与限制相关的情况下(例如,由于需要增加限额而发生限制时),此指标可以指明应用程序中需要修复的内容。

指标 ConnectionErrorCount

定义

由于连接到服务出错而失败的 API 调用数量。这些可能由客户应用程序与Amazon服务,包括负载均衡器、DNS 故障以及中转提供商。在某些情况下,Amazon问题可能导致此错误。

使用方法

使用此指标可确定问题是特定于您的应用程序,还是由基础设施和/或网络所导致。较高的 ConnectionErrorCount 可能也指示 API 调用的超时值较短。

指标 ThrottleCount

定义

由于 Amazon 服务的限制而失败的 API 调用数量。

使用方法

使用此指标来评估应用程序是否已达到限制,以及确定重试和应用程序延迟的原因。请考虑在窗口之上分配调用,而不是批处理调用。

指标 ServerErrorCount

定义

由于来自的服务器错误(5xx HTTP 响应代码)而失败的 API 调用数量。Amazon服务。这些错误通常由 Amazon 服务所导致。

使用方法

确定开发工具包重试或延迟的原因。此指标并不总是指示Amazon服务有故障,因为一些Amazon团队将延迟归类为 HTTP 503 响应。

指标 EndToEndLatency

定义

应用程序使用Amazon开发工具包,包括重试。换句话说,无论多次尝试后是否成功,或者一旦调用由于不可传递的错误而失败。

使用方法

确定如何AmazonAPI 调用会导致应用程序的总体延迟。网络、防火墙或其他配置设置问题或开发工具包重试导致的延迟可能会导致延迟高于预期值。