How abdulrahman11a/orderflow-observability works
ShopFlow is an e-commerce API used as an observability lab: clients browse products or submit orders, while the API emits correlated logs, metrics, and traces for investigation in Grafana, Prometheus, Loki, and Jaeger. The order service owns the validation, stock check, payment, and save workflow; payment delay/failure can be injected to demonstrate incidents. The graph follows documented integrations and sampled calls; backend wiring beyond those sources is based on the README architecture.
Main entry points: Program.cs HTTP API · OrderService.cs Order Workflow · ShopFlowTelemetry.cs Custom Telemetry · PaymentService.cs Payment Simulator
Components 16
ShopFlow API
- HTTP API
ShopFlow.Api/Program.cs - Commerce Models
ShopFlow.Api/Models/Models.cs - Order Workflow
ShopFlow.Api/Services/OrderService.cs - Product Catalog
ShopFlow.Api/Services/ProductService.cs - Payment Simulator
ShopFlow.Api/Services/PaymentService.cs
Observability
- Custom Telemetry
ShopFlow.Api/Telemetry/ShopFlowTelemetry.cs
Monitoring Stack
- Jaeger
- Prometheus
- Loki
- Grafana
- Overview Dashboard
grafana/dashboards/shopflow-overview.json - Scrape Config
prometheus.yml - Log Config
loki-config.yml - Datasource Setup
grafana/provisioning/datasources/datasource.yml
Other components
- Client
- k6 Load Client
load-test.js
Connections 19
- Client → HTTP API: sends requests
README.md - k6 Load Client → HTTP API: generates traffic
README.md - HTTP API → Product Catalog: routes product calls
ShopFlow.Api/Program.cs - HTTP API → Order Workflow: routes order creation
ShopFlow.Api/Program.cs - Order Workflow → Product Catalog: reads and updates
ShopFlow.Api/Services/OrderService.cs - Order Workflow → Payment Simulator: charges payment
ShopFlow.Api/Services/OrderService.cs - HTTP API → Custom Telemetry: configures signals
ShopFlow.Api/Program.cs - Order Workflow → Custom Telemetry: records business signals
ShopFlow.Api/Services/OrderService.cs - Payment Simulator → Custom Telemetry: records payment signals
ShopFlow.Api/Services/PaymentService.cs - HTTP API → Jaeger: exports traces
README.md - Prometheus → HTTP API: scrapes metrics
README.md - HTTP API → Loki: ships logs
README.md - Prometheus → Grafana: provides metrics
README.md - Loki → Grafana: provides logs
README.md - Jaeger → Grafana: explored through
README.md - Grafana → Overview Dashboard: loads dashboard
README.md - Scrape Config → Prometheus: configures scraping
README.md - Log Config → Loki: configures storage
- Datasource Setup → Grafana: provisions sources
README.md