0

0

Laravel Telescope?调试工具如何安装使用?

小老鼠

小老鼠

发布时间:2025-09-06 10:00:01

|

609人浏览过

|

来源于php中文网

原创

Laravel Telescope通过简单安装即可监控应用运行状态,支持配置watchers筛选数据、手动记录信息,并建议开发环境使用以避免性能影响,生产环境需谨慎启用并限制访问权限。

laravel telescope?调试工具如何安装使用?

Laravel Telescope 是 Laravel 官方提供的优雅的调试助手,它能让你深入了解应用程序的运行情况,从请求、异常到数据库查询,应有尽有。安装和使用都非常简单,能极大地提升开发效率。

首先,安装 Telescope 只需要一条 Composer 命令:

composer require laravel/telescope

然后,发布 Telescope 的资源文件:

php artisan telescope:install

这条命令会创建 Telescope 的配置文件

config/telescope.php
和数据库迁移文件。接下来,运行迁移:

php artisan migrate

最后,访问

/telescope
路由,就能看到 Telescope 的界面了。默认情况下,只有本地环境才能访问,可以通过修改
config/telescope.php
中的
middleware
配置来调整访问权限。

Telescope 默认会记录很多信息,但有时我们只想关注特定类型的数据,或者排除一些不重要的信息。

如何配置 Telescope 监控特定数据?

Telescope 的配置非常灵活。你可以通过修改

config/telescope.php
文件来控制哪些数据被记录。例如,如果你只想监控慢查询,可以调整
watchers
配置:

'watchers' => [
    Telescope\Watchers\QueryWatcher::class => [
        'enabled' => env('TELESCOPE_QUERY_WATCHER', true),
        'slow' => 100, // 毫秒,超过这个时间的查询会被标记为慢查询
    ],
    // 其他 watchers...
],

这里的

QueryWatcher
负责监控数据库查询。
slow
选项定义了慢查询的阈值。你还可以禁用其他不需要的 watchers,以减少 Telescope 的资源消耗。

智能网站优化SiteSEO1.52
智能网站优化SiteSEO1.52

系统易学易懂,用户只需会上网、不需学习编程及任何语言,只要使用该系统平台,只要会打字,即可在线直接完成建站所有工作。本程序适合不懂php环境配置的新手用来在本机调试智能SiteSEO网站优化软件,安装过程极其简单。您的网站地址:http://localhost您的网站后台:登录地址: http://localhost/admin.php密 码: admin服务器套件所包含的软件:nginx-0.7

下载

除了配置文件,你还可以在代码中使用 Facades 来手动记录信息:

use Illuminate\Support\Facades\Log;
use Laravel\Telescope\Facades\Telescope;

// 记录调试信息
Telescope::info('这是一个调试信息');

// 记录异常
try {
    // ...
} catch (\Exception $e) {
    Telescope::exception($e);
    Log::error($e);
}

这种方式可以让你更精细地控制哪些信息被 Telescope 记录。

Telescope 对性能有什么影响?如何优化?

Telescope 作为一个调试工具,不可避免地会对性能产生一定的影响,尤其是在生产环境中。默认情况下,Telescope 会记录大量的请求、查询、日志等信息,这会增加 CPU 和内存的开销。

为了优化 Telescope 的性能,可以采取以下措施:

  • 仅在开发环境中使用: 这是最简单有效的方法。在生产环境中禁用 Telescope,可以避免性能问题。可以通过环境变量来控制 Telescope 的启用状态。
  • 禁用不必要的 watchers: 禁用那些你不需要的 watchers,可以减少 Telescope 的数据收集量。
  • 调整采样率: Telescope 允许你设置采样率,控制记录数据的比例。例如,你可以设置只记录 10% 的请求。
  • 使用 Redis 队列: Telescope 默认使用数据库队列来处理数据。如果数据量很大,可以考虑使用 Redis 队列,以提高处理速度。
  • 定期清理数据: Telescope 会将数据存储在数据库中。随着时间的推移,数据量会越来越大。定期清理旧数据,可以释放磁盘空间,提高查询效率。可以使用
    php artisan telescope:prune
    命令来清理数据。
php artisan telescope:prune --hours=48 # 删除 48 小时前的数据

如何在生产环境中使用 Telescope 进行问题排查?

虽然通常建议在生产环境中禁用 Telescope,但在某些情况下,你可能需要在生产环境中使用 Telescope 来排查问题。这时,需要特别注意安全性和性能。

以下是一些建议:

  • 限制访问权限: 确保只有授权的开发人员才能访问 Telescope 界面。可以使用 IP 地址限制、HTTP 认证等方式来保护 Telescope。
  • 启用身份验证: Telescope 允许你配置身份验证,只有通过身份验证的用户才能访问 Telescope。
  • 监控资源消耗: 在生产环境中启用 Telescope 时,密切关注服务器的 CPU、内存、磁盘 I/O 等资源消耗情况。如果发现性能问题,及时调整配置或禁用 Telescope。
  • 使用采样率: 为了减少数据量,可以使用采样率,只记录一部分请求。
  • 及时禁用: 问题排查完毕后,立即禁用 Telescope,避免长时间运行带来的风险。
  • 配置报警: 针对 Telescope 记录的异常、慢查询等信息,配置报警系统,及时发现和解决问题。

总的来说,在生产环境中使用 Telescope 需要谨慎,需要权衡安全性和性能。只有在必要的时候才启用,并采取相应的措施来保护系统。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2840

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1696

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1556

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1058

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1505

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1256

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1629

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1308

2023.11.13

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

22

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4.1万人学习

ASP 教程
ASP 教程

共34课时 | 4万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号