Dozzle日志监控工具常见问题解决方案指南

Dozzle日志监控工具常见问题解决方案指南

dozzle Realtime log viewer for docker containers. 项目地址: https://gitcode.com/gh_mirrors/do/dozzle

前言

Dozzle是一款轻量级的Docker容器日志实时监控工具，为开发者提供了便捷的日志查看体验。本文将针对使用过程中可能遇到的典型问题提供详细的解决方案，帮助用户更好地使用这款工具。

日志加载缓慢或无响应问题

问题根源分析

Dozzle采用Server Sent Events(SSE)技术实现实时日志推送，这种技术通过保持HTTP连接开放来实现持续数据传输。当中间网络服务(如Nginx、Traefik等)尝试缓冲这些连接时，会导致日志数据无法正常传输。

解决方案

Nginx服务配置

在Nginx配置中，需要特别针对API路径禁用缓冲：

server {
    location / {
        proxy_pass http://<dozzle容器IP>:8080;
    }

    location /api {
        proxy_pass http://<dozzle容器IP>:8080;
        proxy_buffering off;
        proxy_cache off;
    }
}

Traefik服务配置

Traefik默认会启用压缩中间件，这会影响SSE数据流。需要排除text/event-stream类型的压缩：

http:
  middlewares:
    compress-middleware:
      compress:
        excludedContentTypes:
          - text/event-stream

容器内存信息不显示问题（ARM设备）

问题诊断

在ARM架构设备上，Docker可能默认未启用内存统计功能。可通过以下命令验证：

docker info | grep "memory limit"

若显示"WARNING: No memory limit support"，则需启用cgroup内存支持。

解决方案

编辑/boot/cmdline.txt文件，添加以下参数后重启设备：

cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1

容器名称直接访问功能

Dozzle提供了通过容器名称直接访问日志的便捷方式。例如，对于名为"web-server"的容器，可通过以下URL直接访问：

/show?name=web-server

系统会自动解析为对应的容器ID并重定向。

主机ID相关问题

重复主机ID错误

当出现以下错误时，通常是由于主机ID重复导致：

duplicate host ID: *********, Endpoint: 1.1.1.1:7007 found, skipping

解决方案

1. 删除/var/lib/docker/engine-id文件
2. 重启Docker服务

主机未找到错误（Podman环境）

Podman默认不创建engine-id文件，需要手动创建：

mkdir -p /var/lib/docker
uuidgen > /var/lib/docker/engine-id

显示已停止的容器

默认情况下，Dozzle仅显示运行中的容器。如需查看已停止的容器：

1. 进入Dozzle设置界面
2. 启用"Show Stopped Containers"选项

多实例设置同步

单用户模式

设置存储在浏览器本地存储中，仅对当前浏览器有效。

多用户模式

需启用认证功能，设置将存储在/data目录下，可通过用户名实现跨实例同步。

结语

dozzle Realtime log viewer for docker containers. 项目地址: https://gitcode.com/gh_mirrors/do/dozzle