flant/loghouse-dashboard

Loghouse Dashboard 镜像说明

镜像概述

Loghouse Dashboard是一款针对Kubernetes的日志管理解决方案，能够高效存储大量日志到ClickHouse数据库，通过简单查询语言处理日志并提供在线监控Web UI。该项目虽不再积极开发，但仍保持开源，可用于K8s集群的日志收集、存储与分析。

注意：Loghouse项目已于2020年12月停止积极开发，推荐使用Loki、Graylog或ELK/EFK等替代方案。

核心功能

• 高效日志收集存储：Fluentd每秒可处理***条日志（单节点占用300MB内存），ClickHouse最小化磁盘使用（如53.5亿条日志仅占54GB）；
• 简单查询语言：支持精确匹配、正则表达式及AND/OR多条件筛选；
• K8s元数据集成：基于Pod名称、命名空间、标签等元数据筛选日志；
• 快速部署：通过Helm Chart一键部署到K8s集群；
• 强大Web UI：支持自定义时间范围、无限滚动、查询保存、权限控制（按命名空间限制）及CSV导出；
• 监控支持：Fluentd和ClickHouse可通过Prometheus+Grafana监控。

使用场景

适用于Kubernetes集群的日志收集、存储、实时查询与监控，帮助开发和运维团队快速定位系统问题、分析运行状态。

配置说明

安装步骤

需先安装Helm（K8s版本≥1.9）及cert-manager：

1. 添加Helm仓库：

bash
helm repo add loghouse https://flant.github.io/loghouse/charts/

2. 安装Chart：

bash
helm fetch loghouse/loghouse --untar
vim loghouse/values.yaml # 配置参数
helm install --namespace loghouse -n loghouse loghouse --timeout 1200

Web UI地址由values.yaml中的loghouse_host指定，通过auth参数配置基础认证。

架构说明

• Fluentd：以DaemonSet部署在每个K8s节点，收集日志并添加K8s元数据，写入ClickHouse；
• ClickHouse：单实例StatefulSet部署（支持外部实例），存储日志数据；
• Web UI：前端Nginx（基础认证）+后端Ruby应用，提供日志查询界面。

升级注意事项

升级到v0.3.0需先删除冲突对象：

bash
kubectl -n loghouse delete jobs,ing --all

警告：数据库 schema 已变更，升级前需备份ClickHouse数据，迁移任务会自动启动。

部署示例

Docker Run（不推荐，建议用Helm）

bash
# 需配合ClickHouse及Fluentd使用，示例仅展示Dashboard容器
docker run -d --name loghouse-dashboard -p 8080:80 flant/loghouse-dashboard

Docker Compose（简化版）

yaml
version: '3'
services:
  dashboard:
    image: flant/loghouse-dashboard
    ports:
      - "8080:80"
    environment:
      - CLICKHOUSE_HOST=clickhouse
  clickhouse:
    image: yandex/clickhouse-server
    ports:
      - "9000:9000"

（注：完整部署需参考Helm Chart配置）