# 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.
:::