Node.js agent release notesRSS

Notes

Features

• Added instrumentation for kafkajs (enabled through a feature flag) (#2237) (#2244) (#2236) (#2236) (#2251)

Miscellaneous chores

• Added KafkaJS instrumentation and versioned tests skeleton (#2224) (fc13916)
• Added KafkaJS to compatibility list (#2254) (f003ee7)
• Implemented DT header injection for message specs (#2250) (3e6bc6d)
• Removed targets for Kafka versioned tests (#2235) (838bab2)
• Updated flaky when test (#2241) (4079a0a)
• Updated readme to remove no longer relevant information (#2240) (01fb53c)
• Updated versioned tests due to update in @newrelic/security-agent V1.3.0 (#2239) (982276c)

Tests

• Migrated memcached tests to versioned tests (#2231) (0b3a928)
• Ported when and q integration tests to versioned tests (#2233) (9a4dddc)
• Updated ioredis tests to assert the host metric getting created on ioredis calls (#2230) (89df06a)
• Updated unit tests that were missing constructing specs at instrumentation source (#2252) (54ab238)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added support for redis v4 legacyMode client.v4.<command> (#2200) (b2284c5)

Code refactoring

• Updated shim.recordConsume to use shim.record and added ability to invoke an after hook with callback args (#2207) (4f48fc3)

Documentation

• Updated compatibility report (#2223) (a256ca0)

Miscellaneous chores

• Removed outdated Slack reference (#2198) (8110d42)
• Removed package-lock.json (#2208) (b267695)
• Removed unused express5 feature flag (#2197) (366504b)

Tests

• Updated langchain versioned tests to separate the vectorstore and other tests. This is to avoid peer resolution of @langchain/community package that is being used to test the elasticsearch vectorstore (#2216) (e768955)
• Fixed aws-sdk-v3 bedrock tests (#2211) (050469e)
• Fixed aws-sdk-v3 bedrock tests (again) (#2212) (330cc4b)

Continuous integration

• Updated the langchain vectorstore test to reference the correct version of @langchain/core getting tested (#2202) (ed81852)
• Added updating of docs site with compatibility table (#2205) (c28a938)
• Fixed CI jobs (#2215) (8b030fb)
• Fixed should-run CI step (#2214) (d0a481d)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added otel compliant server.address, server.port, and http.request.method to external http spans (#2169) (b0a3e6d)
• Added otel compliant db.system, server.address, and server.port attributes to database spans (#2173) (3fdcab4)

Bug fixes

• Added support for AWS API Gateway v2 payloads (#2191) (0ccdc6a)

Code refactoring

• Updated instrumentation for http, undici, grpc to use a new segment.captureExternalAttributes to centralize the necessary data needed to create segment and span attributes (#2179) (ddb6356)

Documentation

• Updated compatibility report (#2185) (eb986c9)

Miscellaneous chores

• Added workflow for generating compatibility doc (#2183) (9b1d5cb)
• Fixed conditionals in CI workflow (#2188) (6b733c0)
• Fixed superagent versioned tests (#2190) (297bc01)
• Made pre-commit hook require dependency changes (#2172) (e7bd356)
• Updated CI to skip expensive actions when not needed (#2184) (8639fb9)
• Updated validate-pr workflow (#2186) (6ff4497)

Continuous integration

• Updated minimum version of lib-dynamo to work around peer dependency resolution (#2174) (7ddf2c9)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added API ignoreApdex to ignore calculating apdex for the active transaction (#2166) (cb21d2c)

Bug fixes

• Fixed issue with CJS being imported as ESM (#2168) (9a14cb0)

Security improvements

• deps: bump formidable and superagent (#2162) (260f16b)

Documentation

• Fixed images in markdown tutorials (#2153) (ef14948)
• Includes api.js in jsdoc generation (#2139) (3883348)

Miscellaneous chores

• Migrated @newrelic/superagent into agent repo (#2141)
• Migrated @newrelic/aws-sdk into agent repo (#2161) (a9eb593)
• Migrated @newrelic/koa into mainline agent repo (#2148) (33af646)
• Removed repetitive cache busting (#2160) (5ac870e)
• Updated instrumentation to use type constants instead of raw strings (#2165) (c5b42cd)
• Updated versioned tests readme (#2159) (a957304)
• Updated versioned tests to support upcoming tooling (#2147) (38e47d9)
• Updated versioned tests to use quiet output mode (#2145) (63a5ddc)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Fixed instrumenting the same module installed in different locations (#2104) (88bdace)

Code refactoring

• mongodb: Removed instrumentation that handles connecting via unix domain socket. (#2129) (808323f)
• Updated shim classes to no longer construct specs. (#2096) (158c295)

Miscellaneous chores

• deps-dev: Bumped express from 4.18.2 to 4.19.2 (#2101) (639cb78)
• deps: Updated @newrelic/security-agent to v1.1.1 (#2092) (3272aa3)
• Fixed incorrect pinning of @elastic/transport (#2120) (7b5bdaa)
• Removed scrollbar styling in generated API docs (#2091) (cb0fa11)
• Removed transaction_id and legacy token count attributes from llm events for openai and langchain (#2093) (df2a0fd)

Tests

• Updated test/integration/core/dns reverse test to remove flakiness (#2121) (c32cb27)
• Updated elastic tests to skip broken version (#2119) (5d0d1bb)

Continuous integration

• Removed usage of use_new_release from prepare release workflow (#2124) (007ddb4)
• Updated prepare-release.js to not require changelog.json (#2106) (328a570)
• Updated prepare release to provide a drop down for release type (#2133) (846269b)
• Updated versioned security agent workflow (#2100) (f787b15)
• Fixed typo in constant name for prepare release script (#2094) (3b887d9)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added guid attribute to TransactionError events (#2079) (3468fb1)
• Added instrumentation for initializeUnorderedBulkOp, and initializeOrderedBulkOp in mongodb 4+ (#2086) (666ae6e)
• Added support for Mongo v5+ (#2085) (00f6feb)

Security improvements

• deps: bump follow-redirects from 1.15.5 to 1.15.6 (#2078) (aa86482)

Documentation

• Changed bug bounty URL (#2081) (f4586d7)

Miscellaneous chores

• Added instrumentation tracking class (#2084) (07d7e7d)
• deps: pin @newrelic/security-agent to 1.0.1 (#2089) (e133c76)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added AI Monitoring(AIM) for OpenAI, Amazon Bedrock, and Langchain.
  • To enable, set config.ai_monitoring.enabled or NEW_RELIC_AI_MONITORING_ENABLED to true.
  • For a full experience, set config.span_events.max_samples_stored to 10000, config.custom_insights_events.max_samples_stored to 100000, and config.distributed_tracing.enabled should not be set to false.
  • Note: Enabling high-security mode will disable the AIM instrumentation and events.
• Added instrumentation for VectorStore.similaritySearch for langchain.js (#2049) (3c50606)
• Added setLlmTokenCountCallback API endpoint to register a callback for calculating token count when none is provided (#2065) (d2faf1a)
• Added token_count to LlmEmbedding and LlmChatCompletionMessage for openai (#2061) (47a925e)
• Added tool_id to Langchain error event (#2064) (793abe8)

Miscellaneous chores

• Added flag for verbosity during docs publishing (#2060) (fe0d41a)
• Added some delays to docs publishing (#2062) (a602fd4)
• Changed casing of OpenAI in vendor property (#2068) (64b4ca2)
• Changed token_count to only use tokenCountCallback (#2070) (66f94b0)
• Removed langchain_instrumentation feature flag as the instrumentation is feature complete (#2073) (925a463)
• updated @newrelic/aws-sdk and @newrelic/koa to latest (#2074) (0747ca4)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added instrumentation for chain.stream for langchain js. (#2052) (03abfce)

Miscellaneous chores

• Added @azure/openai and @langchain/community/llms/bedrock as tracking packages so we can measure usage with angler (#2053) (4830ea3)

Tests

• Updated aws-sdk branch to main as the necessary code was merged. (#2051) (1e52a5c)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added instrumentation for RunnableSequence (#1996) (71ffa37)

• Added LangChain error events capture (#2040) (4d0d839)

• Added ai_monitoring.streaming.enabled. When set to false this will not instrument chat completion streams, thus it will not create relevant Llm events. (#2021) (ff78b51)

• Added ability to recordLlmFeedbackEvent by traceId (#2043) (b0a4ed1)

• Added instrumentation for langchain tools. (#2009) (695d10e)

Code refactoring

• Updated AIM instrumentation (#2015) (d37d2a8)

  • removed capturing last 4 of api key
  • included all custom attributes prefixed with llm. as attributes on all Llm events
  • changed tracking metric to start with Supportability

• Updated capturing conversation_id on Llm Events as llm.conversation_id (#2020) (5f93f65)

• Updated instrumentation to construct specs at source instead of within the shim methods (#2035) (ead8c25)

  • Simplified the logic in shim.recordQuery and shim.recordOperation to reduce merging of spec properties and rely on the constructed spec

Documentation

• Added note about using sudo for firewall script (#2032) (bf106d2)

• Fixed spec objects parameter definitions (#2024) (4378173)

Miscellaneous chores

• Added missing is_response to LangChain completion messages (#2044) (20c7d47)

• Attached specs to the Shim.prototype for use in custom instrumentation and instrumentation outside of the agent (#2038) (2c97488)

• deps: Updated to use @newrelic/ritm from require-in-the-middle (#2034) (ffb729f)

• Updated DatastoreParameters to include collection (#2039) (b9c73ca)

Tests

• Cleaned up pending mocks in the log dropping test to avoid a console warning around pending mocks in after each (#2017) (d2f40c2)

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 about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)