KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

otel-shopping-cart

★ 97 Open GitHub ↗

Sample application illustrating multiple aspects of observability with OpenTelemetry

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenTelemetry shopping cart application

Sample application to highlight distributed tracing and other aspects with [OpenTelemetry](https://opentelemetry.io/) including:

* Microservices
* Traffic generator
* Quality of service interruptor
* Traces, metrics, and logs all through OpenTelemetry
* A variety of observability backends for consumption

## Why?

OpenTelemetry can be thought of as observability middleware:

![Middleware](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/why_overview.png)

These three "layers" can be considered a full implementation. This repo aims at providing all of them (the microservices applications, the OpenTelemetry implementation, and observability backends).

Instead of taking an opinionated approach on what observability backends should be included, this ships multiple:

* Metrics - Prometheus
* Traces - Jaeger and Grafana Tempo
* Logs - Elasticsearch and Grafana Loki

## Usage

There are a few ways to "use" this repository...

### Everything running local in a new kind cluster

```bash
make run-local
```

### Everything in an existing cluster

```bash
make install-tools-and-app
```

### Just the sample application

```bash
make install-app
```

### Just the observability tools

```bash
make install-tools
```

## Viewing telemetry

### Traces

#### Jaeger

```bash
$ make port-forward-jaeger
```

![Jaeger](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/traces_jaeger.png)

#### Tempo

```bash
$ make port-forward-grafana
```

![Tempo](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/traces_tempo.png)

### Metrics

```bash
$ make port-forward-grafana
```

![Prometheus](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/metrics_prometheus.png)

### Logs

#### Elasticsearch

```bash
$ make port-forward-kibana
```

![Elasticsearch](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/logs_elasticsearch.png)

#### Loki

```bash
$ make port-forward-grafana
```

![Loki](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/logs_loki.png)

## Cleanup

To cleanup the local environment:

```
$ make stop-local
```

## Application design

![Application design](https://raw.githubusercontent.com/trstringer/otel-shopping-cart/main/images/otel-shopping-cart-design.png)

There are three services in this application:

* **Cart** - Service handling user requests for shopping cart data (written in Go)
* **User** - Handles user verification and lookup requests from the cart service (written in Go)
* **Price** - Serves update pricing information for products (written in Python)

The backend persistent application data storage is with **PostgreSQL**.

Instrumentation is entirely with OpenTelemetry's APIs and SDKs. Telemetry collection is achieved through the [OpenTelemetry Collector](https://github.com/open-telemetry/opentelemetry-collector) sending trace data to Jaeger.

otel-shopping-cart

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README