Service Catalog
Purpose
Registry of all services emitting to the platform, with owner and on-call.
| Service | Team | Env(s) | Owner | On-call | SLO? | Status |
|---|---|---|---|---|---|---|
| api-gateway | platform-team | dev/qa/prod | Platform SRE | platform-rotation | yes | onboarded |
| auth-service | platform-team | dev/qa/prod | Service Team Lead | platform-rotation | yes | onboarded |
| billing-service | commerce-team | dev/qa/prod | Service Team Lead | commerce-rotation | yes | onboarded |
| notification-service | commerce-team | dev/qa | Service Team Lead | commerce-rotation | no | onboarded |
| tenant-service | platform-team | dev/qa/prod | Platform SRE | platform-rotation | yes | onboarded |
[stub: service-catalog-rows]— illustrative seed rows. Fill this in with real services. Greppable doc-debt marker.
Source of truth for code-level service metadata is each service’s
component.yamlind-apps/. This catalog is the observability-facing view.
Local graph
Linked from 5 notes
Onboarding Checklist
The definitive checklist for taking a service from zero to fully observable.
1 — Why Software Catalogs Matter
Makes the case for a software catalog as the discoverability, ownership, documentation, and governance backbone of a platform.
Internal Developer Platforms
A book-shaped table of contents for Internal Developer Platforms: IDP fundamentals, architecture, self-service, golden paths, software catalogs, Backstage, templates, platform APIs and automation, developer experience, governance, operations, success metrics, anti-patterns, enterprise scale, and MAANG interview preparation — cross-linking existing platform-engineering-fundamentals/sre/observability notes instead of duplicating them.
Quickstart: Onboard in 30 Minutes
Get a service emitting metrics, logs, and traces to Grafana Cloud in **30 minutes**.
02 — Service Onboarding
Paved-road guides to take a service from zero to fully observable.
Related notes
Engagement Model
How teams engage the platform team — intake, support tiers, and SLAs.
Logs Instrumentation Guide
How to instrument a service for **logs** on the ShipSolid observability platform.
Metrics Instrumentation Guide
How to instrument a service for **metrics** on the ShipSolid observability platform.
Naming & Label Schema
The canonical label and resource-attribute schema every signal must follow.