|header|

New Relic Python 代理

"newrelic" 软件包为您的应用程序提供性能监控和高级性能分析功能，以配合 New Relic_ 使用。

精确定位并解决 Python 应用程序性能问题，直达代码行级别。New Relic APM_ 是您唯一需要的工具，可以全面查看 Python 应用程序的各个方面，从最终用户体验到服务器监控。追踪问题至缓慢的数据库查询、缓慢的第三方 API 和 Web 服务、缓存层等。在生产环境中监控您的应用程序，并通过运行可扩展性报告确保您的应用程序能够应对大流量高峰。

访问 使用 New Relic 进行 Python 应用程序性能监控_ 了解更多信息。

.. _New Relic: http://newrelic.com .. _New Relic APM: http://newrelic.com/application-monitoring .. _使用 New Relic 进行 Python 应用程序性能监控: http://newrelic.com/python

使用方法

可以通过 pip 安装此软件包：

.. code:: bash

$ pip install newrelic

（这些说明也可以在线查看：Python 代理快速入门_。）

使用您的 许可证密钥_ 生成代理配置文件。

.. code:: bash

$ newrelic-admin generate-config $YOUR_LICENSE_KEY newrelic.ini
验证代理配置并测试与数据收集服务的连接。

.. code:: bash

$ newrelic-admin validate-config newrelic.ini
将代理与您的 Web 应用程序集成。

如果您可以控制 Web 应用程序或 WSGI 服务器的启动方式，推荐使用 newrelic-admin 包装脚本_ 来集成代理。修改现有的启动脚本，在现有的启动命令和选项前加上 newrelic-admin run-program。

同时，将 NEW_RELIC_CONFIG_FILE 环境变量设置为您上面创建的配置文件名：

.. code:: bash

$ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program $YOUR_COMMAND_OPTIONS

示例：

.. code:: bash

$ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program gunicorn -c config.py test_site.wsgi

$ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program uwsgi uwsgi_config.ini

或者，您也可以 手动集成代理_，方法是在 Python WSGI 脚本文件的最顶部添加以下几行代码。（这在使用 mod_wsgi 时很有用。）

.. code:: python

import newrelic.agent newrelic.agent.initialize('/path/to/newrelic.ini')
启动或重启您的 Python Web 应用程序或 WSGI 服务器。
完成！在 New Relic UI_ 中查看您的应用程序，即可看到从应用程序生成的实时统计数据。

.. _Python 代理快速入门: https://docs.newrelic.com/docs/agents/python-agent/getting-started/python-agent-quick-start .. _许可证密钥: https://docs.newrelic.com/docs/accounts-partnerships/accounts/account-setup/license-key .. _包装脚本: https://docs.newrelic.com/docs/agents/python-agent/installation-configuration/python-agent-integration#wrapper-script .. _手动集成代理: https://docs.newrelic.com/docs/agents/python-agent/installation-configuration/python-agent-integration#manual-integration .. _New Relic UI: https://rpm.newrelic.com

您可以在以下位置找到更多资源：

New Relic Python 文档 <https://docs.newrelic.com/docs/agents/python-agent>_
New Relic Python 发行说明 <https://docs.newrelic.com/docs/release-notes/agent-release-notes/python-release-notes>_

支持

如果您需要 New Relic 产品的协助，我们提供多种支持诊断工具和支持渠道。

这个 故障排除框架 <https://discuss.newrelic.com/t/troubleshooting-frameworks/108787>_ 将引导您解答常见的故障排除问题。 New Relic提供NRDiag，这是一个客户端诊断工具，可自动检测New Relic代理的常见问题。如果NRDiag检测到问题，它会建议故障排除步骤。NRDiag还可以自动将故障排除数据附加到New Relic支持工单中。

如果问题被确认为bug或功能请求，请提交Github问题。

支持渠道

New Relic文档：使用我们平台的全面指南
New Relic社区：进行故障排除问题的最佳场所
New Relic开发者：构建自定义可观测性应用程序的资源
New Relic大学：适合各级New Relic用户的在线培训课程
New Relic技术支持：全天候票务支持。了解更多关于我们的技术支持服务。

隐私

在New Relic，我们严肃对待您的隐私和信息安全，并致力于保护您的信息。我们必须强调不要在公共论坛上分享个人数据的重要性，并要求所有用户从日志和诊断信息中删除敏感信息，无论是个人、专有还是其他信息。

我们将"个人数据"定义为与已识别或可识别个人有关的任何信息，包括但不限于您的姓名、电话号码、邮政编码、设备ID、IP地址和电子邮件地址。

请查看New Relic的通用数据隐私声明以获取更多信息。

产品路线图

查看我们的路线图，了解更多关于我们的产品愿景，了解我们的计划，并为我们提供宝贵的反馈。

贡献

我们鼓励您为改进New Relic Python代理做出贡献！请记住，在提交拉取请求时，您需要通过CLA-Assistant点击流程签署CLA。您只需为每个项目签署一次CLA。如果您有任何问题，或需要执行我们的公司CLA（如果您的贡献代表公司），请发送电子邮件至opensource@newrelic.com。

关于漏洞的说明

正如我们的安全政策所述，New Relic致力于保护客户及其数据的隐私和安全。我们相信，通过安全研究人员提供协调披露并与安全社区合作是实现我们安全目标的重要手段。

如果您认为在此项目或New Relic的任何产品或网站中发现了安全漏洞，我们欢迎并非常感谢您通过我们的漏洞奖励计划向New Relic报告。

许可证

New Relic Python代理根据Apache 2.0许可证授权。New Relic Python代理还使用了第三方库的源代码。您可以在第三方声明文档中找到有关使用哪些库以及这些库的许可条款的完整详细信息。