Trashed 项目常见问题解决方案

trashed Tell StatsD about request time, GC, objects and more. Latest Rails 4 and Ruby 2.1 support, and ancient Rails 2 and Ruby 1.8 support. 项目地址: https://gitcode.com/gh_mirrors/tr/trashed

项目基础介绍

Trashed 是一个开源项目，旨在帮助开发者监控和报告 Rails 应用程序的资源使用情况，如请求时间、GC（垃圾回收）对象、堆增长等，并将这些数据发送到 StatsD。该项目支持多种 Rails 版本和 Ruby 版本，包括最新的 Rails 5 和 Ruby 2.1，以及较旧的 Rails 2 和 Ruby 1.8。

主要的编程语言是 Ruby，因为它是一个专门为 Rails 应用程序设计的工具。

新手使用注意事项及解决方案

1. 安装和配置问题

问题描述：新手在安装和配置 Trashed 时可能会遇到依赖项缺失或配置错误的问题。

解决步骤：

检查依赖项：确保你的项目中已经安装了所有必要的依赖项，特别是 Rails 和 StatsD 客户端。
Gemfile 配置：在项目的 Gemfile 中添加 gem 'trashed'，然后运行 bundle install 来安装 Trashed。

配置文件：在 config/application.rb 中添加以下代码来启用 Trashed：

require 'trashed/railtie'

module YourApp
  class Application < Rails::Application
    config.trashed.statsd = YourApp.statsd
  end
end

2. 数据发送失败问题

问题描述：配置完成后，数据可能无法成功发送到 StatsD。

解决步骤：

检查 StatsD 配置：确保 StatsD 服务正在运行，并且配置正确。
网络连接：检查 Rails 应用服务器与 StatsD 服务器之间的网络连接是否正常。
日志检查：查看 Rails 应用的日志文件，查找是否有关于 Trashed 的错误信息。常见的错误可能是 StatsD 地址配置错误或端口未开放。

3. 自定义维度设置问题

问题描述：新手可能不清楚如何设置自定义维度来更好地监控特定控制器或动作的性能。

解决步骤：

理解维度：自定义维度用于在 StatsD 中为每个请求的测量值添加额外的标签，如控制器名称、动作名称等。

配置自定义维度：在 config/application.rb 中添加以下代码来设置自定义维度：

config.trashed.timing_dimensions = ->(env) do
  if controller = env['action_controller.instance']
    name = controller.controller_name
    action = controller.action_name
    format = controller.rendered_format || :none
    variant = controller.request.variant || :none
    [ :All, :"Controllers.#{name}", :"Actions.#{name}.#{action}.#{format}+#{variant}" ]
  end
end

测试维度：在应用中触发一些请求，检查 StatsD 中是否正确记录了这些自定义维度。

通过以上步骤，新手可以更好地理解和使用 Trashed 项目，解决常见的配置和使用问题。

trashed Tell StatsD about request time, GC, objects and more. Latest Rails 4 and Ruby 2.1 support, and ancient Rails 2 and Ruby 1.8 support. 项目地址: https://gitcode.com/gh_mirrors/tr/trashed