@push.rocks/smartproxy 27.5.0 → 27.6.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/changelog.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 2026-04-13 - 27.6.0 - feat(metrics)
4
+ track per-IP domain request metrics across HTTP and TCP passthrough traffic
5
+
6
+ - records domain request counts per frontend IP from HTTP Host headers and TCP SNI
7
+ - exposes per-IP domain maps and top IP-domain request pairs through the TypeScript metrics adapter
8
+ - bounds per-IP domain tracking and prunes stale entries to limit memory growth
9
+ - adds metrics system documentation covering architecture, collected data, and known gaps
10
+
3
11
  ## 2026-04-06 - 27.5.0 - feat(security)
4
12
  add domain-scoped IP allow list support across HTTP and passthrough filtering
5
13
 
Binary file
Binary file
@@ -3,7 +3,7 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@push.rocks/smartproxy',
6
- version: '27.5.0',
6
+ version: '27.6.0',
7
7
  description: 'A powerful proxy package with unified route-based configuration for high traffic management. Features include SSL/TLS support, flexible routing patterns, WebSocket handling, advanced security options, and automatic ACME certificate management.'
8
8
  };
9
9
  //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHFQQUFxUDtDQUNuUSxDQUFBIn0=
@@ -55,6 +55,14 @@ export interface IMetrics {
55
55
  ip: string;
56
56
  count: number;
57
57
  }>;
58
+ /** Per-IP domain request counts: IP -> { domain -> count }. */
59
+ domainRequestsByIP(): Map<string, Map<string, number>>;
60
+ /** Top IP-domain pairs sorted by request count descending. */
61
+ topDomainRequests(limit?: number): Array<{
62
+ ip: string;
63
+ domain: string;
64
+ count: number;
65
+ }>;
58
66
  frontendProtocols(): IProtocolDistribution;
59
67
  backendProtocols(): IProtocolDistribution;
60
68
  };
@@ -32,6 +32,12 @@ export declare class RustMetricsAdapter implements IMetrics {
32
32
  ip: string;
33
33
  count: number;
34
34
  }>;
35
+ domainRequestsByIP: () => Map<string, Map<string, number>>;
36
+ topDomainRequests: (limit?: number) => Array<{
37
+ ip: string;
38
+ domain: string;
39
+ count: number;
40
+ }>;
35
41
  frontendProtocols: () => IProtocolDistribution;
36
42
  backendProtocols: () => IProtocolDistribution;
37
43
  };
@@ -83,6 +83,39 @@ export class RustMetricsAdapter {
83
83
  result.sort((a, b) => b.count - a.count);
84
84
  return result.slice(0, limit);
85
85
  },
86
+ domainRequestsByIP: () => {
87
+ const result = new Map();
88
+ if (this.cache?.ips) {
89
+ for (const [ip, im] of Object.entries(this.cache.ips)) {
90
+ const dr = im.domainRequests;
91
+ if (dr && typeof dr === 'object') {
92
+ const domainMap = new Map();
93
+ for (const [domain, count] of Object.entries(dr)) {
94
+ domainMap.set(domain, count);
95
+ }
96
+ if (domainMap.size > 0) {
97
+ result.set(ip, domainMap);
98
+ }
99
+ }
100
+ }
101
+ }
102
+ return result;
103
+ },
104
+ topDomainRequests: (limit = 20) => {
105
+ const result = [];
106
+ if (this.cache?.ips) {
107
+ for (const [ip, im] of Object.entries(this.cache.ips)) {
108
+ const dr = im.domainRequests;
109
+ if (dr && typeof dr === 'object') {
110
+ for (const [domain, count] of Object.entries(dr)) {
111
+ result.push({ ip, domain, count: count });
112
+ }
113
+ }
114
+ }
115
+ }
116
+ result.sort((a, b) => b.count - a.count);
117
+ return result.slice(0, limit);
118
+ },
86
119
  frontendProtocols: () => {
87
120
  const fp = this.cache?.frontendProtocols;
88
121
  return {
@@ -259,4 +292,4 @@ export class RustMetricsAdapter {
259
292
  },
260
293
  };
261
294
  }
262
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVzdC1tZXRyaWNzLWFkYXB0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9wcm94aWVzL3NtYXJ0LXByb3h5L3J1c3QtbWV0cmljcy1hZGFwdGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLE9BQU8sa0JBQWtCO0lBQ3JCLE1BQU0sQ0FBa0I7SUFDeEIsS0FBSyxHQUFRLElBQUksQ0FBQztJQUNsQixTQUFTLEdBQTBDLElBQUksQ0FBQztJQUN4RCxjQUFjLENBQVM7SUFFL0IsWUFBWSxNQUF1QixFQUFFLGNBQWMsR0FBRyxJQUFJO1FBQ3hELElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO1FBQ3JCLElBQUksQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO0lBQ3ZDLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxJQUFJO1FBQ2YsSUFBSSxDQUFDO1lBQ0gsSUFBSSxDQUFDLEtBQUssR0FBRyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDOUMsQ0FBQztRQUFDLE1BQU0sQ0FBQztZQUNQLG1EQUFtRDtRQUNyRCxDQUFDO0lBQ0gsQ0FBQztJQUVNLFlBQVk7UUFDakIsSUFBSSxJQUFJLENBQUMsU0FBUztZQUFFLE9BQU87UUFDM0Isa0RBQWtEO1FBQ2xELElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNaLElBQUksQ0FBQyxTQUFTLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUNoQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDZCxDQUFDLEVBQUUsSUFBSSxDQUFDLGNBQWMsQ0FBQyxDQUFDO1FBQ3hCLElBQUksSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUN6QixJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3pCLENBQUM7SUFDSCxDQUFDO0lBRU0sV0FBVztRQUNoQixJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNuQixhQUFhLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1lBQzlCLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDO1FBQ3hCLENBQUM7SUFDSCxDQUFDO0lBRUQsa0NBQWtDO0lBRTNCLFdBQVcsR0FBRztRQUNuQixNQUFNLEVBQUUsR0FBVyxFQUFFO1lBQ25CLE9BQU8sSUFBSSxDQUFDLEtBQUssRUFBRSxpQkFBaUIsSUFBSSxDQUFDLENBQUM7UUFDNUMsQ0FBQztRQUNELEtBQUssRUFBRSxHQUFXLEVBQUU7WUFDbEIsT0FBTyxJQUFJLENBQUMsS0FBSyxFQUFFLGdCQUFnQixJQUFJLENBQUMsQ0FBQztRQUMzQyxDQUFDO1FBQ0QsT0FBTyxFQUFFLEdBQXdCLEVBQUU7WUFDakMsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUM7WUFDekMsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxDQUFDO2dCQUN2QixLQUFLLE1BQU0sQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7b0JBQzNELE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFHLEVBQVUsQ0FBQyxpQkFBaUIsSUFBSSxDQUFDLENBQUMsQ0FBQztnQkFDdkQsQ0FBQztZQUNILENBQUM7WUFDRCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBQ0QsSUFBSSxFQUFFLEdBQXdCLEVBQUU7WUFDOUIsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUM7WUFDekMsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxDQUFDO2dCQUNwQixLQUFLLE1BQU0sQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7b0JBQ3RELE1BQU0sQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUFHLEVBQVUsQ0FBQyxpQkFBaUIsSUFBSSxDQUFDLENBQUMsQ0FBQztnQkFDckQsQ0FBQztZQUNILENBQUM7WUFDRCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBQ0QsTUFBTSxFQUFFLENBQUMsUUFBZ0IsRUFBRSxFQUF3QyxFQUFFO1lBQ25FLE1BQU0sTUFBTSxHQUF5QyxFQUFFLENBQUM7WUFDeEQsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxDQUFDO2dCQUNwQixLQUFLLE1BQU0sQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7b0JBQ3RELE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxFQUFFLEVBQUUsS0FBSyxFQUFHLEVBQVUsQ0FBQyxpQkFBaUIsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDO2dCQUNqRSxDQUFDO1lBQ0gsQ0FBQztZQUNELE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUN6QyxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ2hDLENBQUM7UUFDRCxpQkFBaUIsRUFBRSxHQUEwQixFQUFFO1lBQzdDLE1BQU0sRUFBRSxHQUFHLElBQUksQ0FBQyxLQUFLLEVBQUUsaUJBQWlCLENBQUM7WUFDekMsT0FBTztnQkFDTCxRQUFRLEVBQUUsRUFBRSxFQUFFLFFBQVEsSUFBSSxDQUFDO2dCQUMzQixPQUFPLEVBQUUsRUFBRSxFQUFFLE9BQU8sSUFBSSxDQUFDO2dCQUN6QixRQUFRLEVBQUUsRUFBRSxFQUFFLFFBQVEsSUFBSSxDQUFDO2dCQUMzQixPQUFPLEVBQUUsRUFBRSxFQUFFLE9BQU8sSUFBSSxDQUFDO2dCQUN6QixRQUFRLEVBQUUsRUFBRSxFQUFFLFFBQVEsSUFBSSxDQUFDO2dCQUMzQixPQUFPLEVBQUUsRUFBRSxFQUFFLE9BQU8sSUFBSSxDQUFDO2dCQUN6QixRQUFRLEVBQUUsRUFBRSxFQUFFLFFBQVEsSUFBSSxDQUFDO2dCQUMzQixPQUFPLEVBQUUsRUFBRSxFQUFFLE9BQU8sSUFBSSxDQUFDO2dCQUN6QixXQUFXLEVBQUUsRUFBRSxFQUFFLFdBQVcsSUFBSSxDQUFDO2dCQUNqQyxVQUFVLEVBQUUsRUFBRSxFQUFFLFVBQVUsSUFBSSxDQUFDO2FBQ2hDLENBQUM7UUFDSixDQUFDO1FBQ0QsZ0JBQWdCLEVBQUUsR0FBMEIsRUFBRTtZQUM1QyxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUMsS0FBSyxFQUFFLGdCQUFnQixDQUFDO1lBQ3hDLE9BQU87Z0JBQ0wsUUFBUSxFQUFFLEVBQUUsRUFBRSxRQUFRLElBQUksQ0FBQztnQkFDM0IsT0FBTyxFQUFFLEVBQUUsRUFBRSxPQUFPLElBQUksQ0FBQztnQkFDekIsUUFBUSxFQUFFLEVBQUUsRUFBRSxRQUFRLElBQUksQ0FBQztnQkFDM0IsT0FBTyxFQUFFLEVBQUUsRUFBRSxPQUFPLElBQUksQ0FBQztnQkFDekIsUUFBUSxFQUFFLEVBQUUsRUFBRSxRQUFRLElBQUksQ0FBQztnQkFDM0IsT0FBTyxFQUFFLEVBQUUsRUFBRSxPQUFPLElBQUksQ0FBQztnQkFDekIsUUFBUSxFQUFFLEVBQUUsRUFBRSxRQUFRLElBQUksQ0FBQztnQkFDM0IsT0FBTyxFQUFFLEVBQUUsRUFBRSxPQUFPLElBQUksQ0FBQztnQkFDekIsV0FBVyxFQUFFLEVBQUUsRUFBRSxXQUFXLElBQUksQ0FBQztnQkFDakMsVUFBVSxFQUFFLEVBQUUsRUFBRSxVQUFVLElBQUksQ0FBQzthQUNoQyxDQUFDO1FBQ0osQ0FBQztLQUNGLENBQUM7SUFFSyxVQUFVLEdBQUc7UUFDbEIsT0FBTyxFQUFFLEdBQW9CLEVBQUU7WUFDN0IsT0FBTztnQkFDTCxFQUFFLEVBQUUsSUFBSSxDQUFDLEtBQUssRUFBRSx1QkFBdUIsSUFBSSxDQUFDO2dCQUM1QyxHQUFHLEVBQUUsSUFBSSxDQUFDLEtBQUssRUFBRSx3QkFBd0IsSUFBSSxDQUFDO2FBQy9DLENBQUM7UUFDSixDQUFDO1FBQ0QsTUFBTSxFQUFFLEdBQW9CLEVBQUU7WUFDNUIsT0FBTztnQkFDTCxFQUFFLEVBQUUsSUFBSSxDQUFDLEtBQUssRUFBRSw2QkFBNkIsSUFBSSxDQUFDO2dCQUNsRCxHQUFHLEVBQUUsSUFBSSxDQUFDLEtBQUssRUFBRSw4QkFBOEIsSUFBSSxDQUFDO2FBQ3JELENBQUM7UUFDSixDQUFDO1FBQ0QsT0FBTyxFQUFFLEdBQW9CLEVBQUU7WUFDN0IsT0FBTyxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ25DLENBQUM7UUFDRCxNQUFNLEVBQUUsQ0FBQyxRQUFnQixFQUFtQixFQUFFO1lBQzVDLE9BQU8sSUFBSSxDQUFDLFVBQVUsQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUNuQyxDQUFDO1FBQ0QsT0FBTyxFQUFFLENBQUMsT0FBZSxFQUFrQyxFQUFFO1lBQzNELElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLGlCQUFpQjtnQkFBRSxPQUFPLEVBQUUsQ0FBQztZQUM5QyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsaUJBQWlCLENBQUMsS0FBSyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDO2dCQUNuRSxTQUFTLEVBQUUsQ0FBQyxDQUFDLFdBQVc7Z0JBQ3hCLEVBQUUsRUFBRSxDQUFDLENBQUMsT0FBTztnQkFDYixHQUFHLEVBQUUsQ0FBQyxDQUFDLFFBQVE7YUFDaEIsQ0FBQyxDQUFDLENBQUM7UUFDTixDQUFDO1FBQ0QsT0FBTyxFQUFFLENBQUMsY0FBdUIsRUFBZ0MsRUFBRTtZQUNqRSxNQUFNLE1BQU0sR0FBRyxJQUFJLEdBQUcsRUFBMkIsQ0FBQztZQUNsRCxJQUFJLElBQUksQ0FBQyxLQUFLLEVBQUUsTUFBTSxFQUFFLENBQUM7Z0JBQ3ZCLEtBQUssTUFBTSxDQUFDLElBQUksRUFBRSxFQUFFLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztvQkFDM0QsTUFBTSxDQUFDLEdBQUcsQ0FBQyxJQUFJLEVBQUU7d0JBQ2YsRUFBRSxFQUFHLEVBQVUsQ0FBQyx1QkFBdUIsSUFBSSxDQUFDO3dCQUM1QyxHQUFHLEVBQUcsRUFBVSxDQUFDLHdCQUF3QixJQUFJLENBQUM7cUJBQy9DLENBQUMsQ0FBQztnQkFDTCxDQUFDO1lBQ0gsQ0FBQztZQUNELE9BQU8sTUFBTSxDQUFDO1FBQ2hCLENBQUM7UUFDRCxJQUFJLEVBQUUsQ0FBQyxjQUF1QixFQUFnQyxFQUFFO1lBQzlELE1BQU0sTUFBTSxHQUFHLElBQUksR0FBRyxFQUEyQixDQUFDO1lBQ2xELElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxHQUFHLEVBQUUsQ0FBQztnQkFDcEIsS0FBSyxNQUFNLENBQUMsRUFBRSxFQUFFLEVBQUUsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO29CQUN0RCxNQUFNLENBQUMsR0FBRyxDQUFDLEVBQUUsRUFBRTt3QkFDYixFQUFFLEVBQUcsRUFBVSxDQUFDLHVCQUF1QixJQUFJLENBQUM7d0JBQzVDLEdBQUcsRUFBRyxFQUFVLENBQUMsd0JBQXdCLElBQUksQ0FBQztxQkFDL0MsQ0FBQyxDQUFDO2dCQUNMLENBQUM7WUFDSCxDQUFDO1lBQ0QsT0FBTyxNQUFNLENBQUM7UUFDaEIsQ0FBQztLQUNGLENBQUM7SUFFSyxRQUFRLEdBQUc7UUFDaEIsU0FBUyxFQUFFLEdBQVcsRUFBRTtZQUN0QixPQUFPLElBQUksQ0FBQyxLQUFLLEVBQUUsa0JBQWtCLElBQUksQ0FBQyxDQUFDO1FBQzdDLENBQUM7UUFDRCxTQUFTLEVBQUUsR0FBVyxFQUFFO1lBQ3RCLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLHdCQUF3QixJQUFJLENBQUMsQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUMxRCxDQUFDO1FBQ0QsS0FBSyxFQUFFLEdBQVcsRUFBRTtZQUNsQixPQUFPLElBQUksQ0FBQyxLQUFLLEVBQUUsaUJBQWlCLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsSUFBSSxDQUFDLENBQUM7UUFDNUUsQ0FBQztLQUNGLENBQUM7SUFFSyxNQUFNLEdBQUc7UUFDZCxPQUFPLEVBQUUsR0FBVyxFQUFFO1lBQ3BCLE9BQU8sSUFBSSxDQUFDLEtBQUssRUFBRSxPQUFPLElBQUksQ0FBQyxDQUFDO1FBQ2xDLENBQUM7UUFDRCxRQUFRLEVBQUUsR0FBVyxFQUFFO1lBQ3JCLE9BQU8sSUFBSSxDQUFDLEtBQUssRUFBRSxRQUFRLElBQUksQ0FBQyxDQUFDO1FBQ25DLENBQUM7UUFDRCxXQUFXLEVBQUUsR0FBVyxFQUFFO1lBQ3hCLE9BQU8sSUFBSSxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsSUFBSSxDQUFDLENBQUM7UUFDM0MsQ0FBQztLQUNGLENBQUM7SUFFSyxRQUFRLEdBQUc7UUFDaEIsU0FBUyxFQUFFLEdBQWlDLEVBQUU7WUFDNUMsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLEVBQTJCLENBQUM7WUFDbEQsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxDQUFDO2dCQUN6QixLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7b0JBQzVELE1BQU0sQ0FBQyxHQUFHLEVBQVMsQ0FBQztvQkFDcEIsTUFBTSxXQUFXLEdBQUcsQ0FBQyxDQUFDLGtCQUFrQixJQUFJLENBQUMsQ0FBQztvQkFDOUMsTUFBTSxLQUFLLEdBQUcsQ0FBQyxDQUFDLFlBQVksSUFBSSxDQUFDLENBQUM7b0JBQ2xDLE1BQU0sUUFBUSxHQUFHLENBQUMsQ0FBQyxRQUFRLElBQUksQ0FBQyxDQUFDO29CQUNqQyxNQUFNLFVBQVUsR0FBRyxDQUFDLENBQUMsVUFBVSxJQUFJLENBQUMsQ0FBQztvQkFDckMsTUFBTSxTQUFTLEdBQUcsUUFBUSxHQUFHLFVBQVUsQ0FBQztvQkFDeEMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUU7d0JBQ2QsUUFBUSxFQUFFLENBQUMsQ0FBQyxRQUFRLElBQUksU0FBUzt3QkFDakMsaUJBQWlCLEVBQUUsQ0FBQyxDQUFDLGlCQUFpQixJQUFJLENBQUM7d0JBQzNDLGdCQUFnQixFQUFFLENBQUMsQ0FBQyxnQkFBZ0IsSUFBSSxDQUFDO3dCQUN6QyxhQUFhLEVBQUUsQ0FBQyxDQUFDLGFBQWEsSUFBSSxDQUFDO3dCQUNuQyxlQUFlLEVBQUUsQ0FBQyxDQUFDLGVBQWUsSUFBSSxDQUFDO3dCQUN2QyxhQUFhLEVBQUUsQ0FBQyxDQUFDLGFBQWEsSUFBSSxDQUFDO3dCQUNuQyxnQkFBZ0IsRUFBRSxLQUFLLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsR0FBRyxLQUFLLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7d0JBQzlELFdBQVcsRUFBRSxTQUFTLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLEdBQUcsU0FBUyxDQUFDLENBQUMsQ0FBQyxDQUFDO3dCQUNyRCxVQUFVLEVBQUUsQ0FBQyxDQUFDLFVBQVUsSUFBSSxDQUFDO3FCQUM5QixDQUFDLENBQUM7Z0JBQ0wsQ0FBQztZQUNILENBQUM7WUFDRCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBQ0QsU0FBUyxFQUFFLEdBQXdCLEVBQUU7WUFDbkMsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUM7WUFDekMsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxDQUFDO2dCQUN6QixLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7b0JBQzVELE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFHLEVBQVUsQ0FBQyxRQUFRLElBQUksU0FBUyxDQUFDLENBQUM7Z0JBQ3JELENBQUM7WUFDSCxDQUFDO1lBQ0QsT0FBTyxNQUFNLENBQUM7UUFDaEIsQ0FBQztRQUNELFdBQVcsRUFBRSxDQUFDLFFBQWdCLEVBQUUsRUFBOEMsRUFBRTtZQUM5RSxNQUFNLE1BQU0sR0FBK0MsRUFBRSxDQUFDO1lBQzlELElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxRQUFRLEVBQUUsQ0FBQztnQkFDekIsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO29CQUM1RCxNQUFNLENBQUMsR0FBRyxFQUFTLENBQUM7b0JBQ3BCLE1BQU0sTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLGFBQWEsSUFBSSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxlQUFlLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsYUFBYSxJQUFJLENBQUMsQ0FBQyxDQUFDO29CQUMxRixJQUFJLE1BQU0sR0FBRyxDQUFDO3dCQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUM7Z0JBQ3hELENBQUM7WUFDSCxDQUFDO1lBQ0QsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDO1lBQzNDLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDaEMsQ0FBQztRQUNELGlCQUFpQixFQUFFLEdBQTBCLEVBQUU7WUFDN0MsT0FBTyxJQUFJLENBQUMsS0FBSyxFQUFFLGlCQUFpQixJQUFJLEVBQUUsQ0FBQztRQUM3QyxDQUFDO0tBQ0YsQ0FBQztJQUVLLEdBQUcsR0FBRztRQUNYLGNBQWMsRUFBRSxHQUFXLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLGlCQUFpQixJQUFJLENBQUM7UUFDaEUsYUFBYSxFQUFFLEdBQVcsRUFBRSxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsZ0JBQWdCLElBQUksQ0FBQztRQUM5RCxXQUFXLEVBQUUsR0FBVyxFQUFFLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsSUFBSSxDQUFDO1FBQzVELFlBQVksRUFBRSxHQUFXLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLGlCQUFpQixJQUFJLENBQUM7S0FDL0QsQ0FBQztJQUVLLFdBQVcsR0FBRztRQUNuQixrQkFBa0IsRUFBRSxHQUE4QyxFQUFFO1lBQ2xFLE9BQU8sRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsRUFBRSxDQUFDO1FBQ3BDLENBQUM7UUFDRCxnQkFBZ0IsRUFBRSxHQUdoQixFQUFFO1lBQ0YsT0FBTztnQkFDTCxFQUFFLEVBQUUsRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsRUFBRTtnQkFDOUIsR0FBRyxFQUFFLEVBQUUsR0FBRyxFQUFFLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDLEVBQUU7YUFDaEMsQ0FBQztRQUNKLENBQUM7S0FDRixDQUFDO0NBQ0gifQ==
295
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVzdC1tZXRyaWNzLWFkYXB0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9wcm94aWVzL3NtYXJ0LXByb3h5L3J1c3QtbWV0cmljcy1hZGFwdGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLE9BQU8sa0JBQWtCO0lBQ3JCLE1BQU0sQ0FBa0I7SUFDeEIsS0FBSyxHQUFRLElBQUksQ0FBQztJQUNsQixTQUFTLEdBQTBDLElBQUksQ0FBQztJQUN4RCxjQUFjLENBQVM7SUFFL0IsWUFBWSxNQUF1QixFQUFFLGNBQWMsR0FBRyxJQUFJO1FBQ3hELElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO1FBQ3JCLElBQUksQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO0lBQ3ZDLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxJQUFJO1FBQ2YsSUFBSSxDQUFDO1lBQ0gsSUFBSSxDQUFDLEtBQUssR0FBRyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDOUMsQ0FBQztRQUFDLE1BQU0sQ0FBQztZQUNQLG1EQUFtRDtRQUNyRCxDQUFDO0lBQ0gsQ0FBQztJQUVNLFlBQVk7UUFDakIsSUFBSSxJQUFJLENBQUMsU0FBUztZQUFFLE9BQU87UUFDM0Isa0RBQWtEO1FBQ2xELElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNaLElBQUksQ0FBQyxTQUFTLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUNoQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDZCxDQUFDLEVBQUUsSUFBSSxDQUFDLGNBQWMsQ0FBQyxDQUFDO1FBQ3hCLElBQUksSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUN6QixJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3pCLENBQUM7SUFDSCxDQUFDO0lBRU0sV0FBVztRQUNo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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@push.rocks/smartproxy",
3
- "version": "27.5.0",
3
+ "version": "27.6.0",
4
4
  "private": false,
5
5
  "description": "A powerful proxy package with unified route-based configuration for high traffic management. Features include SSL/TLS support, flexible routing patterns, WebSocket handling, advanced security options, and automatic ACME certificate management.",
6
6
  "main": "dist_ts/index.js",
@@ -0,0 +1,484 @@
1
+ # SmartProxy Metrics System
2
+
3
+ ## Architecture
4
+
5
+ Two-tier design separating the data plane from the observation plane:
6
+
7
+ **Hot path (per-chunk, lock-free):** All recording in the proxy data plane touches only `AtomicU64` counters. No `Mutex` is ever acquired on the forwarding path. `CountingBody` batches flushes every 64KB to reduce DashMap shard contention.
8
+
9
+ **Cold path (1Hz sampling):** A background tokio task drains pending atomics into `ThroughputTracker` circular buffers (Mutex-guarded), producing per-second throughput history. Same task prunes orphaned entries and cleans up rate limiter state.
10
+
11
+ **Read path (on-demand):** `snapshot()` reads all atomics and locks ThroughputTrackers to build a serializable `Metrics` struct. TypeScript polls this at 1s intervals via IPC.
12
+
13
+ ```
14
+ Data Plane (lock-free) Background (1Hz) Read Path
15
+ ───────────────────── ────────────────── ─────────
16
+ record_bytes() ──> AtomicU64 ──┐
17
+ record_http_request() ──> AtomicU64 ──┤
18
+ connection_opened/closed() ──> AtomicU64 ──┤ sample_all() snapshot()
19
+ backend_*() ──> DashMap<AtomicU64> ──┤────> drain atomics ──────> Metrics struct
20
+ protocol_*() ──> AtomicU64 ──┤ feed ThroughputTrackers ──> JSON
21
+ datagram_*() ──> AtomicU64 ──┘ prune orphans ──> IPC stdout
22
+ ──> TS cache
23
+ ──> IMetrics API
24
+ ```
25
+
26
+ ### Key Types
27
+
28
+ | Type | Crate | Purpose |
29
+ |---|---|---|
30
+ | `MetricsCollector` | `rustproxy-metrics` | Central store. All DashMaps, atomics, and throughput trackers |
31
+ | `ThroughputTracker` | `rustproxy-metrics` | Circular buffer of 1Hz samples. Default 3600 capacity (1 hour) |
32
+ | `ForwardMetricsCtx` | `rustproxy-passthrough` | Carries `Arc<MetricsCollector>` + route_id + source_ip through TCP forwarding |
33
+ | `CountingBody` | `rustproxy-http` | Wraps HTTP bodies, batches byte recording per 64KB, flushes on drop |
34
+ | `ProtocolGuard` | `rustproxy-http` | RAII guard for frontend/backend protocol active/total counters |
35
+ | `ConnectionGuard` | `rustproxy-passthrough` | RAII guard calling `connection_closed()` on drop |
36
+ | `RustMetricsAdapter` | TypeScript | Polls Rust via IPC, implements `IMetrics` interface over cached JSON |
37
+
38
+ ---
39
+
40
+ ## What's Collected
41
+
42
+ ### Global Counters
43
+
44
+ | Metric | Type | Updated by |
45
+ |---|---|---|
46
+ | Active connections | AtomicU64 | `connection_opened/closed` |
47
+ | Total connections (lifetime) | AtomicU64 | `connection_opened` |
48
+ | Total bytes in | AtomicU64 | `record_bytes` |
49
+ | Total bytes out | AtomicU64 | `record_bytes` |
50
+ | Total HTTP requests | AtomicU64 | `record_http_request` |
51
+ | Active UDP sessions | AtomicU64 | `udp_session_opened/closed` |
52
+ | Total UDP sessions | AtomicU64 | `udp_session_opened` |
53
+ | Total datagrams in | AtomicU64 | `record_datagram_in` |
54
+ | Total datagrams out | AtomicU64 | `record_datagram_out` |
55
+
56
+ ### Per-Route Metrics (keyed by route ID string)
57
+
58
+ | Metric | Storage |
59
+ |---|---|
60
+ | Active connections | `DashMap<String, AtomicU64>` |
61
+ | Total connections | `DashMap<String, AtomicU64>` |
62
+ | Bytes in / out | `DashMap<String, AtomicU64>` |
63
+ | Pending throughput (in, out) | `DashMap<String, (AtomicU64, AtomicU64)>` |
64
+ | Throughput history | `DashMap<String, Mutex<ThroughputTracker>>` |
65
+
66
+ Entries are pruned via `retain_routes()` when routes are removed.
67
+
68
+ ### Per-IP Metrics (keyed by IP string)
69
+
70
+ | Metric | Storage |
71
+ |---|---|
72
+ | Active connections | `DashMap<String, AtomicU64>` |
73
+ | Total connections | `DashMap<String, AtomicU64>` |
74
+ | Bytes in / out | `DashMap<String, AtomicU64>` |
75
+ | Pending throughput (in, out) | `DashMap<String, (AtomicU64, AtomicU64)>` |
76
+ | Throughput history | `DashMap<String, Mutex<ThroughputTracker>>` |
77
+ | Domain requests | `DashMap<String, DashMap<String, AtomicU64>>` (IP → domain → count) |
78
+
79
+ All seven maps for an IP are evicted when its active connection count drops to 0. Safety-net pruning in `sample_all()` catches entries orphaned by races. Snapshots cap at 100 IPs, sorted by active connections descending.
80
+
81
+ **Domain request tracking:** Records which domains each frontend IP has requested. Populated from HTTP Host headers (for HTTP/1.1, HTTP/2, HTTP/3 requests) and from SNI (for TLS passthrough connections). Capped at 256 domains per IP (`MAX_DOMAINS_PER_IP`) to prevent subdomain-spray abuse. Inner DashMap uses 2 shards to minimise base memory per IP (~200 bytes). Common case (IP + domain both known) is two DashMap reads + one atomic increment with zero allocation.
82
+
83
+ ### Per-Backend Metrics (keyed by "host:port")
84
+
85
+ | Metric | Storage |
86
+ |---|---|
87
+ | Active connections | `DashMap<String, AtomicU64>` |
88
+ | Total connections | `DashMap<String, AtomicU64>` |
89
+ | Detected protocol (h1/h2/h3) | `DashMap<String, String>` |
90
+ | Connect errors | `DashMap<String, AtomicU64>` |
91
+ | Handshake errors | `DashMap<String, AtomicU64>` |
92
+ | Request errors | `DashMap<String, AtomicU64>` |
93
+ | Total connect time (microseconds) | `DashMap<String, AtomicU64>` |
94
+ | Connect count | `DashMap<String, AtomicU64>` |
95
+ | Pool hits | `DashMap<String, AtomicU64>` |
96
+ | Pool misses | `DashMap<String, AtomicU64>` |
97
+ | H2 failures (fallback to H1) | `DashMap<String, AtomicU64>` |
98
+
99
+ All per-backend maps are evicted when active count reaches 0. Pruned via `retain_backends()`.
100
+
101
+ ### Frontend Protocol Distribution
102
+
103
+ Tracked via `ProtocolGuard` RAII guards and `FrontendProtocolTracker`. Five protocol categories, each with active + total counters (AtomicU64):
104
+
105
+ | Protocol | Where detected |
106
+ |---|---|
107
+ | h1 | `FrontendProtocolTracker` on first HTTP/1.x request |
108
+ | h2 | `FrontendProtocolTracker` on first HTTP/2 request |
109
+ | h3 | `ProtocolGuard::frontend("h3")` in H3ProxyService |
110
+ | ws | `ProtocolGuard::frontend("ws")` on WebSocket upgrade |
111
+ | other | Fallback (TCP passthrough without HTTP) |
112
+
113
+ Uses `fetch_update` for saturating decrements to prevent underflow races.
114
+
115
+ ### Backend Protocol Distribution
116
+
117
+ Same five categories (h1/h2/h3/ws/other), tracked via `ProtocolGuard::backend()` at connection establishment. Backend h2 failures (fallback to h1) are separately counted.
118
+
119
+ ### Throughput History
120
+
121
+ `ThroughputTracker` is a circular buffer storing `ThroughputSample { timestamp_ms, bytes_in, bytes_out }` at 1Hz.
122
+
123
+ - Global tracker: 1 instance, default 3600 capacity
124
+ - Per-route trackers: 1 per active route
125
+ - Per-IP trackers: 1 per connected IP (evicted with the IP)
126
+ - HTTP request tracker: reuses ThroughputTracker with bytes_in = request count, bytes_out = 0
127
+
128
+ Query methods:
129
+ - `instant()` — last 1 second average
130
+ - `recent()` — last 10 seconds average
131
+ - `throughput(N)` — last N seconds average
132
+ - `history(N)` — last N raw samples in chronological order
133
+
134
+ Snapshots return 60 samples of global throughput history.
135
+
136
+ ### Protocol Detection Cache
137
+
138
+ Not part of MetricsCollector. Maintained by `HttpProxyService`'s protocol detection system. Injected into the metrics snapshot at read time by `get_metrics()`.
139
+
140
+ Each entry records: host, port, domain, detected protocol (h1/h2/h3), H3 port, age, last accessed, last probed, suppression flags, cooldown timers, consecutive failure counts.
141
+
142
+ ---
143
+
144
+ ## Instrumentation Points
145
+
146
+ ### TCP Passthrough (`rustproxy-passthrough`)
147
+
148
+ **Connection lifecycle** — `tcp_listener.rs`:
149
+ - Accept: `conn_tracker.connection_opened(&ip)` (rate limiter) + `ConnectionTrackerGuard` RAII
150
+ - Route match: `metrics.connection_opened(route_id, source_ip)` + `ConnectionGuard` RAII
151
+ - Close: Both guards call their respective `_closed()` methods on drop
152
+
153
+ **Byte recording** — `forwarder.rs` (`forward_bidirectional_with_timeouts`):
154
+ - Initial peeked data recorded immediately
155
+ - Per-chunk in both directions: `record_bytes(n, 0, ...)` / `record_bytes(0, n, ...)`
156
+ - Same pattern in `forward_bidirectional_split_with_timeouts` (tcp_listener.rs) for TLS-terminated paths
157
+
158
+ ### HTTP Proxy (`rustproxy-http`)
159
+
160
+ **Request counting** — `proxy_service.rs`:
161
+ - `record_http_request()` called once per request after route matching succeeds
162
+
163
+ **Body byte counting** — `counting_body.rs` wrapping:
164
+ - Request bodies: `CountingBody::new(body, ..., Direction::In)` — counts client-to-upstream bytes
165
+ - Response bodies: `CountingBody::new(body, ..., Direction::Out)` — counts upstream-to-client bytes
166
+ - Batched flush every 64KB (`BYTE_FLUSH_THRESHOLD = 65_536`), remainder flushed on drop
167
+ - Also updates `connection_activity` atomic (idle watchdog) and `active_requests` counter (streaming detection)
168
+
169
+ **Backend metrics** — `proxy_service.rs`:
170
+ - `backend_connection_opened(key, connect_time)` — after TCP/TLS connect succeeds
171
+ - `backend_connection_closed(key)` — on teardown
172
+ - `backend_connect_error(key)` — TCP/TLS connect failure or timeout
173
+ - `backend_handshake_error(key)` — H1/H2 protocol handshake failure
174
+ - `backend_request_error(key)` — send_request failure
175
+ - `backend_h2_failure(key)` — H2 attempted, fell back to H1
176
+ - `backend_pool_hit(key)` / `backend_pool_miss(key)` — connection pool reuse
177
+ - `set_backend_protocol(key, proto)` — records detected protocol
178
+
179
+ **WebSocket** — `proxy_service.rs`:
180
+ - Does NOT use CountingBody; records bytes directly per-chunk in both directions of the bidirectional copy loop
181
+
182
+ ### QUIC (`rustproxy-passthrough`)
183
+
184
+ **Connection level** — `quic_handler.rs`:
185
+ - `connection_opened` / `connection_closed` via `QuicConnGuard` RAII
186
+ - `conn_tracker.connection_opened/closed` for rate limiting
187
+
188
+ **Stream level**:
189
+ - For QUIC-to-TCP stream forwarding: `record_bytes(bytes_in, bytes_out, ...)` called once per stream at completion (post-hoc, not per-chunk)
190
+ - For HTTP/3: delegates to `HttpProxyService.handle_request()`, so all HTTP proxy metrics apply
191
+
192
+ **H3 specifics** — `h3_service.rs`:
193
+ - `ProtocolGuard::frontend("h3")` tracks the H3 connection
194
+ - H3 request bodies: `record_bytes(data.len(), 0, ...)` called directly (not CountingBody) since H3 uses `stream.send_data()`
195
+ - H3 response bodies: wrapped in CountingBody like HTTP/1 and HTTP/2
196
+
197
+ ### UDP (`rustproxy-passthrough`)
198
+
199
+ **Session lifecycle** — `udp_listener.rs` / `udp_session.rs`:
200
+ - `udp_session_opened()` + `connection_opened(route_id, source_ip)` on new session
201
+ - `udp_session_closed()` + `connection_closed(route_id, source_ip)` on idle reap or port drain
202
+
203
+ **Datagram counting** — `udp_listener.rs`:
204
+ - Inbound: `record_bytes(len, 0, ...)` + `record_datagram_in()`
205
+ - Outbound (backend reply): `record_bytes(0, len, ...)` + `record_datagram_out()`
206
+
207
+ ---
208
+
209
+ ## Sampling Loop
210
+
211
+ `lib.rs` spawns a tokio task at configurable interval (default 1000ms):
212
+
213
+ ```rust
214
+ loop {
215
+ tokio::select! {
216
+ _ = cancel => break,
217
+ _ = interval.tick() => {
218
+ metrics.sample_all();
219
+ conn_tracker.cleanup_stale_timestamps();
220
+ http_proxy.cleanup_all_rate_limiters();
221
+ }
222
+ }
223
+ }
224
+ ```
225
+
226
+ `sample_all()` performs in one pass:
227
+ 1. Drains `global_pending_tp_in/out` into global ThroughputTracker, samples
228
+ 2. Drains per-route pending counters into per-route trackers, samples each
229
+ 3. Samples idle route trackers (no new data) to advance their window
230
+ 4. Drains per-IP pending counters into per-IP trackers, samples each
231
+ 5. Drains `pending_http_requests` into HTTP request throughput tracker
232
+ 6. Prunes orphaned per-IP entries (bytes/throughput maps with no matching ip_connections key)
233
+ 7. Prunes orphaned per-backend entries (error/stats maps with no matching active/total key)
234
+
235
+ ---
236
+
237
+ ## Data Flow: Rust to TypeScript
238
+
239
+ ```
240
+ MetricsCollector.snapshot()
241
+ ├── reads all AtomicU64 counters
242
+ ├── iterates DashMaps (routes, IPs, backends)
243
+ ├── locks ThroughputTrackers for instant/recent rates + history
244
+ └── produces Metrics struct
245
+
246
+ RustProxy::get_metrics()
247
+ ├── calls snapshot()
248
+ ├── enriches with detectedProtocols from HTTP proxy protocol cache
249
+ └── returns Metrics
250
+
251
+ management.rs "getMetrics" IPC command
252
+ ├── calls get_metrics()
253
+ ├── serde_json::to_value (camelCase)
254
+ └── writes JSON to stdout
255
+
256
+ RustProxyBridge (TypeScript)
257
+ ├── reads JSON from Rust process stdout
258
+ └── returns parsed object
259
+
260
+ RustMetricsAdapter
261
+ ├── setInterval polls bridge.getMetrics() every 1s
262
+ ├── stores raw JSON in this.cache
263
+ └── IMetrics methods read synchronously from cache
264
+
265
+ SmartProxy.getMetrics()
266
+ └── returns the RustMetricsAdapter instance
267
+ ```
268
+
269
+ ### IPC JSON Shape (Metrics)
270
+
271
+ ```json
272
+ {
273
+ "activeConnections": 42,
274
+ "totalConnections": 1000,
275
+ "bytesIn": 123456789,
276
+ "bytesOut": 987654321,
277
+ "throughputInBytesPerSec": 50000,
278
+ "throughputOutBytesPerSec": 80000,
279
+ "throughputRecentInBytesPerSec": 45000,
280
+ "throughputRecentOutBytesPerSec": 75000,
281
+ "routes": {
282
+ "<route-id>": {
283
+ "activeConnections": 5,
284
+ "totalConnections": 100,
285
+ "bytesIn": 0, "bytesOut": 0,
286
+ "throughputInBytesPerSec": 0, "throughputOutBytesPerSec": 0,
287
+ "throughputRecentInBytesPerSec": 0, "throughputRecentOutBytesPerSec": 0
288
+ }
289
+ },
290
+ "ips": {
291
+ "<ip>": {
292
+ "activeConnections": 2, "totalConnections": 10,
293
+ "bytesIn": 0, "bytesOut": 0,
294
+ "throughputInBytesPerSec": 0, "throughputOutBytesPerSec": 0,
295
+ "domainRequests": {
296
+ "example.com": 4821,
297
+ "api.example.com": 312
298
+ }
299
+ }
300
+ },
301
+ "backends": {
302
+ "<host:port>": {
303
+ "activeConnections": 3, "totalConnections": 50,
304
+ "protocol": "h2",
305
+ "connectErrors": 0, "handshakeErrors": 0, "requestErrors": 0,
306
+ "totalConnectTimeUs": 150000, "connectCount": 50,
307
+ "poolHits": 40, "poolMisses": 10, "h2Failures": 1
308
+ }
309
+ },
310
+ "throughputHistory": [
311
+ { "timestampMs": 1713000000000, "bytesIn": 50000, "bytesOut": 80000 }
312
+ ],
313
+ "totalHttpRequests": 5000,
314
+ "httpRequestsPerSec": 100,
315
+ "httpRequestsPerSecRecent": 95,
316
+ "activeUdpSessions": 0, "totalUdpSessions": 5,
317
+ "totalDatagramsIn": 1000, "totalDatagramsOut": 1000,
318
+ "frontendProtocols": {
319
+ "h1Active": 10, "h1Total": 500,
320
+ "h2Active": 5, "h2Total": 200,
321
+ "h3Active": 1, "h3Total": 50,
322
+ "wsActive": 2, "wsTotal": 30,
323
+ "otherActive": 0, "otherTotal": 0
324
+ },
325
+ "backendProtocols": { "...same shape..." },
326
+ "detectedProtocols": [
327
+ {
328
+ "host": "backend", "port": 443, "domain": "example.com",
329
+ "protocol": "h2", "h3Port": 443,
330
+ "ageSecs": 120, "lastAccessedSecs": 5, "lastProbedSecs": 120,
331
+ "h2Suppressed": false, "h3Suppressed": false,
332
+ "h2CooldownRemainingSecs": null, "h3CooldownRemainingSecs": null,
333
+ "h2ConsecutiveFailures": null, "h3ConsecutiveFailures": null
334
+ }
335
+ ]
336
+ }
337
+ ```
338
+
339
+ ### IPC JSON Shape (Statistics)
340
+
341
+ Lightweight administrative summary, fetched on-demand (not polled):
342
+
343
+ ```json
344
+ {
345
+ "activeConnections": 42,
346
+ "totalConnections": 1000,
347
+ "routesCount": 5,
348
+ "listeningPorts": [80, 443, 8443],
349
+ "uptimeSeconds": 86400
350
+ }
351
+ ```
352
+
353
+ ---
354
+
355
+ ## TypeScript Consumer API
356
+
357
+ `SmartProxy.getMetrics()` returns an `IMetrics` object. All members are synchronous methods reading from the polled cache.
358
+
359
+ ### connections
360
+
361
+ | Method | Return | Source |
362
+ |---|---|---|
363
+ | `active()` | `number` | `cache.activeConnections` |
364
+ | `total()` | `number` | `cache.totalConnections` |
365
+ | `byRoute()` | `Map<string, number>` | `cache.routes[name].activeConnections` |
366
+ | `byIP()` | `Map<string, number>` | `cache.ips[ip].activeConnections` |
367
+ | `topIPs(limit?)` | `Array<{ip, count}>` | `cache.ips` sorted by active desc, default 10 |
368
+ | `domainRequestsByIP()` | `Map<string, Map<string, number>>` | `cache.ips[ip].domainRequests` |
369
+ | `topDomainRequests(limit?)` | `Array<{ip, domain, count}>` | Flattened from all IPs, sorted by count desc, default 20 |
370
+ | `frontendProtocols()` | `IProtocolDistribution` | `cache.frontendProtocols.*` |
371
+ | `backendProtocols()` | `IProtocolDistribution` | `cache.backendProtocols.*` |
372
+
373
+ ### throughput
374
+
375
+ | Method | Return | Source |
376
+ |---|---|---|
377
+ | `instant()` | `{in, out}` | `cache.throughputInBytesPerSec/Out` |
378
+ | `recent()` | `{in, out}` | `cache.throughputRecentInBytesPerSec/Out` |
379
+ | `average()` | `{in, out}` | Falls back to `instant()` (not wired to windowed average) |
380
+ | `custom(seconds)` | `{in, out}` | Falls back to `instant()` (not wired) |
381
+ | `history(seconds)` | `IThroughputHistoryPoint[]` | `cache.throughputHistory` sliced to last N entries |
382
+ | `byRoute(windowSeconds?)` | `Map<string, {in, out}>` | `cache.routes[name].throughputIn/OutBytesPerSec` |
383
+ | `byIP(windowSeconds?)` | `Map<string, {in, out}>` | `cache.ips[ip].throughputIn/OutBytesPerSec` |
384
+
385
+ ### requests
386
+
387
+ | Method | Return | Source |
388
+ |---|---|---|
389
+ | `perSecond()` | `number` | `cache.httpRequestsPerSec` |
390
+ | `perMinute()` | `number` | `cache.httpRequestsPerSecRecent * 60` |
391
+ | `total()` | `number` | `cache.totalHttpRequests` (fallback: totalConnections) |
392
+
393
+ ### totals
394
+
395
+ | Method | Return | Source |
396
+ |---|---|---|
397
+ | `bytesIn()` | `number` | `cache.bytesIn` |
398
+ | `bytesOut()` | `number` | `cache.bytesOut` |
399
+ | `connections()` | `number` | `cache.totalConnections` |
400
+
401
+ ### backends
402
+
403
+ | Method | Return | Source |
404
+ |---|---|---|
405
+ | `byBackend()` | `Map<string, IBackendMetrics>` | `cache.backends[key].*` with computed `avgConnectTimeMs` and `poolHitRate` |
406
+ | `protocols()` | `Map<string, string>` | `cache.backends[key].protocol` |
407
+ | `topByErrors(limit?)` | `IBackendMetrics[]` | Sorted by total errors desc |
408
+ | `detectedProtocols()` | `IProtocolCacheEntry[]` | `cache.detectedProtocols` passthrough |
409
+
410
+ `IBackendMetrics`: `{ protocol, activeConnections, totalConnections, connectErrors, handshakeErrors, requestErrors, avgConnectTimeMs, poolHitRate, h2Failures }`
411
+
412
+ ### udp
413
+
414
+ | Method | Return | Source |
415
+ |---|---|---|
416
+ | `activeSessions()` | `number` | `cache.activeUdpSessions` |
417
+ | `totalSessions()` | `number` | `cache.totalUdpSessions` |
418
+ | `datagramsIn()` | `number` | `cache.totalDatagramsIn` |
419
+ | `datagramsOut()` | `number` | `cache.totalDatagramsOut` |
420
+
421
+ ### percentiles (stub)
422
+
423
+ `connectionDuration()` and `bytesTransferred()` always return zeros. Not implemented.
424
+
425
+ ---
426
+
427
+ ## Configuration
428
+
429
+ ```typescript
430
+ interface IMetricsConfig {
431
+ enabled: boolean; // default true
432
+ sampleIntervalMs: number; // default 1000 (1Hz sampling + TS polling)
433
+ retentionSeconds: number; // default 3600 (ThroughputTracker capacity)
434
+ enableDetailedTracking: boolean;
435
+ enablePercentiles: boolean;
436
+ cacheResultsMs: number;
437
+ prometheusEnabled: boolean; // not wired
438
+ prometheusPath: string; // not wired
439
+ prometheusPrefix: string; // not wired
440
+ }
441
+ ```
442
+
443
+ Rust-side config (`MetricsConfig` in `rustproxy-config`):
444
+
445
+ ```rust
446
+ pub struct MetricsConfig {
447
+ pub enabled: Option<bool>,
448
+ pub sample_interval_ms: Option<u64>, // default 1000
449
+ pub retention_seconds: Option<u64>, // default 3600
450
+ }
451
+ ```
452
+
453
+ ---
454
+
455
+ ## Design Decisions
456
+
457
+ **Lock-free hot path.** `record_bytes()` is the most frequently called method (per-chunk in TCP, per-64KB in HTTP). It only touches `AtomicU64` with `Relaxed` ordering and short-circuits zero-byte directions to skip DashMap lookups entirely.
458
+
459
+ **CountingBody batching.** HTTP body frames are typically 16KB. Flushing to MetricsCollector every 64KB reduces DashMap shard contention by ~4x compared to per-frame recording.
460
+
461
+ **RAII guards everywhere.** `ConnectionGuard`, `ConnectionTrackerGuard`, `QuicConnGuard`, `ProtocolGuard`, `FrontendProtocolTracker` all use Drop to guarantee counter cleanup on all exit paths including panics.
462
+
463
+ **Saturating decrements.** Protocol counters use `fetch_update` loops instead of `fetch_sub` to prevent underflow to `u64::MAX` from concurrent close races.
464
+
465
+ **Bounded memory.** Per-IP entries evicted on last connection close. Per-backend entries evicted on last connection close. Snapshot caps IPs and backends at 100 each. `sample_all()` prunes orphaned entries every second.
466
+
467
+ **Two-phase throughput.** Pending bytes accumulate in lock-free atomics. The 1Hz cold path drains them into Mutex-guarded ThroughputTrackers. This means the hot path never contends on a Mutex, while the cold path does minimal work (one drain + one sample per tracker).
468
+
469
+ ---
470
+
471
+ ## Known Gaps
472
+
473
+ | Gap | Status |
474
+ |---|---|
475
+ | `throughput.average()` / `throughput.custom(seconds)` | Fall back to `instant()`. Not wired to Rust windowed queries. |
476
+ | `percentiles.connectionDuration()` / `percentiles.bytesTransferred()` | Stub returning zeros. No histogram in Rust. |
477
+ | Prometheus export | Config fields exist but not wired to any exporter. |
478
+ | `LogDeduplicator` | Implemented in `rustproxy-metrics` but not connected to any call site. |
479
+ | Rate limit hit counters | Rate-limited requests return 429 but no counter is recorded in MetricsCollector. |
480
+ | QUIC stream byte counting | Post-hoc (per-stream totals after close), not per-chunk like TCP. |
481
+ | Throughput history in snapshot | Capped at 60 samples. TS `history(seconds)` cannot return more than 60 points regardless of `retentionSeconds`. |
482
+ | Per-route total connections / bytes | Available in Rust JSON but `IMetrics.connections.byRoute()` only exposes active connections. |
483
+ | Per-IP total connections / bytes | Available in Rust JSON but `IMetrics.connections.byIP()` only exposes active connections. |
484
+ | IPC response typing | `RustProxyBridge` declares `result: any` for both metrics commands. No type-safe response. |
@@ -3,6 +3,6 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@push.rocks/smartproxy',
6
- version: '27.5.0',
6
+ version: '27.6.0',
7
7
  description: 'A powerful proxy package with unified route-based configuration for high traffic management. Features include SSL/TLS support, flexible routing patterns, WebSocket handling, advanced security options, and automatic ACME certificate management.'
8
8
  }
@@ -57,6 +57,10 @@ export interface IMetrics {
57
57
  byRoute(): Map<string, number>;
58
58
  byIP(): Map<string, number>;
59
59
  topIPs(limit?: number): Array<{ ip: string; count: number }>;
60
+ /** Per-IP domain request counts: IP -> { domain -> count }. */
61
+ domainRequestsByIP(): Map<string, Map<string, number>>;
62
+ /** Top IP-domain pairs sorted by request count descending. */
63
+ topDomainRequests(limit?: number): Array<{ ip: string; domain: string; count: number }>;
60
64
  frontendProtocols(): IProtocolDistribution;
61
65
  backendProtocols(): IProtocolDistribution;
62
66
  };
@@ -90,6 +90,39 @@ export class RustMetricsAdapter implements IMetrics {
90
90
  result.sort((a, b) => b.count - a.count);
91
91
  return result.slice(0, limit);
92
92
  },
93
+ domainRequestsByIP: (): Map<string, Map<string, number>> => {
94
+ const result = new Map<string, Map<string, number>>();
95
+ if (this.cache?.ips) {
96
+ for (const [ip, im] of Object.entries(this.cache.ips)) {
97
+ const dr = (im as any).domainRequests;
98
+ if (dr && typeof dr === 'object') {
99
+ const domainMap = new Map<string, number>();
100
+ for (const [domain, count] of Object.entries(dr)) {
101
+ domainMap.set(domain, count as number);
102
+ }
103
+ if (domainMap.size > 0) {
104
+ result.set(ip, domainMap);
105
+ }
106
+ }
107
+ }
108
+ }
109
+ return result;
110
+ },
111
+ topDomainRequests: (limit: number = 20): Array<{ ip: string; domain: string; count: number }> => {
112
+ const result: Array<{ ip: string; domain: string; count: number }> = [];
113
+ if (this.cache?.ips) {
114
+ for (const [ip, im] of Object.entries(this.cache.ips)) {
115
+ const dr = (im as any).domainRequests;
116
+ if (dr && typeof dr === 'object') {
117
+ for (const [domain, count] of Object.entries(dr)) {
118
+ result.push({ ip, domain, count: count as number });
119
+ }
120
+ }
121
+ }
122
+ }
123
+ result.sort((a, b) => b.count - a.count);
124
+ return result.slice(0, limit);
125
+ },
93
126
  frontendProtocols: (): IProtocolDistribution => {
94
127
  const fp = this.cache?.frontendProtocols;
95
128
  return {