You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/nim/fundamentals/tech-specs.md
+23Lines changed: 23 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -83,6 +83,29 @@ The following benchmarks focus on **disk storage** requirements for NGINX Instan
83
83
-**Medium configuration**: Usually includes about **50 servers**, **200 locations**, and **200 upstreams/backends**. Each instance generates **16,766 metrics per minute**.
84
84
-**Generic Large configuration**: Handles up to **100 servers**, **1,000 locations**, and **900 upstreams/backends**. In **NGINX Plus**, each instance generates **59,484 metrics per minute**.
85
85
86
+
87
+
#### Directory Requirements for NGINX Instance Manager
88
+
89
+
Below are the directory requirements and storage recommendations for fresh, minimal, and moderate usage (<100 instances) of NGINX Instance Manager (NIM).
90
+
91
+
Important Note: These recommendations apply if you are using NGINX Agent to connect NGINX instances to NIM for full management capabilities (e.g., managing configurations, viewing metrics, applying WAF policies, managing certificates, etc.). If the use case is solely usage reporting, as introduced in R33+, the Agent is not required, and resources needed are significantly reduced. For usage reporting-only deployments, NIM simply receives and stores usage data sent directly from the instances, which does not require the same resource allocation outlined below.
92
+
93
+
- /usr/bin: Stores NIM binaries; recommend 500MB (current size ~400MB).
94
+
- /var/lib/nms/dqlite: Stores DQLite database data; recommend 1GB (2GB without NAP, 5GB with NAP enabled and large compiled bundles).
- /var/lib/clickhouse: Stores ClickHouse metrics data; recommend 2.5GB per instance (25GB for 10 instances, 250GB for 100 instances). This is only required if ClickHouse metrics are enabled. In NIM 2.20, lightweight mode can be deployed without ClickHouse (no metrics collected).
99
+
- /var/log/nms: Stores logs for NIM with rotation enabled; recommend 50MB per week if archived once a month.
100
+
- /etc/nms/: Stores NIM configuration files; recommend 50MB.
101
+
- /etc/nginx: Stores NGINX configuration files; typical size is 10–50MB (confirm with specific deployments).
102
+
103
+
**Key Considerations**:
104
+
-Resources listed above are necessary for instance management using NIM (via NGINX Agent).
105
+
-For usage reporting-only deployments (without management via Agent):
106
+
No ClickHouse metrics are collected.
107
+
Resource requirements are significantly reduced, as the usage data is only received and stored by NIM. This generally requires much less disk space and memory allocation. The intended use case (management vs. usage reporting) is critical to avoid allocating unnecessary resources. Regular monitoring, backups, and adjustments are still recommended to optimize operations.
108
+
86
109
#### Storage requirements for NGINX Plus
87
110
88
111
The table below provides storage estimates for **NGINX Plus** based on configuration size, number of instances, and a 14-day data retention period. Larger configurations and longer retention periods will require proportionally more storage.
0 commit comments