PulseKit

Official PulseKit SDK for Elixir applications.

Installation

Add pulsekit to your list of dependencies in mix.exs:

def deps do
  [
    {:pulsekit, "~> 1.0"}
  ]
end

Configuration

Add to your config/config.exs:

config :pulsekit,
  endpoint: "https://your-pulsekit-instance.com",
  api_key: "pk_your_api_key",
  environment: "production",
  release: "1.0.0"

Usage

Capture Exceptions

try do
  raise "Something went wrong"
rescue
  e -> PulseKit.capture_exception(e, __STACKTRACE__)
end

# With additional context
PulseKit.capture_exception(error, stacktrace,
  tags: %{user_id: "123"},
  metadata: %{request_id: "abc"}
)

Custom Events

PulseKit.capture(%{
  type: "payment.success",
  level: :info,
  message: "Payment completed",
  metadata: %{amount: 99.99, currency: "USD"},
  tags: %{customer_id: "cust_123"}
})

Simple Messages

PulseKit.capture_message("User signed up", :info)
PulseKit.capture_message("Warning!", :warning, tags: %{user_id: "123"})

Plug Integration

Add to your Phoenix endpoint or router:

defmodule MyAppWeb.ErrorHandler do
  def handle_errors(conn, %{kind: kind, reason: reason, stack: stack}) do
    PulseKit.capture_exception(reason, stack,
      metadata: %{
        request_path: conn.request_path,
        method: conn.method
      }
    )
  end
end

Event Levels

• :debug - Detailed debugging information
• :info - General information
• :warning - Warning conditions
• :error - Error conditions
• :fatal - Critical errors

License

MIT