Python

支持技术

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

版本 应用程序服务器 Web框架 操作系统 验证框架
2.7.10 +
3.4 *
uWSGI内核
Gunicorn 19.10。x, 20.0.x
0.8瓶。x + 1. x
Django 1.7 + 2。3. x, x *
CentOS 6 +
Ubuntu 14 +
Debian 8 +
高山3.7.1 +
不适用

CentOS 6.0生命终结公告

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

Python支持传奇

* -登录支持仅适用于Django

先决条件

  • tCell帐户
  • 使用tCell创建的应用程序(Admin > Applications)
  • 允许到tCell云的出站HTTPS连接tCell代理连接到哪些ip ?
  • 代理和配置文件下载

下载代理和配置文件。

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

安装

  1. 安装tcell代理。
                
    tCell代理安装
    1
    pip安装tcell_agent
  2. 添加tcell_agent.config通常到您的tcell目录/var/www/html/tcell
  3. 更新您的wsgi文件以包含以下行,替换/var/www/html/tcell根据需要:
                
    wsgi文件更新
    1
    操作系统环境“TCELL_AGENT_CONFIG”' / var / www / html / tcell / tcell_agent.config '
    2
    操作系统环境“TCELL_AGENT_HOME”“/ var / www / html / tcell”
    3.
    进口tcell_agent
    4
    tcell_agent初始化

下面是一个完整的使用wsgi的例子:example_wsgi.py

更新代理

要将Python代理更新为最新版本,请运行:

          
tCell代理更新
1
pip安装--升级tcell_agent

使用此命令,pip自动将代理更新到Python包指数

验证

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

故障排除

日志文件可以在tcell /日志目录中。如果你没有看到tcell /日志目录,则很可能tCell代理还没有启动。如果是这样:

  1. 运行以下命令,确认tCell代理正在添加到服务器启动中:
               
    1
    Ps aux | grep——color tcell
  2. 检查你的简历中有没有错误catalina.out日志。另外,跑步bin / catalina.sh运行bin / catalina.bat运行将在前台启动tomcat,并在启动时打印任何错误。

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

         
json
1
“logging_options”
2
“启用”真正的
3.
“水平”“信息”
4

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

有效的日志级别包括:

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

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

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