Repository navigation
Releases
v0.14.2
Links between the dashboards of applications with Monocle now open in one tab per application.
Tracing
- One tab per peer: links to a peer (the Peer column, Called …, Called from … and the folded-out HTTP row) open in a window named after its host, such as
monocle:billing.test(#40).- Each dashboard gives its own tab that name, so following links back and forth reuses the same tabs.
- These links leave out
rel="noopener", because a named tab can only be found again from the tab that opened it or one it opened.
Documentation: exeque.github.io/laravel-monocle
v0.14.1
The calling side of a link between applications now shows every capture its calls started, in one or more peers.
Tracing
- Peer column: the HTTP tab links each call to a peer to the capture it started in that peer's dashboard (#39).
- Header: a capture that called peers says Called Billing, Search (3). A peer with one capture links straight to it; a peer with several opens the HTTP tab.
- For agents: the summary holds
remote_children(name,urland the captureidsper peer), somonocle-showreturns it.
Documentation: exeque.github.io/laravel-monocle
v0.14.0
Applications that each run Monocle can now link the HTTP calls between them.
Tracing
- Calls between applications: list the dashboards of the applications this one calls in the new
trace.peersoption (#38).- A call through the
Httpfacade to a peer's host and port carriesX-Monocle-Parent,X-Monocle-OriginandX-Monocle-Name. Calls to other hosts get none of them. - The call's row in the HTTP tab links to the capture it started in the peer's dashboard (
peer), read from theX-Monocle-Idthe peer answers with. - The peer needs no configuration: its capture links back (
remote_parent) and its header says Called from …. trace.name(MONOCLE_NAME) is what an application calls itself, sent on calls to peers and on recorded responses. A peer is labelled by its string key intrace.peers, then by the name it gives itself, then by its host.
- A call through the
Documentation: exeque.github.io/laravel-monocle
v0.13.0
Every artisan command run at a terminal now shows the id of its capture when it ends.
Commands
- Capture id after a run: a command run at a terminal prints the id of its capture in a box when it ends, below any exception Laravel shows, with the
monocle:showcommand for it (#36).- The id links to the capture in the dashboard in terminals that open links; elsewhere the dashboard url is printed below it.
- It only shows when the error output is a terminal, so files, pipes, scheduler logs and CI never get it, and not with
-q. - The new
CommandLensoptionprint_capturedecides which runs print it:'always'(the default),'failure'for a non-zero exit code, and any other value turns it off.
Fixes
- Filament: notifications were not recorded with Filament 5.11, which serializes each pending notification in its mailbox (#37).
Documentation: exeque.github.io/laravel-monocle
v0.12.1
Laravel's exception page works again with the views lens enabled.
Fixes
- Views: with the views lens enabled, the exception page failed with
Property Illuminate\Support\Facades\Blade::$lastCompiled does not existinstead of showing the real exception (#33).
Documentation: exeque.github.io/laravel-monocle
v0.12.0
CORS preflights are no longer recorded.
Requests
except.methods: a new list of HTTP methods whose requests are never recorded, default['OPTIONS'](#31).- CORS preflights no longer fill the capture list, including preflights
HandleCorsanswers before routing. - Set
except.methodsto[]to recordOPTIONSrequests again. - Apps with a published config keep their own
exceptblock; add'methods' => ['OPTIONS']to get the new default.
- CORS preflights no longer fill the capture list, including preflights
Fixes
- Filament: flashed notifications were not recorded with Filament 5.10.3 and later, which wraps each pending notification in its mailbox (#32).
Documentation: exeque.github.io/laravel-monocle
v0.11.1
Excepted commands no longer leak captures through the commands they call.
Fixes
- Commands: a command called through
Artisan::call()from inside an excepted command became a capture of its own (#30).- Example:
migrate:fresh --seedis excepted (migrate*), and so is thedb:seedit calls (db:*). A seeder that ranArtisan::call('aggregates:backfill')still started a new command capture. That capture kept every query in memory, and on large seeds the process ran out of it. - An exception in
except.commandsnow covers the command and everything it calls. Recording works as before once the excepted command finishes.
- Example:
Documentation: exeque.github.io/laravel-monocle
v0.11.0
Laravel's built-in housekeeping commands are no longer recorded.
Artisan commands
- Default exclusions:
except.commandsnow also leaves out migrations, seeding, generators, publishing, the config, route, event and view caches,serve, Pail and similar built-in commands (#29):migrate*,db:*,schema:*,make:*,install:*,*:publish,key:*,storage:*,optimize*,config:*,route:*,event:*,view:*and more.schedule:run,cache:prune-stale-tagsandqueue:clearare still recorded.- Apps with a published config keep their own list; copy the new entries from
config/monocle.phpto get them.
Documentation: exeque.github.io/laravel-monocle
v0.10.1
Agent runs are counted with their real number of tokens.
Fixes
- AI: every
laravel/aiagent run, prompted or streamed, was recorded with twice its tokens (#27). A run with 10 input, 5 output and 2 cached tokens showed 20/10/4.- The doubled numbers were in the
tokensofairows andai.agentspans, in the token totals, inai_tokens_by_modeland in the estimated cost from v0.10.0. - The lens added each step's usage, and then also the run's usage, which is already the sum of its steps.
- The doubled numbers were in the
Documentation: exeque.github.io/laravel-monocle
v0.10.0
Token totals and an estimated cost for AI agents and Prism calls.
AI and Prism
- Token totals: the AI and Prism tabs and the overview now show the input, output and cached tokens of a capture (
ai_input_tokens,ai_output_tokens,ai_cached_tokens, and the same forprism_). Before, the tokens were only in an array total, which the dashboard leaves out. - Tokens per model:
ai_tokens_by_modelandprism_tokens_by_modelgive the input tokens not read from cache, the cached tokens and the output tokens for eachprovider/model. - Estimated cost: Token prices on the AI and Prism tabs takes a price per million tokens for each model, kept in your browser only. Once every model in a capture has a price, the totals show an Estimated cost. See Estimated cost.
Documentation: exeque.github.io/laravel-monocle