- 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
2.1 KiB
2.1 KiB
Repo Map
Карта ключевых артефактов репозитория.
Исполняемые файлы
Airflow
airflow/dags/ddl_init_dag.py— инициализация схемы ClickHouseairflow/dags/kafka_load_dag.py— загрузка в Kafka из JSONLairflow/dags/etl_pipeline_dag.py— ETL процесс STG -> ODS -> DDS -> DMairflow/dags/utils/kafka_helpers.py— helper-функции для Kafkaairflow/requirements.txt— зависимости Airflow/ClickHouse plugin
SQL
sql/ddl/00_databases.sql— создание БДstg/ods/dds/dmsql/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— применение DDLscripts/load_kafka_data.sh— загрузка в Kafkascripts/run_batch.sh— batch-процесс
Данные и конфиги
data/*.jsonl— исходные данные (могут быть грязными)configs/— конфиги ClickHouse, Prometheus, Grafanaconfigs/grafana/provisioning/alerting/clickhouse-alert-rules.yml— правила алертинга Grafana для ClickHouse
Документация
README.md— быстрый старт и обзор проектаdocs/ARCHITECTURE.md— техническая архитектураdocs/OPERATIONS.md— запуск, проверки, troubleshootingdocs/DE-task.md— исходное заданиеdocs/COMMIT_RULES.md— правила коммитов
Legacy-планы
plans/clickhouse_ddl.md— исходный план (inline DDL)plans/runbook.md— ранний runbookplans/kafka_ingest_plan.md— ранний план Kafka ingest