-
Notifications
You must be signed in to change notification settings - Fork 1.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add python agent release notes for 10.0.0 - PLEASE MERGE SEPTEMBER 27th 2024 AM #18735
Merged
cbehera-newrelic
merged 7 commits into
newrelic:develop
from
hmstepanek:python-10-0-0-release
Sep 30, 2024
Merged
Changes from all commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
4f010b5
Add python agent release notes for 10.0
hmstepanek 17a5131
Update Python2.7 references in docs
hmstepanek f3041b5
Fixup: apply changes from codereview
hmstepanek 2a39f31
Remove th and st from dates
hmstepanek b7af525
Fixup: more review changes
hmstepanek 30928fa
Fixup: code review feedback changes
hmstepanek 2862936
Fixup: code review feedback changes
hmstepanek File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
98 changes: 98 additions & 0 deletions
98
.../release-notes/agent-release-notes/python-release-notes/python-agent-100000.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
--- | ||
subject: 'Python agent' | ||
releaseDate: '2024-09-26' | ||
version: 10.0.0 | ||
downloadLink: 'https://pypi.python.org/pypi/newrelic' | ||
features: ['Remove Python 2.7 support', 'Add Kafka server metric', 'Add capturing of memcache host and port', 'Add support for kafka-python-ng', 'Add support for uvicorn_workers', 'Automatically detect function signature in LangChain similarity search', 'Add environment variable for garbage collector runtime metrics'] | ||
bugs: ['Fix bug in gRPC entity name detection', 'Fix issue in LangChain where a thread is started and the transaction context is lost', 'Fix parsing of request and response when running OpenAI via LangChain', 'Instrument new path to OpenAI chat class', 'Fix pyscopg v3 API incompatibilities', 'Remove versioned logic in loguru instrumentation'] | ||
security: [] | ||
--- | ||
|
||
## Notes | ||
|
||
This release of the Python agent drops support for Python 2.7 and adds the following: | ||
|
||
* a Kafka server metric | ||
* host and port attributes for memcache | ||
* support for [kafka-python-ng](https://pypi.org/project/kafka-python-ng/) | ||
* support for [uvicorn_worker](https://pypi.org/project/uvicorn-worker/) | ||
* an environment variable for garbage collector (GC) runtime metrics | ||
* automatic detection for the function signature in [LangChain](https://pypi.org/project/langchain/)'s `similarity_search` | ||
* updated support for [OpenAI](https://pypi.org/project/openai/)'s chat class | ||
* a fix for a bug in gRPC's entity name detection | ||
* a fix for transaction context propagation loss in [LangChain](https://pypi.org/project/langchain/) in the case of a new thread | ||
* parsing of the request and response when running [OpenAI](https://pypi.org/project/openai/) via [LangChain](https://pypi.org/project/langchain/) | ||
* a fix for [pyscopg](https://pypi.org/project/psycopg/) v3 API incompatibilities | ||
* a fix that removes versioned logic in [loguru](https://pypi.org/project/loguru/) instrumentation | ||
|
||
Install the agent using `easy_install/pip/distribute` via the [Python Package Index](https://pypi.python.org/pypi/newrelic) or download it directly from the [New Relic download site](https://download.newrelic.com/python_agent/release). | ||
|
||
## Deprecations | ||
|
||
* Remove Python 2.7 Support | ||
|
||
* Removes compatibility with Python 2.7. Also removes support for the following libraries that were only supported on Python 2.7: | ||
* [umemcache](https://pypi.org/project/umemcache/) | ||
* [oursql](https://pypi.org/project/oursql/) | ||
* [pywapi](https://pypi.org/project/pywapi/) | ||
* [Pylons](https://pypi.org/project/Pylons/) | ||
* [web2py](https://pypi.org/project/web2py/) | ||
* [weberror](https://pypi.org/project/WebError/) | ||
|
||
## New features | ||
|
||
* Add Kafka server metric | ||
|
||
* Adds a metric to capture the host and port information for Kafka entities on both consumers and producers. This metric allows the UI to link AWS information with AWS MSK entities in the service map. | ||
|
||
* Add capturing of memcache `host` and `port` | ||
|
||
* Adds capturing of `host` and `port` info on the following memcache libraries: [bmemcached](https://pypi.org/project/python-binary-memcached/), [aiomcache](https://pypi.org/project/aiomcache/), and [pymemcache](https://pypi.org/project/pymemcache/). This allows the UI to link AWS information with AWS memcache entities in the service map. | ||
|
||
* Add support for [kafka-python-ng](https://pypi.org/project/kafka-python-ng/) | ||
|
||
* [kafka-python](https://pypi.org/project/kafka-python/) has been released under a new name: [kafka-python-ng](https://pypi.org/project/kafka-python-ng/). This continues to support kafka-python under the new package name. | ||
|
||
* Add support for [uvicorn_worker](https://pypi.org/project/uvicorn-worker/) | ||
|
||
* `uvicorn.workers` has been moved to a separate package called `uvicorn_worker`. This checks for both names of the module when reporting dispatcher information. | ||
|
||
* Automatically detect function signature in [LangChain](https://pypi.org/project/langchain/) `similarity_search` | ||
|
||
* Automatically detect the function signature when wrapping `similarity_search`. | ||
|
||
* Add environment variable for garbage collector runtime metrics | ||
|
||
* Garbage collector runtime metrics can now be enabled/disabled via the following environment variable: `NEW_RELIC_GC_RUNTIME_METRICS_ENABLED`. | ||
|
||
## Bug fixes | ||
|
||
* Fix bug in gRPC entity name detection | ||
|
||
* Previously, the gRPC channel entity name was missing the first character(s) in specific cases. This bug has been fixed. | ||
|
||
* Fix issue in [LangChain](https://pypi.org/project/langchain/) where a thread is started and the transaction context is lost | ||
|
||
* Previously, when LangChain called certain chains, such as retrieval chains, LangChain started a thread that caused the transaction to be lost, resulting in broken instrumentation. This has been fixed so the transaction context is passed across threads and instrumentation still works for retrieval chains. | ||
|
||
* Fix parsing of request and response when running [OpenAI](https://pypi.org/project/openai/) via [LangChain](https://pypi.org/project/langchain/) | ||
|
||
* Previously, when running [OpenAI](https://pypi.org/project/openai/) via [LangChain](https://pypi.org/project/langchain/) the request and response were a different format and were not being recorded. This issue has been fixed. | ||
|
||
* Instrument new path to [OpenAI](https://pypi.org/project/openai/) chat completions class | ||
|
||
* [OpenAI](https://pypi.org/project/openai/) moved the `ChatCompletions` class to a different path which prevented the instrumentation from being applied. This has been fixed. | ||
|
||
* Fix [pyscopg](https://pypi.org/project/psycopg/) v3 API incompatibilities | ||
|
||
* Expand DBAPI2 wrappers to allow arbitrary `kwargs` on `executemany()`. Upgrade [psycopg](https://pypi.org/project/psycopg/) v3 instrumentation to allow arbitrary `kwargs` on `executemany()`. Rename existing psycopg v3 wrapper arguments to match the upstream library's names for compatibility. | ||
|
||
* Remove versioned logic in loguru instrumentation | ||
|
||
* Removed versioned logic in [loguru](https://pypi.org/project/loguru/) instrumentation to fix a bug that occurred when the version was undeterminable. | ||
|
||
## Support statement | ||
|
||
We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read [more](/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/) about keeping agents up to date. | ||
|
||
See the New Relic Python agent [EOL policy](/docs/apm/agents/python-agent/getting-started/python-agent-eol-policy/) for information about agent releases and support dates. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added one more PR into this release since it's a bug fix for a customer so we will want to add that into the release notes as well. Here's the PR: newrelic/newrelic-python-agent#1222