Skip to content
Getting started

Nodes & releases

Give each runtime a stable identity and connect events to the deployed code.

What is a node?

A node represents an instrumented application or service, such as a browser frontend, checkout API, or background worker. It connects incoming telemetry to the right environment and repository.

Create and configure a node

  1. Open Nodes and create a node with a name your team recognizes.

  2. Choose its environment and repository where relevant.

  3. Copy the node ID and ingest key into the SDK configuration. Use the HTTPS ingest endpoint for that node's deployment.

  4. Keep the identity stable between releases. Create another node when the workload or operational boundary changes.

Identify the deployed revision

A release is the version of the artifact you shipped. A full commit SHA identifies its source revision. Backend SDKs can read these environment variables at initialization. In browser builds, supply release and commitSha from your build process.

Backend deployment environment
REELAY_RELEASE=checkout@1.8.0
REELAY_COMMIT_SHA=<full-git-commit-sha>

Handle ingest credentials

Keep backend ingest keys in deployment secrets. A browser's configured ingest key is visible to anyone using the app, so treat it as a scoped telemetry credential. Never place GitHub, model-provider, or agent credentials in browser code. Rotate a node's credential when it is no longer appropriate to trust it.