Quickstart

This section will walk you through a simple example, to quickly give you insights about one of the most important data sources in your organization: your source control systems. You’ll be up and running with 3 simple steps:

1. Connect your source control systems to Faros (we’ll use GitHub as an example)
2. Organize your data
3. Visualize your data

Start Importing Data

1. Navigate to the Sources page
2. Click Add Source. Select the source you want to connect. To narrow down the choices, select a category on the left hand side.
3. Give your source a name and choose how you'll authenticate. Make any changes to the source's configuration (if you'd like) then press Submit!

You can examine logs from the latest sync by navigating to Sources in the navigation panel on the left, and selecting your newly created source. You can also enable/disable the source, edit it, or force a new sync by choosing the appropriate action under the ⋮ icon.

Assign Ownership

Assigning ownership is a way to signal to Faros which boards, repos, etc are of interest to your organization. For now we'll assign the entities we care about to 'all_teams'. Once your team structure exists in Faros you can assign entities to the correct team.

You can assign ownership for up to four Faros entities, depending on which Faros Modules your company is using: Repositories, Boards, Pipelines, Applications.

1. Navigate to one of the ownership pages
2. Select items of interest and click 'Include Selected'
3. When you're done hit the Save button, return to your Sources and select the sync now menu item for the source you're working with. Faros pulls in more detailed data for entities that have been assigned.
4. Repeat with the other entities you have set up!

Refresh Data

1. Remember to re-sync your sources after assigning ownership as described above.
2. Navigate to Settings > Graphs and check when the last dashboard sync. Click the sync button, then monitor the logs to see when the sync has completed.

Inspect Data

At this point it is also possible to inspect your data by building simple dashboards.

1. In the Dashboards menu, navigate to Create > New Question
2. Select Faros Visualization Data as your data then play around with building out a chart

You need to have your organization structure set up in Faros before the pre-created dashboards will work. The next sections of this guide will walk you through organizing your data and give you more detailed information on dashboards.