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

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

设置 SDK 指标AmazonSDK for Ruby

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

要使用开发工具包指标,请运行最新版本的 CloudWatch 代理。

有关开发工具包指标的 IAM 权限的详细信息,请参阅授权开发工具包指标在中收集和发送指标。AmazonSDK for Ruby

要设置 SDK 指标,请使用Amazon适 SDK for Ruby:

  1. 使用客户端创建应用程序,Amazon允许 SDK for Ruby 客户端使用Amazon服务。

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

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

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

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

  6. 启用开发工具包指标。AmazonSDK for Ruby

有关更多信息,请参阅:

启用开发工具包指标。AmazonSDK for Ruby

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

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

启用开发工具包指标与配置凭证以使用Amazon服务。

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

选项 1:设置环境变量

开发工具包首先会检查下的环境变量中指定的配置文件。Amazon_PROFILE以确定是否启用了 SDK 指标。

要打开开发工具包指标,请将以下内容添加到环境变量中。

export AWS_CSM_ENABLED=true

有其他配置设置可用。有关详细信息,请参阅 update_cw_agent。有关使用共享文件的更多信息,请参阅 configuration-sdk 中的环境变量信息。

注意

启用开发工具包指标不会将您的凭证配置为使用Amazon服务。要执行该操作,请指定 -credentials。

选项 2:Amazon共享的 Config 文件

如果在环境变量中未找到开发工具包指标配置,则会显示Amazon适 SDK for Ruby 软件开发工具包寻找自定义Amazon配置文件字段。然后,它会检查 aws_csm 配置文件。要启用开发工具包指标,请将csm_enabled添加到共享的配置文件~/.aws/config

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

有其他配置设置可用。有关详细信息,请参阅 update_cw_agent。有关使用共享文件的更多信息,请参阅 configuration-sdk 中的环境变量信息。

注意

启用开发工具包指标不会将您的凭证配置为使用Amazon服务。要执行该操作,请指定 -credentials。

更新 CloudWatch 代理

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

选项 1:设置环境变量

大多数Amazon服务使用默认端口。但是,如果您希望开发工具包指标监控的服务使用唯一端口,请将AWS_CSM_PORT=[PORT-NUMBER](其中 POR-NUMBER 为端口号)到主机的环境变量。

export AWS_CSM_ENABLED=true export AWS_CSM_PORT=1234

选项 2:Amazon共享的 Config 文件

大多数服务都使用默认端口。如果您的服务需要唯一的端口 ID,请添加AWS_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 代理,以使更改生效。

Setcsm_enabledfalse

选项 1:环境变量

export AWS_CSM_ENABLED=false

选项 2:Amazon共享的 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 控功能,请使用以下命令重新启动云监控。

amazon-cloudwatch-agent-ctl -a start;