Create projects for your environments

You can have several projects in Cloud Observability. For example, you might have one project for your development environment and one for production. Or you may have projects for different areas of your application while they’re in development.

Many things in Cloud Observability are project-specific, meaning they apply only to the project and don’t apply to everything in an Enterprise’s account. The following are specific to projects:

  • Access Tokens: Tracers use access tokens to send data to your Microsatellites.
  • Workflow links: Workflow links allow you to add links to the Trace view to information you may need while resolving an incident.
  • Deployment Markers: When you use an instrumentation attribute to denote deployments to an environment, Cloud Observability allows you to see how your deployments may have affected performance in your system.
  • Metric details: You can view all metrics reporting to this project. Click on a metric to add or edit its details.

    When you add or change a metric’s details, you can choose to apply those changes to all projects.

  • Service name attribute for metric data: Cloud Observability’s correlation feature uses a service name tag in your metric data to map that data to your trace data and find components in your system whose performance changed at the same time as a metric change.
  • Instrumentation Quality Score: Cloud Observability analyzes the instrumentation on your services and provides a score to let you know where your instrumentation might need improvement. The better your instrumentation, the better Cloud Observability can help you find and mitigate issues. To ensure that all your services use the specific attributes needed by your system, you can register custom and environment attributes with Cloud Observability. If these are missing from a service, Cloud Observability will report it and provide the code needed to add it to your service.
  • Inferred Services: When you use attributes to mark requests going to external services (like a database), Cloud Observability can report on the performance of those services.
  • Microsatellites: Microsatellites collect the span data sent from your tracers. You can enforce a project to only accept data from your on-premise Microsatellites. This can be helpful for projects that are for a production environment.

    Cloud Observability recommends having a separate project for each environment (for example, prod and dev), and then using single-project mode on your Microsatellites to create a dedicated pool for each project. Doing so also avoids having to send access tokens from your tracers.

  • Data retention policy: Determine how long your span data lives in Cloud Observability. By default, data is saved for 28 days. Depending on your Cloud Observability plan, you can increase that time to match your company’s data retention policy by up to 2 years.

Access a project

To load the data and settings for a project, click Project in the navigation bar and select your project.

Create a project

Follow these steps to create a project in Cloud Observability:

  1. In Cloud Observability, click Account management > Projects and users.
  2. Click Create new project.
  3. In the dialog, enter a name for the project and click Confirm to create your project.

    Cloud Observability displays Your new project is being created. This could take up to five minutes. Your project appears in the Projects tab when it’s ready.

Adjust project settings

Manage a project’s settings in Project settings. The Project settings page lets you manage Access tokens, Workflow links, metric details, and more.

Follow these steps to access Project settings:

  1. In Cloud Observability, click Project and select your project.
  2. In the same sidebar, click Project settings. Access project settings

Delete a project

Follow these steps to delete a project:

  1. In Cloud Observability, click Account management > Projects and users.
  2. Find your project and click ⋮ > Delete.
  3. In the dialog, enter your project name and click Delete <project name> from <organization name>.

    Cloud Observability displays <project name> was deleted.

Updated Aug 23, 2023