Ruby Agent 常见故障排查方法

应用启动后无法在后台看到数据

探针上传数据的周期为1分钟,所以在应用刚刚启动时是无法看到数据的,请静候1分钟便可看到数据。

应用启动几分钟后仍无法在后台看到数据

这种情况下请查看应用目录下 log/oneapm_agent.log,日志中会提示相应的错误信息,如果不能根据日志提示的错误信息进行修正,请联系我们(support@oneapm.com)。

无法抓取事务

如果无法抓取事务,请直接联系我们,很可能是某些库与 Ruby Agent 冲突导致的。

无法抓取慢事务

默认情况下 Ruby Agent 只会抓取响应时间超过0.5秒的事务,如果您有更高的要求,请在 OneAPM 后台或者配置文件中修改阀值 transaction_threshold。

无法抓取数据库信息

当前 Ruby Agent 支持 active_record,sequel,data_mapper,mongo,mongoid 四种数据库映射模型,如果您有其他需求,请联系我们(support@oneapm.com)。

无法抓取慢查询

默认情况下 Ruby Agent 只会抓取响应时间超过 0.5 秒的数据库查询,如果您有更高的要求,请在 OneAPM 后台或者配置文件中修阀值 explain_threshold。查看设置文档

无法抓取后台任务信息

当前 Ruby Agent 支持 delayed_job, sidekiq, resque 三种后台队列框架,如果您有其他需求,请联系我们(support@oneapm.com)。

无法抓取外部服务

当前 Ruby Agent 支持基于 net/http 的 httpclient,Typhoeus,HTTPClient,Excon,Curl,如果您有其他需求,请联系我们(support@oneapm.com)。

部分数据丢失

OneAPM Ruby Agent 进行了兼容性的处理,与其它类似原理的工具的 Agent 共存不会存在冲突。但是会存在数据丢失的情况,所以不建议共同使用。

其他问题

请联系 OneAPM,并注明:

  • 用户信息
  • 操作系统及版本
  • Ruby版本
  • 使用的框架及版本
还有其他问题? 提交请求

您还可以采取以下方式解决问题: