@spec benchmark(atom(), keyword(), (-> any())) :: map()

Benchmark a function with multiple iterations.

Options

• :iterations - Number of iterations (default: 100)
• :warmup - Warmup iterations (default: 10)

Example

Raxol.Profiler.benchmark(:sort, iterations: 1000, fn ->
  Enum.sort(list)
end)

@spec clear() :: :ok

Clear all profiling data.

@spec compare(
  atom(),
  keyword()
) :: map()

Compare two implementations.

Example

Raxol.Profiler.compare(:concat,
  old: fn -> str1 <> str2 end,
  new: fn -> IO.iodata_to_binary([str1, str2]) end
)

@spec disable() :: :ok

Disable the profiler and stop collecting metrics.

@spec enable() :: :ok | {:error, term()}

Enable the profiler.

Starts the profiler GenServer if not already running.

Profile a code block and record metrics.

Returns the result of the block while recording execution time, memory usage, and GC statistics.

Options

• :sample_rate - Sampling rate 0.0 to 1.0 (default: 1.0)
• :trace - Enable detailed tracing (default: false)
• :metadata - Additional metadata to record

Example

{result, stats} = Raxol.Profiler.profile do
  Enum.sort(large_list)
end

@spec profile_operation(atom(), keyword(), (-> any())) :: any()

Profile a named operation.

Example

Raxol.Profiler.profile_operation(:database_query, fn ->
  Repo.all(User)
end)

@spec report(keyword()) :: String.t() | map() | list()

Generate a performance report.

Options

• :format - Output format: :text (default), :json, or :raw
• :operations - Filter to specific operations (default: :all)

Example

Raxol.Profiler.report()
Raxol.Profiler.report(format: :json)

@spec suggest_optimizations() :: [String.t()]

Get optimization suggestions based on profiling data.