Skip to main content

​
Recall

Recall is a structured logging service built for Rails applications. Send logs with rich metadata, then search and analyze them with a powerful query language.

​
Features

Structured Logging

Log messages with arbitrary metadata as key-value pairs

Powerful Search

Query logs with a simple DSL that supports full-text and field searches

Real-time Streaming

See logs as they happen with live tail

Session Tracking

Group logs by session to follow user journeys

​
Quick Start

# Simple logging
BrainzLab::Recall.info("User signed up")

# With structured data
BrainzLab::Recall.info("Order placed",
  order_id: order.id,
  total: order.total,
  items: order.items.count
)

# Different log levels
BrainzLab::Recall.debug("Cache hit", key: "user:123")
BrainzLab::Recall.warn("Rate limit approaching", current: 95, limit: 100)
BrainzLab::Recall.error("Payment failed", error: e.message, amount: 99.99)
BrainzLab::Recall.fatal("Database connection lost")

​
Log Levels

LevelUse Case
debugDetailed debugging information
infoGeneral informational messages
warnWarning conditions that should be reviewed
errorError conditions that need attention
fatalCritical errors that may crash the application

​
Automatic Context

When using Rails, Recall automatically captures:
  • Request ID - Correlate all logs from a single request
  • Session ID - Follow user journeys across requests
  • User ID - If you set BrainzLab.set_user
  • Git commit - Know which version generated the log
  • Environment - production, staging, development

​
Searching Logs

Use the Query Language to search: 
level:error since:1h
data.user.id:123 since:7d
"payment failed" env:production

Query Language

Learn the full query syntax

​
Next Steps

Logging

Learn about logging best practices

Context

Add custom context to logs

Sessions

Track user sessions

Dashboard

Explore the Recall dashboard