> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracelit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilities

> Configure environment gates, ingest keys, GitHub repository mapping, and archive for sites and backend services.

**Utilities** is the control plane for each site and each backend service. Open it from the app rail after selecting the asset in the circle selector.

There are three tabs: **Environment**, **Repository**, and **Archive**.

***

## Environment

Environment controls what Tracelit is allowed to do with traffic from each deployment stage.

### Frontend sites

| Environment     | Role                            |
| --------------- | ------------------------------- |
| **Development** | Pre-production frontend traffic |
| **Production**  | Live customer traffic           |

Sites use **one site token** for both environments. Pass `environment: "development"` or `environment: "production"` in the SDK `init(...)` (or script tag). Other values are rejected.

### Backend services

| Environment     | Role                                            |
| --------------- | ----------------------------------------------- |
| **Local**       | Developer machines — usually no auto-resolution |
| **Development** | Shared pre-production                           |
| **Production**  | Live APIs                                       |

You can bind a **per-environment ingest key** (or use the workspace ingest key with `OTEL_SERVICE_NAME` + `deployment.environment`).

Supported `deployment.environment` values: `local`, `development`, `production`.

### Gates

| Gate                         | Effect when enabled                             |
| ---------------------------- | ----------------------------------------------- |
| **Allow incidents**          | New incidents may open from this environment    |
| **Allow resolutions**        | AI resolutions may run for incidents here       |
| **Code analysis** (services) | Resolution may read source for this environment |

Save after changing gates. They apply to new work immediately.

***

## Repository

Link the GitHub repository Tracelit should use for resolutions.

<Steps>
  <Step title="Connect GitHub">
    Settings → Integrations → install the Tracelit GitHub App if you have not already.
  </Step>

  <Step title="Link repository">
    In **Utilities → Repository**, pick a repo the app can access.
  </Step>

  <Step title="Map branches">
    Set **Development** and **Production** branches. Resolutions for those environments read code from the mapped branch.
  </Step>
</Steps>

Unlinking the repository stops new code-backed resolutions until you link again. Historical PRs are unchanged.

See also: [GitHub](/integrations/github) · [GitLab](/integrations/gitlab) · [Bitbucket](/integrations/bitbucket).

***

## Archive

Archive pauses monitoring for the whole commercial unit:

| Asset       | What gets archived                                             |
| ----------- | -------------------------------------------------------------- |
| **Site**    | Development and Production together                            |
| **Service** | Local, Development, and Production under that **service name** |

### What happens when you archive

* Ingest for that site or service name is **rejected** (no new data).
* The asset disappears from the circle selector and frees **one plan slot**.
* Historical sessions, logs, traces, and incidents remain.

### Billing note

Plan limits count **distinct sites** and **distinct service names**. Environments under one service name share a single slot and archive together.

You will see a confirmation modal before archive. You can unarchive later (subject to plan capacity).

***

## Related

| Topic                        | Guide                                           |
| ---------------------------- | ----------------------------------------------- |
| Incident gates in practice   | [Incidents](/agentic/incidents)                 |
| Resolution prerequisites     | [Resolutions](/agentic/resolutions)             |
| Code repository integrations | [Integrations](/integrations/overview)          |
| Backend OTLP setup           | [Telemetry overview](/otel/overview)            |
| Frontend install             | [Installation overview](/installation/overview) |