sentry/sentry-agent

Sentry Agent for PHP (https://sentry.io)

dev-main 2025-03-26 02:24 UTC

Requires

• php: ^7.2|^8
• clue/mq-react: ^1.6
• react/http: ^1.11
• react/socket: ^1.16
• sentry/sentry: ^4.10

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.70
• phpstan/phpstan: ^2.1

MIT

• Sentry

README

Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us Check out our open positions

Official Sentry Agent for PHP

Caution

The current state of this project is somewhere along the lines of pre-alpha. We strongly recommend you to not run this in production. During the 0.x release cycle, we might introduce breaking changes at any time.

Getting started

Install

Install the agent using Composer.

composer require sentry/sentry-php-agent

Configuration

The agent is configured as a custom HTTP client for the PHP (also Symfony & Laravel) SDKs.

Sentry\init([
    'dsn' => '___PUBLIC_DSN___',
    'http_client' => new Sentry\Agent\Transport\AgentClient(),
]);

Usage

vendor/bin/sentry-agent

Configuration

vendor/bin/sentry-agent [listen_address] [listen_port] [upstream_timeout] [upstream_concurrency] [queue_limit]

• listen_address, defaults to 127.0.0.1
• listen_port, defaults to 5148
• upstream_timeout, defaults to 2.0 seconds
• upstream_concurrency, defaults to 10
• queue_limit, the amount of envelopes to keep in memory, defaults to 1000

License

Licensed under the MIT license, see LICENSE