Documentation

LaraSignal Overview

Everything you need to integrate, configure, and monitor your Laravel application performance in real-time.

What is LaraSignal?

LaraSignal is a privacy-first, developer-focused observability and APM platform built exclusively around Laravel's request lifecycle, queue workers, database queries, artisan commands, scheduled tasks, outgoing HTTP calls, and logs.

Full Lifecycle Visibility

Trace HTTP requests, background jobs, artisan commands, and scheduled tasks without complex agent daemons.

Zero Third-Party Leaks

Local agent redaction strips passwords, secrets, and sensitive tokens before telemetry leaves your server.

Quickstart Guide

Installing LaraSignal into your Laravel application takes less than 60 seconds using our open Composer package.

Step 1: Install Package

composer require larasignal/agent

Step 2: Run Interactive Setup

Run the Artisan installer to publish configuration and prompt for your project API key:

php artisan larasignal:install

Or Non-Interactive Setup (CI/CD)

php artisan larasignal:install --key=ls_live_your_key_here --no-interaction

Step 3: Verify Signal Ingestion

php artisan larasignal:test

Ingestion Architecture

The LaraSignal agent buffers telemetry spans in memory and flushes them asynchronously at the end of the request/job lifecycle or via background batch dispatchers, minimizing latency impact on your user HTTP responses.

Default Ingest Endpoint

https://larasignal.com/api/v1/ingest/batches

Custom enterprise deployments can configure custom ingest endpoints by setting LARASIGNAL_INGEST_URL in their .env file.

Environment Configuration

Configure environment parameters in your .env file:

LARASIGNAL_KEY=ls_live_a1b2c3d4e5f6
LARASIGNAL_ENABLED=true
LARASIGNAL_SAMPLE_RATE=1.0
LARASIGNAL_RECORD_QUERIES=true
LARASIGNAL_RECORD_LOGS=true
LARASIGNAL_SLOW_QUERY_THRESHOLD_MS=100

Looking for the Open Agent SDK Reference?

Explore the complete PHP API reference for custom event tracing, performance block measurement, global context scoping, and user tagging.

Read Open Agent Docs →

Privacy & Security

LaraSignal is designed with strict data privacy in mind. Standard sensitive field keys such as password, secret, credit_card, and api_key are automatically obfuscated before payload transmission.

For security disclosures or support questions, reach out directly to hello@larasignal.com.