[해결] GA4 전날 데이터를 하루 한 번 조회하고 CloudFront로 캐시하는 방법

한 줄 요약: 서비스 운영 대시보드나 사용자용 주간 보고서를 띄울 때 매번 비용이 발생하는 GA4 Data API 실시간 쿼리를 날리는 대신, 하루 1회 EventBridge 크론으로 전날 데이터를 인출해 S3 저장 후 CloudFront Edge에 캐시하여 API Quota 낭비와 응답 대기 시간을 완전히 제거했습니다.

초기 시도에서는 대시보드 요청 API(GET /api/weekly-report)가 들어올 때마다 Lambda가 즉시 GA4 Data API를 실시간 조회(On-demand API Fetching)하도록 구현했습니다.

// 기존 시도 (실시간 쿼리 - 429 오류 및 속도 지연 발생)
app.get("/api/weekly-report", async (req, res) => {
  const data = await analyticsClient.runReport({ ... }); // 1초 대기
  res.json(data);
});

어차피 "전날(Yesterday)까지의 운영 데이터"는 하루 동안 변하지 않는 고정된 지표임에도 불구하고, 모든 요청마다 실시간 쿼리를 재실행한 비효율적인 설계가 원인이었습니다.

Scheduled Batch Fetching & CloudFront CDN Caching Pattern을 구축했습니다.

4. CloudFront Invalidation (캐시 즉시 갱신): 새 일별 보고서 업로드 완료 직후 AWS SDK CreateInvalidationCommand를 호출하여 CloudFront Edge의 reports/latest.json 캐시를 무효화(Invalidate)합니다.

`infra/report-api/index.mjs` (S3 정적 저장 및 CloudFront Invalidation 코드)

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
import { CloudFrontClient, CreateInvalidationCommand } from "@aws-sdk/client-cloudfront";

const s3Client = new S3Client({});
const cfClient = new CloudFrontClient({});

const BUCKET_NAME = process.env.REPORT_BUCKET || "fruit.nxnl.app";
const CF_DISTRIBUTION_ID = process.env.FRUIT_CF_DISTRIBUTION || "E1RZDJT0J7KKAW";

async function saveReportAndInvalidate(reportData) {
  const jsonBody = JSON.stringify(reportData, null, 2);
  const dateStr = reportData.date; // YYYY-MM-DD

  // 1. S3 버킷에 날짜별 및 최신(latest.json) 파일 업로드 (24시간 캐시 헤더)
  await s3Client.send(new PutObjectCommand({
    Bucket: BUCKET_NAME,
    Key: `reports/latest.json`,
    Body: jsonBody,
    ContentType: "application/json",
    CacheControl: "public, max-age=86400, s-maxage=86400",
  }));

  // 2. CloudFront Edge 캐시 강제 무효화 (새 보고서 즉시 반영)
  await cfClient.send(new CreateInvalidationCommand({
    DistributionId: CF_DISTRIBUTION_ID,
    InvalidationBatch: {
      CallerReference: `report-invalidation-${Date.now()}`,
      Paths: {
        Quantity: 1,
        Items: ["/reports/latest.json"],
      },
    },
  }));
}

자주 바뀌지 않는 집계성 데이터를 매번 백엔드 DB나 3rd-party API로 조회하는 것은 자원 낭비입니다. 하루 1회 배치 인출 + S3 정적 저장 + CloudFront CDN 캐싱 패턴을 쓰면 100배 빠른 응답 속도와 0원에 가까운 아키텍처를 얻을 수 있습니다.

실제 적용 서비스