config-nginx-log.md 2.8 KB
Nginx Log
This section covers configuration options for Nginx log processing and analysis features in Nginx UI.
Advanced Indexing
AdvancedIndexingEnabled
- Type:
boolean - Default:
false - Environment Variable:
NGINX_UI_NGINX_LOG_ADVANCED_INDEXING_ENABLED - Version:
>= v2.2.0
This option enables advanced indexing for Nginx logs, which provides high-performance log search and analysis capabilities.
System Requirements
Minimum Requirements
- CPU: 1 core minimum
- Memory: 2GB RAM minimum
- Storage: At least 20GB available disk space
Recommended Configuration
- CPU: 2+ cores recommended
- Memory: 4GB+ RAM recommended
- Storage: SSD storage for better I/O performance
Performance Metrics
Based on testing with M2 Pro (12 cores):
| Metric | Value | Description |
|---|---|---|
| Indexing Throughput | 3,860it/s | Based on M2 Pro (12 cores) testing |
| CPU Utilization | 90%+ | Optimized multi-core processing |
| Memory Efficiency | 600MB/1Mit | Zero-allocation pipeline optimization |
Features
When advanced indexing is enabled, you get access to the following features:
Core Capabilities
- Zero-allocation pipeline - Optimized memory usage for high-performance processing
- Dynamic shard management - Intelligent distribution of log data across shards
- Incremental index scanning - Only indexes new log entries for efficiency
- Automated log rotation detection - Seamlessly handles rotated log files
Search & Analysis
- Advanced search & filtering - Complex queries with multiple criteria
- Full-text search with regex support - Powerful pattern matching capabilities
- Cross-file timeline correlation - Analyze events across multiple log files
- Error pattern recognition - Automatic detection of error patterns
Data Processing
- Compressed log file support - Works with gzipped and other compressed formats
- Offline GeoIP analysis - Location-based analytics without external services
- Real-time analytics dashboard - Live monitoring and statistics
- Multi-dimensional data visualization - Advanced charts and graphs
Usage Considerations
::: tip Performance Impact Notice Enabling advanced indexing will consume system resources during log processing. The feature is designed to maximize CPU utilization for optimal indexing performance. :::
::: info Open Source Limitation
- Advanced log indexing features are free and open source for all users
- We do not accept feature requests for this functionality
- For commercial or professional use, contact business@uozi.com :::
::: warning Initial Indexing When you enable advanced indexing, the system will immediately start indexing existing log files. This initial indexing process may temporarily impact system performance. :::