StatsD 指标监控

Site24x7-StatsD 集成是一项与 Site24x7 服务器监控代理捆绑的指标聚合服务。代理将获取您的自定义应用程序指标，并通过 StatsD 协议将其推送至 Site24x7。

• 工作原理
• 前提条件
• 集成 StatsD
• 性能指标
• 设置阈值
• 编辑监视器详情
• 自定义仪表板
• 许可

工作原理

Site24x7 服务器监控代理作为监听器，在指定时间间隔内，从用户环境中的自定义应用程序采集和聚合指标。指标通过 UDP 协议发送至 Site24x7 服务器监控代理，格式如下：

metric_name:metric_value|metric_type|@rate*|#tag-key:tag-value 

用户随后可以在 Site24x7 Web 客户端中查看性能趋势、设置阈值并接收告警。由于该机制基于 UDP，您的应用程序无需等待 Site24x7 的响应即可发送指标，即使 Site24x7 暂时不可用，应用程序也能继续正常运行。 

前提条件

• 确保服务器监控代理已启用，并绑定 UDP 端口以采集 StatsD 指标。在集成 StatsD 页面（指标 > StatsD > 所有指标 (+)）中，从下拉菜单选择服务器，然后点击启用 StatsD。
• 确保在管理 > 服务器监视器 > 设置下，启用 StatsD 指标已设置为是。此设置只能由 Site24x7 超级管理员执行，并将应用于整个 Site24x7 账户。 
• 确保 Linux 监控代理版本为 17.7.0 及以上。

集成 StatsD

默认情况下，代理将监听 UDP 端口 8125。如需更改端口，请编辑服务器上 '/opt/site24x7/monagent/metrics/statsd/' 路径下的 statsd.cfg 文件。

1. 登录 Site24x7，前往指标 > StatsD > 所有指标 (+)。
   注意

   如果找不到指标选项卡，请点击 Dock 中的编辑，将其添加为新的 Dock 图标。

2. 点击复制到剪贴板，执行 Site24x7 Web 客户端中给出的命令，安装服务器监控代理并监控通过 StatsD 协议推送的指标。
   
   注意

   请确保正确输入设备密钥以完成认证和代理安装。

3. 如果您使用代理，请切换为"是"，选择以 root 或非 root 方式安装代理，并选择以 root 或非 root 方式运行已安装的代理。例如，若要以代理方式作为 root 用户安装代理并以非 root 方式运行，请执行以下命令：
   

   wget https://staticdownloads.site24x7.com/server/Site24x7InstallScript.sh
   bash Site24x7InstallScript.sh -i -key=<device key> -proxy=user:password@proxyhost:proxyport -s24x7-agent

在下一次数据采集时，代理将开始向 Site24x7 推送指标。前往指标 > StatsD > 所有指标查看并添加阈值。 

请按照以下说明，将指标从应用程序推送至 StatsD 和 Prometheus，再推送至 Site24x7。

步骤 1：如何集成 StatsD 和 Site24x7

执行以下命令启用 StatsD 集成：

./AgentManager.sh statsd --enable=true
./AgentManager.sh statsd --update_config='[{"hostname":"localhost", "port": "8125"}]'

这将重启并配置代理，使其在端口 "8125" 上监听 "localhost" 的传入 StatsD 指标。默认刷新和推送间隔为 60 秒。

若要在安装服务器监控代理时启用 StatsD 集成，请执行以下命令：

wget https://staticdownloads.site24x7.com/server/Site24x7InstallScript.sh
bash Site24x7InstallScript.sh -i -automation=true -key=<EnterDeviceKeyHere> -statsd='[{ "hostname" : "localhost" , "port" : "8125" }]'

步骤 2：如何配置应用程序以向 StatsD 推送指标

下一步是配置您的应用程序，使其向 StatsD 服务器发送指标。指标应通过 UDP 以下列格式发送：

metric_name:metric_value|metric_type|@rate*|#tag-key:tag-value

例如，如果您的应用程序基于 Python，脚本将类似于：

import statsd
statsdclient = statsd.StatsClient('localhost', 8125)
statsdclient.gauge("metric_name", metric_value)
statsdclient.incr("metric_name")

性能指标

使用 Site24x7-StatsD 集成，可以监控定时器、计数器、仪表和集合指标。所有通过 StatsD 协议推送至 Site24x7 的指标均可在指标 > StatsD > 所有指标下查看。您可以按名称、标签或类型搜索指标。 

点击某个指标，可查看该属性或多个属性的性能报表。

设置阈值

您可以为推送至 Site24x7 的每个指标设置阈值，并在指标超过配置的阈值时接收告警。设置特定指标阈值的步骤：

1. 在 Site24x7 Web 客户端中，前往指标 > StatsD > 所有指标。   
2. 点击要设置阈值的指标旁操作列中的铅笔图标。
3. 输入阈值，设置适当的条件（<、<=、>、>=、=）、轮询策略以及您希望接收的告警类型（异常或严重）。您还可以关联自动化，在阈值被突破时自动修复问题。
4. 保存更改。

编辑监视器详情

您可以在编辑监视器详情页面编辑通知和用户组偏好设置。

1. 前往服务器 > StatsD 集成 > 将鼠标悬停在监视器名称旁的汉堡图标上，点击编辑。
2. 在"编辑监视器详情"页面，您可以选择通知配置文件、用户告警组，并关联第三方集成。
3. 保存更改。

自定义仪表板

您可以使用自定义仪表板创建自己的仪表板，在单个仪表板中查看所有指标。代理成功集成后，在指标 > StatsD > Statsdmetrics - 默认仪表板下将列出一个默认仪表板。创建新仪表板的步骤： 

1. 在 Site24x7 Web 客户端中，前往指标 > StatsD > 所有指标。
2. 选择要添加到仪表板的指标。
3. 点击构建自定义仪表板。
4. 提供显示名称并保存更改。    

这将在新标签页中打开仪表板。您可以使用编辑仪表板选项添加/删除指标，并以 PDF 或永久链接的形式分享此仪表板。 

许可

最多 500 个无阈值检查的指标可免费使用。超出此限制后，每 25 个指标（无论是否有阈值检查）计为一个基础监视器。 

例如，

500 个无阈值检查的指标        = 免费

500 个指标含 100 个阈值检查    = 4 个基础监视器

1000 个指标含 500 个阈值检查  = 40 个基础监视器