AI 위젯 · CloudPeek 문서

작동 방식

AI 모델은 CloudWatch 대시보드가 이미 사용하는 형식으로 위젯을 작성하므로, CloudPeek은 다른 대시보드 위젯처럼 위젯을 쿼리하고 그릴 수 있으며, 위젯을 대시보드에 붙여 넣을 수도 있습니다.

모델이 지표를 조회합니다. 계정의 지표 목록을 가져와(CloudWatch ListMetrics) 실제 네임스페이스, 지표, 차원, 리소스 이름을 사용합니다.
모델이 위젯을 작성하고 CloudPeek이 확인합니다. CloudPeek이 계정에서 위젯의 데이터를 로드합니다. 쿼리가 실패하거나 아무것도 찾지 못하면 모델에 이유를 알려 주고 모델이 다시 시도하며, 모델에 대한 요청은 모두 합쳐 최대 8회입니다.
사용자가 확인합니다. 미리보기에서 모든 크기로 위젯을 보여 주며, 모델이 남긴 메모가 있으면 함께 표시합니다. 원하면 이름을 바꾸거나 다른 리전에서 표시한 다음 추가하세요.

추가된 AI 위젯은 모델 없이 다른 위젯처럼 새로고침됩니다.

위젯 작성

위젯 탭에서 위젯 만들기를 탭하고 계정을 선택한 다음(계정이 하나뿐이면 이미 선택되어 있습니다) AI 생성을 선택하세요.
위젯 설명에 보고 싶은 내용을 500자 이내로 입력하세요. 또는 예시 아래의 예시 중 하나를 탭하세요. 예시는 CloudPeek이 계정에 지표가 있는 서비스를 파악하고 나면(프리셋에서처럼) 해당 서비스에 맞게 표시됩니다.
생성을 탭하세요. CloudPeek이 AWS/Lambda 지표를 살펴보는 중… 또는 “…” 위젯이 로드되는지 확인하는 중…처럼 진행 상황을 알려 줍니다. 중단을 탭하면 취소됩니다.
미리보기를 확인하고, 원하면 제목이나 리전을 변경한 다음 위젯 추가를 탭하세요.

모델은 계정의 기본 리전에서 지표를 찾으며, 작성한 위젯은 다른 리전을 지정하지 않는 한 그 리전을 표시합니다. 리소스가 다른 리전에 있으면 미리보기의 리전에서 해당 리전을 선택하세요. 그러면 그 리전에서 위젯의 데이터를 로드합니다. 지표마다 자체 리전을 지정한 위젯에는 선택할 리전이 없습니다. 위젯은 추가된 리전을 유지하며, 그 리전이 위젯 아래에 표시됩니다.

모델이 작성한 각 위젯의 제목 옆에는 위젯 탭에서, 그리고 홈 화면 위젯으로 연 위젯 자체 화면에서 AI 배지가 표시됩니다.

편집한 설명으로 AI 위젯을 다시 작성하려면 위젯의 더 보기(⋯) 메뉴나 위젯 자체 화면에서 설명 편집을 선택하거나, 편집을 선택하고 설명 아래의 설명 편집을 탭하세요. 위젯 만들기가 위젯의 설명이 입력된 상태로 열립니다. 설명을 변경하고 생성을 다시 탭한 다음 위젯 업데이트를 탭하면 기존 위젯이 같은 자리에서 대체되므로, 이 위젯을 표시하는 홈 화면 위젯도 그대로 유지됩니다. 변경할 부분만 설명하려면 대신 AI로 변경을 사용하세요(위젯 변경 참조). 편집에서 저장하면 작성된 내용은 그대로 두고 제목, 리전 또는 시간 범위만 변경됩니다(위젯 편집하기 참조).

Anthropic API를 사용하면 처음 생성을 탭할 때 먼저 Anthropic과 공유하겠습니까?를 묻습니다. 모델이 보는 정보를 참조하세요. Amazon Bedrock은 내 AWS 계정에서 실행되므로 묻지 않습니다.

위젯 변경

위젯 탭의 그래프나 숫자는 프리셋이든 대시보드 위젯이든 AI 위젯이든 변경 사항을 설명하여 변경할 수 있습니다. 예: “하나의 숫자로 표시”, “checkout 함수만”, “지난 7일 표시”, “초당 대신 분당으로”. 모델에는 지정한 제목, 리전, 시간 범위를 포함하여 현재 표시되는 그대로의 위젯이 전달되며, 모델은 변경 사항과 관계없는 부분은 그대로 유지합니다.

위젯 탭에서 위젯 아래의 더 보기 버튼(⋯)을 탭하거나 위젯 자체 화면을 여세요.
AI로 변경을 선택하세요. 현재 상태의 위젯이 상단에 표시됩니다.
변경 사항 설명에 변경할 내용을 500자 이내로 입력하세요. 또는 예시 아래의 예시 중 하나를 탭하세요.
생성을 탭하세요. 위젯을 작성할 때처럼 CloudPeek이 진행 상황을 알려 주며, 중단을 탭하면 취소됩니다.
미리보기를 확인하고, 원하면 제목이나 리전을 변경하세요.
두 위젯을 모두 유지하려면 새 위젯으로 추가를, 변경된 위젯으로 원래 위젯을 대체하려면 교체를 탭하세요.

결과: 변경된 위젯이 AI 배지와 함께 위젯 탭에 표시됩니다. 새 위젯으로 추가는 위젯을 맨 아래에 추가하고 원래 위젯은 그대로 둡니다. 교체는 원래 위젯의 자리에 넣으며, 원래 위젯을 표시하던 홈 화면 위젯(iPhone 및 iPad에서는 잠금 화면 위젯도)에 변경된 위젯이 표시됩니다.

이 방법으로 교체한 대시보드 위젯은 더 이상 대시보드를 따르지 않고, 프리셋은 CloudPeek이 프리셋을 업데이트해도 더 이상 바뀌지 않습니다. 둘 다 AI 위젯이 됩니다. 선택하기 전에 미리보기에서 이를 알려 줍니다.
원래 위젯에 지정한 경고 및 경보 수준은 모델에 전송되지 않습니다. 미리보기는 표시할 수 있는 경우 수준에서 이 수준을 그대로 가져와 시작하므로, 초당 대신 분당처럼 변경으로 단위가 달라지면 수준을 확인하세요(경고 및 경보 수준 참조).
변경된 위젯의 설명(편집 아래)은 원래 위젯의 내용(AI 위젯의 설명 또는 다른 위젯의 제목) 뒤에 “변경 사항:”과 입력한 변경 내용이 붙은 형태이므로, 설명 편집으로 이 설명을 바탕으로 위젯을 다시 작성할 수 있습니다.
모델은 지표 위젯만 작성하므로 경보 목록과 텍스트 위젯에서는 AI로 변경을 사용할 수 없으며, AWS 계정이 CloudPeek에 없는 위젯에서도 사용할 수 없습니다.
비용은 위젯을 작성할 때와 같고, 모델이 보는 정보에 나열된 내용을 전송하며, Anthropic API를 사용하면 같은 방식으로 먼저 Anthropic과 공유하겠습니까?를 묻습니다.

원하는 내용 설명하기

서비스와 지표를 지정하세요: “내 함수는 괜찮나요?”보다 “지난 하루 동안 Lambda 함수별 오류”가 더 잘 작동합니다.
중요하다면 표시 방법을 지정하세요: “EC2 평균 CPU를 게이지로”, “… 표로”, “… 숫자로”. 지표별이 아니라 일별 또는 시간별 표를 원하면 그렇게 지정하세요: “지난 7일간의 지출 표, 하루에 한 행”.
지난 3시간이 아니라면 시간 범위를 지정하세요: “이번 주 DynamoDB 읽기 및 쓰기 스로틀링”.
범위를 좁히려면 리소스 이름을 지정하세요: “checkout API의 p99 지연 시간”.

모델은 지표 위젯(선, 누적 영역, 막대, 파이, 숫자, 게이지, 표)을 작성하며, 도움이 되는 경우 지표 수학과 SEARCH를 사용합니다. 경보 목록이나 텍스트 위젯은 작성하지 않습니다. 경보에는 경보 프리셋이나 대시보드를 사용하세요.

모델 실행 위치 선택

CloudPeek의 설정에서 AI 위젯 아래의 서비스를 선택하세요.

서비스	모델	요금 청구 대상	필요한 항목
Amazon Bedrock(기본값)	Kimi K2.5(Moonshot AI)	위젯이 속한 AWS 계정. 요청은 기기에서 해당 계정의 로그인 정보로 서명됩니다.	CloudPeek 정책에 포함된 `bedrock:InvokeModel`. Bedrock에서 활성화하거나 가입할 것은 없습니다.
Anthropic API	모델에서 선택: Claude Sonnet 5.5(기본값), Claude Opus 5.5 또는 Claude Haiku 5.5	내 Anthropic 계정	Anthropic API 키: API 키에 붙여 넣고 API 키 저장을 탭하세요. 추가 AWS 권한은 필요 없습니다.

Claude Sonnet 5.5는 CloudWatch의 지표 수학과 SEARCH 구문을 안정적으로 다루며, 휴대폰에서 기다릴 만큼 빠릅니다. Claude Opus 5.5는 가장 성능이 뛰어나지만 가격이 약 두 배이고, Claude Haiku 5.5는 가장 빠르고 저렴합니다.
Anthropic API 키는 이 기기에 보관됩니다. iOS에서는 키체인에, Android에서는 Android Keystore의 키로 암호화되어 저장되며, Anthropic에만 전송됩니다. API 키 제거를 탭하면 삭제됩니다.

리전 및 권한

Amazon Bedrock에서 CloudPeek은 계정의 기본 리전에서 Bedrock이 Kimi K2.5를 제공하면 그 리전에서, 그렇지 않으면 가까운 고정 리전에서 Kimi K2.5를 호출합니다.

계정의 기본 리전	모델이 실행되는 리전
`us-east-1`, `us-east-2`, `us-west-2`, `eu-west-2`, `eu-north-1`, `ap-northeast-1`, `ap-south-1`, `ap-southeast-2`, `sa-east-1`	같은 리전
그 밖의 모든 유럽(`eu-`), 중동(`me-`, `il-`) 또는 아프리카(`af-`) 리전	`eu-north-1`(스톡홀름)
그 밖의 `ap-northeast-` 및 `ap-east-` 리전	`ap-northeast-1`(도쿄)
그 밖의 `ap-south-` 리전	`ap-south-1`(뭄바이)
그 밖의 아시아 태평양(`ap-`) 리전	`ap-southeast-2`(시드니)
그 밖의 `us-west-` 리전	`us-west-2`(오레곤)
그 밖의 남아메리카(`sa-`) 리전	`sa-east-1`(상파울루)
그 밖의 모든 리전(예: `ca-central-1`)	`us-east-1`(버지니아 북부)
AWS 중국(`cn-`), AWS GovCloud(미국)(`us-gov-`) 및 격리 리전	사용할 수 없음: Anthropic API를 사용하세요

Moonshot AI의 모델은 AWS Marketplace를 통해 판매되지 않으므로 요청할 모델 액세스, 사용 사례 양식, 구독이 없습니다. 계정에 필요한 것은 IAM 권한뿐입니다. 단, AWS Organizations의 서비스 제어 정책으로 이 권한이 거부될 수는 있습니다.

CloudPeek의 모델만 허용

CloudPeek 정책은 Bedrock의 모든 모델을 허용합니다. CloudPeek이 사용하는 모델만 허용하려면 CloudPeek 문에서 bedrock:InvokeModel을 빼고 그 뒤에 다음 문을 추가하세요.

JSON

{
  "Sid": "CloudPeekBedrock",
  "Effect": "Allow",
  "Action": "bedrock:InvokeModel",
  "Resource": "arn:aws:bedrock:*::foundation-model/moonshotai.kimi-k2.5"
}

AI 위젯이 나오기 전에 설정했나요?

정책 또는 권한 세트에 cloudwatch:ListMetrics와 bedrock:InvokeModel을 추가하거나, 시작하기에서 업데이트된 템플릿을 배포하세요. ListMetrics가 없으면 모델은 표준 AWS 지표 이름으로 위젯을 작성하므로, 직접 만든 리소스에서는 잘 작동하지 않는 경우가 많습니다.

비용

위젯 하나에는 보통 모델에 대한 요청이 두세 번 필요합니다. Amazon Bedrock에서는 약 1센트, Claude Sonnet 5.5에서는 몇 센트입니다. 비용은 작성할 때 한 번만 지불합니다.
그 후에는 다른 위젯과 같은 새로고침 비용이 듭니다. 비용을 참조하세요.

모델이 보는 정보

생성을 탭할 때만 CloudPeek이 모델에 다음을 전송합니다.

설명, 또는 AI로 위젯을 변경할 때는 설명한 변경 사항과 위젯의 정의: 제목, 지표와 지표의 차원(리소스 이름이 포함될 수 있음), 시간 범위와 리전 같은 설정
계정의 기본 리전
모델이 계정에서 조회하는 지표의 이름과 차원. 함수나 대기열 이름 같은 리소스 이름이 포함될 수 있습니다. 보통 기본 리전에서 조회하지만 계정의 어느 리전에서나 조회할 수 있습니다.
작성하는 각 위젯에 대해 데이터를 찾았는지 여부(찾지 못한 경우 시간 범위가 시작된 날짜와 시각) 또는 CloudWatch가 반환한 오류

모델은 AWS 자격 증명, 지표 값, 대시보드를 절대 보지 않습니다.

Amazon Bedrock은 AWS와의 계약에 따라 위 표의 리전에서 내 AWS 계정 안에서 실행됩니다.
Anthropic API는 Anthropic의 개인정보 처리방침 및 Anthropic과의 계약에 따라 내 API 키로 기기에서 이 정보를 받습니다. 처음 전송하기 전에 CloudPeek이 Anthropic과 공유하겠습니까?를 묻고, 허용을 탭한 후에만 전송합니다.

권한 및 보안과 개인정보 처리방침도 참조하세요.

작동하지 않는 경우

Bedrock 권한, 리전, API 키에 관한 메시지나 모델이 로드되는 위젯을 만들지 못했다는 메시지는 문제 해결 › AI 위젯에 설명되어 있습니다.