This release of the Python agent adds introductory support for instrumenting Tornado 4 applications.
For a list of known issues with the Python agent, see Status of the Python agent.
- Introductory Support for Tornado 4. (See below for details.)
- Django Template Tags for Browser Monitoring Fixed for Django 1.9
Starting in Django version 1.9, the output of
django.utils.safestring:mark_safe() to prevent automatic escaping for these two template tags.
Introductory Support for Tornado 4
New Relic is pleased to announce introductory support for Tornado 4. While not all features are supported at this point, providing it at an early stage allows interested customers to preview our Tornado 4 support, and provide feedback on what works well and what doesn't.
We strongly advise running the introductory Tornado 4 instrumentation in a testing or staging environment before considering using it in a production environment.
For detailed information about the introductory Tornado 4 support, including Supported Features, Design Decisions, and Known Limitations, see Introductory Tornado 4 support.
Status of Tornado 4 Support
The following is a list of known limitations for our Tornado 4 support as it exists in the current version of the agent. In the next few releases, we plan to address these issues.
If you use
psycopg2in aynchronous mode, you must disable explain plans in the Python agent, or else the agent will throw an error when it attempts to run an explain plan query. Add this setting to your
transaction_tracer.explain_enabled = false
Metric names should be more consistent. For a method of a class, the metric name should contain both the name of the class and the method, but sometimes, the metric name will be missing the class name.
The nesting of segments in a Transaction Trace should be improved. Right now, transaction traces give a good indication of the order that callbacks run on the IOLoop, but they do not group together callbacks that belong to the same coroutine, nor do they show how callbacks relate to each other.
Transaction Traces mislabel time spent in "Application code". Because the Tornado 4 instrumentation traces all callbacks that run on the IOLoop, nearly everything that happens in a transaction is recorded. Very little is uninstrumented "Application code". When you see "Application code" time in a transaction trace, that usually means that the IOLoop was either busy running callbacks belonging to another transaction, or was waiting and not doing any work. This will be made clearer in a future release.
In the current version of the agent, the Total Time for a transaction will always equal the duration of the transaction. In future versions, we may begin measuring the time spent waiting for asynchronous External Traces and Datastore Traces to return results, which will increase the Total Time for a transaction, making it possible to have a Total Time greater than the duration of the transaction.
tornado.httpclient, no Cross Application Tracing headers are added to the outgoing requests. (This is true for both
AsyncHTTPClient.) That means that the application that the
httpclientconnects to will not show up in any of the following: trace maps, transaction maps, and service maps.
Asynchronous External Traces only trace the initial HTTP connection. They do not trace the time for the response to come back.
If you monitor your Tornado 4 application with Synthetics, the Python agent will not capture transaction traces for Synthetics checks, so you will be unable to connect your Synthetics results to APM transaction traces.
Measuring thread utilization is disabled for Tornado applications.
Exceptions thrown in
RequestHandler.initialize()are not recorded.
Use of Tornado's built-in multi-process mode to start multiple processes and have them all share the same port is untested and unsupported.
tornado.wsgi.WSGIContaineris untested and unsupported.
tornado.platform.asyncioto bridge between
asyncioand Tornado IOLoop is untested and unsupported. Currently, the agent only supports the use of the
Use of the
awaitkeywords is untested and unsupported.
Twistedis untested and unsupported.