Vercel CLI 업데이트: vercel alerts --ai로 anomaly alert와 AI investigation results 확인하기

 

Vercel CLI 업데이트: vercel alerts --ai로 이상 징후와 AI 조사 결과 확인하기

터미널에서 anomaly alert와 AI investigation results를 읽는 새 운영 흐름

 

Vercel CLI 업데이트에서 먼저 볼 점

 

vercel alerts --ai anomaly alert AI investigation results라는 긴 검색어가 가리키는 기능은 Vercel CLI에서 이상 징후 알림과 AI 조사 결과를 함께 읽는 조회 흐름입니다. Vercel은 2026년 5월 21일 공식 changelog에서 이 명령과 `--ai` 옵션을 공개했습니다.

Vercel로 Next.js 앱이나 AI 기능을 운영하다 보면 문제가 꼭 대시보드를 보고 있을 때만 생기지는 않습니다. 함수 호출이 갑자기 늘거나, 5xx가 튀거나, 데이터 전송량이 비정상적으로 증가했을 때 먼저 필요한 것은 긴 설명보다 바로 확인할 운영 단서입니다.

Vercel은 그 단서를 CLI 쪽으로 가져옵니다. `vercel alerts`로 alert 목록과 상세 정보를 보고, `--ai` 옵션을 붙이면 가능한 경우 AI investigation results까지 터미널에서 이어서 확인합니다. 그래서 볼 부분은 세 가지입니다. 어떤 조건에서 쓸 수 있는지, 첫 테스트를 어디까지 해야 하는지, AI 조사 결과를 운영 판단에 어느 정도 반영할지입니다.

제가 보기에는 이 기능을 'AI가 장애를 고친다'로 읽으면 빗나갑니다. 더 현실적인 변화는 운영자가 보던 알림, 로그, metrics, 최근 배포 변경점을 CLI와 agent 흐름 안으로 당겨오는 쪽에 가깝습니다.

 

 

alert 목록 옆에 붙는 AI 조사 결과

 

기본 `vercel alerts`는 linked project, 특정 project, 또는 team 범위의 최근 alert를 보여주고, `--ai`를 붙이면 가능한 경우 조사 요약과 key findings를 함께 출력합니다. 이 기능은 자동 수정이 아니라 운영자가 확인할 조사 자료를 터미널에 가져오는 방식입니다.

`vercel alerts`의 기본 동작은 현재 연결된 프로젝트의 최근 24시간 alert를 읽는 것입니다. 필요하면 `--project`로 특정 프로젝트를 지정하거나, team scope에서 `--all`로 팀 전체 alert를 조회할 수 있습니다. 운영 중인 프로젝트가 여러 개인 팀이라면 이 scope 차이를 먼저 확인해야 합니다.

`--ai` 옵션을 붙이면 일반 table 출력 대신 AI investigation sections가 표시됩니다. 문서 기준으로 가능한 경우 alert title, resolved time, summary, key findings 같은 조사 정보가 함께 나옵니다. `vercel alerts --ai anomaly alert AI investigation results`를 찾는 독자라면, 'alert가 왜 발생했는지 추정하는 AI 조사 단서가 CLI에 붙는다'고 이해하면 충분합니다.

다만 여기서 선을 그어야 합니다. AI investigation results는 원인 확정 판결문이 아닙니다. Vercel 문서는 조사 결과가 logs와 metrics 주변 정보를 바탕으로 단서를 제공하는 성격이라고 설명하므로, 실제 조치는 route별 오류율, 최근 deployment, traffic spike, function duration 등을 다시 대조한 뒤 결정하는 편이 맞습니다.

 

타임라인: anomaly alerts에서 CLI AI 조사까지

 

2026년 5월 21일 `vercel alerts`와 `--ai` 공개는 anomaly alerts, alert rules, Agent Investigation, CLI metrics 조회가 이어진 뒤 나온 업데이트입니다. Vercel이 운영 관찰 데이터를 대시보드 밖, 특히 터미널과 coding agent 쪽으로 옮기고 있다는 점이 보입니다.

날짜를 놓고 보면 흐름이 더 잘 보입니다. 단일 명령 하나가 추가됐다기보다, Vercel이 alert와 metrics, AI 조사를 같은 운영 흐름으로 묶는 과정에 가깝습니다.

날짜	변화	실무 의미
2025-10-31	Vercel Agent Investigations Public Beta 발표	anomaly alert와 AI 기반 incident response 연결
2026-04-10	anomaly alert rules 구성 공개	project, metric, route, status code 기준 조정
2026-04-13	anomaly alerts 일반 제공 공지	usage anomaly와 error anomaly를 dashboard, email, Slack, webhook으로 수신
2026-05-05	`vercel metrics` 공개	Observability Plus metrics를 CLI에서 조회
2026-05-21	`vercel alerts`와 `--ai` 공개	alert와 AI investigation results를 CLI에서 확인

한국 사용자 입장에서는 이 순서가 꽤 중요합니다. Vercel은 단순 호스팅 플랫폼을 넘어, Next.js와 AI 앱을 운영하는 작은 팀이 alert, metrics, AI 조사 결과를 같은 터미널 흐름에서 다루도록 기능을 붙이고 있습니다. 이미 Slack 알림을 받고 있던 팀이라면 담당자가 대시보드를 열기 전에 `vercel alerts --ai`로 첫 triage를 시작하는 그림이 나옵니다.

 

 

설치와 첫 테스트: 터미널에서 확인하는 최소 절차

 

처음에는 Vercel CLI를 최신으로 설치한 뒤 로그인, 프로젝트 연결, `vercel alerts`, `vercel alerts --ai` 순서로 읽기 전용 확인부터 하는 것이 안전합니다. 자동화가 필요할 때만 `--format json`을 별도 단계로 붙이는 편이 좋습니다.

첫 테스트의 목표는 production 상태를 바꾸는 것이 아닙니다. 현재 계정과 프로젝트에서 alert를 읽을 권한이 있는지 확인하는 일부터 시작하는 편이 좋습니다.

1. `pnpm i -g vercel@latest`로 Vercel CLI를 최신 상태로 맞춥니다.
2. `vercel --version`으로 설치 상태를 확인합니다.
3. `vercel login`으로 로컬 환경을 인증합니다.
4. 프로젝트 디렉터리에서 필요하면 `vercel link`로 linked project를 맞춥니다.
5. `vercel alerts`로 최근 alert가 읽히는지 확인합니다.
6. `vercel alerts --ai`로 AI investigation results가 붙는지 확인합니다.
7. 스크립트나 runbook에 넣을 때만 `vercel alerts --format json`을 검토합니다.

실제로 확인할 부분은 명령 자체보다 scope입니다. 기본값은 linked project 기준이므로, 여러 Vercel 프로젝트를 오가는 로컬 폴더라면 먼저 `vercel link` 상태를 확인하는 편이 안전합니다. 팀 단위로 보려면 `--all`을 쓰지만, 문서상 team scope가 필요하고 특정 프로젝트 조회용 `--project`와는 목적이 다릅니다.

시간 범위를 줄이고 싶다면 `--since`와 `--until`에 ISO 8601 timestamp를 넣어 조사 구간을 좁힙니다. 예를 들어 특정 장애 창만 보려면 `vercel alerts --ai --since 2026-03-01T00:00:00.000Z --until 2026-03-02T00:00:00.000Z`처럼 고정된 구간으로 확인하는 방식이 runbook에 더 잘 맞습니다.

 

운영 모델: 장애·비용·성능 이상 대응에 넣는 방법

 

실무에서는 Slack이나 webhook으로 이상을 받고, 담당자나 coding agent가 `vercel alerts --ai`로 최근 alert와 조사 결과를 조회한 뒤 logs, metrics, deployment diff로 재검증하는 흐름이 적합합니다. 이때 AI 요약은 출발점이지 최종 결론이 아닙니다.

제가 권하고 싶은 운영 흐름은 복잡하지 않습니다. 먼저 Vercel Alerts에서 usage anomaly와 error anomaly를 팀이 실제로 보는 채널로 보냅니다. alert가 오면 담당자는 터미널에서 `vercel alerts`로 최근 발생 목록을 확인하고, 같은 구간에 대해 `vercel alerts --ai`로 조사 결과를 읽습니다.

그다음이 중요합니다. AI 조사 결과에 summary와 key findings가 보이더라도 바로 rollback이나 설정 변경을 하면 안 됩니다. `vercel metrics`나 Observability 화면에서 Function duration, Function CPU duration, Edge requests, Function invocations, Fast Data Transfer 같은 지표를 함께 확인해야 합니다. 최근 배포가 있었다면 deployment diff와 route별 5xx 증가도 같이 봐야 합니다.

> 이 기능의 실무 가치는 '정답을 대신 내는 AI'보다 'alert를 보고 다음에 확인할 로그와 metrics를 빨리 좁히는 CLI 단서'에 있습니다.

AI API를 쓰는 서비스라면 비용 이상이 특히 민감합니다. 갑작스러운 request 증가가 모델 호출량, serverless function duration, edge traffic에 같이 영향을 줄 수 있기 때문입니다. 그래서 `vercel alerts --ai anomaly alert AI investigation results`를 운영 runbook에 넣는다면, 비용 확인 단계와 rate limiting 또는 abuse 대응 체크를 옆에 두는 편이 좋습니다.

 

 

 

추천 적용 대상과 함께 쓰기 좋은 도구

 

이 업데이트는 Vercel에서 운영 중인 Next.js, AI Gateway, serverless 함수 기반 서비스처럼 request volume, error rate, function duration, data transfer 이상이 비용이나 사용자 경험에 직접 영향을 주는 프로젝트에 잘 맞습니다. 함께 볼 도구는 `vercel metrics`, Vercel Alerts Slack/webhook, Observability Plus, Agent Investigation입니다.

작은 팀에서 가장 먼저 체감할 장점은 화면 전환이 줄어든다는 점입니다. Slack에서 alert를 보고, 터미널에서 `vercel alerts --ai`를 실행하고, 이어서 metrics와 로그를 확인하는 식으로 한 사람이 초기 판단을 내릴 수 있습니다. coding agent를 쓰는 팀이라면 JSON 출력과 alert summary를 agent 작업 컨텍스트로 넘기는 방식도 생각해볼 만합니다.

잘 맞는 프로젝트는 꽤 분명합니다.

• Vercel에 배포된 Next.js 또는 full-stack 웹 앱
• Vercel AI Gateway나 serverless functions로 AI 기능을 운영하는 서비스
• 5xx 증가, Function duration, Edge requests, Fast Data Transfer가 비용이나 UX에 바로 영향을 주는 앱
• Slack/webhook 알림은 있지만, 터미널 기반 triage 단계가 약한 팀
• 작은 운영팀이 coding agent에게 alert context를 넘기고 싶은 워크플로

함께 쓰기 좋은 것은 `vercel metrics`입니다. alert는 '무엇이 이상한가'를 알려주고, metrics는 '얼마나, 어느 구간에서, 어떤 지표가 움직였나'를 좁히는 역할을 합니다. Observability Plus는 이 데이터의 retention과 advanced filtering 전제를 제공하고, Agent Investigation은 AI 조사 결과가 만들어지는 쪽의 설정과 비용 조건을 설명합니다.

 

도입 전 확인할 조건: Observability Plus, 권한, credits

 

공식 changelog는 CLI alert 기능이 Observability Plus에서 제공된다고 설명합니다. Agent Investigation까지 쓰려면 설정과 credits 조건이 있으므로 모든 Vercel 팀에서 바로 쓸 수 있다고 단정하면 안 됩니다.

다만 이 기능은 플랜과 권한 전제가 있습니다. 공식 changelog는 CLI alert 기능을 Observability Plus에서 제공한다고 설명합니다. Observability Plus 자체도 Pro와 Enterprise 팀을 위한 optional paid upgrade로 안내됩니다.

권한도 확인해야 합니다. Alerts 문서는 Alerts 기능에 Alerts 권한이 필요하다고 설명합니다. Agent Investigation 문서에는 investigation을 사용하기 위한 조건과 credits 관련 내용이 따로 정리되어 있습니다. 자동 조사를 켜려면 team settings에서 Vercel Agent의 Investigations toggle을 별도로 enable해야 하며, code review용 Agent 활성화만으로 자동 실행되는 구조는 아닙니다.

가격 정보는 발행일 기준 문서 확인이 필요합니다. 2026년 5월 24일 기준 브리프에 정리된 Observability Plus 문서 값은 Pro base fee 월 10달러, usage-based pricing 1 million events당 1.20달러입니다. 이런 금액은 플랫폼 정책에 따라 바뀔 수 있으므로 실제 도입 전에는 Observability Plus 공식 문서를 다시 확인하는 편이 낫습니다.

 

 

 

건너뛰어도 되는 경우

 

Vercel에서 운영하지 않거나 Observability Plus를 쓸 계획이 없거나, 외부 APM과 SRE 체계가 이미 더 강하게 자리 잡은 팀이라면 이 기능을 메인 운영 도구로 추천하기 어렵습니다. 대규모 팀에서는 `--all` 사용 전 team scope를 반드시 확인해야 합니다.

모든 팀이 새 CLI 조회 흐름을 바로 도입할 필요는 없습니다. 취미 프로젝트처럼 트래픽이 작고 alert 자체가 거의 없다면 dashboard 확인만으로도 충분합니다. 반대로 대규모 조직에서 이미 Datadog, New Relic, Grafana, PagerDuty 같은 외부 관측성과 on-call 체계를 운영한다면, `vercel alerts --ai`는 보조 확인 도구에 가깝습니다.

또 하나의 skip 조건은 비용과 검증 문화입니다. Agent Investigation credits를 관리할 준비가 없거나, AI 조사 결과를 비판적으로 읽을 운영 습관이 없다면 자동 조사를 먼저 켜기보다 수동 조회부터 시작하는 편이 낫습니다. JSON 자동화도 마찬가지입니다. `--format json`은 runbook과 agent workflow에 유용하지만, 문서화되지 않은 payload 세부 구조에 강하게 의존하는 자동화는 피해야 합니다.

`vercel alerts --ai anomaly alert AI investigation results`라는 긴 키워드로 들어온 독자에게 제가 주고 싶은 결론은 이렇습니다. Vercel 위에서 실제 production AI 앱을 운영하고 있고, alert를 본 뒤 다음 확인 지점을 줄이고 싶다면 테스트할 가치가 있습니다. 하지만 Vercel 밖의 multi-cloud tracing, 엄격한 SLO, 감사 로그, on-call escalation까지 대체하는 도구로 보면 기대치가 과합니다.

 

자주 묻는 질문

 

Q. vercel alerts --ai는 일반 vercel alerts와 무엇이 다른가?
A. 일반 `vercel alerts`는 최근 anomaly alert 목록과 상세 정보를 CLI에서 확인하는 명령입니다. `--ai`를 붙이면 가능한 경우 AI investigation results가 함께 표시되어 summary와 key findings를 터미널에서 읽을 수 있습니다. 다만 이는 자동 수정 기능이 아니라 triage 자료입니다.

Q. vercel alerts --ai는 어떤 정보를 터미널에 보여주나?
A. 공식 문서 기준으로 alert title, resolved time, summary, key findings 같은 AI investigation sections가 가능한 경우 표시됩니다. 기본 alert 조회 자체는 시작 시각, 유형, 활성 상태 같은 alert 정보를 확인하는 흐름입니다.

Q. Vercel anomaly alert AI investigation results는 어떤 플랜에서 사용할 수 있나?
A. 2026년 5월 21일 공식 changelog는 이 CLI alert 기능이 Observability Plus에서 제공된다고 설명합니다. Agent Investigation까지 활용하려면 Observability Plus subscription, 관련 권한, investigation credits 조건을 함께 확인해야 합니다.

Q. Agent Investigation 자동 실행과 vercel alerts --ai 조회는 같은 기능인가?
A. 같게 보면 안 됩니다. `vercel alerts --ai`는 CLI에서 조사 결과를 확인하는 조회 흐름이고, 자동 Agent Investigation은 team settings에서 Investigations toggle을 별도로 켜야 하는 설정입니다. code review용 Vercel Agent 활성화만으로 자동 조사가 켜지는 구조는 아닙니다.

Q. vercel alerts --format json은 어떤 자동화에 쓸 수 있나?
A. runbook, 내부 dashboard, incident bot, coding agent context 전달처럼 machine-readable alert payload가 필요한 곳에 쓸 수 있습니다. 다만 문서가 보장하지 않는 세부 payload 구조에 강하게 묶인 자동화는 피하고, `--since`, `--until`, `--limit`, `--type`으로 범위를 제한하는 편이 안전합니다.

Q. AI investigation results를 그대로 믿어도 되나?
A. 그대로 확정 원인으로 받아들이면 위험합니다. AI 조사 결과는 logs와 metrics 주변 정보를 바탕으로 만든 운영 단서이므로, 최근 deployment, route별 error rate, traffic 변화, Function duration, Edge requests 같은 실제 지표와 대조해야 합니다.

Q. 팀 전체 alert와 특정 프로젝트 alert는 어떻게 구분해서 보나?
A. 기본 실행은 linked project의 최근 alert를 봅니다. 특정 프로젝트는 `vercel alerts --project my-app`, 팀 전체는 team scope에서 `vercel alerts --all`을 사용합니다. 큰 팀에서는 `--all` 실행 전 현재 team scope를 먼저 확인하는 것이 좋습니다.

Q. 어떤 팀은 이 기능을 건너뛰는 것이 나은가?
A. Vercel에 production 서비스를 운영하지 않거나 Observability Plus를 쓸 계획이 없는 팀은 우선순위가 낮습니다. 이미 외부 APM, on-call, SLO, 감사 로그 체계가 강하게 갖춰진 조직이라면 `vercel alerts --ai`는 메인 도구보다 Vercel 프로젝트 보조 확인 도구로 보는 편이 현실적입니다.

함께 읽으면 좋은 글

 

• Cloudflare AI Gateway REST API 공개: OpenAI·Anthropic 모델을 한 엔드포인트로 호출하기 — AI UPDATES
• OpenAI Codex 업데이트 정리: Goal mode와 Appshots로 바뀌는 개발 방식 — AI UPDATES
• Claude Code 2.1.144 업데이트: 백그라운드 세션 /resume와 모델 설정 변화 — AI UPDATES
• GitHub Copilot Auto 모델 선택: VS Code에서 작업별 모델 라우팅이 시작됐다 — AI UPDATES
• Cursor Composer 2.5 출시: AI 코딩 모델 성능과 가격 변화 핵심 정리 — AI UPDATES

참조 링크

 

• Pull anomaly alert details using the Vercel CLI — 2026년 5월 21일 업데이트의 원 공지이며 vercel alerts, --ai, AI investigation results, Observability Plus 제공 조건을 직접 설명한다.
• vercel alerts — CLI 사용법과 --project, --all, --type, --ai, --since, --until, --limit, --format json 옵션을 검증하는 공식 문서다.
• Vercel CLI — Vercel CLI 설치, 로그인, 프로젝트 연결 흐름을 확인하기 위한 공식 문서다.
• Alerts — anomaly alert 유형, 감지 기준, 권한, Slack/webhook/email 흐름을 확인하기 위한 공식 문서다.
• Investigation — AI investigation의 전제 조건, 자동 실행 설정, 결과 확인 방식, credits 구조를 검증하는 공식 문서다.
• Observability Plus — Observability Plus의 add-on 전제, retention, pricing, limits를 확인하기 위한 공식 문서다.
• Anomaly alerts are now generally available — anomaly alerts의 GA와 usage anomaly/error anomaly 배경을 확인하기 위한 자료다.
• Anomaly alert configuration now available — alert rules 구성 공개와 project, metric, route, status code 기준 조정 배경을 설명한다.
• Query observability metrics using the Vercel CLI — vercel alerts 이후 metrics 확인을 CLI에서 이어가는 운영 흐름의 근거다.
• Vercel Agent can now run AI investigations — Agent Investigation과 anomaly alerts를 결합한 incident response 방향을 이해하는 배경 자료다.