Home Explore Help
Register Sign In
lqb
/
nginx-ui
mirror of https://github.com/0xJacky/nginx-ui.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: e04de298a4
Branches Tags
nginx-ui
/
docs
/
guide
/
config-nginx-log.md

config-nginx-log.md 3.2 KB
History Raw

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 production validation and comprehensive testing (M2 Pro 12 cores, September 2025):

Metric Value Description
Production Pipeline ~10,000 records/sec Complete indexing with search capabilities
Parser Performance ~932K records/sec Stream processing only
CPU Utilization 90%+ Optimized multi-core processing
Memory Efficiency Zero-allocation design Advanced memory pooling system
Adaptive Scaling 12→36 workers Dynamic resource optimization
Batch Optimization 1000→6000 Real-time throughput tuning

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 Advanced indexing delivers enterprise-grade performance with ~10,000 records/second throughput for complete log processing. The system automatically optimizes CPU utilization (90%+) and adapts worker scaling (12→36) for optimal performance based on your hardware. :::

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