Beamlens.Skill.Exception (beamlens v0.3.1)

View Source

Application exception monitoring skill.

Experimental

This skill is experimental. The API may change in future releases.

Captures and analyzes exceptions via Tower's reporter system to help identify error patterns, exception types, and crash investigations.

Requires Tower to be installed and configured:

# In mix.exs deps
{:tower, "~> 0.8.6"}

# In config/config.exs
config :tower,
  reporters: [Beamlens.Skill.Exception.ExceptionStore]

Usage

{Beamlens, skills: [:beam, :exception]}

Sensitive Data

This skill captures exception messages and stacktraces which may contain sensitive data (file paths, variable values, etc.). Ensure your exception handling does not expose PII before enabling this operator.

All functions are read-only with zero side effects.

Summary

Functions

callbacks()

Returns the Lua sandbox callback map for exception analysis.

snapshot()

High-level exception statistics for quick health assessment.

Functions

callbacks()

Returns the Lua sandbox callback map for exception analysis.

These functions are registered with Puck.Sandbox.Eval and can be called from LLM-generated Lua code.

snapshot()

High-level exception statistics for quick health assessment.

Returns a map with:

  • :total_exceptions_5m - Total exceptions in the 5-minute window
  • :by_kind - Map of counts by exception kind (:error, :exit, :throw, :message)
  • :by_level - Map of counts by log level
  • :top_exception_types - List of maps, each with :type (string) and :count (integer)
  • :unique_exception_types - Count of distinct exception types