Zero-Observer：一站式轻量级 Java 应用监控平台

仪表盘

应用日志

控制台日志

应用日志查询

应用日志详情

接口性能监控

慢请求分析

调用链监控

JVM 监控

服务端部署

zero-observer 数据存储使用 MySQL 与 Elasticsearch，MySQL 存储系统数据，Elasticsearch 存储日志数据。需自行安装 MySQL 与 Elasticsearch。

1. MySQL 初始化脚本

创建数据库：zero_observer，执行脚本。

CREATE TABLE `app_log_growth_trend` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `level` varchar(10) NOT NULL,
  `statistic_time` datetime NOT NULL,
  `log_count` int(11) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `app_log_total_growth_trend` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `statistic_time` datetime NOT NULL,
  `log_count` bigint(20) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `app_log_level_statistic` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `level` varchar(10) NOT NULL,
  `statistic_time` datetime NOT NULL,
  `log_count` int(11) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `app_env_instance` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `ip` varchar(50) NOT NULL,
  `port` varchar(5) NOT NULL,
  `hostname` varchar(255) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `app_log_statistic` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app_log_statistic_counter_id` bigint(20) NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `statistic_time` datetime NOT NULL,
  `log_count` bigint(20) NOT NULL DEFAULT '0',
  `slow_request_count` bigint(20) NOT NULL DEFAULT '0',
  `error_count` bigint(20) NOT NULL DEFAULT '0',
  `warn_count` bigint(20) NOT NULL DEFAULT '0',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `app_log_statistic_counter` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `statistic_time` datetime NOT NULL,
  `statistic_status` int(11) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `system_config` (
  `id` bigint(20) NOT NULL COMMENT '主键',
  `create_time` datetime NOT NULL COMMENT '创建时间',
  `key_code` varchar(50) NOT NULL COMMENT 'key 编码',
  `key_name` varchar(50) DEFAULT NULL COMMENT 'key 名称',
  `key_value` varchar(255) NOT NULL COMMENT 'key 值',
  `enabled` int(11) NOT NULL DEFAULT '1' COMMENT '是否启用',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

INSERT INTO `system_config` (`id`, `create_time`, `key_code`, `key_name`, `key_value`, `enabled`) VALUES (1, '2025-07-19 23:56:06', 'app_log_storage_days', '应用日志存储天数', '3', 1);

CREATE TABLE `users` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `account` varchar(100) NOT NULL,
  `pwd` varchar(255) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `token_info` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `subject` varchar(100) NOT NULL,
  `token` varchar(255) NOT NULL,
  `expire_time` datetime NOT NULL,
  `expire_timestamp` bigint(20) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `license` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `content` text NOT NULL,
  `remark` text DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `request_monitor_statistic` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `statistic_date` int(11) NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `uri` varchar(255) NOT NULL,
  `executeCount` int(11) DEFAULT NULL,
  `rtAvg` float DEFAULT NULL,
  `rtMax` int(11) DEFAULT NULL,
  `rtMin` int(11) DEFAULT NULL,
  `slow_count` int(11) DEFAULT 0,
  `slow_avg` float DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `request_mapping` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `ip` varchar(50) NOT NULL,
  `port` varchar(5) NOT NULL,
  `hostname` varchar(255) NOT NULL,
  `uri` varchar(255) DEFAULT NULL,
  `method` varchar(10) DEFAULT NULL,
  `handler_method` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

ALTER TABLE app_env_instance ADD online INT NULL;
ALTER TABLE app_env_instance ADD last_heartbeat DATETIME NULL;
ALTER TABLE request_monitor_statistic ADD req_method varchar(10) NULL;

CREATE TABLE `app_env` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `app` varchar(255) NOT NULL,
  `env` varchar(50) NOT NULL,
  `gene` varchar(20) NOT NULL,
  `signature` varchar(100) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `sys_lock` (
  `id` bigint(20) NOT NULL,
  `create_time` datetime NOT NULL,
  `lock_name` varchar(100) NOT NULL,
  `status` INT NOT NULL,
  `last_heartbeat` datetime DEFAULT NULL,
  `holder` varchar(255) DEFAULT NULL,
  `holder_id` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2. Docker 部署

拉取镜像

docker pull registry.cn-hangzhou.aliyuncs.com/kuafucv/zero-observer:2.0.0

启动容器

docker run -itd -p 8080:8080 --name zero-observer \
  -e TZ=Asia/Shanghai \
  -e ES_IP=127.0.0.1 \
  -e ES_PORT=9200 \
  -e ES_USERNAME=es \
  -e ES_PASSWORD=es \
  -e MYSQL_IP=127.0.0.1 \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USERNAME=root \
  -e MYSQL_PASSWORD=123456 \
  registry.cn-hangzhou.aliyuncs.com/kuafucv/zero-observer:2.0.0

参数解析：

• TZ：时区，默认 Asia/Shanghai
• ES_IP：elasticsearch 的 IP
• ES_PORT：elasticsearch restapi 的端口
• ES_USERNAME：elasticsearch 用户名，无则不填即可
• ES_PASSWORD：elasticsearch 密码，无则不填即可
• MYSQL_IP：mysql 的 IP
• MYSQL_PORT：mysql 端口
• MYSQL_USERNAME：用户名
• MYSQL_PASSWORD：密码

启动成功后，浏览器访问：http://127.0.0.1:8080/zero-observer/

默认用户密码：admin/123456

SpringBoot 应用接入

1. 引入 Maven 依赖

<dependency>
    <groupId>io.github.kuafucv</groupId>
    <artifactId>zero-log-spring-boot-starter</artifactId>
    <version>2.0.0</version>
</dependency>

2. 配置 application.yml

zero:
  log:
    server-url: http://127.0.0.1:8080/zero-observer

注意：serverUrl 为 zero-observer 服务访问地址，该属性值为 http://ip:port/zero-observer

3. 启动类添加注解

启动类添加 @EnableZeroLog 注解。

@SpringBootApplication
@EnableZeroLog
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

4. 启动服务

启动 Java 服务，等待日志自动上报至 zero-observer，前往界面查看对应数据。