feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster #3

mmacanmunhoz · 2024-12-26T00:59:44Z

Added docker-compose.yml file with configuration for:

Jaeger (distributed tracing)
Prometheus (metrics collection)
Alertmanager (alert management)
Grafana (metrics and log visualization)
Loki (log storage)
Added persistent volumes for relevant services.
Initial configuration for all services with ports exposed for easy access.
Suggested infra/docker directory for custom files like prometheus.yml and loki-config.yml.
Add Kind Manifest and Instruction to Install

…er structure

EzzioMoreira · 2025-01-10T12:11:04Z

iac/README.md

+**Portas Explicadas:**
+- `3000`: Interface web do Grafana para criação de dashboards e visualização de dados.
+
+**Ambiente Configurado:**


Acredito que podemos utiliza a env no dockerfile para habilitar o login anonimo do Grafana. Isso evita pequenas confusões para os usuários.

GF_AUTH_ANONYMOUS_ENABLED=true

Ótima sugestão

EzzioMoreira · 2025-01-10T12:12:19Z

iac/README.md

+
+## Volumes Persistentes
+
+Os seguintes volumes são utilizados para armazenar dados de forma persistente:


Por se tratar de um ambiente de teste, acha necessário persistir dados?

Eu acho relevante os seguintes pontos para um ambiente local:

Testes que dependem de dados históricos: Se você precisa testar comportamentos baseados em dados armazenados anteriormente, a persistência é necessária (importante no contexto de logs, métricas e afins).

Validação de integridade de dados: Testar se a aplicação mantém a integridade dos dados após reinicializações ou falhas requer volumes persistentes.

Dado a esses pontos e a capacidade simplista de remover volumes do docker (docker volume prune -f), não vejo o motivo do porque "não manter" volumes persistentes pré definidos, e a facilidade de remoção desses volumes no manifesto do docker compose caso não deseje é simples, porém para atender o ponto que você trouxe e a minha observação, podemos manter as seguintes opções (minha percepção)

Manter um documento de como mapear volumes persistentes ou manter um documento de como remover volumes persistentes.

Acho que ambos são validos e englobaria ambos os cenários e traria facilidade para quem for utilizar

EzzioMoreira · 2025-01-10T12:14:10Z

iac/README.md

+
+## Como Utilizar
+
+1. Certifique-se de ter o Docker e Docker Compose instalados em sua máquina.


Acha interessante adicionar um tópico de pré-requisitos com os links de instalação do docker e docker-compose?
Ex.

### Pré-Requisitos: [Docker](https://docs.docker.com/get-docker/) [Docker Compose](https://docs.docker.com/compose/install/)

Sugiro também colocar os links das documentações de todas as ferramentas utilizadas, através de um tópico de Referências.
Ex:

Referências:

[Docker] (https://docs.docker.com/manuals/)
[Docker Compose] (https://docs.docker.com/compose/)
[Grafana] (https://grafana.com/docs/grafana/latest/)
[Jaeger] (https://www.jaegertracing.io/docs/2.2/)
[Prometheus] (https://prometheus.io/docs/prometheus/latest/configuration/configuration/)
[Loki] (https://grafana.com/docs/loki/latest/)

Pode fazer sentido sim !!

EzzioMoreira · 2025-01-10T12:15:24Z

iac/README.md

+   git clone [email protected]:dosedetelemetria/projeto-otel-na-pratica.git
+   cd iac
+   ```
+3. Suba os serviços com o comando:


Suggested change

3. Suba os serviços com o comando:

3. Inicie os serviços com o comando:

EzzioMoreira · 2025-01-10T12:19:35Z

iac/README.md

+
+## Finalidade de Cada Serviço
+
+- **Jaeger:** Rastreamento distribuído.


Sugestão você pode migrar esse bloco com as descrições para tópico 4,

Suggested change

- **Jaeger:** Rastreamento distribuído.

- [Jaeger:](http://localhost:16686) Rastreamento distribuído.

EzzioMoreira · 2025-01-10T12:21:48Z

iac/docker/docker-compose.yaml

+      - "9093:9093"
+    command:
+      - "--config.file=/etc/alertmanager/alertmanager.yml"
+


Aqui tem uma linha a mais.

Suggested change

Podemos contribuir com um pré commit que faça lint nos arquivos para melhorar espaçamentos e comentários

EzzioMoreira · 2025-01-10T12:23:09Z

iac/docker/docker-compose.yaml

+      - GF_SECURITY_ADMIN_USER=admin 
+      - GF_SECURITY_ADMIN_PASSWORD=admin 


Validar antes.

Suggested change

- GF_SECURITY_ADMIN_USER=admin

- GF_SECURITY_ADMIN_PASSWORD=admin

- GF_AUTH_ANONYMOUS_ENABLED=true

FBarros98 · 2025-01-10T14:23:03Z

iac/README.md

+
+## Como Utilizar
+
+1. Certifique-se de ter o Docker e Docker Compose instalados em sua máquina.


Sugiro também colocar os links das documentações de todas as ferramentas utilizadas, através de um tópico de Referências.
Ex:

Referências:

[Docker] (https://docs.docker.com/manuals/)
[Docker Compose] (https://docs.docker.com/compose/)
[Grafana] (https://grafana.com/docs/grafana/latest/)
[Jaeger] (https://www.jaegertracing.io/docs/2.2/)
[Prometheus] (https://prometheus.io/docs/prometheus/latest/configuration/configuration/)
[Loki] (https://grafana.com/docs/loki/latest/)

FBarros98 · 2025-01-10T14:29:42Z

iac/README.md

+
+Este repositório contém uma stack completa de ferramentas de observabilidade, configurada utilizando o Docker Compose (versão 3.9). Abaixo estão os serviços incluídos e suas respectivas funcionalidades.
+
+## Serviços Disponíveis


Para quem tiver interesse em estudar outras ferramentas, poderia ser interessante utilizar os serviços da Grafana Stack (Loki, Tempo e Mimir).

Pretendo criar os arquivos de configuração para essa stack sugerida e abro um PR posteriormente.

Acho uma boa opção dar visão a mais ferramentas

aloisiobilck · 2025-01-15T15:44:43Z

deployments/README.md

Alguem motivo para remover os manifestos ?

@aloisiobilck eu sugeri uma outra estrutura de pastas, dividindo na pasta docker e k8s, então o README fica dentro do seu respectivo contexto

mmacanmunhoz added 2 commits December 25, 2024 21:53

feat(api): add stack observability in docker compose, and change fold…

81ca0c7

…er structure

feat(api): add kind cluster instruction and manifest

1fe2bd1

mmacanmunhoz changed the title ~~feat(api): Add docker-compose file with observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki)~~ feat(api): Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster Dec 26, 2024

mmacanmunhoz changed the title ~~feat(api): Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster~~ feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster Dec 26, 2024

EzzioMoreira reviewed Jan 10, 2025

View reviewed changes

FBarros98 reviewed Jan 10, 2025

View reviewed changes

aloisiobilck reviewed Jan 15, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster #3

feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster #3

mmacanmunhoz commented Dec 26, 2024 •

edited

Loading

EzzioMoreira Jan 10, 2025

mmacanmunhoz Jan 10, 2025

EzzioMoreira Jan 10, 2025

mmacanmunhoz Jan 10, 2025 •

edited

Loading

EzzioMoreira Jan 10, 2025

FBarros98 Jan 10, 2025

mmacanmunhoz Jan 10, 2025

EzzioMoreira Jan 10, 2025

EzzioMoreira Jan 10, 2025

EzzioMoreira Jan 10, 2025

mmacanmunhoz Jan 10, 2025

EzzioMoreira Jan 10, 2025

FBarros98 Jan 10, 2025

FBarros98 Jan 10, 2025

mmacanmunhoz Jan 10, 2025

aloisiobilck Jan 15, 2025

mmacanmunhoz Jan 21, 2025 •

edited

Loading


		## Volumes Persistentes

		Os seguintes volumes são utilizados para armazenar dados de forma persistente:


		## Como Utilizar

		1. Certifique-se de ter o Docker e Docker Compose instalados em sua máquina.

	3. Suba os serviços com o comando:
	3. Inicie os serviços com o comando:


		## Finalidade de Cada Serviço

		- Jaeger: Rastreamento distribuído.

	- Jaeger: Rastreamento distribuído.
	- [Jaeger:](http://localhost:16686) Rastreamento distribuído.

		- GF_SECURITY_ADMIN_USER=admin
		- GF_SECURITY_ADMIN_PASSWORD=admin

	- GF_SECURITY_ADMIN_USER=admin
	- GF_SECURITY_ADMIN_PASSWORD=admin
	- GF_AUTH_ANONYMOUS_ENABLED=true


		Este repositório contém uma stack completa de ferramentas de observabilidade, configurada utilizando o Docker Compose (versão 3.9). Abaixo estão os serviços incluídos e suas respectivas funcionalidades.

		## Serviços Disponíveis

feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster #3

Are you sure you want to change the base?

feat: Add Iac observability stack (Jaeger, Prometheus, Alertmanager, Grafana and Loki and Configuration Kind Cluster #3

Conversation

mmacanmunhoz commented Dec 26, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mmacanmunhoz Jan 10, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Referências:

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Referências:

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mmacanmunhoz Jan 21, 2025 • edited Loading

Choose a reason for hiding this comment

mmacanmunhoz commented Dec 26, 2024 •

edited

Loading

mmacanmunhoz Jan 10, 2025 •

edited

Loading

mmacanmunhoz Jan 21, 2025 •

edited

Loading