怎么手动重置Laravel的Telescope日志数据_批量清空监控表

风丽同学_5665

风丽同学_5665

2026-07-28

794人浏览

原创

telescope:clear 命令物理清空 Telescope 所有主表数据(如 telescope_entries),不触发模型事件,需配合 pause/resume 避免写入冲突;prune 按时间精细清理,默认删 48 小时前数据,注意时区对齐。

telescope:clear 能清空所有数据,但不是“日志”而是调试条目

telescope 没有传统意义上的“日志文件”,它把所有请求、异常、查询、模型事件等都存进数据库表(如 telescope_entries、telescope_entries_tags)。所以所谓“重置日志数据”,本质是清空这些表里的记录。php artisan telescope:clear 就是为此设计的命令——它会 truncate 所有 telescope 主表,比手动写 sql 更安全,也自动处理外键依赖。

  • 执行后所有监控历史瞬间消失,包括已归档的旧条目
  • 不会删表结构,也不会影响 migrations 表或你的业务数据
  • ⚠️ 注意:该命令不走 Eloquent,不触发模型事件,也不调用软删除逻辑 —— 是真·物理删除
  • 如果你启用了 TELESCOPE_MODEL_WATCHER=true,模型变更记录也会一并清除

想保留部分数据?别用 clear,改用 prune 控制时间范围

有时候你只是想甩掉最近一周的脏数据,又不想连刚配好的测试链路都丢了。telescope:prune 就是更精细的方案:它按时间戳删,只清理超过指定天数的条目,默认是 48 小时(可通过 --hours 或 --days 调整)。

  • 例如清掉 7 天前的所有记录:php artisan telescope:prune --days=7
  • 它会自动识别并清理关联表(tags、monitored-tags 等),避免孤儿数据
  • ⚠️ 坑点:如果数据库时区和 PHP 时区不一致(比如 DB 是 UTC,APP 是 Asia/Shanghai),--days 可能误删或漏删 —— 建议先查下 telescope_entries.created_at 的实际值确认时区对齐
  • 这个命令适合加进定时任务,比如每天凌晨跑一次,比 clear 更贴近真实运维场景

暂停采集再清空,避免边删边写导致数据不一致

直接 telescope:clear 时,如果恰巧有请求正在写入 Telescope 表,可能造成部分新条目残留,或触发唯一索引冲突(尤其在高并发开发环境)。稳妥做法是先暂停采集,再清空,最后恢复。

Laravel
Laravel

避免常见的Laravel错误:N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载
  • 三步顺序不能错:php artisan telescope:pause → php artisan telescope:clear → php artisan telescope:resume
  • pause 实际是往 telescope_monitoring 表里插了一条禁用标记,不影响其他功能
  • ⚠️ 坑点:如果执行 pause 后忘记 resume,后续所有调试数据都不会被捕获,且面板上不会报错,只会显示“无数据”——容易误以为配置失效
  • 这个组合特别适合 CI 测试前重置环境,或本地调试卡顿时快速回归干净状态

手写 SQL 清空?可以,但得绕开外键和迁移锁

极少数情况(比如表被自定义修改过、或 telescope:clear 报错),你可能得自己 truncate。但直接 TRUNCATE TABLE telescope_entries 会失败——因为外键约束和可能的迁移锁。

  • 必须按依赖顺序清空:telescope_entries_tags → telescope_monitoring → telescope_entries
  • 推荐用 DELETE FROM + WHERE 1 替代 TRUNCATE,避开 AUTO_INCREMENT 重置和锁表问题
  • 示例(MySQL):DELETE FROM telescope_entries_tags; DELETE FROM telescope_monitoring; DELETE FROM telescope_entries;
  • ⚠️ 坑点:Laravel 默认开启 strict mode,某些 MySQL 版本下 DELETE 不带 LIMIT 会报错;可临时加 SET SQL_SAFE_UPDATES = 0;,但执行完记得关掉
Telescope 的“清空”不是日志轮转,而是调试上下文重置。真正容易被忽略的是时区偏差和 pause/resume 的状态残留——这两处不检查,就容易出现“明明清了却还有旧数据”或者“清完发现监控不动了”的假性故障。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

1973

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1219

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

715

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

2592

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

4288

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1019

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

4551

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

4102

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

5294

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 185人学习

Composer手册
Composer手册

共0课时 | 0人学习