whatap 1.0.0-canary.0 β†’ 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,108 +1,62 @@
1
1
 
2
2
  [![WhaTap Logo](https://login.whatap.io/static/whatap_logo.png)](http://www.whatap.io/)
3
3
 
4
- # πŸš€ WhaTap Node.js Agent
4
+ # Whatap for Node.js
5
5
 
6
- > **Comprehensive Node.js Application Performance Monitoring (APM) Solution**
6
+ Whatap allows for application performance monitoring.
7
7
 
8
- WhaTap Node.js Agent provides real-time monitoring, tracing, and performance analysis capabilities as a professional APM agent.
8
+ Works on Linux(32bit, 64bit), MacOSx(32bit, 64bit), Windows(32bit, 64bit).
9
9
 
10
- ## πŸ“‹ Supported Environment
11
- - **Platform**: macOS (64bit), Linux (64bit)
12
- - **Node.js Version**: 17.0.0 or higher
13
- - **Database**: MySQL, PostgreSQL, MSSQL, Oracle, MariaDB, MongoDB, Redis
14
- - **Framework**: Express, Fastify, Socket.IO, WebSocket, GraphQL
10
+ *Node.js 지원 버젼: 16.4.0 이상
15
11
 
16
- You can install WhaTap using npm with the following command:
12
+ ![step01](http://apm.whatap.io/images/icon_step01.png)
17
13
 
18
- ```bash
19
- $ npm install whatap
20
- ```
14
+ #### Npm install
21
15
 
16
+ npm μ—μ„œ λ‹€μŒκ³Ό 같은 λͺ…λ Ήμ–΄λ₯Ό 톡해 whatap을 μ„€μΉ˜ ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
22
17
 
18
+ $ npm install whatap
23
19
 
24
- ## πŸ“ Configuration
25
20
 
26
- Copy the `whatap.conf` file from `node_modules/whatap` to your project root directory and configure it as follows:
27
21
 
28
- ```ini
29
- # Essential Settings
30
- license=XXXXXXXXXXXXXX-XXXXXXXXXXXXXX-XXXXXXXXXXXXXX
31
- whatap.server.host=XXX.XXX.XXX.XXX
22
+ ![step02](http://apm.whatap.io/images/icon_step02.png)
32
23
 
33
- # Application Identification Settings
34
- app_name=MyNodeApp # Application name
35
- app_process_name=node # Process name
36
- ```
24
+ #### License Key
37
25
 
26
+ node\_modules/whatap에 μžˆλŠ” whatap.confνŒŒμΌμ„ 루트 λ””λ ‰ν† λ¦¬λ‘œ 볡사 ν›„
27
+ λΌμ΄μ„ΌμŠ€ ν‚€λ₯Ό λ°œκΈ‰λ°›μ€ ν›„ μΆ”κ°€ ν•΄ μ£Όμ„Έμš”.
38
28
 
29
+ whatap.conf νŒŒμΌμ€ λ‹€μŒκ³Ό 같은 λ‚΄μš©μ„ ν¬ν•¨ν•©λ‹ˆλ‹€.
39
30
 
40
- ## πŸš€ Usage
31
+ license=XXXXXXXXXXXXXX-XXXXXXXXXXXXXX-XXXXXXXXXXXXXX
32
+ whatap.server.host=XXX.XXX.XXX.XXX
41
33
 
42
- ### Agent Initialization
43
34
 
44
- To activate WhaTap monitoring in your Node.js application, add the WhaTap agent initialization code to your application's **top-level entry point file**.
45
35
 
46
- > **⚠️ Important**: The WhaTap agent must be loaded before all other modules.
36
+ ![step03](http://apm.whatap.io/images/icon_step03.png)
47
37
 
48
- ### Method 1: Using require('whatap') in Code
38
+ #### Usage
49
39
 
50
- ```javascript
51
- // app.js (or server.js)
52
- var WhatapAgent = require('whatap').NodeAgent;
40
+ 루트 디렉토리에 μœ„μΉ˜ν•œ Node.js μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ Whatap λͺ¨λ‹ˆν„°λ§ κΈ°λŠ₯을 ν™œμ„±ν™”ν•˜λ €λ©΄,
41
+ μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ˜ μ§„μž…μ  νŒŒμΌμ— Whatap μ—μ΄μ „νŠΈλ₯Ό μ΄ˆκΈ°ν™”ν•˜λŠ” μ½”λ“œλ₯Ό μΆ”κ°€ν•΄μ•Ό ν•©λ‹ˆλ‹€.
53
42
 
54
- // Import other modules after
55
- const express = require('express');
56
- const app = express();
43
+ Node.js μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ— Whatap λͺ¨λ‹ˆν„°λ§μ„ μ μš©ν•˜λŠ” 방법은 λͺ¨λ“ˆ μ‹œμŠ€ν…œμ˜ μ’…λ₯˜(CommonJS λ˜λŠ” ECMAScript Modules, ESM)에 따라 μ•½κ°„ λ‹€λ¦…λ‹ˆλ‹€. μ•„λž˜μ—μ„œλŠ” 두 κ°€μ§€ λͺ¨λ“ˆ μ‹œμŠ€ν…œμ— λŒ€ν•΄ Whatap μ—μ΄μ „νŠΈλ₯Ό μ΄ˆκΈ°ν™”ν•˜κ³  μ‚¬μš©ν•˜λŠ” 방법을 μ„€λͺ…ν•©λ‹ˆλ‹€.
57
44
 
58
- // Application logic...
59
- ```
60
45
 
61
- Run with:
62
- ```bash
63
- node app.js
64
- ```
46
+ #### CommonJS λͺ¨λ“ˆ μ‹œμŠ€ν…œ μ‚¬μš© μ‹œ
47
+ Whatap μ—μ΄μ „νŠΈλ₯Ό CommonJS λ°©μ‹μœΌλ‘œ κ°€μ Έμ˜€κ³  μ΄ˆκΈ°ν™”ν•˜λ €λ©΄, λ‹€μŒ μ½”λ“œλ₯Ό μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ˜ μ§„μž…μ  νŒŒμΌμ— μΆ”κ°€ν•˜μ„Έμš”:
48
+
49
+ var WhatapAgent = require('whatap').NodeAgent;
65
50
 
66
- ### Method 2: Using -r flag (without code modification)
51
+ #### ECMAScript λͺ¨λ“ˆ(ESM) μ‹œμŠ€ν…œ μ‚¬μš© μ‹œ
52
+ ESM λ°©μ‹μœΌλ‘œ Whatap μ—μ΄μ „νŠΈλ₯Ό κ°€μ Έμ˜€κ³  μ‚¬μš©ν•˜λ €λ©΄, λ‹€μŒκ³Ό 같이 μ½”λ“œλ₯Ό μž‘μ„±ν•˜μ„Έμš”:
67
53
 
68
- If you prefer not to modify your application code, you can use the `-r` flag:
54
+ import WhatapAgent from 'whatap';
55
+ WhatapAgent.NodeAgent;
69
56
 
70
- ```bash
71
- node -r whatap app.js
72
- ```
57
+ ![step04](http://apm.whatap.io/images/icon_step04.png)
73
58
 
74
- ### ECMAScript Module (ESM) System
75
-
76
- ```javascript
77
- // app.js (or server.js)
78
- import WhatapAgent from 'whatap';
79
- WhatapAgent.NodeAgent;
80
-
81
- // Import other modules after
82
- import express from 'express';
83
- const app = express();
84
-
85
- // Application logic...
86
- ```
87
-
88
- ## βœ… Run Application
89
-
90
- Once the agent configuration is complete, restart your application to begin monitoring:
91
-
92
- ```bash
93
- # Direct Node.js execution
94
- node app.js
95
-
96
- # Using npm scripts
97
- npm start
98
- ```
99
-
100
- ### Monitoring Dashboard
101
-
102
- Once your application is running, you can view the following information in the WhaTap console:
103
-
104
- - πŸ” **Real-time Transactions**: HTTP requests, database query tracking
105
- - πŸ“Š **Performance Metrics**: CPU, memory, GC information
106
- - 🚨 **Error Monitoring**: Application error and exception tracking
107
- - πŸ“ˆ **Statistical Analysis**: Response time and throughput statistics
59
+ #### Restart
108
60
 
61
+ μ–΄ν”Œλ¦¬μΌ€μ΄μ…˜ μ„œλ²„κ°€ μ‹€ν–‰λ˜λ©΄ μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ˜ λͺ¨λ‹ˆν„°λ§ 정보λ₯Ό μˆ˜μ§‘ν•˜κΈ°
62
+ μ‹œμž‘ν•©λ‹ˆλ‹€.
@@ -60,7 +60,7 @@ class UdpSession {
60
60
  self.serverHost = conf.net_udp_host || PacketEnum.SERVER;
61
61
  self.serverPort = parseInt(conf.net_udp_port || PacketEnum.PORT);
62
62
 
63
- // console.log(`UDP initialized with server ${self.serverHost}:${self.serverPort}`);
63
+ console.log(`UDP initialized with server ${self.serverHost}:${self.serverPort}`);
64
64
 
65
65
  // "connected UDP" 둜 μ „ν™˜: lsofμ—μ„œ peerκ°€ 보이도둝
66
66
  self.socket.connect(self.serverPort, self.serverHost, () => {
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "whatap",
3
3
  "homepage": "http://www.whatap.io",
4
- "version": "1.0.0-canary.0",
5
- "releaseDate": "20250924",
4
+ "version": "1.0.0",
5
+ "releaseDate": "20250324",
6
6
  "description": "Monitoring and Profiling Service",
7
7
  "main": "index.js",
8
8
  "scripts": {},
package/whatap.conf CHANGED
@@ -1,5 +1,2 @@
1
1
  license=XXXXXXXXXXXXXX-XXXXXXXXXXXXXX-XXXXXXXXXXXXXX
2
- whatap.server.host=XXX.XXX.XXX.XXX
3
-
4
- app_name=XXX
5
- app_process_name=node
2
+ whatap.server.host=XXX.XXX.XXX.XXX