Services

Services are a named group of resources, environments, repository, and people. It can be dependent (upstream or downstream) on other services. As an example, there may be a “Credit card processing” service that is dependent on a “logging service”.

Create a Service

To add a new service, click on the + Add Service button in the upper right corner of the Services Summary view.

There are four "types" of services you can create:

• Standard Service: This is a service that is connected to a repo that you "own".

• Monorepo Service: This is a service that is in a subdirectory of repo that you "own".

• External Service: This is a service where you are not owners of the code repo (maybe it's another group within your company or a 3rd party service)

• General Item: This is a generic item that you can use for anything that provides a service into your infrastructure. We kept it wide open to fit the many needs of our customers. You could make it a person or outside consulting group (just some of the ideas our customers have had).

Standard Service

Select Standard Service on the top and then complete the necessary information below. You will be required to select a Repository that you have already set up the credentials for. (See Credentials section for more information on how to do that.) Click on Create once complete.

Monorepo Service

Select Monorepo Service on the top and then complete the necessary information below. Select a repo that has already been configured and then you will see a drop down field that allows you to select the subdirectory of that repo that has package information. You can select one of these subdirectories or type in the path if it is not listed. Fill out the rest of the information and click on Create once complete.

If your source control provider is Github, in order for sub-directories to show up automatically, you will need to enable Dependencies for your repository. You can do this in your Github account, by navigating to your project > Insights > Dependency graph > Allow access

External Service

Select External Service on the top and then complete the necessary information below. (NB You will not be asked to provide a repo of the source code and you will not be able to see any package information on the service detail page as you would for a repository you owned). Click on Create once complete.

General Item

Select General Item on the top and then complete the necessary information below. Click on Create once complete.

Working with Services

To view a list of all your services, select Catalog on the top line menu then Services.

In this table you can see a summary of all relevant information about your service:

• Name

• Owners

• Applications

• Environments

• Accrued Costs

• Prior Period Costs

• % Change (in costs)

• Open PRs

• Scorecards

• Lifecycle

• On-call

• Incidents P1

• Incidents P2

• Incidents P3

• Incidents P4

• Incidents P5

You can display or hide columns in the Columns selector:

You can use the Filters button to filters values among all service table columns:

Viewing a Service

If you click on the name of the service, you will open the service detail page. This page's view will depend on the plug-ins you have installed for that particular service. To see how to install a plug-in, check out our Plug-in section. You can also see a visual representation of your service.

The CI/CD tab shows you your CI and CD pipelines for this service, if you have configured the plugin in the service page:

The Environments tab for each service, shows you the different environments for that service. To learn more about how environments work, check out our Environments section.

Adding a Dependency

The Dependencies tab, shows you all the upstream and downstream services connected to this service.

To add a Dependency, click on + Add Dependencies in the upper right corner. Then select whether it is upstream or downstream and then select the service to add.

Enabling Packages

To see the Packages pulled from the repository, click on the Packages tab.

If your source control provider is Github, in order for install dependencies to show up automatically, you will need to enable Dependencies for your repository. You can do this in your Github account, by navigating to your project > Insights > Dependency graph > Allow access

Editing a Service

To delete a Service, you can select Delete on the Service table Actions (...) or under the Actions menu on the Service Detail page.

Use the right lateral menu to edit general service information:

• Owners

• Visibility Control (see RBAC)

• Viewers

• Tags

• Applications

• Description

• Repository

• Metadata

  • Auto Map

  • Text

  • Link

  • JSON

  • Nickname

• Links

  • API

  • Dashboard

  • Diagram

  • Documentation

  • Health Check

  • Logs

  • Metrics

  • Other

  • Runbook