要在 Laravel 的 Telescope 中監(jiān)控排隊(duì)中的任務(wù)，需手動(dòng)添加監(jiān)聽(tīng)事件。1. 打開(kāi) app/Providers/TelescopeServiceProvider.php 文件；2. 在 register() 方法中引入并監(jiān)聽(tīng) JobQueued 事件；3. 配置完成后，在 Telescope 的 Jobs 標(biāo)簽下即可查看 queued job 的詳細(xì)信息，包括任務(wù)類(lèi)名、隊(duì)列名稱(chēng)及入隊(duì)參數(shù)等。此方法適用于 Redis 或數(shù)據(jù)庫(kù)驅(qū)動(dòng)的隊(duì)列，并支持延遲任務(wù)的監(jiān)控。注意線(xiàn)上環(huán)境應(yīng)合理設(shè)置過(guò)濾規(guī)則和數(shù)據(jù)安全策略以避免性能問(wèn)題和敏感信息泄露。

如果你在用 Laravel 的 Telescope 來(lái)監(jiān)控隊(duì)列任務(wù)，尤其是想查看排隊(duì)中的（queued）任務(wù)，可能會(huì)發(fā)現(xiàn)默認(rèn)情況下 Telescope 并不會(huì)記錄這些狀態(tài)的任務(wù)。這會(huì)讓排查問(wèn)題或調(diào)試任務(wù)流程變得有點(diǎn)麻煩。

要讓 Telescope 能監(jiān)控到 queued jobs，需要做一些小配置調(diào)整。

修改 Telescope 的記錄規(guī)則

默認(rèn)情況下，Telescope 只會(huì)記錄已處理（processed）、失?。╢ailed）和已刪除（pruned）的任務(wù)。想要它也記錄排隊(duì)中的任務(wù)，需要修改 TelescopeServiceProvider 中的監(jiān)聽(tīng)邏輯。

在 app/Providers/TelescopeServiceProvider.php 文件中找到 register() 方法，添加對(duì) JobProcessing 事件的監(jiān)聽(tīng)：

use Illuminate\Support\Facades\Bus;
use Illuminate\Queue\Events\JobQueued;

public function register()
{
    $this->hideSensitiveRequestDetails();

    Telescope::filter(function (IncomingEntry $entry) {
        if ($this->app->isLocal()) {
            return true;
        }

        return false;
    });

    // 添加這一行，監(jiān)聽(tīng) JobQueued 事件
    Telescope::listen([
        \Illuminate\Queue\Events\JobQueued::class,
    ]);
}

這樣，當(dāng)任務(wù)被推入隊(duì)列時(shí)，就會(huì)被 Telescope 捕獲并記錄下來(lái)了。

在 Telescope 界面中查看 queued job

配置完成后，當(dāng)你觸發(fā)一個(gè)任務(wù)入隊(duì)操作時(shí)，可以在 Telescope 的 Jobs 標(biāo)簽下看到對(duì)應(yīng)記錄。每條記錄會(huì)顯示任務(wù)類(lèi)名、連接名稱(chēng)、隊(duì)列名稱(chēng)以及序列化的任務(wù)數(shù)據(jù)。

點(diǎn)擊某條記錄可以查看詳情，包括任務(wù)參數(shù)、入隊(duì)時(shí)間等信息。這對(duì)調(diào)試任務(wù)是否成功入隊(duì)、參數(shù)是否正確非常有幫助。

注意：如果你使用的是 Redis 或數(shù)據(jù)庫(kù)驅(qū)動(dòng)的隊(duì)列，并且設(shè)置了延遲任務(wù)，Telescope 一樣可以捕獲到這些 queued job。

常見(jiàn)問(wèn)題與建議

• 隊(duì)列環(huán)境限制：默認(rèn)只在本地環(huán)境啟用 Telescope，線(xiàn)上環(huán)境通常是關(guān)閉的。如果你希望在線(xiàn)上記錄部分日志，記得合理控制過(guò)濾規(guī)則，避免性能影響。
• 數(shù)據(jù)安全：任務(wù)中可能包含敏感數(shù)據(jù)，比如用戶(hù) ID 或郵箱。在生產(chǎn)環(huán)境中務(wù)必注意不要記錄敏感字段，可以通過(guò) $telescope->hidden() 方法屏蔽某些字段。
• 任務(wù)重復(fù)記錄：有些任務(wù)可能多次入隊(duì)，導(dǎo)致 Telescope 中出現(xiàn)多條記錄。可以通過(guò)任務(wù) ID 或自定義標(biāo)識(shí)去重分析。

基本上就這些。只要加個(gè)監(jiān)聽(tīng)事件，就可以用 Telescope 查看 queued job 了。不復(fù)雜但容易忽略，默認(rèn)設(shè)置下看不到 queued 狀態(tài)的任務(wù)，手動(dòng)補(bǔ)一下就行。

以上是監(jiān)視排隊(duì)的作業(yè)望遠(yuǎn)鏡|隊(duì)列檢查的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！