Files
clickstream-ch-kafka-supers…/docs/REPO_MAP.md
T
ddadmin 5270273d8a feat(monitoring): add Grafana alert rules and fix datasource binding
- Why:
  - dashboard panels could resolve to stale datasource uid and show No data
  - monitoring required proactive alerts for ClickHouse health signals
- What:
  - pin dashboard panels to prometheus_uid and remove datasource templating variable
  - fix PromQL metrics for CPU, inserted rows, and parts panels
  - add provisioning alert rules for failed queries, memory resident, and active parts
  - pin Prometheus datasource uid and update monitoring documentation
- Check:
  - POST /api/admin/provisioning/datasources/reload
  - POST /api/admin/provisioning/dashboards/reload
  - POST /api/admin/provisioning/alerting/reload
  - GET /api/v1/provisioning/alert-rules
2026-02-08 20:49:31 +03:00

2.1 KiB

Repo Map

Карта ключевых артефактов репозитория.

Исполняемые файлы

Airflow

  • airflow/dags/ddl_init_dag.py — инициализация схемы ClickHouse
  • airflow/dags/kafka_load_dag.py — загрузка в Kafka из JSONL
  • airflow/dags/etl_pipeline_dag.py — ETL процесс STG -> ODS -> DDS -> DM
  • airflow/dags/utils/kafka_helpers.py — helper-функции для Kafka
  • airflow/requirements.txt — зависимости Airflow/ClickHouse plugin

SQL

  • sql/ddl/00_databases.sql — создание БД stg/ods/dds/dm
  • sql/ddl/stg/10_stg.sql — STG (Kafka Engine + MV)
  • sql/ddl/ods/20_ods.sql — ODS (типизация + MV для ошибок)
  • sql/ddl/dds/30_dds.sql — DDS (таблицы для batch-загрузки)
  • sql/ddl/dm/40_dm.sql — DM (витрины VIEW)
  • sql/dds/30_ods_to_dds.sql — ODS -> DDS (argMax + JOIN)
  • sql/dm/40_dds_to_dm.sql — обновление dq_summary

Скрипты

  • scripts/apply_clickhouse_ddl.sh — применение DDL
  • scripts/load_kafka_data.sh — загрузка в Kafka
  • scripts/run_batch.sh — batch-процесс

Данные и конфиги

  • data/*.jsonl — исходные данные (могут быть грязными)
  • configs/ — конфиги ClickHouse, Prometheus, Grafana
  • configs/grafana/provisioning/alerting/clickhouse-alert-rules.yml — правила алертинга Grafana для ClickHouse

Документация

  • README.md — быстрый старт и обзор проекта
  • docs/ARCHITECTURE.md — техническая архитектура
  • docs/OPERATIONS.md — запуск, проверки, troubleshooting
  • docs/DE-task.md — исходное задание
  • docs/COMMIT_RULES.md — правила коммитов

Legacy-планы

  • plans/clickhouse_ddl.md — исходный план (inline DDL)
  • plans/runbook.md — ранний runbook
  • plans/kafka_ingest_plan.md — ранний план Kafka ingest