摘要：文章轉(zhuǎn)自視頻教程優(yōu)雅的應(yīng)用調(diào)試工具新擴(kuò)展是由和開(kāi)源的應(yīng)用的調(diào)試工具。計(jì)劃任務(wù)列出已運(yùn)行的計(jì)劃任務(wù)。該封閉函數(shù)會(huì)被序列化為一個(gè)長(zhǎng)字符串，加上他的哈希與簽名如出一轍該功能將記錄所有異常，并可查看具體異常情況。事件顯示所有事件的列表。

文章轉(zhuǎn)自：https://laravel-china.org/topics/19013
視頻教程：047. 優(yōu)雅的應(yīng)用調(diào)試工具--laravel/telescope （5.7 新擴(kuò)展）

Laravel Telescope 是由 Mohamed Said 和 Taylor Otwell?開(kāi)源?的 Laravel 應(yīng)用的調(diào)試工具。

你可以使用 Composer 安裝到你的應(yīng)用中。

安裝完 Telescope 后，你可以訪問(wèn)?/telescope?來(lái)訪問(wèn)該應(yīng)用。

如果你之前用過(guò) Clockwork 或者 Laravel Debugbar ，那么這兩款應(yīng)用與 Telescope 進(jìn)行對(duì)比的話就是純 UI 界面和重量級(jí)武器。

Telescope 由一系列監(jiān)聽(tīng)器組成，這些 "監(jiān)聽(tīng)器" 監(jiān)聽(tīng)每個(gè)進(jìn)入應(yīng)用的請(qǐng)求，不管是來(lái)自 HTTP 、命令行、任務(wù)調(diào)度還是隊(duì)列的。

這些監(jiān)聽(tīng)器捕獲這些請(qǐng)求以及其相關(guān)數(shù)據(jù)信息 -- 例如數(shù)據(jù)庫(kù)查詢以及其執(zhí)行時(shí)間，是否命中緩存，事件觸發(fā)郵件觸發(fā)等等。

在它操作界面上有用于檢查以下各項(xiàng)的選項(xiàng)欄，每個(gè)選項(xiàng)欄都代表它的監(jiān)聽(tīng)器：

Requests

Commands

Schedule

Jobs

Exceptions

Logs

Dumps

Queries

Models

Events

Mail

Notifications

Cache

Redis

讓我們逐步瀏覽每個(gè)選項(xiàng)查看觀察到的內(nèi)容。每個(gè)選項(xiàng)都顯示一個(gè)列表頁(yè)面，然后您可以點(diǎn)擊查看指定項(xiàng)目的詳細(xì)信息。

該選項(xiàng)允許您查看進(jìn)入應(yīng)用程序的所有 HTTP 請(qǐng)求。您將能查看所有 HTTP 請(qǐng)求以及每個(gè)請(qǐng)求的詳細(xì)信息。

每個(gè)請(qǐng)求頁(yè)面還會(huì)顯示來(lái)自其他觀察者關(guān)于此請(qǐng)求相關(guān)的數(shù)據(jù)；例如，所有數(shù)據(jù)庫(kù)查詢以及它們花費(fèi)時(shí)長(zhǎng)；該請(qǐng)求已通過(guò)身份驗(yàn)證用戶；等等。

命令選項(xiàng)列出已運(yùn)行的所有命令及其退出代碼。您還可以點(diǎn)擊查看所有參數(shù)，選項(xiàng)和相關(guān)內(nèi)容。

列出已運(yùn)行的計(jì)劃任務(wù)。在每個(gè)任務(wù)的詳細(xì)信息頁(yè)面上，查看他們的所有計(jì)劃信息，例如他們的 cron 計(jì)劃（例如?* * * * *）。

任務(wù)部分會(huì)列出所有運(yùn)行過(guò)，和正在運(yùn)行的任務(wù)。他和Horizon很類似，不過(guò)Horizon只支持Redis驅(qū)動(dòng)，而且它不僅僅是UI，它還能和隊(duì)列溝通，看你隊(duì)列運(yùn)行的情況。Telescope，簡(jiǎn)簡(jiǎn)單單只是一個(gè)UI，一個(gè)可以和任何隊(duì)列驅(qū)動(dòng)玩在一起的UI。

在任務(wù)列表頁(yè)上，你會(huì)看到任務(wù)名，和它在哪個(gè)隊(duì)列和連接上運(yùn)行，她的工作情況，和其所發(fā)生的經(jīng)歷。

在任務(wù)細(xì)節(jié)頁(yè)面上，你會(huì)看到以上列舉的數(shù)據(jù)，以及：主機(jī)名， 他的FQCN，網(wǎng)絡(luò)連接，隊(duì)列，嘗試次數(shù)，超時(shí)，還有標(biāo)簽。

任務(wù)會(huì)自動(dòng)給用過(guò)的Eloquent模型貼標(biāo)簽 (栗子：?AppVideo:1) ，如果用過(guò)用戶模型，就會(huì)給用戶模型貼標(biāo)簽，以此類推。

標(biāo)簽
諸如請(qǐng)求，命令等項(xiàng)目，會(huì)自動(dòng)被Telescope貼標(biāo)簽 （舉栗子： 如果一個(gè)用戶發(fā)出了請(qǐng)求，他就自動(dòng)會(huì)被貼上?Auth:1?if User 1 ； 如果你點(diǎn)擊那個(gè)標(biāo)簽， Telescope就只會(huì)顯示被貼上該標(biāo)簽的項(xiàng)目）

如HTTP請(qǐng)求一般，你可以看到所有與此任務(wù)相關(guān)的信息，比如數(shù)據(jù)庫(kù)查詢記錄，其觸發(fā)的其他任務(wù)，和任何生成的日志。

不過(guò)，你如若出發(fā)了封閉函數(shù)，那么你所見(jiàn)之信息不是?AppJobsRenderVideo?， 取而代之的是?Closure (web.php:43)?.

新封閉函數(shù)隊(duì)列
Taylor寫了一個(gè)新的庫(kù)，加回了隊(duì)列封閉函數(shù) （Laravel很多年前用過(guò)）。 這個(gè)庫(kù)的功能是，當(dāng)你將一個(gè)模型放入封閉函數(shù)中，它只會(huì)存這個(gè)模型的ID，而不是整個(gè)對(duì)象。（原作者說(shuō)的： 豈不妙哉？（反正隊(duì)列的類已經(jīng)如此作為了），他很興奮）。
dispatch(function () use ($video) { // do stuff in a queued job // 做一些隊(duì)列的事情 });
這樣做以后，封閉函數(shù)會(huì)被序列化，并且有一個(gè)哈希（Hash）值如影隨形。這樣可以防止你的代碼在進(jìn)入隊(duì)列事件后，代碼被篡改，很是不好。現(xiàn)在有了哈希，函數(shù)會(huì)先被檢查一遍，媽媽就不怕我的代碼被篡改了。
該封閉函數(shù)會(huì)被序列化為一個(gè)長(zhǎng)字符串，加上他的哈希（與簽名URL如出一轍）

該功能將記錄所有異常，并可查看具體異常情況。界面使用選項(xiàng)卡的形式呈現(xiàn)，包括主機(jī)信息，類型，請(qǐng)求，標(biāo)簽，用戶身份驗(yàn)證等。

除此之外也可看到異常在代碼中的位置，使其高亮并展示上下代碼段，且包含完整的堆棧追蹤。

你還可以從拋出異常請(qǐng)求中獲取指向異常詳情頁(yè)面的鏈接。

注意：在眾多選項(xiàng)卡中，如果您在單個(gè)頁(yè)面上（例如，給定的異常頁(yè)面），你也可獲得指向生成該頁(yè)面的請(qǐng)求鏈接。

如果產(chǎn)生多次相同的異常，它們將在列表頁(yè)面上進(jìn)行分組，但仍然可以深入查看異常顯示頁(yè)面中的各個(gè)異常。

日志項(xiàng)展示了日志的基本信息，級(jí)別和每條日志項(xiàng)的記錄時(shí)間。

當(dāng)你訪問(wèn)日志的單個(gè)詳細(xì)頁(yè)面時(shí)，你可以看到更多消息，包含所有你傳遞給日志的上下文數(shù)據(jù)（作為數(shù)組）。

"比挖掘原始文本文件棒一點(diǎn)。".

當(dāng)你用數(shù)組為你的日志項(xiàng)傳遞上下文時(shí)，你可以查看所有數(shù)據(jù)，查看觸發(fā)它的請(qǐng)求，觸發(fā)的用戶。"比挖掘原始文本文件棒一點(diǎn)。

"這是我最愛(ài)的功能之一"

如果你代碼中使用?dump()?函數(shù)，而且你在 Telescope 中打開(kāi)了 dump screen。你可以在 Telescope 中看到 dumps 并非來(lái)自你實(shí)際應(yīng)用。這為你提供了數(shù)據(jù)的?dd()?樣式輸出，而不會(huì)弄亂您的正常頁(yè)面加載。每個(gè) dump 還鏈接到生成它的請(qǐng)求。

如果你離開(kāi) dump screen，你所有的 dumps 會(huì)突然再次顯示到你的瀏覽器上。

列出了所有數(shù)據(jù)查詢相關(guān)信息，就像 debug bar 一樣。如 消耗時(shí)常、完整查詢、請(qǐng)求觸發(fā) 等。

漂亮的格式化顯示。

可以在服務(wù)中配置慢查詢的邊界，一旦查詢查過(guò)其配置時(shí)間將會(huì)被標(biāo)記，并配以紅色警告顯示。

注意：每個(gè)列表頁(yè)都有快捷方式和快速搜索。搜索標(biāo)簽和其他內(nèi)容。

可以看到 查詢、更新、刪除事件；以及這些事件產(chǎn)生的變化 等。

顯示所有事件的列表?？梢钥吹侥男┦录峭ㄟ^(guò)標(biāo)記廣播的；查看所有偵聽(tīng)器的列表，并深入了解調(diào)用的對(duì)象。

顯示發(fā)送的所有電子郵件的列表;收件人是誰(shuí);什么時(shí)候發(fā)的;是否還在隊(duì)列，然后什么時(shí)候出隊(duì)的?？梢钥吹诫娮余]件主題，當(dāng)你深入研究它時(shí)，你也會(huì)看到諸如 MailTrap 的郵件預(yù)覽。

甚至可以下載原始的?.eml?文件并在選定的客戶端中打開(kāi)。

顯示所有通知，及其類型，等等。

無(wú)法預(yù)覽，因?yàn)橛行┩ㄖ遣豢深A(yù)覽的，假如是郵件通知，你就會(huì)看到它在列表中。

如果通知已進(jìn)入隊(duì)列，還可以在 Jobs 的請(qǐng)求部分看到。有很多方式可以得到這些數(shù)據(jù)。

顯示緩存命中、未命中和更新等。

顯示鍵，值，何時(shí)過(guò)期。可以看到觸發(fā)它的請(qǐng)求，也可以在請(qǐng)求頁(yè)面上看到該請(qǐng)求的所有緩存命中/未命中。

跟上面的緩存類似。

諸如花了多久時(shí)間，什么時(shí)候發(fā)生，什么時(shí)候發(fā)起請(qǐng)求等等。

在任一選項(xiàng)卡的條目上獲取已驗(yàn)證用戶的相關(guān)信息。

可在生產(chǎn)環(huán)境的 telescope 服務(wù)中，配置可訪問(wèn)的郵件賬戶列表

在Gate 的 viewTelescope 中定義哪些用戶可以訪問(wèn)

你可能不想在生產(chǎn)環(huán)境中把所有東西都存著，所以你可以在 Telescope 服務(wù)提供者中， 運(yùn)行?Telescope::filter(function ($entry))。

默認(rèn)篩選器：

function ($entry) {
    if (local) { return true; }

    return $entry->isReportableException ||
        $entry->isfailedJob() ||
        $entry->isScheduledTask() ||
        $entry->hasMonitoredTag();
}

但是你可以自由地修改它。

點(diǎn)進(jìn)雷達(dá)按鈕，聲明一個(gè)監(jiān)控標(biāo)簽。你可以在 UI 界面聲明一個(gè)?Auth:1?監(jiān)視器。

生產(chǎn)環(huán)境中不會(huì)記錄請(qǐng)求，但是如果你有一個(gè)像?Auth:1?這樣的監(jiān)視器，你就會(huì)看到所有的請(qǐng)求都被記錄下來(lái)，除非你取消監(jiān)視。

NOTE: 如果你使用的是 Redis 隊(duì)列的話， Horizon 和 Telescope 能完美搭配。

在 Telescope 中任務(wù)調(diào)度會(huì)修剪掉過(guò)期的條目。你可以每晚都刪除超過(guò)__ 小時(shí)的東西。

這個(gè)也是在 config/telescope 中設(shè)置。

可以隨時(shí)啟用或棄用任意觀察者。 E.g.?WatchersCacheWatcher::class?就可以棄用。

還有一個(gè)?TELESCOPE_LIMIT?默認(rèn)定義是 100 ；該選項(xiàng)的意義就是一次性進(jìn)行 100 個(gè)查詢，100 次 Redis 查詢等。它們都可以在env中進(jìn)行配置。

Telescope 可以在本地和生產(chǎn)環(huán)境中運(yùn)行，并有內(nèi)建授權(quán)和工具用來(lái)保護(hù)私有數(shù)據(jù)。它可從多角度訪問(wèn)同類數(shù)據(jù)，具備一系列配置項(xiàng)，提供了健壯的標(biāo)記和過(guò)濾功能。

考慮把它放在一個(gè)獨(dú)立的數(shù)據(jù)庫(kù)中。

Taylor 稍后就在 Twitter 上提到你可以添加過(guò)濾器從而確保私有數(shù)據(jù)不會(huì)被記錄下來(lái)。

你可以使用?Telescope::night()?來(lái)開(kāi)啟夜晚模式(可能在某個(gè)服務(wù)提供者那里？)

數(shù)據(jù)存放在何處？隱藏在一個(gè) StorageRepository 接口實(shí)現(xiàn)之后； 類似數(shù)據(jù)庫(kù)一樣運(yùn)作在 Redis 上。你可以隨心所欲的實(shí)現(xiàn)它。這個(gè)接口中只有6-7 個(gè)方法。

它能存多少數(shù)據(jù)？不是太多，因?yàn)樯a(chǎn)環(huán)境幾乎會(huì)拋棄所有的東西，修剪下來(lái)，你一次只能保存 100 個(gè)。

我們能從 Slack 收到通知嗎？我們正在努力。

我能退出 Bugsnag/etc.嗎? 可能不能。雖然它簡(jiǎn)易且輕便，但并不意味著穩(wěn)定健壯。小心火燭。

我們能否按照時(shí)間戳進(jìn)行過(guò)濾？暫時(shí)還不能，但是這個(gè)是開(kāi)源項(xiàng)目，幫幫我們

在系統(tǒng)引導(dǎo)階段會(huì)產(chǎn)生什么影響？每次只會(huì)執(zhí)行一個(gè)查詢。生產(chǎn)環(huán)境中不會(huì)頻繁地把所有東西都插入進(jìn)去。你可以取消你不關(guān)心的監(jiān)聽(tīng)器。

我們能在同一個(gè)UI中檢查多個(gè)應(yīng)用嗎？可以；只需要在同一個(gè)數(shù)據(jù)庫(kù)中指向并記錄它們，然后考慮做標(biāo)記/過(guò)濾， 這樣你就可以按需做區(qū)分了。

Laravel 的哪個(gè)版本能與之兼容? 5.7.7+。