# OpenTelemetry Demo Chart

LLMS index: [llms.txt](/llms.txt)

---

A [Demo do OpenTelemetry](/docs/demo/) é um sistema distribuído baseado em
microsserviços, criado para ilustrar a implementação do OpenTelemetry em um
ambiente próximo ao real. Como parte desse esforço, a comunidade OpenTelemetry
criou o
[OpenTelemetry Demo Helm Chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-demo)
para que possa ser facilmente instalado no Kubernetes.

## Configuração

O arquivo `values.yaml` padrão do chart do Demo está pronto para ser instalado.
Todos os componentes tiveram seus limites de memória ajustados para otimizar o
desempenho, o que pode causar problemas caso seu _cluster_ não seja grande o
suficiente. A instalação completa é limitada a aproximadamente 4 Gigabytes de
memória, mas pode utilizar menos.

Todas as opções de configuração (com comentários) disponíveis no chart podem ser
visualizadas no
[arquivo `values.yaml`](https://github.com/open-telemetry/opentelemetry-helm-charts/blob/main/charts/opentelemetry-demo/values.yaml),
e descrições detalhadas podem ser encontradas no
[README do chart](https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-demo#chart-parameters).

## Instalação

Adicione o repositório Helm do OpenTelemetry:

```shell
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
```

Para instalar o chart com o nome de _release_ `my-otel-demo`, execute o seguinte
comando:

```sh
helm install my-otel-demo open-telemetry/opentelemetry-demo
```

Após a instalação, todos os serviços ficam disponíveis via frontend proxy
(<http://localhost:8080>) ao executar estes comandos:

```sh
kubectl port-forward svc/my-otel-demo-frontendproxy 8080:8080
```

Após expor o proxy, também é possível acessar os seguintes caminhos:

| Componente        | Caminho                           |
| ----------------- | --------------------------------- |
| Web store         | <http://localhost:8080>           |
| Grafana           | <http://localhost:8080/grafana>   |
| Feature Flags UI  | <http://localhost:8080/feature>   |
| Load Generator UI | <http://localhost:8080/loadgen>   |
| Jaeger UI         | <http://localhost:8080/jaeger/ui> |

Para que os trechos (_spans_) provenientes da loja virtual sejam coletados, é
necessário expor o Receiver OTLP/HTTP do OpenTelemetry Collector:

```sh
kubectl port-forward svc/my-otel-demo-otelcol 4318:4318
```

Para mais detalhes sobre o uso da Demo no Kubernetes, consulte
[Implantação no Kubernetes](/docs/demo/kubernetes-deployment/).