Get started

Use this guide for the first setup. By the end, you will have one organization, one project, one project key, and one session you can review in TraceFast.

Create your first project

Start in the TraceFast app and create the project that will receive your traces.

1. Sign in to TraceFast, or create a new account.
2. On the onboarding screen, enter an organization name.
3. Enter a project name.
4. Open the new project after TraceFast finishes setup.

If you already own an organization, TraceFast skips the organization step. If your organization already has a project, TraceFast sends you straight to the dashboard.

Create a project key

Create one project key before you connect your exporter.

1. Open Projects.
2. Open the project you just created.
3. Open Settings.
4. Open API keys.
5. Enter a label for the key, then select Generate key.
6. Copy the key right away. TraceFast shows the full key only once.

Use this key only for sending traces to the collector.

Use the hosted collector address

TraceFast accepts OTLP over HTTP and OTLP over gRPC. If you are using the hosted app, send traces to the hosted collector.

• OTLP HTTP hosted: https://collector.tracefast.dev/v1/traces
• OTLP gRPC hosted: collector.tracefast.dev:4317

Choose the names you want to see

Pick clear names before you send your first trace so the session is easy to find in TraceFast.

• Set service.name to the name you want to see in TraceFast, such as hotel-interview-agent.
• Set deployment.environment.name to a clear environment name, such as development, staging, or production.

Send one traced run

Start with one real request, job, or conversation before you connect more of your system.

1. Point your OTLP exporter at the TraceFast collector.
2. Send the project key in the x-tracefast-api-key header.
3. Set service.name and deployment.environment.name.
4. Run one real request, job, or conversation.

Check the first run

Use the app surface to confirm the first trace landed where you expect.

1. Open the project dashboard, and confirm the project is receiving activity.
2. Open Sessions.
3. Find the new session by time, trace ID, session key, or preview text.
4. Open the session, and review the conversation timeline, raw trace, issues, and cost tabs.
5. If the cost tab shows unmatched models, add a pricing override in Settings.

Next steps

Read Connect your traces for the full OTLP HTTP and OTLP gRPC setup, including a concrete LiveKit example.