Projects

What a project is

A project is one app you are watching. The frontend and the backend of that app share it, so a click and the request it caused land on the same timeline.

A second app gets a second project. Staging and production can be two projects, or one project with an environment on each event. The environment is a label the SDK sends, such as production or staging. It does not create a new project.

Add the first project

Sign in and open Setup. If the workspace has no project yet, that page asks for a name before anything else.

1. 01

   Name it

   Use the name of the app. You can change which project you are looking at later. You cannot rename it from this screen.

2. 02

   Create the project

   You land on Setup for that project. The first card is the GitHub repository. The install command is under it.

3. 03

   Copy the project key

   The key is on the same page. It is safe in a browser bundle. It can only write events for this project.

Add another project

Open the project menu in the sidebar and choose New project. That is the same name form. After you create it, Setup is for the new project, including its own repository. Connecting a second app does not replace the first.

The project key

Every batch the SDK sends carries the project key, which is how an event is filed under the right app. Frontend and backend of the same app use the same key. Two apps do not.

The key is not a secret for reading data. Anyone with it can write events into the project. They cannot read timelines or run investigations with it.