Skip to content

Releases

v0.14.2

Choose a tag to compare

@ExeQue ExeQue released this 06 Nov 12:10
341ea54

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

Choose a tag to compare

@ExeQue ExeQue released this 06 Nov 11:49
fc7e0b8

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, url and the capture ids per peer), so monocle-show returns it.

Documentation: exeque.github.io/laravel-monocle

v0.14.0

Choose a tag to compare

@ExeQue ExeQue released this 06 Nov 11:17
abcabba

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.peers option (#38).
    • A call through the Http facade to a peer's host and port carries X-Monocle-Parent, X-Monocle-Origin and X-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 the X-Monocle-Id the 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 in trace.peers, then by the name it gives itself, then by its host.

Documentation: exeque.github.io/laravel-monocle

v0.13.0

Choose a tag to compare

@ExeQue ExeQue released this 05 Nov 09:42
5315be2

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:show command 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 CommandLens option print_capture decides 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

Choose a tag to compare

@ExeQue ExeQue released this 23 Oct 19:41

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 exist instead of showing the real exception (#33).

Documentation: exeque.github.io/laravel-monocle

v0.12.0

Choose a tag to compare

@ExeQue ExeQue released this 22 Oct 13:16
84c2e35

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 HandleCors answers before routing.
    • Set except.methods to [] to record OPTIONS requests again.
    • Apps with a published config keep their own except block; add 'methods' => ['OPTIONS'] to get the new default.

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

Choose a tag to compare

@ExeQue ExeQue released this 20 Oct 12:39
e519918

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 --seed is excepted (migrate*), and so is the db:seed it calls (db:*). A seeder that ran Artisan::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.commands now covers the command and everything it calls. Recording works as before once the excepted command finishes.

Documentation: exeque.github.io/laravel-monocle

v0.11.0

Choose a tag to compare

@ExeQue ExeQue released this 20 Oct 11:53
b793810

Laravel's built-in housekeeping commands are no longer recorded.

Artisan commands

  • Default exclusions: except.commands now 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-tags and queue:clear are still recorded.
    • Apps with a published config keep their own list; copy the new entries from config/monocle.php to get them.

Documentation: exeque.github.io/laravel-monocle

v0.10.1

Choose a tag to compare

@ExeQue ExeQue released this 19 Oct 12:48
a86e4d6

Agent runs are counted with their real number of tokens.

Fixes

  • AI: every laravel/ai agent 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 tokens of ai rows and ai.agent spans, in the token totals, in ai_tokens_by_model and 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.

Documentation: exeque.github.io/laravel-monocle

v0.10.0

Choose a tag to compare

@ExeQue ExeQue released this 19 Oct 12:29
9e26e4b

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 for prism_). Before, the tokens were only in an array total, which the dashboard leaves out.
  • Tokens per model: ai_tokens_by_model and prism_tokens_by_model give the input tokens not read from cache, the cached tokens and the output tokens for each provider/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