For the complete documentation index, see llms.txt. This page is also available as Markdown.

Observability

How to see what your BoxLang applications, servers and AI agents are doing, with BxLens, BxMCP, logging and the debugger.

Observability answers one question: what is my application doing right now, and why? BoxLang gives you several tools for it. Some are built into the runtime, and some are modules you add. This section helps you pick the right one and shows how to get started.

🧭 Pick your tool

I want to...
Use
Cost

See what one request did, step by step

BxLens debug bar

Free

Find slow queries, repeated queries and slow outgoing calls

BxLens bar and console

Free, with limits

Work failures as issues: group, resolve, ignore, add notes

BxLens Errors page

Free in memory, saved to disk with BoxLang+

Watch the JVM, threads, disks, caches and scheduled tasks of a server

BxLens console

Free for one server

Be alerted by email, Slack, Teams or Telegram

BxLens alerts and reports

BoxLang+

Watch many servers from one place

BxLens fleet view

BoxLang+

See what your AI agents do and what they cost

BoxLang+

Keep an audit trail of an agent you build

Included with BoxLang AI

Let an AI assistant inspect and operate a live runtime

Free, needs bx-ai

Write application and runtime logs

Core

Step through code

Core

Time a block of code

Core

🔭 What you can observe

Your application

  • Every request, with a waterfall of templates, queries and HTTP calls

  • Errors grouped into issues that you can work through

  • Slow and repeated queries, including ORM SQL

  • Outgoing HTTP calls by host and endpoint

  • Mail your application builds and sends

  • ColdBox events, views, modules and schedulers

Your servers and agents

  • The JVM: heap, garbage collection, threads and deadlocks

  • Executors, scheduled tasks, datasources and caches

  • Disks, CPU and memory, with the share that belongs to BoxLang

  • Every server that shares a store folder

  • AI agent runs, model calls, tool calls and MCP servers, with cost

🚀 Get started

1

Install BxLens

2

Turn on the bar and the console

BxLens ships with everything off. Enable each surface in boxlang.json. The BxLens page shows the settings.

3

Open your app

Load a page from the same machine to see the bar. Open /~bxlens/index.bxm for the console.

4

Add the agents

If you build with BoxLang AI, turn on the AI page of the console. If you want an AI assistant to inspect the runtime, install BxMCP. See AI and MCP observability.

📚 In this section

BxLensAI and MCP ObservabilityGallery and VideosLoggingBxMCP

Last updated

Was this helpful?