# Nginx Log

本節介紹 Nginx UI 中 Nginx 日誌處理和分析功能的設定選項。

## 進階索引

### AdvancedIndexingEnabled

- 類型: `boolean`
- 預設值: `false`
- 環境變數: `NGINX_UI_NGINX_LOG_ADVANCED_INDEXING_ENABLED`
- 版本: `>= v2.2.0`

此選項啟用 Nginx 日誌的進階索引功能，提供高效能的日誌搜尋和分析能力。

### 系統需求

#### 最低需求
- **CPU**: 最少 1 核心
- **記憶體**: 最少 2GB RAM
- **儲存**: 至少 20GB 可用磁碟空間

#### 建議配置
- **CPU**: 建議 2 核心或以上
- **記憶體**: 建議 4GB RAM 或以上
- **儲存**: 建議使用 SSD 以獲得更好的 I/O 效能

### 效能指標

基於 M2 Pro（12 核心）的測試結果：

| 指標 | 數值 | 說明 |
|------|------|------|
| **索引吞吐量** | 3,860it/s | 基於 M2 Pro（12 核心）測試 |
| **CPU 使用率** | 90%+ | 最佳化的多核處理 |
| **記憶體效率** | 600MB/1Mit | 零分配管道最佳化 |

### 功能特性

啟用進階索引後，您將獲得以下功能：

#### 核心能力
- **零分配管道** - 最佳化記憶體使用以實現高效能處理
- **動態分片管理** - 智慧分布日誌資料到各個分片
- **增量索引掃描** - 僅索引新的日誌條目以提高效率
- **自動日誌輪轉偵測** - 無縫處理輪轉的日誌檔案

#### 搜尋與分析
- **進階搜尋和過濾** - 支援多條件的複雜查詢
- **支援正規表示式的全文搜尋** - 強大的模式比對能力
- **跨檔案時間線關聯** - 分析多個日誌檔案中的事件
- **錯誤模式識別** - 自動偵測錯誤模式

#### 資料處理
- **壓縮日誌檔案支援** - 支援 gzip 和其他壓縮格式
- **離線 GeoIP 分析** - 無需外部服務的位置分析
- **即時分析儀表板** - 即時監控和統計
- **多維資料視覺化** - 進階圖表和圖形

### 使用注意事項

::: tip 效能影響提示
啟用進階索引將在日誌處理期間消耗系統資源。該功能設計為最大化 CPU 使用率以獲得最佳索引效能。
:::

::: info 開源限制
- 進階日誌索引功能對所有使用者免費開源
- 我們不接受該功能的功能請求
- 如需商業或專業使用，請聯絡 business@uozi.com
:::

::: warning 初始索引
當您啟用進階索引時，系統將立即開始索引現有日誌檔案。此初始索引過程可能會暫時影響系統效能。
:::