Environments

Separate local, test, staging, and production evidence without losing provenance.

Set the environment on the SDK client or pass it per request.

const lodger = new Lodger({
  apiKey: process.env.LODGER_API_KEY!,
  workspaceId: process.env.LODGER_WORKSPACE_ID!,
  projectId: "core",
  environment: process.env.NODE_ENV,
  server: process.env.HOSTNAME,
})

Lodger stores environment and server hints inside event provenance. Reviewers can tell whether a record came from production, staging, CI, or a local build.

Project boundaries

Use separate projects when retention, visibility, or evidence ownership differs. Use environment provenance when the same project receives events from multiple deployments.

Developer tier

Developer workspaces are for local builds, CI, and test projects. They are not for production evidence. Exports from Developer workspaces are watermarked.

Production

Production integrations should use scoped API keys, stable event catalogs, and request context headers.