dcape-app-uptrace

Uptrace application package for dcape.

Upstream

• Project: Uptrace
• Docker: uptrace

Состав

• uptrace - фронтенд трейсов и метрик
• otelcol - коллектор трейсов и метрик
• mailpit - фронтенд почтовых алертов
• clickhouse - хранение метрик и трейсов
• postgresql (в составе dcape) - служебные данные uptrace
• grafana

FQDN

Для домена dev.test дефолтные FQDN сервисов имеют вид:

• ut.dev.test - WWW фронт uptrace
• utg.dev.test - GRPC фронт uptrace
• utotc.dev.test - prometheus фронт otel-collector
• utotcg.dev.test - GRPC фронт otel-collector
• utmail.dev.test - WWW фронт mailpit
• utgraf.dev.test - WWW фронт grafana

Архитектура решения

1. логи и метрики отправляются на заданный эндпоинт otel-collector
2. коллектор получает данные от приложений и своих агентов и отправляет все в uptrace
3. uptrace предоставляет интерфейс к трейсам, логам, метрикам
4. grafana использует метрики utrace в качестве источника данных

Requirements

• linux 64bit with git, make, sed installed
• docker with compose plugin
• dcape v3
• VCS service like Gitea
• CI/CD service like Woodpecker CI

See also

• https://github.com/uptrace/uptrace/tree/master/example/docker

Install

Via CI/CD

• VCS: Fork or mirror this repo in your Git service
• CI/CD: Activate repo
• VCS: "Test delivery", config sample will be saved to config service (enfist in dcape)
• Config: Edit config vars and remove .sample from config name
• VCS: "Test delivery" again (or CI/CD: "Restart") - app will be installed and started on CI/CD host
• After that just change source and do git push - app will be reinstalled and restarted on CI/CD host

Via terminal

Run commands on deploy host with dcape installed:

git clone https://github.com/dopos/dcape-app-uptrace.git
cd dcape-app-uptrace
make config-if
... <edit .env>
make up

License

Copyright 2024 Aleksei Kovrizhkin lekovr+dopos@gmail.com

Licensed under the Apache License, Version 2.0 (the "License");