Node.js - История изменений

IKuznetsov в 16:17, 8 января 2025

2025-01-08T16:17:20Z

← Предыдущая версия		Версия от 16:17, 8 января 2025
Строка 1:		Строка 1:
	'''''[[Поддержка технологий]] / Node.js'''''		'''''[[Поддержка технологий]] / [https://docs.expert-apm.ru/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_%D1%82%D0%B5%D1%85%D0%BD%D0%BE%D0%BB%D0%BE%D0%B3%D0%B8%D0%B9#:~:text=%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5%20%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Программное обеспечение]/ Node.js'''''

	Node.js - это серверный фреймворк, основанный на движке JavaScript V8 от Google. Node.js имеет асинхронную модель выполнения и часто используется для склейки или в качестве уровня прокси в корпоративных средах.		Node.js - это серверный фреймворк, основанный на движке JavaScript V8 от Google. Node.js имеет асинхронную модель выполнения и часто используется для склейки или в качестве уровня прокси в корпоративных средах.

IKuznetsov в 12:45, 8 ноября 2024

2024-11-08T12:45:51Z

← Предыдущая версия		Версия от 12:45, 8 ноября 2024
Строка 4:		Строка 4:

	== Возможности ==		== Возможности ==
	~~Ключ-Астром~~ предоставляет обширные возможности мониторинга Node.js:		АппОптима предоставляет обширные возможности мониторинга Node.js:
	* Куча и метрики процесса		* Куча и метрики процесса
	* Heap dumps		* Heap dumps
Строка 22:		Строка 22:
	Каждый раз, когда выпускается новая основная версия Node.js (четная или нечетная), мы добавляем поддержку этой версии.		Каждый раз, когда выпускается новая основная версия Node.js (четная или нечетная), мы добавляем поддержку этой версии.

	~~Ключ-Астром~~ будет следовать этой модели поддержки, но будет поддерживать каждую версию Node.js как минимум на полгода дольше, чтобы у наших клиентов было время для обновлений.		АппОптима будет следовать этой модели поддержки, но будет поддерживать каждую версию Node.js как минимум на полгода дольше, чтобы у наших клиентов было время для обновлений.
	{\| class="wikitable"		{\| class="wikitable"
	!Node.js version		!Node.js version
Строка 29:		Строка 29:
	!Первая поддерживаемая версия ЕдиногоАгена		!Первая поддерживаемая версия ЕдиногоАгена
	!Последняя поддерживаемая версия ЕдиногоАгента		!Последняя поддерживаемая версия ЕдиногоАгента
	!Поддержка ~~Ключ-Астром~~ до		!Поддержка АппОптима до
	!Уровень поддержки ~~Ключ-Астром~~		!Уровень поддержки АппОптима
	\|-		\|-
	\|18		\|18
Строка 122:		Строка 122:
	<sup>1</sup> Новые функции Node.js 18, помеченные как «экспериментальные», не поддерживаются.		<sup>1</sup> Новые функции Node.js 18, помеченные как «экспериментальные», не поддерживаются.

	<sup>2</sup> Ограниченная поддержка: ~~Ключ-Астром~~ может решать только те проблемы, которые можно воспроизвести в поддерживаемых версиях.		<sup>2</sup> Ограниченная поддержка: АппОптима может решать только те проблемы, которые можно воспроизвести в поддерживаемых версиях.

	== Известные ограничения ==		== Известные ограничения ==

	*Из-за ограничений платформы JavaScript и Node.js видимость на уровне кода ограничена по сравнению с .NET или Java.		*Из-за ограничений платформы JavaScript и Node.js видимость на уровне кода ограничена по сравнению с .NET или Java.
	*В сочетании с неподдерживаемыми сторонними модулями контекст может быть потерян в асинхронных обратных вызовах. В таких случаях свяжитесь со специалистом по продуктам ~~Ключ-Астром~~ ONE, нажав кнопку чата в правом верхнем углу строки меню ~~Ключ-Астром~~.		*В сочетании с неподдерживаемыми сторонними модулями контекст может быть потерян в асинхронных обратных вызовах. В таких случаях свяжитесь со специалистом по продуктам АппОптима ONE, нажав кнопку чата в правом верхнем углу строки меню АппОптима.
	*Использование модуля esm NPM в варианте 1 для пакетов может привести к снижению видимости (особенно если используется для основного сценария приложения). Предпочтительно использовать вариант 2 для предварительной загрузки esm с помощью параметра командной строки -r.		*Использование модуля esm NPM в варианте 1 для пакетов может привести к снижению видимости (особенно если используется для основного сценария приложения). Предпочтительно использовать вариант 2 для предварительной загрузки esm с помощью параметра командной строки -r.
	*В настоящее время существует только ограниченная поддержка модулей ECMAScript (также известных как «модули ES6»):		*В настоящее время существует только ограниченная поддержка модулей ECMAScript (также известных как «модули ES6»):

ENetrebin в 15:28, 15 августа 2023

2023-08-15T15:28:03Z

← Предыдущая версия		Версия от 15:28, 15 августа 2023
Строка 1:		Строка 1:
			'''''[[Поддержка технологий]] / Node.js'''''

	Node.js - это серверный фреймворк, основанный на движке JavaScript V8 от Google. Node.js имеет асинхронную модель выполнения и часто используется для склейки или в качестве уровня прокси в корпоративных средах.		Node.js - это серверный фреймворк, основанный на движке JavaScript V8 от Google. Node.js имеет асинхронную модель выполнения и часто используется для склейки или в качестве уровня прокси в корпоративных средах.

Lobanov: /* Поддержка и отказ от поддержки */

2022-11-24T17:12:55Z

Поддержка и отказ от поддержки

Внесённые изменения

IKolomin в 08:25, 1 декабря 2021

2021-12-01T08:25:05Z

← Предыдущая версия		Версия от 08:25, 1 декабря 2021
Строка 2:		Строка 2:

	== Возможности ==		== Возможности ==
	~~Dynatrace~~ предоставляет обширные возможности мониторинга Node.js:		Ключ-Астром предоставляет обширные возможности мониторинга Node.js:
	* Куча и метрики процесса		* Куча и метрики процесса
	* Heap dumps		* Heap dumps
Строка 10:		Строка 10:
	*Выделенная поддержка для множества баз данных (включая захват запросов)		*Выделенная поддержка для множества баз данных (включая захват запросов)
	*Захват следов OpenTelemetry		*Захват следов OpenTelemetry
	*~~OneAgent~~ SDK для пользовательской трассировки		*ЕдиныйАгент SDK для пользовательской трассировки
	См. Нашу матрицу поддерживаемых технологий для получения подробной информации о поддерживаемых технологиях, которые будут использоваться вместе с Node.js.		См. Нашу матрицу поддерживаемых технологий для получения подробной информации о поддерживаемых технологиях, которые будут использоваться вместе с Node.js.

Строка 20:		Строка 20:
	Каждый раз, когда выпускается новая основная версия Node.js (четная или нечетная), мы добавляем поддержку этой версии.		Каждый раз, когда выпускается новая основная версия Node.js (четная или нечетная), мы добавляем поддержку этой версии.

	~~Dynatrace~~ будет следовать этой модели поддержки, но будет поддерживать каждую версию Node.js как минимум на полгода дольше, чтобы у наших клиентов было время для обновлений.		Ключ-Астром будет следовать этой модели поддержки, но будет поддерживать каждую версию Node.js как минимум на полгода дольше, чтобы у наших клиентов было время для обновлений.
	{\| class="wikitable"		{\| class="wikitable"
	!Node.js version		!Node.js version
	!Vendor released		!Vendor released
	!Vendor End of life		!Vendor End of life
	!Supported by ~~Dynatrace~~ until		!Supported by Ключ-Астром until
	!First supported ~~Dynatrace OneAgent~~ version		!First supported Ключ-Астром ЕдиныйАгент version
	!Last supported ~~Dynatrace OneAgent~~ version		!Last supported Ключ-Астром ЕдиныйАгент version
	\|-		\|-
	\|16		\|16
Строка 138:		Строка 138:

	*Из-за ограничений платформы JavaScript и Node.js видимость на уровне кода ограничена по сравнению с .NET или Java.		*Из-за ограничений платформы JavaScript и Node.js видимость на уровне кода ограничена по сравнению с .NET или Java.
	* В сочетании с неподдерживаемыми сторонними модулями контекст может быть потерян в асинхронных обратных вызовах. В таких случаях свяжитесь со специалистом по продукту ~~Dynatrace~~ ONE, нажав кнопку чата в правом верхнем углу строки меню ~~Dynatrace~~.		* В сочетании с неподдерживаемыми сторонними модулями контекст может быть потерян в асинхронных обратных вызовах. В таких случаях свяжитесь со специалистом по продукту Ключ-Астром ONE, нажав кнопку чата в правом верхнем углу строки меню Ключ-Астром.
	*Использование модуля NPM esm в варианте 1 для пакетов может привести к снижению видимости (особенно, если он используется для основного сценария приложения). Предпочтительно использовать вариант 2 для предварительной загрузки esm с помощью параметра командной строки -r.		*Использование модуля NPM esm в варианте 1 для пакетов может привести к снижению видимости (особенно, если он используется для основного сценария приложения). Предпочтительно использовать вариант 2 для предварительной загрузки esm с помощью параметра командной строки -r.
	*В настоящее время существует только ограниченная поддержка модулей ECMAScript (также известных как «модули ES6»):		*В настоящее время существует только ограниченная поддержка модулей ECMAScript (также известных как «модули ES6»):
	**Если сам основной файл сценария является модулем ECMAScript, ~~OneAgent~~ версии 1.219+ с включенной предварительной загрузкой агента необходим для внедрения ~~OneAgent~~ в процесс Node.js.		**Если сам основной файл сценария является модулем ECMAScript, ЕдиныйАгент версии 1.219+ с включенной предварительной загрузкой агента необходим для внедрения ЕдиныйАгент в процесс Node.js.
	** Инструментарий модулей ECMAScript в настоящее время недоступен. Это ограничивает поддержку kafkajs в случае, если пользовательская точка входа для датчика KafkaJs находится внутри модуля ECMAScript.		** Инструментарий модулей ECMAScript в настоящее время недоступен. Это ограничивает поддержку kafkajs в случае, если пользовательская точка входа для датчика KafkaJs находится внутри модуля ECMAScript.
	* По умолчанию '''Webpack''' объединяет все модули в один файл. ~~OneAgent~~ не может инструментировать связанные модули. Чтобы обойти это ограничение, все модули, которые необходимо инструментировать с помощью ~~OneAgent~~ (например, express, mongodb, pg,…), должны быть экстернализованы в конфигурации webpack. Подробности см. В документации Webpack Externals.		* По умолчанию '''Webpack''' объединяет все модули в один файл. ЕдиныйАгент не может инструментировать связанные модули. Чтобы обойти это ограничение, все модули, которые необходимо инструментировать с помощью ЕдиныйАгент (например, express, mongodb, pg,…), должны быть экстернализованы в конфигурации webpack. Подробности см. В документации Webpack Externals.
	* Ограничения внешней выборки для определенных версий ~~OneAgent~~: Google V8 подвержен ряду проблем с памятью и нагрузкой на ЦП, что препятствует фоновому профилированию ЦП на производственном уровне:		* Ограничения внешней выборки для определенных версий ЕдиныйАгент: Google V8 подвержен ряду проблем с памятью и нагрузкой на ЦП, что препятствует фоновому профилированию ЦП на производственном уровне:
	** утечка памяти		** утечка памяти
	**чрезмерное пиковое потребление памяти		**чрезмерное пиковое потребление памяти
	**чрезмерная нагрузка на ЦП в системах Windows Таким образом, профилирование ЦП (окружающая выборка) не включено по умолчанию для всех версий ~~OneAgent~~:		**чрезмерная нагрузка на ЦП в системах Windows Таким образом, профилирование ЦП (окружающая выборка) не включено по умолчанию для всех версий ЕдиныйАгент:
	** Внешняя выборка включена по умолчанию в ~~OneAgent~~ версии 1.181. В ~~OneAgent~~ версии 1.181 вышеупомянутые ограничения были устранены за счет отказа от использования v8 CpuProfiler для внешней выборки. Ambient Sampling полностью доступен на всех поддерживаемых платформах и во всех поддерживаемых версиях Node.js без каких-либо ограничений.		** Внешняя выборка включена по умолчанию в ЕдиныйАгент версии 1.181. В ЕдиныйАгент версии 1.181 вышеупомянутые ограничения были устранены за счет отказа от использования v8 CpuProfiler для внешней выборки. Ambient Sampling полностью доступен на всех поддерживаемых платформах и во всех поддерживаемых версиях Node.js без каких-либо ограничений.
	**Внешняя выборка отключена по умолчанию для ~~OneAgent~~ версий от 1.157 до 1.179. В Linux внешняя выборка может быть включена для следующих версий Node.js:		**Внешняя выборка отключена по умолчанию для ЕдиныйАгент версий от 1.157 до 1.179. В Linux внешняя выборка может быть включена для следующих версий Node.js:
	*** Node.js version 6		*** Node.js version 6
	*** Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)		*** Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)
	*** Node.js ~~version~~ 9.3.0 ~~or later On ''~~Windows~~'' ambient sampling is disabled for these OneAgent versions~~, ~~because it would cause~~ 100% ~~CPU usage for one CPU~~. ~~OneAgent records a log entry for each unsupported version it detects~~: <code>AmbientSampling: <unsupported platform> / <node version></code>		*** Node.js версии 9.3.0 или более поздней. В Windows выборка окружающей среды отключена для этих версий ЕдиныйАгент, так как это приведет к 100% загрузке ЦП для одного ЦП. ЕдиныйАгент записывает в журнал записи для каждой обнаруженной неподдерживаемой версии: <code>AmbientSampling: <unsupported platform> / <node version></code>

	== ~~Further reading~~ ==		== Дальнейшее чтение ==

	* ~~How do I monitor~~ Cloud Foundry ~~applications~~?		*Как отслеживать приложения Cloud Foundry?
	* ~~Blog~~: ~~Understanding Garbage Collection and hunting Memory Leaks in~~ Node.js		* Блог: Общие сведения о сборке мусора и поиск утечек памяти в Node.js
	* ~~Blog~~: ~~How to track down CPU issues in~~ Node.js		*Блог: как отслеживать проблемы с процессором в Node.js
	* ~~Blog~~: ~~All you need to know to really understand the~~ Node.js ~~Event Loop and its Metrics~~		*Блог: все, что вам нужно знать, чтобы по-настоящему понять цикл событий Node.js и его показатели.

IKolomin в 08:04, 1 декабря 2021

2021-12-01T08:04:46Z

← Предыдущая версия		Версия от 08:04, 1 декабря 2021
Строка 1:		Строка 1:
	Node.js ~~is a server~~-~~side framework based on the~~ V8 ~~JavaScript engine by~~ Google. Node.js ~~has an asynchronous execution model and is frequently used for gluing or as a proxy tier within enterprise environments~~		Node.js - это серверный фреймворк, основанный на движке JavaScript V8 от Google. Node.js имеет асинхронную модель выполнения и часто используется для склейки или в качестве уровня прокси в корпоративных средах.

	== ~~Capabilities~~ ==		== Возможности ==
	Dynatrace ~~provides extensive~~ Node.js ~~monitoring capabilities~~:		Dynatrace предоставляет обширные возможности мониторинга Node.js:
			* Куча и метрики процесса
	* ~~Heap and process metrics~~
	* Heap dumps		* Heap dumps
	* ~~CPU sampling~~ (~~see known limitations~~)		*Выборка процессора (см. Известные ограничения)
	* ~~Event loop metrics~~		* Показатели цикла событий
	* ~~Insights into inbound and outbound~~ HTTP ~~calls~~		* Анализ входящих и исходящих HTTP-вызовов
	* ~~Dedicated support for a variety of databases~~ (~~includes query capture~~)		*Выделенная поддержка для множества баз данных (включая захват запросов)
	* ~~Capturing~~ OpenTelemetry ~~traces~~		*Захват следов OpenTelemetry
	* OneAgent SDK ~~for custom tracing~~		*OneAgent SDK для пользовательской трассировки
			См. Нашу матрицу поддерживаемых технологий для получения подробной информации о поддерживаемых технологиях, которые будут использоваться вместе с Node.js.
	~~See our supported technologies matrix for details about supported technologies that will be used in conjunction with~~ Node.js.

	== ~~Support & desupport~~ ==		== Поддержка и отказ от поддержки ==
	Node.js ~~follows an~~ LTS ~~release model~~.		Node.js следует модели выпуска LTS.

	~~Each odd-numbered version reaches~~ EOL ~~shortly after each new even-numbered version is released~~. ~~Each even~~-~~numbered version eventually becomes an LTS release~~. ~~For enterprise production environments, we recommend that you stick to~~ LTS ~~releases~~.		Каждая версия с нечетным номером достигает EOL вскоре после выпуска каждой новой версии с четным номером. Каждая четная версия в конечном итоге становится LTS-выпуском. Для корпоративных производственных сред мы рекомендуем придерживаться выпусков LTS.

	~~Whenever a new~~ Node.js ~~major version~~ (~~even or uneven~~) ~~is released~~, ~~we add support for that version~~.		Каждый раз, когда выпускается новая основная версия Node.js (четная или нечетная), мы добавляем поддержку этой версии.

	Dynatrace ~~will follow this support model~~, ~~but will support each~~ Node.js ~~version at least half a year longer to give our customers time for upgrades~~.		Dynatrace будет следовать этой модели поддержки, но будет поддерживать каждую версию Node.js как минимум на полгода дольше, чтобы у наших клиентов было время для обновлений.
	{\| class="wikitable"		{\| class="wikitable"
	!Node.js version		!Node.js version
Строка 137:		Строка 135:
	\|}		\|}

	== ~~Known limitations~~ ==		== Известные ограничения ==

	* ~~Due to platform limitations of~~ JavaScript ~~and~~ Node.js~~, code-level visibility is limited compared to~~ .NET or Java.		*Из-за ограничений платформы JavaScript и Node.js видимость на уровне кода ограничена по сравнению с .NET или Java.
	* ~~In conjunction with unsupported third-party modules, context can be lost in asynchronous callbacks~~. ~~In such cases, please contact a~~ Dynatrace ONE ~~product specialist by clicking the chat button in the upper-right corner of the~~ Dynatrace ~~menu bar~~.		* В сочетании с неподдерживаемыми сторонними модулями контекст может быть потерян в асинхронных обратных вызовах. В таких случаях свяжитесь со специалистом по продукту Dynatrace ONE, нажав кнопку чата в правом верхнем углу строки меню Dynatrace.
	* ~~Using the~~ NPM ~~module~~ esm ~~in variant~~ 1 ~~for packages might result in reduced visibility~~ (~~especially if used for the main application script~~). ~~It's preferable to use variant~~ 2 ~~to preload <code>~~esm~~</code> via the <code>~~-r~~</code> command line option~~.		*Использование модуля NPM esm в варианте 1 для пакетов может привести к снижению видимости (особенно, если он используется для основного сценария приложения). Предпочтительно использовать вариант 2 для предварительной загрузки esm с помощью параметра командной строки -r.
	* ~~There is currently only limited support for~~ ECMAScript ~~modules~~ (~~aka "ES6 modules"~~):		*В настоящее время существует только ограниченная поддержка модулей ECMAScript (также известных как «модули ES6»):
	** ~~If the main script file itself is an~~ ECMAScript ~~module~~ OneAgent ~~version~~ 1.219+ ~~with Agent preloading enabled is needed for the~~ OneAgent ~~to be injected into the~~ Node.js ~~process~~.		**Если сам основной файл сценария является модулем ECMAScript, OneAgent версии 1.219+ с включенной предварительной загрузкой агента необходим для внедрения OneAgent в процесс Node.js.
	** ~~Instrumentation of~~ ECMAScript ~~modules is currently not available~~. ~~This limits support for <code>~~kafkajs~~</code> in case the user defined entrypoint for the~~ KafkaJs ~~sensor is inside an~~ ECMAScript ~~module~~.		** Инструментарий модулей ECMAScript в настоящее время недоступен. Это ограничивает поддержку kafkajs в случае, если пользовательская точка входа для датчика KafkaJs находится внутри модуля ECMAScript.
	* '''Webpack''' ~~bundles all modules into a single file by default~~. OneAgent ~~is unable to instrument bundled modules~~. ~~To work around this limitation all modules which need to be instrumented by the~~ OneAgent (~~e.g.~~ express, mongodb, pg,…) ~~have to be externalized in the~~ webpack ~~configuration~~. ~~See webpack~~ Externals ~~documentation for details~~.		* По умолчанию '''Webpack''' объединяет все модули в один файл. OneAgent не может инструментировать связанные модули. Чтобы обойти это ограничение, все модули, которые необходимо инструментировать с помощью OneAgent (например, express, mongodb, pg,…), должны быть экстернализованы в конфигурации webpack. Подробности см. В документации Webpack Externals.
	* ~~'''Ambient Sampling''' limitations for certain~~ OneAgent ~~versions~~: Google V8 ~~is affected by a series of memory and CPU overhead issues~~, ~~which is a blocker for production-level background CPU profiling~~:		* Ограничения внешней выборки для определенных версий OneAgent: Google V8 подвержен ряду проблем с памятью и нагрузкой на ЦП, что препятствует фоновому профилированию ЦП на производственном уровне:
	** ~~memory leak~~		** утечка памяти
	** ~~excessive peak memory consumption~~		**чрезмерное пиковое потребление памяти
	** ~~excessive CPU overhead on~~ Windows ~~systems Therefore~~, ~~CPU profiling~~ (~~ambient sampling~~) ~~is not enabled by default for all~~ OneAgent ~~versions~~:		**чрезмерная нагрузка на ЦП в системах Windows Таким образом, профилирование ЦП (окружающая выборка) не включено по умолчанию для всех версий OneAgent:
	** ~~Ambient sampling is '''enabled''' by default as of~~ OneAgent ~~version~~ 1.181 ~~As of~~ OneAgent ~~version~~ 1.181 ~~the above limitations have been resolved by not using~~ v8 CpuProfiler ~~for Ambient Sampling~~. Ambient Sampling ~~is fully available on all supported platforms and all supported~~ Node.js ~~versions without any restrictions~~.		** Внешняя выборка включена по умолчанию в OneAgent версии 1.181. В OneAgent версии 1.181 вышеупомянутые ограничения были устранены за счет отказа от использования v8 CpuProfiler для внешней выборки. Ambient Sampling полностью доступен на всех поддерживаемых платформах и во всех поддерживаемых версиях Node.js без каких-либо ограничений.
	** ~~Ambient sampling is '''disabled''' by default for~~ OneAgent ~~versions~~ 1.157 ~~up to~~ 1.179 ~~On ''~~Linux~~'' ambient sampling can be enabled for the following~~ Node.js ~~versions~~:		**Внешняя выборка отключена по умолчанию для OneAgent версий от 1.157 до 1.179. В Linux внешняя выборка может быть включена для следующих версий Node.js:
	*** Node.js version 6		*** Node.js version 6
	*** Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)		*** Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)

IKolomin: Новая страница: «Node.js is a server-side framework based on the V8 JavaScript engine by Google. Node.js has an asynchronous execution model and is frequently used for gluing or a...»

2021-12-01T07:52:14Z

Новая страница: «Node.js is a server-side framework based on the V8 JavaScript engine by Google. Node.js has an asynchronous execution model and is frequently used for gluing or a...»

Новая страница

Node.js is a server-side framework based on the V8 JavaScript engine by Google. Node.js has an asynchronous execution model and is frequently used for gluing or as a proxy tier within enterprise environments

== Capabilities ==
Dynatrace provides extensive Node.js monitoring capabilities:

* Heap and process metrics
* Heap dumps
* CPU sampling (see known limitations)
* Event loop metrics
* Insights into inbound and outbound HTTP calls
* Dedicated support for a variety of databases (includes query capture)
* Capturing OpenTelemetry traces
* OneAgent SDK for custom tracing

See our supported technologies matrix for details about supported technologies that will be used in conjunction with Node.js.

== Support & desupport ==
Node.js follows an LTS release model.

Each odd-numbered version reaches EOL shortly after each new even-numbered version is released. Each even-numbered version eventually becomes an LTS release. For enterprise production environments, we recommend that you stick to LTS releases.

Whenever a new Node.js major version (even or uneven) is released, we add support for that version.

Dynatrace will follow this support model, but will support each Node.js version at least half a year longer to give our customers time for upgrades.
{| class="wikitable"
!Node.js version
!Vendor released
!Vendor End of life
!Supported by Dynatrace until
!First supported Dynatrace OneAgent version
!Last supported Dynatrace OneAgent version
|-
|16
|2021/04/20
|2024/04/30
|2025/04/30
|1.219
|
|-
|15
|2020/10/20
|2021/06/01
|2021/12/01
|1.207
|
|-
|14
|2020/04/21
|2023/04/30
|2024/04/30
|1.195
|
|-
|13
|2019/10/22
|2020/06/01
|2020/12/01
|1.183
|1.205
|-
|12
|2019/04/23
|2022/04/30
|2023/04/30
|1.171
|
|-
|11
|2018/10/23
|2019/06/30
|2019/12/31
|
|1.181
|-
|10
|2015/04/24
|2021/04/30
|2022/04/30
|
|
|-
|9
|2017/10/01
|2018/06/30
|2018/12/31
|
|1.157
|-
|8
|2017/05/30
|2019/12/31
|2020/12/31
|
|
|-
|7
|2015/10/25
|2016/07/30
|2017/11/30
|
|1.131
|-
|6
|2016/04/26
|2019/04/30
|2019/10/31
|
|1.179
|-
|5
|2015/10/29
|2016/06/30
|2017/10/31
|
|1.129
|-
|4
|2015/09/08
|2018/04/30
|2018/12/31
|
|1.157
|-
|0.12
|2015/02/06
|2016/12/31
|2017/10/31
|
|1.129
|-
|0.10
|2013/03/01
|
|2017/10/31
|
|1.129
|}

== Known limitations ==

* Due to platform limitations of JavaScript and Node.js, code-level visibility is limited compared to .NET or Java.
* In conjunction with unsupported third-party modules, context can be lost in asynchronous callbacks. In such cases, please contact a Dynatrace ONE product specialist by clicking the chat button in the upper-right corner of the Dynatrace menu bar.
* Using the NPM module esm in variant 1 for packages might result in reduced visibility (especially if used for the main application script). It's preferable to use variant 2 to preload <code>esm</code> via the <code>-r</code> command line option.
* There is currently only limited support for ECMAScript modules (aka "ES6 modules"):
** If the main script file itself is an ECMAScript module OneAgent version 1.219+ with Agent preloading enabled is needed for the OneAgent to be injected into the Node.js process.
** Instrumentation of ECMAScript modules is currently not available. This limits support for <code>kafkajs</code> in case the user defined entrypoint for the KafkaJs sensor is inside an ECMAScript module.
* '''Webpack''' bundles all modules into a single file by default. OneAgent is unable to instrument bundled modules. To work around this limitation all modules which need to be instrumented by the OneAgent (e.g. express, mongodb, pg,…) have to be externalized in the webpack configuration. See webpack Externals documentation for details.
* '''Ambient Sampling''' limitations for certain OneAgent versions: Google V8 is affected by a series of memory and CPU overhead issues, which is a blocker for production-level background CPU profiling:
** memory leak
** excessive peak memory consumption
** excessive CPU overhead on Windows systems Therefore, CPU profiling (ambient sampling) is not enabled by default for all OneAgent versions:
** Ambient sampling is '''enabled''' by default as of OneAgent version 1.181 As of OneAgent version 1.181 the above limitations have been resolved by not using v8 CpuProfiler for Ambient Sampling. Ambient Sampling is fully available on all supported platforms and all supported Node.js versions without any restrictions.
** Ambient sampling is '''disabled''' by default for OneAgent versions 1.157 up to 1.179 On ''Linux'' ambient sampling can be enabled for the following Node.js versions:
*** Node.js version 6
*** Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)
*** Node.js version 9.3.0 or later On ''Windows'' ambient sampling is disabled for these OneAgent versions, because it would cause 100% CPU usage for one CPU. OneAgent records a log entry for each unsupported version it detects: <code>AmbientSampling: <unsupported platform> / <node version></code>

== Further reading ==

* How do I monitor Cloud Foundry applications?
* Blog: Understanding Garbage Collection and hunting Memory Leaks in Node.js
* Blog: How to track down CPU issues in Node.js
* Blog: All you need to know to really understand the Node.js Event Loop and its Metrics