새 아키텍처 (전면 재구축)​

v1의 단일 EC2 호스트(빌드·운영·로컬 상태가 한곳에 묶여 있던 구조)를 풀어, 컴포넌트를 독립적으로 배포·확장할 수 있는 구조로 재설계했습니다.

새로워진 경험​

• 인앱 로그인 — 자체 /login 폼에서 이메일·비밀번호로 로그인합니다. 미인증 요청은 엣지에서 로그인 화면으로 안내합니다.
• 3종 테마 — Cobalt(기본) · Teal · Dark 테마 피커. 선택은 저장되며 차트·브랜드 마크까지 테마에 맞춰 바뀝니다.
• 모바일 반응형 — 상단 바 + 하단 5탭 + 슬라이드 드로어로 좁은 화면에서도 전체 기능을 사용할 수 있습니다.
• 명령 팔레트 — Cmd-K(또는 Ctrl-K)로 어느 페이지·리소스로든 바로 이동하고 테마를 전환합니다.

AI — 더 빠르고, 더 똑똑하게​

• AI 어시스턴트 — 질문을 토큰 단위로 스트리밍하고 **마크다운(표·코드·목록)**으로 답합니다. 질문은 도메인(네트워크·비용·보안 등)으로 자동 라우팅되며, 대화는 영속 저장되어 드로어와 전체 화면이 같은 기록을 공유합니다.
• AI 진단 — Light / Mid / Deep 깊이로 계정 운영 상태 종합 리포트를 생성하고, MD · DOCX · PDF로 내보냅니다. 의도 대비 실제(불변식) 점검과 이전 리포트 대비 변화 인사이트를 함께 제공합니다.

더 넓은 가시성​

• 토폴로지 — Route53 → CloudFront → LB → Target Group → 타깃으로 이어지는 요청 흐름 그래프. 노드 클릭 시 포커스 모드 + 상세 패널(ARN 복사·AI 질문).
• 리소스 인벤토리 — EC2·Lambda·RDS·S3·VPC·IAM 등 20여 종을 정렬·검색·상세 조회.
• EKS / Kubernetes — 클러스터 함대 요약과 노드·파드·디플로이먼트 인-클러스터 조회(읽기 전용), OpenCost 설치 안내.
• 비용 — 서비스별 비용 분해·드릴다운, 월말 예측, 그리고 Bedrock 모델 사용량(토큰·지연·비용·캐시 절감).
• 데이터소스 탐색 — 연결된 관측성 데이터소스를 **네이티브 쿼리 언어(PromQL/LogQL/TraceQL/SQL)**로 읽기 전용 조회.

읽기 전용 운영 자세​

AWSops는 운영 현황을 관찰·분석·진단하는 데 집중하며 AWS 리소스를 변경하지 않습니다. 설치·변경이 필요한 작업은 사용자가 직접 실행할 수 있도록 스크립트·안내를 제공합니다.

사용 가이드​

새 화면별 사용법은 가이드 문서에서 확인하세요:

• AWSops 소개
• 로그인 · 화면 구성과 테마
• 대시보드 · AI 어시스턴트 · AI 진단

이벤트 사전 스케일링 (ADR-010 Phase 1+2)​

대형 트래픽 이벤트가 시작되기 전에 자원을 데울 수 있도록, /event-scaling 관리자 페이지가 추가되었습니다. 등록부터 스크립트 다운로드까지 4단계로 동작합니다:

1. 이벤트 등록 — 이벤트 이름, 시작/종료 시간, 영향받는 자원 태그
2. 과거 메트릭 수집 — 동일 이벤트가 과거에 있었다면 그 구간의 CloudWatch 메트릭(ASG·RDS·MSK·EBS·ALB)을 GetMetricData 배치로 수집
3. AI 워밍업 플랜 생성 — Bedrock Sonnet 4.6이 자원별로 다단계 사전 스케일 플랜을 생성하고 PLAN_JSON 마커로 구조화된 결과 반환
4. bash 스크립트 다운로드 — 자원 타입별로 안전한 스크립트 생성 (KEDA·HPA, Aurora 리더 추가, MSK 파티션 확장, ASG warm pool, EBS IOPS 부스트)

검토-후-실행 (mutation-by-review)​

대시보드는 변경 작업을 직접 실행하지 않습니다. 스크립트는 다운로드 전용이며 운영자가 검토한 뒤 적절한 환경(kubectl, aws cli)에서 직접 적용합니다. 이는 ADR-029(Proposed)의 변경 작업 게이트 모델 — "AI가 생성한 mutating action은 명시적 인간 승인 후에만 실행된다" — 와 일치합니다.

관련 파일​

Aurora 데이터 계층 기반 (ADR-030 Phase 1)​

빌드 서버와 운영 서버가 같은 EC2에 묶여 있어 AgentCore Docker 빌드 시 Next.js 지연이 튀고 Steampipe FDW 쿼리가 타임아웃되는 문제를 해결하기 위해, ADR-030에서 ECS Fargate 워크로드 + Aurora 앱 상태 + 이중 ECR(Dev=Private, Prod=Public) 로의 전환을 결정했습니다. v1.9.0은 그중 Phase 1 기반만 들어갑니다.

들어간 것​

opt-in 배포​

기본은 off입니다. 활성화하려면 컨텍스트 플래그를 명시:

cd infra-cdk
npx cdk deploy AwsopsDataStack -c enableAurora=true
# 또는 스크립트 사용
../scripts/13-deploy-aurora.sh deploy

이렇게 게이트한 이유는 (1) Aurora Serverless v2 최소 0.5 ACU 청구(~$43/월)가 모든 환경에 적합하지 않고, (2) Phase 1 dual-write가 아직 들어가지 않아 실제 데이터는 여전히 data/*.json에 쌓이기 때문입니다.

Steampipe는 그대로​

ADR-030의 미묘한 지점: Steampipe는 stateless입니다. FDW가 AWS API를 실시간 조회하고 결과를 인메모리에 잠시 두는 구조라, 컨테이너가 재시작되어도 잃을 "데이터"가 없습니다. Aurora가 대체하는 것은 Steampipe가 아니라, 대시보드 자체가 EC2 디스크에 쌓던 data/*.json (인벤토리·Cost·메모리·alert 기록·event-scaling 플랜 등)입니다.

다음 릴리스 예정 (Phase 1 dual-write)​

7개 소스 파일이 이중 쓰기 경로를 받습니다. 쓰기는 JSON과 Aurora 양쪽에 들어가고, 읽기는 7일 패리티 게이트가 통과할 때까지 JSON 측에서 합니다:

• resource-inventory.ts, cost-snapshot.ts, agentcore-memory.ts, agentcore-stats.ts, alert-knowledge.ts, event-scaling.ts, report-scheduler.ts

ADR-029: 변경 작업 프레임워크 (Proposed)​

이벤트 사전 스케일링이 검토-후-실행으로 들어간 이유는 ADR-010 Phase 3(자동 실행)의 게이트 모델이 아직 정해지지 않았기 때문입니다. ADR-029는 그 게이트 — "어떤 조건에서 AI가 생성한 변경 작업을 어떤 권한 모델로 실행 가능하게 할 것인가" — 를 Proposed 상태로 등록해 향후 Phase 3 작업의 선행 조건을 명시합니다.

AI 코드 리뷰 워크플로​

PR이 열리거나 업데이트될 때 Claude가 자동으로 코드 리뷰를 수행하는 GitHub Actions 워크플로가 추가되었습니다 (.github/workflows/claude-review.yml). AWSops 컨벤션(Steampipe pg Pool, basePath, SCP 차단 컬럼 등)에 맞춰진 리뷰 프롬프트를 사용합니다.

좀비 연결 정리 강화​

src/lib/steampipe.ts의 좀비 정리 작업이 풀에서 connection을 빌리지 않고 전용 단명 Client를 사용하도록 변경되었습니다. Cost Explorer/IAM 요약 FDW가 hung 상태일 때 풀 전체가 고갈되어도 정리가 계속 동작합니다. 임계값도 90초로 단축되었습니다.

통계 비교​

참고​

• ADR-010: 이벤트 기반 사전 스케일링 (Phase 1+2 Accepted)
• ADR-029: 변경 작업 프레임워크 (Proposed)
• ADR-030: ECS Fargate + Aurora + 이중 ECR (Accepted, Phase 1 부분 구현)

알림 트리거 AI 진단 (ADR-009)​

심각도 critical 인시던트 발생 시 자동으로 부분 AI 진단이 실행됩니다.

파이프라인 흐름​

[CloudWatch Alarm] → SNS Topic → SQS Queue
                                    ↓
                            [EC2 Poller (15s)]
                                    ↓
[Alertmanager/Grafana/Generic] → POST /api/alert-webhook
                                    ↓
                            [alert-correlation.ts]
                                    ↓
                         [alert-diagnosis.ts (AI)]
                                    ↓
                          [Slack/SNS 발송]

지원 소스​

상관 분석 엔진​

src/lib/alert-correlation.ts가 개별 알림을 인시던트로 그룹화합니다:

스코프 제한 자동 진단​

전체 15섹션 진단과 달리 발화한 알림 범위로만 제한되어 1~2분 내 완료됩니다:

1. AlertContext 빌드 — 영향받은 서비스/리소스/네임스페이스, 발화 시각(since) 추출
2. 스코프 제한 수집 — CloudWatch 메트릭을 since 기준 ±10분, 해당 리소스만 필터링
3. 관련 섹션 선택 — Compute / Network / Container 등 3~5개만 실행
4. 변경 감지 — Terraform state / CloudTrail 최근 변경 비교
5. Bedrock Sonnet 분석 — 근본 원인 추정 + Next Steps 제안

// src/lib/alert-diagnosis.ts (핵심 인터페이스)
interface AlertContext {
  services: string[];
  resources: string[];
  namespaces: string[];
  since: Date;     // 발화 시각 − 10분
  until: Date;     // 발화 시각 + 10분
}

Slack 알림 (Block Kit)​

심각도에 따라 채널 라우팅 + 스레드 업데이트로 동작합니다:

• 최초 알림은 메인 메시지, 후속 이벤트(추가 알림 병합, AI 진단 결과, 해결)는 동일 스레드에 reply
• Webhook 모드와 Bot Token 모드 모두 스레딩 지원 (thread_ts 재사용)
• CloudWatch OK 또는 Alertmanager resolved 수신 시 ✅ 해결 알림

HMAC 인증​

공유 시크릿은 data/config.json의 alertWebhookSecret에 저장합니다:

curl -X POST https://awsops.example.com/awsops/api/alert-webhook \
  -H 'X-Alert-Source: generic' \
  -H "X-Signature-256: sha256=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $2}')" \
  -H 'Content-Type: application/json' \
  -d "$BODY"

알림 지식 베이스​

data/alert-diagnosis/ 아래에 진단 기록이 영구 저장됩니다:

UI의 Knowledge Base 탭에서 과거 유사 인시던트를 검색할 수 있으며, 새 인시던트 발생 시 유사도 기반으로 자동 추천됩니다.

문서 대폭 확장​

ADR 18건 신규 (011-028)​

v1.8.0에서 추가된 기능들의 설계 의사결정을 공식화했습니다:

런북 5건 신규​

운영 상황에서 실제로 쓸 수 있는 트러블슈팅/설정 가이드:

• alert-pipeline-troubleshoot.md — 웹훅이 안 올 때, 상관 분석이 인시던트를 못 만들 때, Slack이 안 뜰 때
• cache-warmer-operations.md — 캐시 워머 디버깅, 쿼리 추가/제거
• cognito-auth-troubleshoot.md — Lambda@Edge, HttpOnly 쿠키, OAuth2 콜백 이슈
• deploy-flow.md — 11단계 배포 스크립트 운영 매뉴얼
• multi-account-setup.md — Aggregator 설정, 교차 계정 IAM 역할, 검증 절차

모듈 CLAUDE.md 11개 신규​

각 소스 모듈의 역할/규칙/주요 파일을 Claude 컨텍스트 파일로 정리:

Web 가이드 확장​

Docusaurus 가이드에 v1.8 기능을 반영했습니다:

• monitoring/ai-diagnosis.md — 15섹션 진단, 내보내기 포맷(DOCX/MD/PDF/PPTX), 스케줄링, 비용 제어 팁
• monitoring/alerts.md — 알림 파이프라인 전체 흐름, HMAC, 상관 분석, Slack 스레딩, 지식 베이스
• intro.md — 40 페이지 / 18 API / 11 AI 라우트 반영, "AI 종합 진단 & 알림 파이프라인" 기능 블록 추가
• faq/troubleshooting.md — Slack 알림 실패 / AI 진단 부분 실패 케이스
• 한국어(docs/) + 영어(i18n/en/docusaurus-plugin-content-docs/current/) 양쪽 모두 반영

버그 수정 하이라이트​

주요 파일 변경​

버전 비교​

참고​

• ADR-009: 알림 트리거 AI 진단
• ADR-012: SNS 알림 전략
• ADR-013: 자동 수집 조사 에이전트
• ADR-020: HMAC 웹훅 인증

외부 관측성 통합 (7종)​

AWS 데이터에 더해 기존 관측성 플랫폼을 데이터소스로 연동합니다.

• /datasources — 데이터소스 CRUD · 연결 테스트 · 인증 구성
• /datasources/explore — 직접 쿼리 실행 + AI 쿼리 생성(자연어 → PromQL/LogQL/TraceQL/SQL)
• AI 어시스턴트의 datasource 라우트가 외부 메트릭 질문을 자동 분류 (AI 라우팅 10 → 11로 확장)

AI 종합 진단 (15섹션)​

• Bedrock Opus가 인프라 전반을 15섹션으로 자동 분석 — 비용/보안/안정성 중심
• DOCX · Markdown · 브라우저 Print-to-PDF 내보내기
• 주간/격주/월간 자동 스케줄 (report scheduler)
• 인쇄용 리포트 페이지 /ai-diagnosis/report (A4 페이지 브레이크)

보안 (SSRF 방지)​

• datasource-client.ts의 URL 검증이 AI 라우트 포함 모든 외부 fetch 경로를 보호
• allowlist 기반 사설망 접근 제어 + IPv6 사설/링크로컬(fc00::/7, fe80::/10) 탐지
• 데이터소스 쿼리·AI 쿼리 생성은 관리자 전용

기타​

• 멀티 라우트 합성에 Converse Stream API + AgentCore 응답 타이핑 효과
• 좀비 PostgreSQL 커넥션 자동 정리, 모니터링 쿼리 시간 범위 필터로 pg pool 고갈 방지
• EKS Access Entry 상태 표시 + kubeconfig 등록, EKS 서비스 리소스 탭

AI 종합진단 리뉴얼​

기존 /diagnosis 경로가 /ai-diagnosis로 변경되고, UI 전반이 리뉴얼되었습니다.

Before / After​

3종 내보내기​

DOCX — docx 패키지 기반 A4 전문 리포트:

• 표지 (제목, 건강 점수, 계정 별칭, 날짜)
• 목차 (하이퍼링크, Heading 1-3)
• 섹션별 강조색 (비용=초록, 보안=빨강, 네트워크/EKS=보라, 유휴/MSK=주황)
• 마크다운 파싱 (제목, 테이블, 목록, 인용, 인라인 코드/볼드/이탤릭)

Markdown — 모든 섹션을 하나의 .md 파일로 합쳐 내보냅니다.

PDF — /ai-diagnosis/report 전용 인쇄 페이지:

• 흰 배경 A4 레이아웃, CSS @media print 페이지 나눔
• "인쇄 / PDF 저장" 버튼으로 브라우저 Print-to-PDF

// src/lib/report-docx.ts (주요 구조)
const doc = new Document({
  sections: [
    coverPage(title, healthScore, accountAlias, date),
    tableOfContents(),
    ...sections.map(s => sectionPage(s, accentColor)),
  ],
});
const buffer = await Packer.toBuffer(doc);

예약 리포트​

// src/lib/report-scheduler.ts
type Schedule = {
  enabled: boolean;
  frequency: 'weekly' | 'biweekly' | 'monthly';
  dayOfWeek?: number;   // 0=일 ~ 6=토
  dayOfMonth?: number;  // 1~28
  hour: number;         // KST 기준
  language: 'ko' | 'en';
};

UI에서 토글 ON/OFF, 빈도/요일/시간/언어를 설정하면 자동으로 리포트가 생성되고 S3에 업로드됩니다.

6종 Auto-Collect 에이전트​

AI 종합진단 리포트의 데이터 수집을 자동화하는 전용 에이전트입니다. 각 에이전트는 멀티 소스에서 병렬로 데이터를 수집하고 라이브 상태를 스트리밍합니다.

// src/lib/collectors/types.ts
export interface Collector {
  collect(send: SendFn, accountId?: string, isEn?: boolean): Promise<CollectorResult>;
  formatContext(data: CollectorResult): string;
  analysisPrompt: string;
  displayName: string;
}

FinOps MCP Lambda​

Cost Gateway에 5개 FinOps 도구가 추가되었습니다.

모든 도구는 target_account_id 파라미터로 크로스 계정 조회를 지원합니다.

EKS/K8s UX 대폭 개선​

클러스터 액세스 관리​

새 기능​

버그 수정​

• external_ip → external_ips 컬럼명 수정 (서비스 0/0 버그)
• EC2 IAM Role ARN 잘림 수정 (SQL || 연산자 필터 충돌)
• Register 클릭 시 클러스터 필터 토글 방지 (stopPropagation)
• 등록 후 폴링으로 연결 확인 (5회 × 3초)

Benchmark: Powerpipe Exit Code 2 처리​

Powerpipe는 벤치마크 컨트롤에 알람이 있으면 exit code 2로 종료합니다. 이는 정상 동작이지만, 기존 코드는 비정상 종료로 처리했습니다.

# exit code 무시, 출력 파일 유효성으로 판단
powerpipe benchmark run ... > "${tmpFile}" 2>"${errorFile}"; \
if [ -s "${tmpFile}" ]; then
  mv "${tmpFile}" "${resultFile}" && echo "done" > "${statusFile}";
else
  echo "error" > "${statusFile}";
fi

인프라: S3 리포트 업로드 + update-infra 스크립트​

S3 정책​

CDK 스택에 EC2 역할 S3 권한이 추가되었습니다:

// infra-cdk/lib/awsops-stack.ts
ec2Role.addToPolicy(new iam.PolicyStatement({
  actions: ['s3:PutObject', 's3:GetObject'],
  resources: [`arn:aws:s3:::awsops-deploy-${this.account}/reports/*`],
}));

update-infra 스크립트​

EC2 교체 없이 CDK 스택을 안전하게 업데이트하는 00-update-infra.sh 스크립트:

1. 기존 스택 파라미터 읽기 — CloudFormation에서 현재 값 보존
2. CDK 컨텍스트 복원 — VPC, TGW, 도메인 등 라이브 인프라에서 재추출
3. cdk diff 미리보기 — EC2 교체 여부 경고
4. 배포 — --no-rollback으로 안전 배포

버전 비교​

주요 파일 변경​

외부 데이터소스 관리​

Grafana의 데이터소스 관리와 유사한 방식으로 외부 관측성(Observability) 도구를 AWSops에서 직접 연결하고 쿼리할 수 있습니다.

지원 데이터소스 7종​

기능 상세​

인증 설정 예시​

4가지 인증 방식을 지원하며, 데이터소스 타입에 따라 적절한 방식을 선택합니다:

// src/lib/datasource-client.ts
type AuthType = 'none' | 'basic' | 'bearer' | 'custom-header';

// Basic Auth → Authorization: Basic base64(user:pass)
// Bearer Token → Authorization: Bearer <token>
// Custom Header → 사용자 지정 헤더명: 값

config.json 데이터소스 설정​

data/config.json에 datasources 배열을 추가하여 데이터소스를 관리합니다:

{
  "costEnabled": true,
  "agentRuntimeArn": "arn:aws:bedrock-agentcore:...",
  "datasources": [
    {
      "id": "prom-1",
      "name": "Production Prometheus",
      "type": "prometheus",
      "url": "https://prometheus.example.com:9090",
      "authType": "bearer",
      "authConfig": { "token": "***" },
      "isDefault": true
    },
    {
      "id": "ch-1",
      "name": "Analytics ClickHouse",
      "type": "clickhouse",
      "url": "https://clickhouse.example.com:8443",
      "authType": "basic",
      "authConfig": { "username": "reader", "password": "***" }
    }
  ]
}

보안: SSRF 방어​

외부 URL에 요청을 보내기 전에 SSRF(Server-Side Request Forgery) 공격을 방지하는 검증 계층을 적용합니다.

// src/lib/datasource-client.ts (간소화)
function validateUrl(url: string): void {
  const parsed = new URL(url);
  const hostname = parsed.hostname;

  // Private IP 대역 차단
  const privatePatterns = [
    /^10\./,                          // 10.0.0.0/8
    /^172\.(1[6-9]|2\d|3[01])\./,    // 172.16.0.0/12
    /^192\.168\./,                     // 192.168.0.0/16
    /^127\./,                          // Loopback
    /^169\.254\./,                     // Link-local
    /^0\./,                            // Current network
  ];

  // Cloud metadata endpoint 차단
  if (hostname === '169.254.169.254') {
    throw new Error('SSRF blocked: cloud metadata endpoint');
  }

  for (const pattern of privatePatterns) {
    if (pattern.test(hostname)) {
      throw new Error(`SSRF blocked: private IP range (${hostname})`);
    }
  }
}

보안: ClickHouse SQL Injection 방지​

ClickHouse 쿼리는 사용자 입력을 직접 문자열에 삽입하지 않고 파라미터화된 쿼리를 사용합니다:

// src/lib/datasource-client.ts — ClickHouse 쿼리 실행

// 위험: 직접 문자열 보간 (사용하지 않음)
// const query = `SELECT * FROM logs WHERE service = '${userInput}'`;

// 안전: 파라미터화된 쿼리
const response = await fetch(`${url}/?param_service=${encodeURIComponent(service)}`, {
  method: 'POST',
  body: `SELECT * FROM logs WHERE service = {service:String}`,
  headers: { 'Content-Type': 'text/plain' },
});

PromQL 쿼리 예시​

Prometheus 데이터소스에서 PromQL로 메트릭을 조회하는 예시:

# 최근 5분간 CPU 사용률 (Pod별)
rate(container_cpu_usage_seconds_total{namespace="production"}[5m])

# 메모리 사용량 상위 10개 Pod
topk(10, container_memory_working_set_bytes{namespace="production"})

# HTTP 요청 에러율 (5xx)
sum(rate(http_requests_total{status=~"5.."}[5m]))
  / sum(rate(http_requests_total[5m])) * 100

// API를 통한 PromQL 실행
const response = await fetch('/awsops/api/datasources', {
  method: 'POST',
  body: JSON.stringify({
    action: 'query',
    datasourceId: 'prom-1',
    query: 'rate(container_cpu_usage_seconds_total{namespace="production"}[5m])',
  }),
});

Dynamic VPC CIDR​

CDK 스택에서 VPC CIDR을 컨텍스트 파라미터로 설정할 수 있게 변경했습니다.

Before / After​

# 기본 VPC CIDR (10.10.0.0/16)
cdk deploy -c newVpcCidr=10.10.0.0/16

# 커스텀 VPC CIDR + 다중 TGW 라우트
cdk deploy \
  -c newVpcCidr=10.20.0.0/16 \
  -c tgwRouteCidrs=10.10.0.0/16,10.30.0.0/16,172.16.0.0/12

데이터소스 진단 에이전트​

외부 데이터소스 연결 문제를 체계적으로 진단하는 전용 에이전트가 추가되었습니다. AI 라우팅에 priority 11 datasource 라우트가 신규 등록됩니다.

진단 에이전트가 확인하는 항목:

• 네트워크: 대상 호스트 도달 가능 여부, 방화벽/보안그룹 설정
• 인증: 자격증명 유효성, 토큰 만료, 권한 부족
• SSL/TLS: 인증서 유효성, 만료, 체인 문제
• DNS: 호스트명 해석 실패, DNS 전파 지연

버전 비교​

주요 파일 변경​

Converse Stream API로 실시간 합성​

멀티 라우트 응답 합성이 가짜 청킹에서 진짜 토큰 스트리밍으로 전환되었습니다.

Before / After​

코드 변경​

Before — synthesizeResponses() + simulateStreaming():

// src/app/api/ai/route.ts (v1.7.0)
const synthesized = await synthesizeResponses(
  lastMsg, successful, modelKey, clientLang
);
// 완성된 텍스트를 50자씩 나눠서 가짜 스트리밍
await simulateStreaming(synthesized, send);

After — synthesizeResponsesStreaming() + ConverseStreamCommand:

// src/app/api/ai/route.ts (v1.7.1)
const synthesized = await synthesizeResponsesStreaming(
  lastMsg, successful, send, modelKey, clientLang
);
// send() 콜백이 contentBlockDelta마다 즉시 chunk 전송

synthesizeResponsesStreaming() 핵심 로직:

const response = await bedrockClient.send(new ConverseStreamCommand({
  modelId,
  system: [{ text: systemPrompt }],
  messages: [{ role: 'user', content: [{ text: synthesisPrompt }] }],
  inferenceConfig: { maxTokens: 4096 },
}));

for await (const event of response.stream) {
  if (event.contentBlockDelta?.delta?.text) {
    const text = event.contentBlockDelta.delta.text;
    fullContent += text;
    send('chunk', { delta: text });  // 토큰 즉시 전송
  }
}

타이핑 효과 (simulateStreaming)​

AgentCore Gateway는 완성된 텍스트를 한 번에 반환하기 때문에, 타이핑 효과를 시뮬레이션합니다.

// src/app/api/ai/route.ts
const CHUNK_SIZE = 50;     // 청크당 50자
const CHUNK_DELAY_MS = 15; // 청크 간 15ms 딜레이

async function simulateStreaming(
  text: string,
  send: (event: string, data: any) => void,
): Promise<void> {
  for (let i = 0; i < text.length; i += CHUNK_SIZE) {
    const chunk = text.slice(i, i + CHUNK_SIZE);
    send('chunk', { delta: chunk });
    if (i + CHUNK_SIZE < text.length) {
      await new Promise(r => setTimeout(r, CHUNK_DELAY_MS));
    }
  }
}

적용 대상 (3곳):

1. 단일 AgentCore Gateway 응답 — 완성된 텍스트에 타이핑 효과
2. 멀티 라우트 합성 (v1.7.0) — synthesizeResponses() 결과에 적용 (v1.7.1에서 Converse Stream으로 대체)
3. 멀티 라우트 단일 성공 — 1개 Gateway만 성공한 경우

채팅 버블 너비 안정화 (PR #8)​

SSE 스트리밍 중 채팅 버블 너비가 갑자기 변하는 문제를 수정했습니다.

Before — 너비 점프:

<div class="max-w-5xl rounded-lg px-4 py-3 ...">
  <!-- 콘텐츠가 짧을 때 좁고, 길어지면 갑자기 넓어짐 -->
</div>

After — 안정적 너비:

<div class="w-full max-w-5xl rounded-lg px-4 py-3 ...">
  <!-- 처음부터 w-full로 최대 너비 확보, max-w-5xl로 상한 제한 -->
</div>

모니터링 쿼리 시간 범위 필터​

시간 범위 제한이 없는 모니터링 쿼리가 Steampipe API를 통해 전체 이력 데이터를 가져와 pg pool 5개 커넥션을 모두 점유하는 문제를 수정했습니다.

3가지 스트리밍 모드 요약​

v1.7.1에서 AWSops AI 응답은 상황에 따라 3가지 스트리밍 모드를 사용합니다.

멀티 어카운트 아키텍처 (PR #6)​

Steampipe Aggregator 패턴으로 여러 AWS 계정을 단일 대시보드에서 관리합니다. data/config.json의 accounts[] 배열만 변경하면 코드 수정 없이 계정을 추가할 수 있습니다.

config.json 구조​

{
  "accounts": [
    {
      "accountId": "111111111111",
      "alias": "Host",
      "connectionName": "aws_111111111111",
      "region": "ap-northeast-2",
      "isHost": true,
      "features": {
        "costEnabled": true,
        "eksEnabled": true,
        "k8sEnabled": true
      }
    },
    {
      "accountId": "222222222222",
      "alias": "Staging",
      "connectionName": "aws_222222222222",
      "region": "ap-northeast-2",
      "isHost": false,
      "features": {
        "costEnabled": false,
        "eksEnabled": false,
        "k8sEnabled": false
      }
    }
  ]
}

보안 수정 (25건)​

3단계 심각도로 분류하여 25건의 보안 이슈를 수정했습니다.

CRITICAL 상세:

HIGH 상세:

실시간 Bedrock 스트리밍​

Bedrock 응답을 청크 단위로 실시간 전송합니다.

캐시 프리워밍​

대시보드 로딩 속도를 개선하기 위해 백그라운드 캐시 프리워밍을 도입했습니다.

고객 로고 커스터마이징​

data/config.json에서 고객 로고를 설정하면 서버 재시작 없이 1분 내에 반영됩니다.

{
  "customerLogo": "/logos/customer-logo.png",
  "customerName": "Customer Corp",
  "customerLogoBg": "#ffffff"
}

• public/logos/ 디렉토리에 로고 파일 배치
• config 변경만으로 브랜딩 전환 — 코드 수정 불필요

버전 비교​

다국어 지원 (i18n)​

React Context + localStorage 기반으로 URL 라우팅 없이 언어를 전환합니다. Next.js의 basePath: '/awsops'와 충돌하지 않는 설계입니다.

번역 범위:

• 모든 35개 페이지 텍스트
• Header, Sidebar 메뉴 레이블
• AI 상태 메시지 (분석 중, Gateway 연결 중, 완료 등)
• DataTable 컬럼 헤더
• StatsCard 레이블

Bedrock 모니터링 (/bedrock)​

Bedrock 모델별 사용량을 CloudWatch 메트릭과 AWSops 앱 자체 토큰 추적으로 모니터링합니다.

Docusaurus 사용자 가이드​

web/ 디렉토리에 Docusaurus 기반 사용자 가이드 사이트를 구축했습니다.

버전 비교​

AgentCore Memory Store​

사용자별 대화 이력을 365일간 보관하는 Memory Store를 도입했습니다. src/lib/agentcore-memory.ts에서 저장/검색 로직을 관리합니다.

AgentCore 페이지 통합:

• 6개 StatsCard: 총 호출 수, 평균 응답 시간, Gateway별 호출 비율, 모델별 토큰 사용량
• 대화 이력 검색: 키워드, 날짜 범위, 라우트별 필터

AI 페이지 통합:

• 하단 토글 패널에서 대화 이력 조회
• 이전 질문/응답 컨텍스트 참조 가능

신규 페이지 (4개)​

컨테이너 비용 분석​

ECS와 EKS 컨테이너 비용을 분석하는 2개 페이지와 API를 추가했습니다.

AI 라우팅 개선​

보안 강화​

AgentCore 대시보드 (/agentcore)​

Bedrock AgentCore Runtime과 8개 Gateway의 상태를 한눈에 파악할 수 있는 전용 대시보드입니다.

• Runtime 상태: data/config.json의 agentRuntimeArn으로 상태 조회
• 8 Gateway 카드: 각 Gateway의 상태, 도구 수, 주요 기능 표시
• 125 도구 전체 목록: 검색, Gateway별 필터 지원
• 아키텍처 다이어그램: Runtime → Gateway → Lambda 관계 시각화

Sign Out 기능​

Header에 로그아웃 버튼을 추가하여 Cognito 세션을 안전하게 종료합니다.

CloudWatch 메트릭 테이블 (4개 서비스)​

4개 서비스에 대해 전용 API 라우트와 CloudWatch 메트릭 테이블을 추가했습니다. 모두 동일한 패턴(cloudwatch get-metric-data → 프로그레스 바 + 수치)을 사용합니다.

Resource Inventory (PR #1)​

/inventory 페이지에서 18종 리소스 수량 추이를 모니터링합니다.

• 멀티라인 차트: 리소스별 수량 변화 시계열
• 비용 영향 추정: 리소스 변화에 따른 예상 비용 표시
• src/lib/resource-inventory.ts: 스냅샷 기반 (data/inventory/), 추가 쿼리 0건
• Cost Explorer 가용성: checkCostAvailability()로 MSP Payer 자동 판별

S3 / RDS / ElastiCache 강화​

Monitoring 강화​

• 인스턴스 상세 메트릭 뷰: Date Range 선택 (1h ~ 30d)
• Resource Topology: Graph/Map View 전환 (React Flow)

멀티 라우트 AI 아키텍처​

복합 질문을 분석하여 최대 3개 Gateway를 동시에 호출하고, Bedrock이 응답을 합성합니다.

대시보드 전면 재설계​

18개 카드를 6x3 레이아웃으로 배치하고, 사이드바 메뉴와 1:1 매핑했습니다.

• 카드 하단 sub-metrics: 18 running · 4 stopped 형태로 핵심 수치 표시
• CIS Compliance Pass Rate: 전체 벤치마크 통과율 게이지
• Monthly Cost: 이번 달 비용 + MoM 변화율
• Resource Distribution + K8s Pod Status: Recharts 차트로 시각화

SSE 스트리밍 AI 응답​

AI 응답을 실시간으로 스트리밍하여 UX를 개선했습니다.

• status 이벤트: 분석 중 → Gateway 연결 → 도구 호출 단계 표시
• chunk 이벤트: 응답 텍스트 실시간 전송
• done 이벤트: 최종 결과 + 사용된 도구 + 응답 시간 + 토큰 수
• 응답 시간 표시, 클립보드 복사, 연관 추천 질문 기능 추가

신규 페이지 (3개)​

VPC & Network 강화​

• VPC Resource Map: AWS 콘솔 스타일 4컬럼 레이아웃

  VPC → Subnets → Route Tables → Connections (IGW/NAT/TGW/VPN)
  

• Route Table 탭: 서브넷 연결, 라우팅 규칙 테이블
• TGW Route Tables: Transit Gateway 라우트 테이블 상세
• Resource Topology: React Flow 기반 Graph View / Map View 전환

EKS & Cost 강화​

EKS 개선:

• K8s Overview 노드 카드: CPU/Memory 프로그레스 바
• 노드 상세: ENI 카드 + per-ENI 트래픽 + Pods 테이블
• EKS Explorer: Status/Node 필터, 페이지네이션

Cost Explorer 개선:

• 기간/서비스 필터, Projected 월말 비용, MoM Change
• Monthly Trend 라인, Cost by Service 파이 차트

Gateway 분리: Infra → Network + Container​

v1.1.0의 Infra Gateway(41개 도구)가 너무 많은 도구를 포함하고 있어, 네트워크와 컨테이너 도메인으로 분리했습니다.

배포 안정성 개선​

배포 스크립트에 에러 핸들링과 자동 감지 로직을 추가했습니다.

테스트 결과: 104/104 통과​

주요 버그 수정​

Before / After: Gateway 아키텍처​

7개 역할 기반 Gateway​

각 Gateway가 특정 도메인에 최적화된 도구 세트를 제공합니다. agent.py의 GATEWAYS 딕셔너리에서 URL을 관리합니다.

19개 Lambda 함수​

agent/lambda/ 디렉토리에서 관리되며, create_targets.py로 Gateway Target을 일괄 생성합니다.

동적 라우팅 시스템​

src/app/api/ai/route.ts에서 9단계 우선순위 키워드 기반 라우팅을 수행합니다.

• agent.py: payload.gateway 파라미터로 게이트웨이 선택
• route.ts: 9단계 우선순위 키워드 기반 라우팅
• Sonnet 인텐트 분류기 도입 (c56f557) — 키워드 미매칭 시 자연어 분석으로 최적 Gateway 선택

AI 테스트 결과​

Gateway 분리 효과를 검증하기 위해 104개 질문 테스트를 수행했습니다.

아키텍처 개요​

CloudFront에서 사용자 요청을 받아 ALB를 거쳐 EC2에서 Next.js 앱이 실행되고, Steampipe를 통해 실시간으로 AWS API를 SQL로 조회합니다.

CDK 인프라 전환​

CloudFormation YAML 템플릿에서 AWS CDK TypeScript로 전환하여 인프라를 코드로 관리합니다.

Cognito 인증​

AWS Cognito를 활용한 사용자 인증 시스템을 구축했습니다.

• Lambda@Edge (Python 3.12, us-east-1) — CloudFront viewer-request에서 JWT 검증
• OAuth2 Authorization Code flow로 안전한 인증
• 07-setup-cloudfront-auth.sh 스크립트로 자동 설정

AgentCore Runtime + Gateway​

Amazon Bedrock AgentCore를 활용한 AI 에이전트 시스템입니다.

초기 대시보드​

• Recharts 메트릭 시각화 — CPU, Memory, Network 트렌드
• React Flow 네트워크 토폴로지 — VPC, Subnet, Route Table 관계 표현
• CIS 컴플라이언스 — v1.5 ~ v4.0 벤치마크 자동 검사 (Steampipe aws_compliance 테이블)
• AI 라우팅 — Code Interpreter → AgentCore → Steampipe+Bedrock → Bedrock Direct

Claude Code 스캐폴딩​

개발 생산성 향상을 위한 Claude Code 통합 환경을 구성했습니다.

• Module CLAUDE.md — 각 디렉토리별 컨텍스트 문서 (src/lib/CLAUDE.md, src/app/CLAUDE.md 등)
• Auto-Sync Rules — 코드 변경 시 문서 자동 동기화 규칙
• .claude/hooks/check-doc-sync.sh — 문서 동기화 검증 훅