위젯 참조

이 페이지 소개

이 페이지는 참조용입니다. CloudWatch 위젯의 종류별로 각 크기에서 어떻게 그려지는지, CloudPeek이 대시보드 JSON의 어떤 부분을 정확히 사용하는지 설명합니다. 프리셋과 AI 위젯도 같은 JSON으로 작성되므로 이 내용이 똑같이 적용됩니다. 위젯을 만들려면 위젯 만들기를 참조하세요.

위젯 만들기 내용은 이제 별도 페이지인 위젯 만들기에 있습니다.

프리셋 내용은 이제 별도 페이지인 프리셋에 있습니다.

AI 위젯 내용은 이제 별도 페이지인 AI 위젯에 있습니다.

위젯 탭 내용은 이제 홈 화면 및 잠금 화면에 포함되어 있습니다.

새로고침과 데이터 최신성 내용은 이제 CloudPeek 작동 방식에 포함되어 있습니다.

위젯 유형

모든 CloudWatch 지표 위젯 보기와 텍스트 및 경보 상태 위젯은 iPhone, iPad, Android에서 네이티브 위젯이 되며, 대시보드의 색상과 임계값, 축 한도를 그대로 사용해 그려집니다.

목록이 다 들어가지 않을 때

• 막대: 남은 막대를 합산하는 것이 의미가 있으면(통화, 또는 같은 지표의 개수와 합계) 마지막 막대가 그 합계를 나타내는 회색 기타 막대가 됩니다. 그렇지 않으면 “외 N개”가 표시됩니다. 표시되는 막대는 0에서 가장 먼 막대이며, 위젯의 수준이 미만이면 가장 낮은 막대입니다(경고 및 경보 수준 참조).
• 합계: 막대 또는 파이 위젯은 대시보드에 계정 전체의 EstimatedCharges 행이나 SUM(METRICS()) 표현식 같은 합계가 있으면 합계를 표시합니다. 이 행은 별도의 막대로 그려지지 않습니다. 막대가 여러 개인 통화 위젯은 직접 합계를 계산합니다.
• 파이: 모든 조각이 그려지며, 범례에는 들어가는 만큼 나열한 다음 “외 N개”가 표시됩니다. 합계가 조각을 모두 더한 값보다 크면 그 차이가 회색 기타 조각으로 표시됩니다.
• 선 차트와 누적 영역 차트의 범례는 중형 위젯에서 최대 4개(텍스트 크기가 크면 더 적게), 대형 위젯에서 4개의 시리즈를 각각의 최신 값과 함께 나열한 다음 “외 N개”를 표시합니다. 소형 위젯에는 범례가 없습니다.
• 표와 경보 목록은 들어가는 만큼 행을 표시한 다음 “외 N개”를 표시합니다. 기간마다 행이 있는 표는 최신 행부터 표시한 다음 “이전 N개”를 표시합니다.

크기

모든 위젯은 모든 크기로 제공됩니다. CloudPeek은 추가하기 전에 각 크기를 미리 보여 줍니다. Android에서는 홈 화면 위젯의 크기를 조절하여 크기를 선택하며, 위젯은 확보된 공간에 맞는 레이아웃을 표시합니다. 110 × 110 dp부터 소형, 250 × 110 dp부터 중형, 250 × 250 dp부터 대형입니다. 앱 4개 너비의 홈 화면에서는 각각 2 × 2, 4 × 2, 4 × 4 칸입니다.

• 소형 위젯에는 범례와 바닥글이 없습니다. 경보 위젯은 “경보 발생 1개” 같은 요약 문구를 맨 위에 표시합니다.
• 중형 이상 위젯에는 새로고침 버튼, 범례, 그리고 시간 범위와 업데이트 시간을 보여 주는 바닥글(예: “지난 3시간 · 14:05 업데이트됨”)이 추가됩니다. 경보 목록에는 각 경보가 얼마 전에 변경되었는지 표시됩니다.
• 대형 위젯에는 축 레이블이 더 많이 표시됩니다. iPad의 특대형은 공간이 더 넓은 대형 레이아웃입니다. Android에서는 각 레이아웃이 주어진 공간을 채우도록 그려집니다.
• 합계가 있는 막대 위젯은 소형 및 중형에서 자리 하나를 합계에 내줍니다.
• 들어가는 행 수는 텍스트 크기에 따라 다르며, 나머지는 “외 N개”로 표시됩니다.
• iPhone의 스탠바이는 소형 위젯을 검은색 배경에 더 크게 그려 표시하며, Mac의 데스크탑은 iPhone의 소형, 중형, 대형 위젯을 표시합니다(스탠바이 및 Mac에서 참조).

경보 목록

경보 위젯은 다음 순서로 경보를 나열하며, 각 경보의 상태를 함께 표시합니다.

• 같은 상태 안에서는 위젯에 나열된 순서를 유지하며, "sortBy": "stateUpdatedTimestamp"를 사용하면 가장 최근에 변경된 경보가 먼저 옵니다.
• 중형 이상 위젯에는 각 경보의 상태가 얼마 전에 변경되었는지 표시됩니다.
• 소형 위젯과 잠금 화면의 요약 문구는 경보가 하나라도 발생하면 빨간색 경보 발생 N개, 모두 정상이면 녹색 모두 정상, 충분한 데이터가 있는 경보가 아직 없으면 데이터 없음, 그 밖에는 데이터가 없거나 찾을 수 없는 경보 수를 세어 알 수 없음 N개로 표시됩니다.
• 경보 요약 프리셋은 대신 상태별 경보 수를 셉니다(예: “경보 발생 2개, 데이터 부족 4개, 정상 14개”). 프리셋을 참조하세요.
• 모든 계정을 아우르는 경보 프리셋은 계정마다 한 줄씩 가장 심각한 계정부터 표시하며, 각 줄에는 가장 심각한 상태의 기호가 함께 표시됩니다(예: “prod: 경보 발생 2개”). 경보 프리셋은 그 아래에 해당 계정의 정상이 아닌 경보를 나열합니다. 모든 계정의 경보를 참조하세요.

잠금 화면

iPhone 및 iPad의 잠금 화면 위젯은 대표 값 하나를 표시하므로 잠금을 해제하지 않고도 확인할 수 있습니다. Android 휴대전화에는 잠금 화면 위젯이 없습니다.

• 직사각형: 제목, 값, 그리고 값이 나온 시리즈나 막대(데이터가 오래되었으면 경고)를 표시합니다.
• 원형: 값과 제목에서 따온 약 8자의 캡션을 표시합니다.
• 시계 위의 인라인: 값과 제목을 표시하며, 제목은 약 18자 이내에서 단어 단위로 자릅니다.
• 수준: 잠금 화면은 한 가지 색으로 그려지므로, 위젯의 경고 또는 경보 수준을 넘은 값 옆에는 해당 수준의 기호가 표시됩니다(경고 및 경보 수준 참조).

개요 위젯

개요 위젯은 위젯 2~4개를 최신 값으로 표시합니다(위젯 하나에 여러 값 표시 참조). 소형 위젯에는 2개, 중형 이상에는 4개가 표시되며, iPhone 및 iPad의 잠금 화면에는 첫 번째 위젯이 표시됩니다.

• 값은 위 표에 나온 각 위젯의 잠금 화면 대표 값입니다. 경보 위젯과 경보 요약 프리셋은 요약 문구를 표시합니다. 예를 들어 빨간색 삼각형과 함께 빨간색 “경보 발생 1개”, 녹색 체크 표시와 함께 녹색 “모두 정상”, 경보가 없으면 “경보 없음”을 표시합니다. 모든 계정을 아우르는 경보 위젯은 대신 확인이 필요한 가장 심각한 계정의 줄을 표시하므로(예: “prod: 경보 발생 2개” 또는 “dev: 로그인하여 새로고침”), 읽을 수 없었던 계정이 다른 계정의 “모두 정상” 뒤에 가려지지 않습니다.
• 수준: 위젯 자체와 마찬가지로, 위젯의 경고 수준을 넘은 값은 원 안에 “!”가 있는 주황색으로, 경보 수준을 넘은 값은 삼각형이 있는 빨간색으로 표시됩니다(경고 및 경보 수준 참조). 수준과 비교하는 것은 표시된 값입니다. 단, 수준과 비교하지 않는 막대 합계는 막대들이 넘은 수준 중 가장 나쁜 수준을 따릅니다.
• 추세는 “+12%”처럼 화살표와 백분율로 표시되며, 이전 데이터 포인트 이후 값이 얼마나 변했는지 나타냅니다. 추세를 표시하는 숫자 위젯, 게이지, 선 또는 누적 영역 그래프에 표시됩니다. 막대, 파이, 표, 경보, 열로 그려지는 그래프에는 추세가 없습니다. 열은 대개 오늘의 지금까지 지출처럼 아직 진행 중인 기간이기 때문입니다.
• 텍스트 위젯은 값이 없으므로 개요 위젯에서 선택할 수 없습니다.
• 새로고침할 수 없었던 위젯은 마지막 값을 유지하고 추세 대신 이유를 주황색으로 표시합니다(예: “로그인하여 새로고침”, “계정이 추가되지 않음”, “14:05 이후 업데이트되지 않음”). 유지할 값이 없으면 “액세스 거부됨”, “AWS에 연결할 수 없음” 등을 표시합니다. 하루 이상 지난 데이터는 흐리게 표시됩니다.

CloudPeek이 사용하는 대시보드 설정

CloudPeek은 대시보드 JSON을 읽고 CloudWatch 콘솔과 같은 방식으로 쿼리합니다. 프리셋과 AI 위젯도 같은 JSON으로 작성되므로 아래 내용이 모두 똑같이 적용됩니다.

지원되는 항목

• 지표: "." 및 "..." 약식 표기를 사용하는 지표 행, 지표 수학, SEARCH 및 Metrics Insights(SELECT … FROM SCHEMA(…)) 표현식, 그리지 않을 입력에 대한 "visible": false.
• 지표별: id, label(${PROP('Dim.ServiceName')}, ${LAST} 같은 동적 레이블 포함), color, stat, period, region, accountId, yAxis.
• 위젯별: title, view, stacked, stat(설정하지 않으면 Average), period, region, accountId, start, end, setPeriodToTimeRange, sparkline, trend, 양쪽 Y축의 min 및 max, 수평 annotations(값, 색상, 축, visible), "legend": {"position": "hidden"}.
• 오른쪽 Y축: "yAxis": "right"가 설정된 지표는 별도의 눈금으로 그려지며, 레이블은 오른쪽에 표시됩니다.
• 대시보드별: start, end, periodOverride.
• 경보 위젯: alarms, sortBy.

사용되지 않는 항목

• 주석 레이블과 Y축 레이블(선과 한도는 그려지지만 텍스트는 표시되지 않음), 주석 밴드(첫 번째 경계만 그려짐), 수직 주석.
• hidden 이외의 범례 위치, liveData, singleValueFullPrecision, 표 요약 옵션.
• 대시보드 변수: 위젯은 대시보드에 저장된 값을 사용합니다.

시간 범위 및 기간

• 시간 범위: 위젯에 start가 있으면 그 값, 없으면 대시보드의 값, 그것도 없으면 지난 3시간입니다. -PT3H나 -P7D 같은 상대 범위와 절대 타임스탬프 모두 사용할 수 있습니다. 모든 위젯에는 해당 시간 범위가 표시됩니다(예: “지난 3시간”).
• 기간: 지표의 period, 없으면 위젯의 값, 그것도 없으면 5분입니다. 콘솔과 마찬가지로 CloudPeek은 범위에 필요한 데이터 포인트가 너무 많으면(300개 초과, "periodOverride": "inherit"를 사용하면 1,440개 초과) 1분, 5분, 15분, 1시간, 3시간, 6시간, 1일, 1주, 30일 순으로 기간을 늘립니다.
• CloudWatch에서 오래된 데이터는 해상도가 낮으므로, 15일보다 이전에 시작하는 범위는 최소 5분 기간을, 63일보다 이전에 시작하는 범위는 최소 1시간 기간을 사용합니다.
• setPeriodToTimeRange를 사용하면 콘솔과 마찬가지로 숫자, 게이지, 막대, 파이, 표 위젯이 전체 범위에 하나의 기간을 사용합니다.

값이 표시되는 방식

• 숫자는 유효 숫자 세 자리로 표시되며, 천, 백만, 십억, 조 단위에는 K, M, B, T를 사용합니다(1.23K, 45.6M). 세 자리로 반올림하면 오해를 줄 만큼 딱 떨어지는 숫자가 되는 값은 자릿수를 더 유지하므로, 99.96이 100으로 표시되지 않습니다. CloudWatch 단위는 표시되지 않으므로 “지연 시간(초)”처럼 레이블에 단위를 넣으세요.
• 통화: 위젯의 모든 지표가 같은 통화의 AWS/Billing EstimatedCharges이면 값이 금액으로 표시됩니다. 100 미만은 센트까지, 10,000까지는 정수 금액으로, 그 이상은 $12.3K처럼 축약해서 표시합니다. Currency를 지정하지 않은 AWS/Billing의 SEARCH는 AWS가 요금을 게시하는 유일한 통화인 미국 달러로 표시됩니다.
• 결제 위젯의 서비스 이름은 짧게 표시됩니다. AmazonEC2는 EC2로, AWSLambda는 Lambda로 표시됩니다.
• 레이블: 레이블이 없는 지표는 지표 이름이나, 위젯의 다른 지표와 구별되는 차원 값으로 이름이 붙습니다.
• 숫자의 추세는 최신 데이터 포인트를 바로 이전 데이터 포인트와 비교합니다.
• 색상: 각 지표에 지정한 color, 없으면 CloudWatch의 기본 팔레트를 사용합니다.
• 경고 및 경보 수준: 숫자, 게이지, 막대 또는 그래프의 최신 값이 CloudPeek에서 설정한 수준을 넘으면 기호와 함께 주황색이나 빨간색으로 표시됩니다(경고 및 경보 수준 참조). CloudPeek은 수준을 "cloudPeekLevel"로 표시된 수평 주석으로 위젯에 기록하며, 그래프는 이를 점선으로 그립니다. 대시보드 자체의 주석도 선으로 그려지지만 값에 색을 입히지는 않습니다.

계정, 리전 및 한도

• 리전: 각 지표는 자체 region, 없으면 위젯의 리전, 그것도 없으면 CloudPeek에 설정된 계정의 기본 리전을 사용합니다. 위젯 하나에 여러 리전을 섞을 수 있으며, CloudPeek은 각 리전을 병렬로 쿼리합니다.
• 계정: 각 위젯은 위젯을 만든 계정으로 새로고침됩니다. 한 위젯에 다른 계정의 지표를 표시하려면 CloudWatch 교차 계정 관측성을 설정하고 지표에 accountId를 사용하거나, 그 계정을 CloudPeek에 추가하고 해당 계정용 위젯을 만드세요.
• 경보는 위젯을 만든 계정에서 각 ARN의 리전을 기준으로 조회합니다. 경보 프리셋은 추가된 리전에서 최대 1,000개의 경보를 읽으며(표시에서 텍스트를 선택했다면 이름이 그 텍스트로 시작하는 경보만), 이를 넘으면 ALARM 상태인 경보를 우선 유지합니다.
• 크기: 위젯은 리전당 한 번에 최대 500개의 지표를 요청할 수 있으며, 선마다 최대 400개의 데이터 포인트를 유지합니다. 그래프에는 최대 30개 시리즈가 그려집니다. 선 그래프는 값이 가장 높은 30개를 표시하고, 누적 그래프는 나머지를 합산하여 기타로 표시합니다.

텍스트 위젯

텍스트 위젯은 그래프 옆에 런북 메모를 둘 때 유용합니다. CloudPeek은 다음을 표시합니다.

• 굵게, 기울임꼴, code 및 링크.
• 제목(굵은 줄로 표시).
• 글머리 기호 목록(*, - 또는 +, 글머리 기호로 표시).
• CloudWatch의 버튼([button:Label](https://…), 일반 링크로 표시).

가로줄은 생략되고, 연속된 빈 줄은 하나로 줄어듭니다. 표, 이미지, 코드 블록은 콘솔의 대시보드에만 두는 것이 좋습니다. 제목이 없는 텍스트 위젯은 첫 줄을 이름으로 사용합니다.