Skip to content

Commit deda363

Browse files
VasilenkovDenisDenis VasilenkovKGOH
authored
New section for Node.js with instructions (#56)
Co-authored-by: Denis Vasilenkov <denis.vasilenkov@gmonit.ru> Co-authored-by: KgOfHedgehogs <kgofhedgehogs@gmail.com>
1 parent 9e5a11a commit deda363

2 files changed

Lines changed: 75 additions & 0 deletions

File tree

_sidebar.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
- [Мониторинг производительности приложений (APM)](agent_installation_guide/apm_agents_install.md)
1111
- [Java](agent_installation_guide/APM/java.md)
1212
- [PHP](agent_installation_guide/APM/php.md)
13+
- [Node.js](agent_installation_guide/APM/nodejs.md)
1314
- [Python](agent_installation_guide/APM/python.md)
1415
- [Мониторинг инфраструктуры](agent_installation_guide/Infra/infra_install.md)
1516
- [Мониторинг браузера (web)](agent_installation_guide/RUM/real_user_monitoring.md)
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Установка APM-агента для Node.js
2+
3+
Для интеграции APM-агента New Relic в Node.js выполните следующие шаги:
4+
5+
---
6+
7+
### 1. Установка пакета New Relic
8+
9+
Установите агент через npm или Yarn:
10+
11+
```bash
12+
# Через npm
13+
npm install newrelic --save
14+
15+
# Через Yarn
16+
yarn add newrelic
17+
```
18+
---
19+
20+
### 2. Копирование файла конфигурации
21+
22+
Скопируйте стандартный файл конфигурации агента в базовую папку вашего приложения:
23+
24+
```bash
25+
cp ./node_modules/newrelic/newrelic.js ./<your-destination>
26+
```
27+
28+
---
29+
30+
### 3. Настройка файла конфигурации
31+
32+
Откройте скопированный файл `newrelic.js` и добавьте или измените следующие параметры:
33+
34+
```javascript
35+
exports.config = {
36+
app_name: ['My awesome application name. Not hostname'], // Название приложения
37+
license_key: '0123456789-123456789-123456789-123456789', // Ключ(заглушка, не меняем)
38+
host: 'gmonit-collector.<<DOMAIN>>.ru' // Домен коллектора
39+
};
40+
```
41+
42+
---
43+
44+
### 4. Запуск программы с модулем агента
45+
46+
Запустите ваше приложение, предварительно загрузив модуль APM-агента, используя флаг `-r` или `--require`:
47+
48+
```bash
49+
node -r newrelic your-program.js
50+
```
51+
52+
> **Примечание**: Если вы не можете контролировать запуск программы, загрузите модуль агента перед любым другим модулем в коде вашей программы:
53+
54+
```javascript
55+
const newrelic = require('newrelic');
56+
```
57+
58+
---
59+
60+
### 5. Настройка для исключения установки модуля Native Metrics
61+
62+
В стандартной поставке включён модуль Node.js VM, который использует `gyp` и требует установленного Python для сборки бинарных файлов. Если Python отсутствует на хосте, вы можете исключить установку модуля Native Metrics, определив переменную окружения:
63+
64+
```bash
65+
export NR_NATIVE_METRICS_NO_DOWNLOAD=true
66+
```
67+
68+
Подробнее о Node.js VM и связанных измерениях можно найти в [документации New Relic](https://docs.newrelic.com/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-vm-measurements/)
69+
70+
---
71+
72+
### Подробнее
73+
74+
Для более детальной информации о конфигурации агента и дополнительных настройках обратитесь к [официальной документации New Relic](https://docs.newrelic.com/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent/)

0 commit comments

Comments
 (0)