# avizway1/awar06-otel architecture

> Architecture diagram of the GitHub repository avizway1/awar06-otel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/avizway1/awar06-otel
- Repository: https://github.com/avizway1/awar06-otel

## Overview

This repository packages the OpenTelemetry Astronomy Shop and its observability stack as a Kubernetes manifest. The main user workflow is browser or synthetic traffic through the Envoy proxy to the storefront and its commerce services; checkout coordinates order-related services and Kafka events. Separately, application telemetry and infrastructure signals flow through the Collector to trace, metric, and log backends, which Grafana queries. The README documents these relationships; the sampled source does not expose the manifest’s individual resource definitions, so component paths point to the consolidated manifest.

Main entry points: [`opentelemetry-demo.yaml`](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml) (Frontend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Traffic Entry"]
  node_loadgen["Load Generator"]
  node_proxy["Frontend Proxy"]
  node_frontend["Frontend"]
  node_images["Image Provider"]
end

subgraph group_commerce["Commerce Services"]
  node_ads["Ad Service"]
  node_cart["Cart Service"]
  node_checkout["Checkout Service"]
  node_currency["Currency Service"]
  node_email["Email Service"]
  node_payment["Payment Service"]
  node_catalog["Product Catalog"]
  node_quote["Quote Service"]
  node_recommendation["Recommendation"]
  node_shipping["Shipping Service"]
end

subgraph group_events["Events and Data"]
  node_kafka["Kafka"]
  node_accounting["Accounting"]
  node_fraud["Fraud Detection"]
  node_valkey[("Valkey Cart")]
  node_postgres[("PostgreSQL")]
  node_flagd["Feature Flags"]
end

subgraph group_pipeline["Telemetry Pipeline"]
  node_collector["OTel Collector"]
  node_processors{{"Processors"}}
end

subgraph group_backends["Observability Backends"]
  node_jaeger[("Jaeger")]
  node_prometheus[("Prometheus")]
  node_opensearch[("OpenSearch")]
  node_grafana["Grafana"]
end

node_browser(("Browser"))

node_browser -->|"requests"| node_proxy
node_loadgen -->|"generates traffic"| node_proxy
node_proxy -->|"routes to"| node_frontend
node_frontend -->|"loads images"| node_images
node_frontend -->|"calls"| node_ads
node_frontend -->|"calls"| node_cart
node_frontend -->|"calls"| node_checkout
node_frontend -->|"calls"| node_currency
node_frontend -->|"calls"| node_catalog
node_frontend -->|"calls"| node_recommendation
node_frontend -->|"calls"| node_shipping
node_checkout -->|"calls"| node_payment
node_checkout -->|"calls"| node_email
node_checkout -->|"calls"| node_quote
node_checkout -->|"publishes events"| node_kafka
node_checkout -->|"uses"| node_postgres
node_cart -->|"stores cart"| node_valkey
node_accounting -->|"consumes"| node_kafka
node_fraud -->|"consumes"| node_kafka
node_catalog -->|"evaluates flags"| node_flagd
node_payment -->|"evaluates flags"| node_flagd
node_frontend -.->|"exports telemetry"| node_collector
node_ads -.->|"exports telemetry"| node_collector
node_cart -.->|"exports telemetry"| node_collector
node_checkout -.->|"exports telemetry"| node_collector
node_payment -.->|"exports telemetry"| node_collector
node_catalog -.->|"exports telemetry"| node_collector
node_collector -->|"processes signals"| node_processors
node_processors -->|"exports traces"| node_jaeger
node_processors -->|"exports metrics"| node_prometheus
node_processors -->|"exports logs"| node_opensearch
node_prometheus -->|"queried by"| node_grafana
node_jaeger -->|"queried by"| node_grafana
node_opensearch -->|"queried by"| node_grafana

click node_loadgen "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_proxy "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_frontend "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_images "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_ads "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_cart "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_checkout "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_currency "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_email "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_payment "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_catalog "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_quote "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_recommendation "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_shipping "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_kafka "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_accounting "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_fraud "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_valkey "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_postgres "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_flagd "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_collector "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_processors "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_jaeger "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_prometheus "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_opensearch "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"
click node_grafana "https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_loadgen,node_proxy,node_frontend,node_images,node_browser toneBlue
class node_ads,node_cart,node_checkout,node_currency,node_email,node_payment,node_catalog,node_quote,node_recommendation,node_shipping toneAmber
class node_kafka,node_accounting,node_fraud,node_valkey,node_postgres,node_flagd toneMint
class node_collector,node_processors toneRose
class node_jaeger,node_prometheus,node_opensearch,node_grafana toneIndigo
```

## Components

### Traffic Entry

- [Load Generator](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Frontend Proxy](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Frontend](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Image Provider](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`

### Commerce Services

- [Ad Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Cart Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Checkout Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Currency Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Email Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Payment Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Product Catalog](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Quote Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Recommendation](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Shipping Service](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`

### Events and Data

- [Kafka](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Accounting](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Fraud Detection](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Valkey Cart](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [PostgreSQL](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Feature Flags](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`

### Telemetry Pipeline

- [OTel Collector](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Processors](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`

### Observability Backends

- [Jaeger](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Prometheus](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [OpenSearch](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`
- [Grafana](https://github.com/avizway1/awar06-otel/blob/main/opentelemetry-demo.yaml): `opentelemetry-demo.yaml`

### Other components

- **Browser**

## Connections

- Browser → Frontend Proxy: requests (evidence: `README.md`)
- Load Generator → Frontend Proxy: generates traffic (evidence: `README.md`)
- Frontend Proxy → Frontend: routes to (evidence: `README.md`)
- Frontend → Image Provider: loads images (evidence: `README.md`)
- Frontend → Ad Service: calls (evidence: `README.md`)
- Frontend → Cart Service: calls (evidence: `README.md`)
- Frontend → Checkout Service: calls (evidence: `README.md`)
- Frontend → Currency Service: calls (evidence: `README.md`)
- Frontend → Product Catalog: calls (evidence: `README.md`)
- Frontend → Recommendation: calls (evidence: `README.md`)
- Frontend → Shipping Service: calls (evidence: `README.md`)
- Checkout Service → Payment Service: calls (evidence: `README.md`)
- Checkout Service → Email Service: calls (evidence: `README.md`)
- Checkout Service → Quote Service: calls (evidence: `README.md`)
- Checkout Service → Kafka: publishes events (evidence: `README.md`)
- Checkout Service → PostgreSQL: uses (evidence: `README.md`)
- Cart Service → Valkey Cart: stores cart (evidence: `README.md`)
- Accounting → Kafka: consumes (evidence: `README.md`)
- Fraud Detection → Kafka: consumes (evidence: `README.md`)
- Product Catalog → Feature Flags: evaluates flags (evidence: `README.md`)
- Payment Service → Feature Flags: evaluates flags (evidence: `README.md`)
- Frontend → OTel Collector: exports telemetry (evidence: `README.md`)
- Ad Service → OTel Collector: exports telemetry (evidence: `README.md`)
- Cart Service → OTel Collector: exports telemetry (evidence: `README.md`)
- Checkout Service → OTel Collector: exports telemetry (evidence: `README.md`)
- Payment Service → OTel Collector: exports telemetry (evidence: `README.md`)
- Product Catalog → OTel Collector: exports telemetry (evidence: `README.md`)
- OTel Collector → Processors: processes signals (evidence: `README.md`)
- Processors → Jaeger: exports traces (evidence: `README.md`)
- Processors → Prometheus: exports metrics (evidence: `README.md`)
- Processors → OpenSearch: exports logs (evidence: `README.md`)
- Prometheus → Grafana: queried by (evidence: `README.md`)
- Jaeger → Grafana: queried by (evidence: `README.md`)
- OpenSearch → Grafana: queried by (evidence: `README.md`)
