email 전송 기능 추가

.env.example

@@ -1,7 +1,12 @@
-# Grafana 설정
+# .env.example
-GRAFANA_URL=http://localhost:3000
+GRAFANA_URL=
 GRAFANA_API_KEY=
+MATTERMOST_WEBHOOK=
 GRAFANA_DASHBOARD_UID=
 
-# Mattermost 설정 (리포트 전송용)
+# Email settings
-MATTERMOST_WEBHOOK=
+SMTP_HOST=
+SMTP_PORT=587
+SMTP_USER=
+SMTP_PASSWORD=
+EMAIL_RECIPIENTS=b24053@hanmaceng.co.kr

.gitea/workflows/main.yml

@@ -35,7 +35,7 @@ jobs:
           GRAFANA_DASHBOARD_UID: ${{ vars.GRAFANA_DASHBOARD_UID }}
         run: |
           set -euo pipefail
-          if [ "$(date -u +%u)" -eq 1 ]; then
+          if [ "$(TZ=Asia/Seoul date +%u)" -eq 1 ]; then
             bash ./run_table.sh 7d
           else
             bash ./run_table.sh 24h

requirements.txt

@@ -1,2 +1,3 @@
 requests
 python-dotenv
+markdown

src/report_table.py

@@ -1,169 +1,184 @@
-import argparse
+import argparse
-import logging
+import logging
-import re
+import re
-from datetime import timedelta
+from datetime import timedelta
-from typing import Dict, List, Tuple
+from typing import Dict, List, Tuple
-
+
-from clients.grafana_client import GrafanaClient
+from clients.grafana_client import GrafanaClient
-from clients.loki import is_loki
+from clients.loki import is_loki
-from services.dashboard import (
+from services.dashboard import (
-    extract_targets,
+    extract_targets,
-    flatten_panels,
+    flatten_panels,
-    panel_datasource_resolver,
+    panel_datasource_resolver,
-)
+)
-from services.reporter import post_mattermost
+from services.reporter import post_mattermost, send_email
-from services.summarizer import compute_total_for_target
+from services.summarizer import compute_total_for_target
-from setting.config import AppConfig
+from setting.config import AppConfig
-from utils.timeutils import now_kst, step_for_range, to_epoch
+from utils.timeutils import now_kst, step_for_range, to_epoch
-
+
-logging.basicConfig(level=logging.INFO, format="%(message)s")
+logging.basicConfig(level=logging.INFO, format="%(message)s")
-logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
-
+
-
+
-def parse_args():
+def parse_args():
-    p = argparse.ArgumentParser()
+    p = argparse.ArgumentParser()
-    p.add_argument("--range", choices=["7d", "24h", "1d"], required=True)
+    p.add_argument("--range", choices=["7d", "24h", "1d"], required=True)
-    return p.parse_args()
+    return p.parse_args()
-
+
-
+
-# ✅ 추가: compute_total_for_target 가 반환한 문자열에서 total 값만 추출
+# ✅ 추가: compute_total_for_target 가 반환한 문자열에서 total 값만 추출
-_TOTAL_RX = re.compile(r"total\s+\*\*([^*]+)\*\*", re.IGNORECASE)
+_TOTAL_RX = re.compile(r"total\s+\*\*([^*]+)\*\*", re.IGNORECASE)
-
+
-
+
-def _parse_total_str(line: str) -> str | None:
+def _parse_total_str(line: str) -> str | None:
-    """
+    """
-    '  - `legend` (loki) → total **123**' 형태에서 123만 추출.
+    '  - `legend` (loki) → total **123**' 형태에서 123만 추출.
-    실패 시 None
+    실패 시 None
-    """
+    """
-    if not line:
+    if not line:
-        return None
+        return None
-    m = _TOTAL_RX.search(line)
+    m = _TOTAL_RX.search(line)
-    return m.group(1).strip() if m else None
+    return m.group(1).strip() if m else None
-
+
-
+
-# ✅ 추가: 마크다운 테이블에서 안전하게 보이도록 간단 이스케이프
+# ✅ 추가: 마크다운 테이블에서 안전하게 보이도록 간단 이스케이프
-def _md_escape(s: str) -> str:
+def _md_escape(s: str) -> str:
-    return (s or "").replace("|", r"\|").replace("\n", " ")
+    return (s or "").replace("|", r"\|").replace("\n", " ")
-
+
-
+
-def main():
+def main():
-    args = parse_args()
+    args = parse_args()
-    cfg = AppConfig.load()  # env에서 URL, API KEY, 대시보드 UID, 웹훅
+    cfg = AppConfig.load()  # env에서 URL, API KEY, 대시보드 UID, 웹훅
-    gf = GrafanaClient(cfg.grafana_url, cfg.grafana_api_key)  # Grafana REST 호출용
+    gf = GrafanaClient(cfg.grafana_url, cfg.grafana_api_key)  # Grafana REST 호출용
-
+
-    # 시간 범위 설정
+    # 시간 범위 설정
-    now = now_kst()
+    now = now_kst()
-    if args.range in ("24h", "1d"):
+    if args.range in ("24h", "1d"):
-        start = now - timedelta(days=1)
+        start = now - timedelta(days=1)
-        range_label = "지난 24시간"
+        range_label = "지난 24시간"
-        step = 3600  # 1시간 - Interval
+        step = 3600  # 1시간 - Interval
-    else:
+    else:
-        start = now - timedelta(days=7)
+        start = now - timedelta(days=7)
-        range_label = "지난 7일"
+        range_label = "지난 7일"
-        step = 21600  # 6시간 - Interval
+        step = 21600  # 6시간 - Interval
-
+
-    start_epoch, end_epoch = to_epoch(start), to_epoch(now)
+    start_epoch, end_epoch = to_epoch(start), to_epoch(now)
-    step = step_for_range(end_epoch - start_epoch)
+    step = step_for_range(end_epoch - start_epoch)
-
+
-    # 대시보드에서 패널 추출
+    # 대시보드에서 패널 추출
-    dash = gf.get_dashboard_by_uid(cfg.grafana_dashboard_uid)
+    dash = gf.get_dashboard_by_uid(cfg.grafana_dashboard_uid)
-    panels = flatten_panels(dash)
+    panels = flatten_panels(dash)
-
+
-    skipped: List[str] = []
+    skipped: List[str] = []
-    all_ds = gf.list_datasources()
+    all_ds = gf.list_datasources()
-
+
-    grouped: Dict[str, List[Tuple[str, str]]] = {}
+    grouped: Dict[str, List[Tuple[str, str]]] = {}
-
+
-    # 모든 패널 순회
+    # 모든 패널 순회
-    for p in panels:
+    for p in panels:
-        title = p.get("title") or "(제목 없음)"
+        title = p.get("title") or "(제목 없음)"
-        # 패널에 연결된 데이터소스 해석
+        # 패널에 연결된 데이터소스 해석
-        ds = panel_datasource_resolver(p, gf.get_datasource_by_uid, lambda: all_ds)
+        ds = panel_datasource_resolver(p, gf.get_datasource_by_uid, lambda: all_ds)
-
+
-        if not ds or ds.get("id") is None:
+        if not ds or ds.get("id") is None:
-            skipped.append(f"- `{title}` (데이터소스 없음)")
+            skipped.append(f"- `{title}` (데이터소스 없음)")
-            continue
+            continue
-
+
-        # Loki 데이터소스가 아니면 건너뜀 (Prometheus 패널 제외)
+        # Loki 데이터소스가 아니면 건너뜀 (Prometheus 패널 제외)
-        if not is_loki(ds):
+        if not is_loki(ds):
-            continue
+            continue
-
+
-        # 패널에 정의된 쿼리(target) 추출 (expr + legend)
+        # 패널에 정의된 쿼리(target) 추출 (expr + legend)
-        targets = extract_targets(p)
+        targets = extract_targets(p)
-        if not targets:
+        if not targets:
-            skipped.append(f"- `{title}` (쿼리 없음)")
+            skipped.append(f"- `{title}` (쿼리 없음)")
-            continue
+            continue
-
+
-        # 각 target 쿼리(expr) 순회
+        # 각 target 쿼리(expr) 순회
-        for t in targets:
+        for t in targets:
-            expr = t["expr"]
+            expr = t["expr"]
-            legend = t["legend"] or ""
+            legend = t["legend"] or ""
-
+
-            try:
+            try:
-                # Loki 쿼리를 실행해 total 합계 계산 (문자열)
+                # Loki 쿼리를 실행해 total 합계 계산 (문자열)
-                line = compute_total_for_target(
+                line = compute_total_for_target(
-                    ds=ds,
+                    ds=ds,
-                    ds_id=ds["id"],
+                    ds_id=ds["id"],
-                    legend=legend,
+                    legend=legend,
-                    expr=expr,
+                    expr=expr,
-                    start_epoch=start_epoch,
+                    start_epoch=start_epoch,
-                    end_epoch=end_epoch,
+                    end_epoch=end_epoch,
-                    step_sec=step,
+                    step_sec=step,
-                    # prom_query_range_fn=gf.prom_query_range,
+                    # prom_query_range_fn=gf.prom_query_range,
-                    loki_query_range_fn=gf.loki_query_range,
+                    loki_query_range_fn=gf.loki_query_range,
-                )
+                )
-                if not line:
+                if not line:
-                    continue
+                    continue
-
+
-                # ✅ total **...** 파싱해서 테이블 행으로 적재
+                # ✅ total **...** 파싱해서 테이블 행으로 적재
-                total_str = _parse_total_str(line)
+                total_str = _parse_total_str(line)
-                if total_str is not None:
+                if total_str is not None:
-                    grouped.setdefault(title, []).append(
+                    grouped.setdefault(title, []).append(
-                        (_md_escape(legend or "(no legend)"), total_str)
+                        (_md_escape(legend or "(no legend)"), total_str)
-                    )
+                    )
-                else:
+                else:
-                    # total 추출 실패한 경우 스킵 목록에 상세 기록
+                    # total 추출 실패한 경우 스킵 목록에 상세 기록
-                    skipped.append(
+                    skipped.append(
-                        f"- `{title}` / `{legend}`: total 파싱 실패 → {line}"
+                        f"- `{title}` / `{legend}`: total 파싱 실패 → {line}"
-                    )
+                    )
-
+
-            except Exception as e:
+            except Exception as e:
-                skipped.append(f"- `{title}` / `{legend}`: 오류 - {e}")
+                skipped.append(f"- `{title}` / `{legend}`: 오류 - {e}")
-
+
-    # ✅ Mattermost 메시지 본문 구성
+    # ✅ Mattermost 메시지 본문 구성
-    lines: List[str] = []
+    lines: List[str] = []
-    lines.append(
+    lines.append(
-        f"**LLM Gateway Unified Monitoring 요약**  \n기간: {range_label} "
+        f"**LLM Gateway Unified Monitoring 요약**  \n기간: {range_label} "
-        f"({start.strftime('%Y-%m-%d %H:%M')} ~ {now.strftime('%Y-%m-%d %H:%M')} KST)"
+        f"({start.strftime('%Y-%m-%d %H:%M')} ~ {now.strftime('%Y-%m-%d %H:%M')} KST)"
-    )
+    )
-    lines.append("")
+    lines.append("")
-
+
-    if grouped:
+    if grouped:
-        # 발견된 순서를 유지(파이썬 3.7+ dict는 삽입순서 유지)
+        # 발견된 순서를 유지(파이썬 3.7+ dict는 삽입순서 유지)
-        for panel_title, rows in grouped.items():
+        for panel_title, rows in grouped.items():
-            if not rows:
+            if not rows:
-                continue
+                continue
-
+
-            lines.append(f"**• {panel_title}**\n")
+            lines.append(f"**• {panel_title}**\n")
-            lines.append("| 타겟(legend) | 합계 |")
+            lines.append("| 타겟(legend) | 합계 |")
-            lines.append("|:--|--:|")
+            lines.append("|:--|--:|")
-            for legend, total_str in rows:
+            for legend, total_str in rows:
-                lines.append(f"| {legend} | {total_str} |")
+                lines.append(f"| {legend} | {total_str} |")
-            lines.append("")  # 섹션 간 공백
+            lines.append("")  # 섹션 간 공백
-    else:
+    else:
-        lines.append("_표시할 데이터가 없습니다._")
+        lines.append("_표시할 데이터가 없습니다._")
-        lines.append("")
+        lines.append("")
-
+
-    if skipped:
+    if skipped:
-        lines.append(
+        lines.append(
-            "<details><summary>건너뛴 항목</summary>\n\n"
+            "<details><summary>건너뛴 항목</summary>\n\n"
-            + "\n".join(skipped)
+            + "\n".join(skipped)
-            + "\n\n</details>"
+            + "\n\n</details>"
-        )
+        )
-
+
-    post_mattermost(cfg.mattermost_webhook, lines)
+    post_mattermost(cfg.mattermost_webhook, lines)
-    logger.info(f"[OK] Sent grouped tables for {len(grouped)} panels.")
+
-
+    # ✅ Email 전송
-
+    if cfg.email_recipients:
-if __name__ == "__main__":
+        subject = f"Grafana 요약 리포트 ({range_label})"
-    main()
+        body_md = "\n".join(lines)
+        send_email(
+            host=cfg.smtp_host,
+            port=cfg.smtp_port,
+            user=cfg.smtp_user,
+            password=cfg.smtp_password,
+            recipients=cfg.email_recipients,
+            subject=subject,
+            body_md=body_md,
+        )
+
+    logger.info(f"[OK] Sent grouped tables for {len(grouped)} panels.")
+
+
+if __name__ == "__main__":
+    main()

src/services/reporter.py

@@ -1,11 +1,52 @@
 import logging
+import smtplib
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
 from typing import List
 
+import markdown
 import requests
 
 logger = logging.getLogger(__name__)
 
 
+def send_email(
+    host: str,
+    port: int,
+    user: str | None,
+    password: str | None,
+    recipients: list[str],
+    subject: str,
+    body_md: str,
+) -> None:
+    """
+    SMTP를 통해 이메일 전송.
+    """
+    if not all([host, recipients]):
+        logger.warning("[EMAIL SKIP] SMTP_HOST or EMAIL_RECIPIENTS is not configured.")
+        return
+
+    msg = MIMEMultipart("alternative")
+    msg["Subject"] = subject
+    msg["From"] = user or "noreply@localhost"
+    msg["To"] = ", ".join(recipients)
+
+    # HTML 본문 생성
+    html_body = markdown.markdown(body_md, extensions=["tables"])
+    msg.attach(MIMEText(html_body, "html"))
+
+    try:
+        with smtplib.SMTP(host, port) as server:
+            if user and password:
+                server.starttls()
+                server.login(user, password)
+            server.sendmail(msg["From"], recipients, msg.as_string())
+            logger.info(f"[EMAIL OK] Sent to {', '.join(recipients)}")
+    except Exception as e:
+        logger.exception(f"[EMAIL ERROR] {e}")
+        raise
+
+
 def post_mattermost(webhook: str, lines: List[str]) -> None:
     """
     Mattermost Webhook으로 메시지 전송.

src/setting/config.py

@@ -1,29 +1,43 @@
-import os
+import os
-import sys
+import sys
-from dataclasses import dataclass
+from dataclasses import dataclass
-
+
-
+
-def env(name: str) -> str:
+def env(name: str) -> str:
-    v = os.getenv(name)
+    v = os.getenv(name)
-    if not v:
+    if not v:
-        print(f"[ERR] env {name} is required.", file=sys.stderr)
+        print(f"[ERR] env {name} is required.", file=sys.stderr)
-        sys.exit(1)
+        sys.exit(1)
-    return v.strip()
+    return v.strip()
-
+
-
+
-@dataclass(frozen=True)
+@dataclass(frozen=True)
-class AppConfig:
+class AppConfig:
-    grafana_url: str
+    grafana_url: str
-    grafana_api_key: str
+    grafana_api_key: str
-    grafana_dashboard_uid: str
+    grafana_dashboard_uid: str
-    mattermost_webhook: str
+    mattermost_webhook: str
-
+
-    @staticmethod
+    # Email settings
-    def load() -> "AppConfig":
+    smtp_host: str | None
-        url = env("GRAFANA_URL").rstrip("/")
+    smtp_port: int
-        return AppConfig(
+    smtp_user: str | None
-            grafana_url=url,
+    smtp_password: str | None
-            grafana_api_key=env("GRAFANA_API_KEY"),
+    email_recipients: list[str]
-            grafana_dashboard_uid=env("GRAFANA_DASHBOARD_UID"),
+
-            mattermost_webhook=env("MATTERMOST_WEBHOOK"),
+    @staticmethod
-        )
+    def load() -> "AppConfig":
+        url = env("GRAFANA_URL").rstrip("/")
+        recipients = os.getenv("EMAIL_RECIPIENTS")
+        return AppConfig(
+            grafana_url=url,
+            grafana_api_key=env("GRAFANA_API_KEY"),
+            grafana_dashboard_uid=env("GRAFANA_DASHBOARD_UID"),
+            mattermost_webhook=env("MATTERMOST_WEBHOOK"),
+            # Email settings
+            smtp_host=os.getenv("SMTP_HOST"),
+            smtp_port=int(os.getenv("SMTP_PORT") or 587),
+            smtp_user=os.getenv("SMTP_USER"),
+            smtp_password=os.getenv("SMTP_PASSWORD"),
+            email_recipients=[r.strip() for r in (recipients or "").split(",") if r],
+        )