Last updated Dec 11, 2024

Import components from other apps

You can import components into Compass in bulk from applications that are external to Compass. Bulk import lets you start tracking many components at once, without having to add each component one by one.

You can import components from:

  • Comma-separated values (CSV) files
  • Bitbucket
  • GitHub
  • GitLab
  • New Relic

When you connect a Bitbucket or a GitHub repository, Compass automatically scans the source code management (SCM) app for API documentation. If the scan finds API specificiations in your repository, you can view endpoints on individual component pages.

You can’t import components of the capability, cloud resource, data pipeline, machine learning model, UI element, and website types from a connected app. We're working on adding this feature for components like this.

For now, create the component manually or use the API.

We recommend that you don't exceed 20,000 components in Compass, beyond which you may notice some performance degradation. We are working on scaling the solution to increase the limits over time.

Import components from a CSV file

CSV file import is a quick way to add many components in bulk to Compass.

CSV files contain delimited text that represents tabulated data. Each line in the file is a record and a comma separates each field in that record. Most applications that support tabulated data, for example, Microsoft Excel, OpenOffice, and databases, support CSV files.

The CSV file import process involves:

  1. downloading a sample CSV file from Compass
  2. preparing your data in the CSV file for import
  3. importing the CSV file into Compass

The import process adds new components to Compass and updates existing components that have changed.

Learn how to import components from a CSV file

Import components from Bitbucket

Bitbucket Cloud is a Git-based code hosting and collaboration tool, built for teams.

Compass currently supports Bitbucket Cloud as a tool to:

  • import components from Bitbucket repositories to track them in Compass
  • automate component management from an external tool with config-as-code
  • sync component data, such as deployment activity, from Bitbucket to Compass
  • automatically scan Bitbucket for API documentation and endpoints, which display on relevant component pages

Components are software artifacts such as services, applications, and libraries. They usually live in repositories in source code management tools, such as Bitbucket Cloud. You can create a catalog listing of these components in Compass by importing them from their Bitbucket repositories.

The process to import component from Bitbucket repositories involves:

  1. integrating Compass with Bitbucket Cloud
  2. selecting the repositories to import
  3. optionally, letting Compass set up config-as-code for your components during the import process

Learn how to import components from Bitbucket

Import components from GitHub

GitHub is a Git-based code hosting and collaboration tool, built for teams.

Compass currently supports GitHub as a tool to:

  • import components from GitHub repositories to track them in Compass
  • automate component management from an external tool with config-as-code
  • sync component data, such as deployment activity, from GitHub to Compass
  • automatically scan GitHub for API documentation and endpoints, which display on relevant component pages

Components are software artifacts such as services, applications, and libraries. They usually live in repositories in source code management tools, such as GitHub. You can create a catalog listing of these components in Compass by importing them from their GitHub repositories.

The process to import component from GitHub repositories involves:

  1. integrating Compass with GitHub Cloud
  2. selecting the repositories to import

Learn how to import components from GitHub

Import components from GitLab

GitLab is a web-based Git repository that provides free open and private repositories, issue-following capabilities, and wikis. Compass supports GitLab SaaS but not self-managed.

Compass currently supports GitLab SaaS as a tool to:

  • import components from GitLab projects to track them in Compass
  • automate component management from an external tool with config-as-code
  • sync component data, such as deployment activity, from GitLab to Compass
  • only GitLab.com SaaS/cloud hosted instances are supported, we do not currently support self-managed GitLab instances

Components are software artifacts such as services, applications, and libraries. They usually live in repositories in source code management tools, such as GitLab. You can create a catalog listing of these components in Compass by importing them from their GitLab repositories.

The process to import component from GitLab repositories involves:

  1. integrating Compass with GitLab Cloud
  2. selecting the repositories to import

Learn how to import components from GitLab

Import services from New Relic

New Relic is an observability platform that enables engineering teams to monitor the performance of their deployed software.

If your team uses New Relic for application performance monitoring (APM), you can import your monitored services directly into Compass. This is an easy way to begin building your component catalog in Compass.

The process to integrate and import services from New Relic involves:

  1. installing the New Relic app in Compass
  2. connecting to your New Relic account
  3. importing the New Relic services into Compass
  4. syncing new and updated services from New Relic

Learn how to integrate and import services from New Relic

Rate this page: