Ruby

支持技术

确认tCell代理支持您的Ruby配置，如下所示:

版本 应用程序服务器 Web框架 操作系统 验证框架
2.倍 彪马3.11。x, 4.3.x
独角兽5.5.x
乘客. x		 Rails 4.1 + 5。倍、6.倍 CentOS 6 +
Ubuntu 14 +
Debian 8 +
高山3.7.1 +		 设计3。4. x, x *
Authlogic 3.5。x 4。x, 5。倍、6.倍

CentOS 6.0生命终结公告

截至2021年12月31日，Rapid7将在CentOS 6.0上结束生命(EOL) tCell代理。Agent文档和支持要求将同时反映这一变化。看到CentOS临终公告看看你是否受到了影响，以及你能采取什么行动。

Ruby支持传奇

* -在设计4.7+，会话劫持不可用

先决条件

下载代理和配置文件。

  1. 点击顶部导航栏中的“tCell Admin”。
  2. 点击“下载代理”。
  3. 选择“Ruby”代理。
  4. 选择“Create New API Key”(默认)。
  5. 单击“下载配置文件”下载代理的配置文件(其中预先填充了应用程序和API密钥信息)。

安装

  1. 在你的Gemfile中添加以下内容:
               
    
            
    
             
            
    
           
    
            
    
             
    
              1
    
             宝石的tcell_agent
  2. 运行包安装:
                
    
             包安装
    
              
             
    
            
    
             
    
              
    
               1
    
              包安装
  3. 添加tcell_agent.config配置文件到。/配置项目的目录。当您启动服务器时，tCell将运行。您将看到在项目的./tcell目录中创建的日志。

初始化器

在通过tcell_agent配置应用程序时。配置静态配置文件适用于大多数部署，有时需要动态配置应用程序。Ruby代理通过公开一个Rails初始化proc,配置．

的配置Proc是TCellAgent模块的一部分，可以使用它来配置服务器代理选项．如果值使用" #{…}语法，然后像其他地方一样，它将被动态地解释为代码。

请注意

初始化式中配置值相同的一个例外是，“log_dir”配置值在初始化式中实际上被称为“agent_log_dir”。

下面是一个通过初始化器动态配置代理的示例:

          

           使用初始化器动态配置代理的示例

            
           

          

           

            

             1

            如果定义? (TCellAgent)
           

           

            

             2

            TCellAgent。配置do |config|
           

           

            

             3.

            配置。app_id = "——APPID值——"
           

           

            

             4

            配置。api_key = "——APIKEY VALUE——"
           

           

            

             5

            配置。agent_log_dir = " # {Rails.root.join(日志).to_s}”
           

           

            

             6

            配置。loging_options = {"enabled" => true， "level" => "DEBUG"}
           

           

            

             7

            结束
           

           

            

             8

            结束

在上面的示例中，日志目录被动态地计算为来自应用程序根目录的子目录“log”。

更新代理

要将Ruby代理更新到最新版本，请运行:

          

           tCell代理更新

            
           

          

           

            

             1

            包更新tcell_agent

打包机自动更新代理到最新的版本Rubygems.org．

验证

要验证数据正在发送到tCell，请转到您的tCell控制台，并确保为您刚刚创建的应用程序列出的应用程序服务器代理的数量大于0。

故障排除

您可以在日志列表中自定义日志级别tcell_agent.config文件通过添加一个块，如以下:

          

           代理配置代码片段

            
           

          

           

            

             1

            json
           

           

            

             2

            “logging_options”：｛
           

           

            

             3.

            “启用”：真正的，
           

           

            

             4

            “水平”：“信息”
           

           

            

             5

            ｝

看到tcell_agent.config.template了一个例子。

有效的日志级别包括:

  • 错误
  • 警告
  • 信息(默认)
  • 调试
  • 跟踪

上面的列表显示了级别之间从上到下的优先级。当启用日志级别时，较高的日志级别也同时启用。例如，如果您启用WARN，那么ERROR也会启用。

当日志文件已满时，将在新的日志文件中继续记录日志。看到日志滚动为更多的信息。