petclinic/docs/index.md

petclinic

Deployed from custom via the Backstage Hello Demo template.

Property	Value
Environment	dev
Namespace	demo-apps
ArgoCD Project	default
Branch	main
Observability	Enabled (OpenTelemetry)

Quick Links

• Repository: https://gitea.kyndemo.live/validate/petclinic

• ArgoCD: https://argocd.kyndemo.live/applications/petclinic

• Live App: https://petclinic.kyndemo.live

• Grafana Dashboard: https://grafana.kyndemo.live/d/otel-app-observability-v2/...?var-app=petclinic

Architecture

This service was scaffolded using the hello-demo Backstage template.

Deployment flow:

1. Source cloned from custom

2. Catalog entity and CI workflows overlaid by Backstage

3. The Watcher scanned the repository and injected OpenTelemetry auto-instrumentation via Kustomize overlay

4. ArgoCD Application created targeting the demo-apps namespace

5. ArgoCD continuously syncs from the main branch

ArgoCD sync path: overlays/otel

Development Workflow

git clone https://gitea.kyndemo.live/validate/petclinic.git
cd petclinic
# make changes, then:
git add . && git commit -m "your change" && git push origin main

ArgoCD monitors the repository and automatically syncs changes to the demo-apps namespace.

Rollback

To roll back to a previous version:

1. Open the ArgoCD UI
2. Click History and Rollback
3. Select the desired revision and click Rollback

Alternatively, revert the commit in Git and push — ArgoCD will auto-sync the rollback.

Observability

This service has OpenTelemetry auto-instrumentation enabled. Traces, metrics, and logs are exported to the OTel Collector and visualised in Grafana.

Viewing telemetry:

• Open the Grafana Dashboard
• Filter by app=petclinic to see service-specific data
• Check the Alerts tab in Backstage for any firing Grafana alerts

OTel Collector endpoint: http://otel-collector.monitoring.svc.cluster.local:4317

SLOs and Monitoring

Define your service level objectives here once the service is stable:

SLI	Target	Dashboard
Availability	99.9%	Grafana
Latency (p99)	< 500ms	Grafana
Error rate	< 1%	Grafana