Apache Solr 管理員介面 (Admin UI) 功能模組全解析
Solr 內建的 Web 管理介面為管理員與工程師提供直觀的配置檢視、查詢測試、文件分析與系統監控功能。本文詳細拆解各模組用途與操作要點。
一、概覽與求助區
介面右側固定顯示求助連結，包含：
- Documentation： 官方線上文件
- Issue Tracker： JIRA 問題追蹤
- IRC Channel： 線上聊天室加入指引
- Community forum： 郵件列表與社群討論
- Solr Query Syntax： 查詢語法參考
二、Logging（日誌管理）
1. 日誌檢視
點擊左側 Logging 可查看最近記錄，支援分頁與級別過濾。
2. 動態調整日誌級別
選中 Level 連結，呈現類別樹狀結構。點擊任意行可彈出選單設定級別 (OFF, ERROR, WARN, INFO, DEBUG, TRACE, ALL)。父節點設定會繼承至子節點，除非子節點有獨立設定。
三、Core Admin（核心管理）
左側列出現有 Core，點擊可檢視詳細資訊並執行建立、重載、卸載、合併索引等操作。由 Core Admin API 驅動。
四、Java Properties（系統屬性）
展示 JVM 所有系統屬性：Classpath、檔案編碼、記憶體設定、作業系統版本等，便於診斷環境差異。
五、Thread Dump（線程堆疊）
列出所有活躍線程狀態：
- ✅ RUNNABLE - 正在執行
- 🔒 BLOCKED - 等待監視器鎖
- ⏳ WAITING / TIMED_WAITING - 等待其他線程
- ✅ TERMINATED - 已結束
點擊線程名稱右側箭頭可展開堆疊追蹤，定位卡死或效能瓶頸。
六、Core Selector 與二級選單
下拉選單切換 Core，支援搜尋。選中 Core 後顯示元資料，下方二級選單包含：
- Overview： 統計、同步複寫資訊
- Analysis： 字段分析器測試
- Dataimport： DIH 狀態與執行
- Documents： 瀏覽器直接執行索引指令 (JSON/XML/CSV/檔案上傳)
- Files： 檢視配置檔 - solrconfig.xml, schema.xml 等
- Ping： 健康檢查
- Plugins/Stats： 外掛與統計資訊
- Query： 結構化查詢介面，支援 facet、highlight、spellcheck 等參數
- Replication： 主從複寫設定
- Schema： 欄位/動態欄位/複製欄位管理
- Segments Info： 索引分段資訊
七、重點功能深度說明
Analysis（分析介面）
驗證索引與查詢時的分詞處理一致性。輸入文字、選擇字段類型，勾選 Verbose Output 可見完整 Token 流程。
Dataimport（資料匯入）
配置與監控 DataImportHandler，支援完整/增量匯入，可即時調整參數。
Documents（文件索引）
支援多種格式直接索引：
- JSON / XML / CSV： 文字框輸入或檔案上傳
- Solr 命令： XML/JSON 格式的 add/delete/commit/optimize 指令
- 更新策略： Commit Within、Overwrite 控制
Files（配置檔檢視）
唯讀檢視 solrconfig.xml、schema.xml 等，編輯需使用外部編輯器。
Query（查詢介面）
完整查詢參數支援：
| 參數 | 說明 |
|---|
| q | 主查詢字串 |
| fq | 過濾查詢 (不影響評分) |
| sort | 排序規則 |
| start, rows | 分頁偏移與筆數 |
| fl | 回傳欄位列表 |
| wt | 回傳格式 (json/xml/csv...) |
| hl | 高亮顯示 |
| facet | 分面統計 |
| spellcheck | 拼字檢查 |
右側顯示完整 HTTP 請求 URL，便於程式碼整合。
提示： Admin UI 僅供管理與測試，生產環境建議啟用認證授權 (Basic Auth / Kerberos) 並限制網路存取。
