Quickstart

Packrat takes OpenTelemetry from any SDK, and what Sentry's SDKs and the Datadog Agent already send. There are two ways in. Pick the one that describes your app today.

New apps without monitoring

For applications without existing monitoring installed, we suggest using OpenTelemetry, an open-source framework for collecting and exporting telemetry data. There is no Packrat SDK to install.

Pick your framework for the steps:

Any OpenTelemetry SDK works today, so if your framework is not listed, follow Other and give the SDK the values in What the variables do.

Adding Packrat to an app you already monitor

Your app already sends telemetry somewhere. Start from what is already running, so there is no new library to add to your app.

You already run	What Packrat gets	How
OpenTelemetry, exporting to another vendor	Traces, logs and metrics. The other vendor still gets every one	Add a second exporter
Sentry on the server	Exceptions and every request and job trace. Sentry still gets every one	Add a transport
Sentry in the browser	Page loads, Web Vitals, JavaScript errors and replays. Sentry still gets every one	Send Packrat a copy
The Datadog Agent on your hosts	Traces, logs, exceptions, system metrics and hosts. Datadog still gets every one	Point it at Packrat
Datadog in the browser	Page views, Web Vitals, clicks and JavaScript errors. Datadog still gets every one	Send Packrat a copy

Check it works

Start the app and load a page. The first request reaches your setup screen in about a minute, and it names the service and environment it arrived under.

Run packrat status with your app's name, as <service>/<environment>:

packrat status --app shop/production

The output lists each signal (exceptions, traces, logs, metrics and replays), the sources that send it, when each source last sent, and whether Packrat keeps it. A signal with no source hasn't arrived yet. To see the names your apps report under, run packrat apps.

Not seeing data?

401 from the query endpoint: your key is wrong or has been revoked. Run packrat login again.
Nothing on the setup screen: check that the app has the ingest key, that telemetry is not switched off in the environment you are running, and that the protocol is http/protobuf.