# CloudWatch 대시보드에서 위젯 사용
<a name="create-and-work-with-widgets"></a>

CloudWatch 대시보드에서 다음 유형의 위젯을 사용할 수 있습니다.
+ **그래프 위젯** - 하나 이상의 지표를 포함하는 그래프를 CloudWatch 대시보드에 추가할 수 있습니다. 대시보드에는 ***선(Line)***, ***누적 영역(Stacked area)***, ***숫자(Number)***, ***게이지(Gauge)***, ***막대(Bar)*** 및 ***파이(Pie)*** 유형의 그래프를 추가할 수 있습니다. 그래프가 더 이상 필요 없는 경우 대시보드에서 그래프를 제거할 수 있습니다.
+ **수동 지표 위젯** - 지표가 지난 14일간 데이터를 게시하지 않은 경우 CloudWatch 대시보드에서 그래프에 추가할 지표를 검색할 때 이 지표를 찾을 수 없습니다. 기존 그래프에 수동으로 원하는 지표를 추가할 수 있습니다.
+ **지표 탐색기 위젯** – 지표 탐색기 위젯에는 동일한 태그가 있거나 인스턴스 유형과 같은 동일한 리소스 속성을 공유하는 여러 리소스의 그래프가 포함됩니다. 이러한 위젯은 일치하는 리소스가 생성되거나 삭제될 때 최신 상태로 유지됩니다. 대시보드에 지표 탐색기 위젯을 추가하면 환경 관련 문제를 더욱 효율적으로 해결할 수 있습니다.

  예를 들어 프로덕션 또는 테스트와 같은 환경을 나타내는 태그를 할당하여 EC2 인스턴스 플릿을 모니터링할 수 있습니다. 그런 다음, 이러한 태그를 사용하여 `CPUUtilization`과 같은 운영 지표를 필터링하고 집계함으로써 각 태그와 연결된 EC2 인스턴스의 상태 및 성능을 파악할 수 있습니다.
+ **선 위젯** - 선 위젯을 사용하면 기간 동안의 지표를 비교할 수 있습니다. 위젯의 미니 맵 확대/축소 기능을 사용하여 확대/축소된 뷰 간에 변경하지 않고 선 그래프의 섹션을 검사할 수도 있습니다. 이 섹션의 절차에서는 CloudWatch 대시보드에서 선 위젯을 추가 및 제거하는 방법에 대해 설명합니다. 선 그래프와 함께 위젯의 미니 맵 확대/축소 기능을 사용하는 방법에 대한 자세한 내용은 [선 또는 누적 영역 그래프 확대](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/zoom-graph.html)를 참조하세요.
+ **숫자 위젯** - 숫자 위젯을 사용하면 최신 지표 값과 추세가 나타나는 즉시 확인할 수 있습니다. 숫자 위젯에는 스파크라인 기능이 포함되어 있으므로 단일 그래프로 지표 추세의 상단 및 하단 절반을 시각화할 수 있습니다. 이 섹션의 절차에서는 CloudWatch 대시보드에서 숫자 위젯을 추가 및 제거하는 방법에 대해 설명합니다.
+ **게이지 위젯** - 게이지 위젯을 사용하면 범위 사이에 있는 지표 값을 시각화할 수 있습니다. 예를 들어 게이지 위젯을 사용하여 백분율과 CPU 사용률을 그래프로 표시하여 발생하는 성능 문제를 관찰하고 진단할 수 있습니다. 이 섹션의 절차에서는 CloudWatch 대시보드에서 게이지 위젯을 추가 및 제거하는 방법에 대해 설명합니다.
+ **텍스트 위젯** - 텍스트 위젯에는 [마크다운](https://docs.aws.amazon.com/general/latest/gr/aws-markdown.html) 형식으로 된 텍스트 블록이 포함되어 있습니다. CloudWatch 대시보드에서 텍스트 위젯을 추가, 편집 또는 제거할 수 있습니다.
+ **경보 위젯** - 대시보드에 경보 위젯을 추가하려면 다음 옵션 중 하나를 선택합니다.
  + 경보 지표 그래프와 경보 상태를 모두 표시하는 위젯에 단일 경보를 추가합니다.
  + 그리드에 여러 경보의 상태를 표시하는 *경보 상태 위젯*을 추가합니다. 이 위젯에는 경보 이름과 현재 상태만 표시되며, 그래프는 표시되지 않습니다. 경보 상태 위젯 하나에 최대 100개의 경보가 포함될 수 있습니다.
+ **테이블 위젯** - 데이터 테이블 위젯을 사용하면 지표의 원시 데이터포인트와 해당 원시 데이터에 대한 간략한 요약을 볼 수 있습니다. 데이터 테이블 위젯은 실제 데이터를 추상화하기 위한 차트가 아니므로 표시되는 데이터 포인트를 더 쉽게 이해할 수 있습니다. 이 섹션의 절차에서는 CloudWatch 대시보드에서 데이터 테이블 위젯을 추가 및 제거하는 방법에 대해 설명합니다. 다음 이미지는 CloudWatch 지표 세트에 대한 최소, 최대, 합계, 평균 통계 열이 있는 테이블 위젯의 예를 보여줍니다.
+ **연결된 그래프** - 하나의 그래프를 확대 또는 축소하면 다른 그래프도 동시에 확대 또는 축소가 되도록 대시보드의 그래프들을 하나로 연결할 수 있습니다. 그래프 링크를 해제하면 하나의 그래프로만 확대/축소를 제한할 수 있습니다.

**Topics**
+ [그래프 위젯 추가](add_graph_dashboard.md)
+ [그래프 위젯 제거](remove_graph_dashboard.md)
+ [대시보드에서 수동으로 그래프 지표 생성](add_old_metrics_to_graph.md)
+ [그래프 편집](edit_graph_dashboard.md)
+ [그래프 이름 바꾸기](rename_graph_dashboard.md)
+ [그래프 이동](move_graph_dashboard.md)
+ [그래프 크기 변경](#resize_graph_dashboard)
+ [일시적으로 그래프 크기 변경](#resize_graph_temp_dashboard)
+ [지표 탐색기 위젯 추가](add_metrics_explorer_dashboard.md)
+ [선형 그래프 위젯 추가](add_line_dashboard.md)
+ [선형 그래프 제거](remove_line_dashboard.md)
+ [숫자 위젯 추가](add_number_dashboard.md)
+ [숫자 위젯 제거](remove_number_dashboard.md)
+ [게이지 위젯 추가](add_gauge_dashboard.md)
+ [게이지 위젯 제거](remove_gauge_dashboard.md)
+ [사용자 지정 위젯 사용](add_custom_widget_dashboard.md)
+ [텍스트 위젯 추가](add_text_dashboard.md)
+ [텍스트 위젯 편집](edit_text_dashboard.md)
+ [텍스트 위젯 제거](remove_text_dashboard.md)
+ [경보 추가](add_alarm_dashboard.md)
+ [경보 상태 위젯 추가](add_alarm_widget_dashboard.md)
+ [알림 위젯 제거](remove_alarm_dashboard.md)
+ [데이터 테이블 위젯 사용](add_remove_table_dashboard.md)
+ [그래프 연결](link_graphs_dashboard.md)
+ [그래프 연결 해제](unlink_graphs_dashboard.md)

# CloudWatch 대시보드에 그래프 위젯 추가
<a name="add_graph_dashboard"></a>

이 섹션의 절차에서는 대시보드에서 그래프를 추가 및 제거하는 방법을 설명합니다. 대시보드에서 그래프를 편집하는 방법에 대한 자세한 내용은 [CloudWatch 대시보드에서 그래프 편집](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/edit_graph_dashboard.html)을 참조하세요.

**대시보드에 그래프 추가**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  **\$1** 기호를 선택한 다음 대시보드에 추가할 그래프 유형을 선택한 후 **다음**을 선택합니다.

   1.  ***선(Line)***, ***누적 영역(Stacked area)***, ***막대(Bar)*** 또는 ***파이(Pie)***를 선택한 경우 **지표(Metrics)**를 선택합니다.

1.  **찾아보기** 탭에서 그래프로 표시할 지표를 검색하거나 찾아보고 원하는 지표를 선택합니다.

1.  (선택 사항) 그래프의 시간 범위를 변경하려면 화면 상단에서 미리 정의된 시간 범위 중 하나를 선택합니다. 이 범위는 ***1시간(1h)***, ***3시간(3h)***, ***12시간(12h)***, ***1일(1d)***, ***3일(3d)***, ***1주(1w)*** 중에서 선택할 수 있습니다.

    고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

   1. (선택 사항) 나중에 대시보드의 나머지 시간 범위가 변경되더라도 이 위젯에는 선택한 이 시간 범위가 계속 사용되게 하려면 **시간 범위 유지**를 선택합니다.

1.  (선택 사항) 그래프의 위젯 유형을 변경하려면 미리 정의된 시간 범위 옆에 있는 드롭다운을 사용합니다.

1.  (선택 사항) **그래프로 표시된 지표(Graphed metrics)**에서 지표에 동적 레이블을 추가하고 지표의 레이블, 레이블 색상, 통계 및 기간을 변경할 수 있습니다. Y축에서 레이블의 위치를 왼쪽에서 오른쪽으로 결정할 수도 있습니다.

   1.  동적 레이블을 추가하려면 **그래프로 표시된 지표(Graphed metrics)**를 선택한 다음 **동적 레이블 추가(Add dynamic labels)**를 선택합니다. 동적 레이블은 그래프 범례에 지표에 대한 통계를 표시합니다. 동적 레이블은 대시보드나 그래프가 새로 고쳐지는 경우 자동으로 업데이트됩니다. 기본적으로 레이블에 추가하는 동적 값은 레이블 시작 부분에 표시됩니다. 자세한 내용은 [동적 레이블 사용](graph-dynamic-labels.md) 섹션을 참조하세요.

   1.  지표의 색상을 변경하려면 지표 옆에 있는 색상 사각형을 선택합니다.

   1.  통계를 변경하려면 ***통계(Statistic)***에서 드롭다운을 선택한 다음 새 값을 선택합니다. 자세한 내용은 [통계](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic)를 참조하세요.

   1.  기간을 변경하려면 ***기간(Period)*** 열에서 드롭다운을 선택한 다음 새 값을 선택합니다.

1. 게이지 위젯을 만드는 경우 **옵션** 탭을 선택하고 게이지의 양쪽 끝에 사용할 **최소값**과 **최대값**을 지정해야 합니다.

1.  (선택 사항) Y축을 사용자 지정하려면 **옵션(Options)**을 선택합니다. 레이블 필드의 ***왼쪽 Y축(Left Y-axis)*** 아래에서 사용자 지정 레이블을 추가할 수 있습니다. 또한 그래프가 Y축의 오른쪽에 값을 표시하는 경우 해당 레이블도 사용자 지정할 수 있습니다. 그래프에 지정한 값의 범위만 표시되도록 Y축 값에 최솟값과 최댓값을 설정할 수도 있습니다.

1.  (선택 사항) 선형 또는 누적 영역 그래프에 가로 주석을 추가 또는 편집하거나 게이지 위젯에 임곗값을 추가하려면 **옵션**을 선택합니다.

   1.  가로 주석 또는 임곗값을 추가하려면 **가로 주석 추가** 또는 **임곗값 추가**를 선택합니다.

   1.  ****레이블**에 주석의 레이블을 입력한 다음 확인 표시 아이콘을 선택합니다.

   1.  ***레이블(Label)***에서 현재 값 옆에 있는 펜과 종이 아이콘을 선택하고 새 값을 입력합니다. 값을 입력한 후 확인 표시 아이콘을 선택합니다.

   1.  ***채우기(Fill)***에서 드롭다운을 선택하고 주석에서 음영을 사용하는 방법을 지정합니다. ***없음(None) ***, ***위(Above)***, ***사이(Between)*** 또는 ***아래(Below)***를 선택할 수 있습니다. 채우기 색상을 변경하려면 주석 옆의 색상 정사각형을 선택합니다.

   1.  ***축(Axis)***에서 주석을 Y축의 왼쪽 또는 오른쪽에 표시할지 여부를 지정합니다.

   1.  주석을 숨기려면 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 ***작업(Actions)***에서 **X**를 선택합니다.
**참고**  
 이 단계를 반복하여 동일한 그래프 또는 게이지에 여러 개의 가로 주석 또는 임곗값을 추가할 수 있습니다.

1.  (선택 사항) 세로 주석을 추가 또는 편집하려면 **옵션(Options)**을 선택합니다.

   1.  세로 주석을 추가하려면 **세로 주석 추가(Add vertical annotation)**를 선택합니다.

   1.  ***레이블(Label)***에서 현재 주석 옆에 있는 펜과 종이 아이콘을 선택하고 새 주석을 입력합니다. 날짜와 시간만 표시하려면 레이블 필드를 비워둡니다.

   1.  ***날짜(Date)***에서 현재 날짜 및 시간을 선택한 후 새 날짜 및 시간을 입력합니다.

   1.  ***채우기(Fill)***에서 드롭다운을 선택하고 주석에서 음영을 사용하는 방법을 지정합니다. ***없음(None) ***, ***위(Above)***, ***사이(Between)*** 또는 ***아래(Below)***를 선택할 수 있습니다. 채우기 색상을 변경하려면 주석 옆의 색상 정사각형을 선택합니다.

   1.  주석을 숨기려면 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 ***작업(Actions)***에서 **X**를 선택합니다.
**참고**  
 이 단계를 반복하여 동일한 그래프에 여러 세로 주석을 추가할 수 있습니다.

1. **위젯 생성**을 선택합니다.

1. **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 그래프 위젯 제거
<a name="remove_graph_dashboard"></a>

**대시보드에서 그래프를 제거하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  제거하려는 그래프 오른쪽 상단에서 **위젯 작업(Widget actions)**을 선택한 다음 **삭제(Delete)**를 선택합니다.

1.  **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 수동으로 지표 그래프 생성
<a name="add_old_metrics_to_graph"></a>

**그래프에 검색에서 찾을 수 없는 지표를 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 대시보드에 지표를 추가하고자 하는 그래프가 이미 있어야 합니다. 아직 없는 경우 그래프를 생성한 다음 지표를 추가합니다. 자세한 내용은 [CloudWatch 대시보드에 그래프 위젯 추가](add_graph_dashboard.md) 섹션을 참조하세요.

1. **작업**, **소스 보기/편집**을 선택합니다.

   JSON 블록이 표시됩니다. 블록은 대시보드 및 해당 콘텐츠의 위젯을 지정합니다. 다음은 그래프 하나를 정의하는 이 블록 일부의 예제입니다.

   ```
   {
     "type": "metric",
     "x": 0,
     "y": 0,
     "width": 6,
     "height": 3,
     "properties": {
       "view": "singleValue",
       "metrics": [
         [
           "AWS/EBS",
           "VolumeReadOps",
           "VolumeId",
           "vol-1234567890abcdef0"
         ]
       ],
       "region": "us-west-1"
     }
   },
   ```

   이 예제에서 다음 섹션은 이 그래프에 표시되는 지표를 정의합니다.

   ```
   [ "AWS/EBS", "VolumeReadOps", "VolumeId", "vol-1234567890abcdef0" ]
   ```

1. 아직 없는 경우 닫는 괄호 뒤에 쉼표를 추가한 후, 쉼표 뒤에 비슷한 괄호로 묶은 섹션을 추가합니다. 이 새 섹션에서 네임스페이스, 지표 이름 및 그래프에 추가하려는 지표의 필요한 모든 측정기준을 지정합니다. 다음은 예입니다.

   ```
   [ "AWS/EBS", "VolumeReadOps", "VolumeId", "vol-1234567890abcdef0" ],
   [ "MyNamespace", "MyMetricName", "DimensionName", "DimensionValue" ]
   ```

   JSON으로 지표 형식 지정에 대한 자세한 내용은 Amazon CloudWatch API 참조의 [지표 위젯 객체의 속성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CloudWatch-Dashboard-Body-Structure.html#CloudWatch-Dashboard-Properties-Metric-Widget-Object)을 참조하세요.

1. **업데이트**를 선택합니다.

# CloudWatch 대시보드에서 그래프 편집
<a name="edit_graph_dashboard"></a>

 CloudWatch 대시보드에 추가하는 그래프를 편집할 수 있습니다. 그래프의 제목, 통계 또는 기간을 변경할 수 있습니다. 그래프에서 지표를 추가, 업데이트 및 제거할 수 있습니다. 그래프에 두 개 이상의 지표가 포함되어 있는 경우, 사용하지 않는 지표를 숨기면 혼란을 줄일 수 있습니다. 이 섹션의 절차에서는 대시보드에서 그래프를 편집하는 방법에 대해 설명합니다. 그래프 생성에 대한 자세한 내용은 [CloudWatch 대시보드에서 그래프 추가 또는 제거](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/add_remove_graph_dashboard.html)를 참조하세요.

------
#### [  New interface  ]

**대시보드에서 그래프를 편집하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  편집하려는 그래프의 오른쪽 상단 모서리에서 **위젯 작업(Widget actions)**을 선택한 다음 **편집(Edit)**을 선택합니다.

1.  그래프 제목을 변경하려면 현재 제목 옆의 펜과 종이 아이콘을 선택합니다. 새 제목을 입력한 다음 **적용(Apply)**을 선택합니다.

1.  (선택 사항) 그래프의 시간 범위를 변경하려면 그래프 상단에서 미리 정의된 시간 범위 중 하나를 선택합니다. 이 범위는 ***1시간(1h)***, ***3시간(3h)***, ***12시간(12h)***, ***1일(1d)***, ***3일(3d)***, ***1주(1w)*** 중에서 선택할 수 있습니다.

    고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

   1. (선택 사항) 나중에 대시보드의 나머지 시간 범위가 변경되더라도 이 위젯에는 선택한 이 시간 범위가 계속 사용되게 하려면 **시간 범위 유지**를 선택합니다.

1.  그래프의 위젯 유형을 변경하려면 미리 정의된 시간 범위 옆에 있는 드롭다운을 사용합니다.

1.  **그래프로 표시된 지표(Graphed metrics)**에서 지표에 동적 레이블을 추가하고 지표의 레이블, 레이블 색상, 통계 및 기간을 변경할 수 있습니다. Y축에서 레이블의 위치를 왼쪽에서 오른쪽으로 결정할 수도 있습니다.

   1.  지표에 대한 동적 레이블을 추가하려면 **동적 레이블(Dynamic labels)**을 선택합니다. 동적 레이블은 그래프 범례에 지표에 대한 통계를 표시합니다. 동적 레이블은 대시보드나 그래프가 새로 고쳐지는 경우 자동으로 업데이트됩니다. 기본적으로 레이블에 추가하는 동적 값은 레이블 시작 부분에 표시됩니다. 자세한 내용은 [동적 레이블 사용](graph-dynamic-labels.md) 섹션을 참조하세요.

   1.  지표의 색상을 변경하려면 지표 옆에 있는 색상 사각형을 선택합니다.

   1.  통계를 변경하려면 ***통계(Statistic)*** 열에서 통계 값을 선택한 다음 새 값을 선택합니다. 자세한 내용은 [통계](cloudwatch_concepts.md#Statistic) 섹션을 참조하세요.

   1.  기간을 변경하려면 ***기간(Period)*** 열에서 기간 값을 선택한 다음 새 값을 선택합니다.

1.  가로 주석을 추가 또는 편집하려면 **옵션(Options)**을 선택합니다.

   1.  가로 주석을 추가하려면 **가로 주석 추가(Add horizontal annotation)**를 선택합니다.

   1.  **레이블(Label)**에서 현재 주석 옆에 있는 펜 앤 페이퍼 아이콘을 선택합니다. 그런 다음 새 주석을 입력합니다. 주석을 입력한 후 확인 표시 아이콘을 선택합니다.

   1.  **값(Value)**에서 현재 메트릭 값 옆에 있는 펜 앤 페이퍼 아이콘을 선택합니다. 그런 다음 새 지표 값을 입력합니다. 값을 입력한 후 확인 표시 아이콘을 선택합니다.

   1.  **채우기(Fill)**에서 열 아래의 드롭다운을 선택한 다음 주석에서 음영을 사용하는 방법을 지정합니다. **없음(None) **, **위(Above)**, **사이(Between)** 또는 **아래(Below)**를 선택할 수 있습니다. **사이(Between)**를 선택한 경우 다른 새 레이블 및 값 필드가 나타납니다.
**작은 정보**  
 주석 옆의 유색 정사각형을 선택하여 채우기 색상을 변경할 수 있습니다.

   1.  **축(Axis)**에서 주석을 Y축의 왼쪽 또는 오른쪽에 표시할지 여부를 지정합니다.

   1.  주석을 숨기려면 그래프에서 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 **작업(Actions)** 열에서 **x**를 선택합니다.
**참고**  
 이 단계를 반복하여 동일한 그래프에 여러 가로 주석을 추가할 수 있습니다.

1.  세로 주석을 추가 또는 편집하려면 **옵션(Options)**을 선택합니다.

   1.  세로 주석을 추가하려면 **세로 주석 추가(Add vertical annotation)**를 선택합니다.

   1.  **레이블(Label)**에서 현재 주석 옆에 있는 펜 앤 페이퍼 아이콘을 선택합니다. 그런 다음 새 주석을 입력합니다. 주석을 입력한 후 확인 표시 아이콘을 선택합니다.
**작은 정보**  
 날짜와 시간만 표시하려면 레이블 필드를 비워둡니다.

   1.  **날짜(Date)**에서 현재 날짜 및 시간을 선택합니다. 그런 다음 새 날짜 및 시간을 입력합니다.

   1.  **채우기(Fill)**에서 열 아래의 드롭다운을 선택한 다음 주석에서 음영을 사용하는 방법을 지정합니다. **없음(None) **, **위(Above)**, **사이(Between)** 또는 **아래(Below)**를 선택할 수 있습니다. **사이(Between)**를 선택한 경우 새 레이블 및 값 필드가 나타납니다.
**작은 정보**  
 주석 옆의 색상 정사각형을 선택하여 채우기 색상을 변경할 수 있습니다.
**참고**  
 이 단계를 반복하여 동일한 그래프에 여러 세로 주석을 추가할 수 있습니다.

   1.  주석을 숨기려면 그래프에서 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 **작업(Actions)** 열에서 **x**를 선택합니다.

1.  Y축을 사용자 지정하려면 **옵션(Options)**을 선택합니다. ***왼쪽 Y축(Left Y-axis)***에 **레이블(Label)**에 대한 사용자 지정 레이블을 입력할 수 있습니다. 그래프가 오른쪽 Y축의 값을 표시하는 경우 해당 레이블도 사용자 지정할 수 있습니다. 그래프에 지정한 값의 범위만 표시되도록 Y축 값에 최솟값과 최댓값을 설정할 수도 있습니다.

1.  변경을 마치면 **위젯 업데이트(Update widget)**를 선택합니다.

**그래프 범례의 위치를 숨기거나 변경하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  편집하려는 그래프 오른쪽 상단 모서리에서 **위젯 작업(Widget actions)**을 선택합니다. **범례(Legend)**를 선택하고 **숨김(Hidden)**, **하단(Bottom)** 또는 **오른쪽(Right)**을 선택합니다.

**대시보드의 그래프에서 지표를 일시적으로 숨기려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  그래프의 바닥글에서 숨기려는 지표의 색상 정사각형을 선택합니다. 색상 사각형에 마우스를 가져가면 ***X***가 표시되고 정사각형을 선택하면 회색으로 바뀝니다.

1.  숨겨진 지표를 복원하려면 회색 사각형의 **X**를 지웁니다.

------
#### [  Original interface  ]

**대시보드에서 그래프를 편집하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  편집하려는 그래프의 오른쪽 상단 모서리에 마우스를 가져갑니다. **위젯 작업(Widget Actions)**을 선택한 다음, **편집(Edit)**을 선택합니다.

1.  그래프 제목을 변경하려면 현재 제목 옆의 펜과 종이 아이콘을 선택한 다음 새 제목을 입력합니다.

1.  그래프의 시간 범위를 변경하려면 그래프 상단 영역에서 미리 정의된 시간 범위 중 하나를 선택합니다. 이 범위는 1시간에서 1주까지 다양합니다(***1시간***, ***3시간***, ***12시간***, ***1일***, ***3일***, ***1주***).

   1.  고유한 시간 범위를 설정하려면 **사용자 지정(Custom)**을 선택합니다.

1.  그래프의 위젯 유형을 변경하려면 **그래프 옵션(Graph options)** 탭을 선택합니다. ***선(Line)***, ***누적 영역(Stacked area)***, ***숫자(Number)***, ***막대(Bar)***, ***파이(Pie)***를 선택할 수 있습니다.
**작은 정보**  
 미리 정의된 시간 범위 옆에 있는 드롭다운을 선택하여 그래프의 위젯 유형을 변경할 수도 있습니다.

1.  **그래프로 표시된 지표(Graphed metrics)**에서 지표에 동적 레이블을 추가하고 지표의 레이블, 레이블 색상, 통계 및 기간을 변경할 수 있습니다. Y축에서 레이블의 위치를 왼쪽에서 오른쪽으로 결정할 수도 있습니다.

   1.  지표에 대한 동적 레이블을 추가하려면 **동적 레이블(Dynamic labels)**을 선택합니다. 동적 레이블은 그래프 범례에 지표에 대한 통계를 표시합니다. 동적 레이블은 대시보드나 그래프가 새로 고쳐지는 경우 자동으로 업데이트됩니다. 기본적으로 레이블에 추가하는 동적 값은 레이블 시작 부분에 표시됩니다. 자세한 내용은 [동적 레이블 사용](graph-dynamic-labels.md) 섹션을 참조하세요.

   1.  지표의 색상을 변경하려면 지표 옆에 있는 색상 사각형을 선택합니다.

   1.  통계를 변경하려면 ***통계(Statistic)*** 열에서 통계 값을 선택한 다음 새 값을 선택합니다. 자세한 내용은 [통계](cloudwatch_concepts.md#Statistic) 섹션을 참조하세요.

   1.  기간을 변경하려면 ***기간(Period)*** 열에서 기간 값을 선택한 다음 새 값을 선택합니다.

1.  가로 주석을 추가 또는 편집하려면 **그래프 옵션(Graph options)**을 선택합니다.

   1.  가로 주석을 추가하려면 **가로 주석 추가(Add horizontal annotation)**를 선택합니다.

   1.  **레이블(Label)**에서 현재 주석 옆에 있는 연필 아이콘을 선택합니다. 그런 다음 새 주석을 입력합니다. 주석을 입력한 후 확인 표시 아이콘을 선택합니다.

   1.  **값(Value)**에서 현재 메트릭 값 옆에 있는 연필 아이콘을 선택합니다. 그런 다음 새 지표 값을 입력합니다. 값을 입력한 후 확인 표시 아이콘을 선택합니다.

   1.  **채우기(Fill)**에서 열 아래의 드롭다운을 선택한 다음 주석에서 음영을 사용하는 방법을 지정합니다. **없음(None) **, **위(Above)**, **사이(Between)** 또는 **아래(Below)**를 선택할 수 있습니다. **사이(Between)**를 선택한 경우 새 레이블 및 값 필드가 나타납니다.
**작은 정보**  
 주석 옆의 색상 정사각형을 선택하여 채우기 색상을 변경할 수 있습니다.

   1.  **축(Axis)**에서 주석을 Y축의 왼쪽 또는 오른쪽에 표시할지 여부를 지정합니다.

   1.  주석을 숨기려면 그래프에서 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 **작업(Actions)** 열에서 **x**를 선택합니다.
**참고**  
 이 단계를 반복하여 동일한 그래프에 여러 가로 주석을 추가할 수 있습니다.

1.  세로 주석을 추가 또는 편집하려면 **그래프 옵션(Graph options)**을 선택합니다.

   1.  세로 주석을 추가하려면 **세로 주석 추가(Add vertical annotation)**를 선택합니다.

   1.  **레이블(Label)**에서 현재 주석 옆에 있는 연필 아이콘을 선택합니다. 그런 다음 새 주석을 입력합니다. 주석을 입력한 후 확인 표시 아이콘을 선택합니다.
**작은 정보**  
 날짜와 시간만 표시하려면 레이블 필드를 비워둡니다.

   1.  **날짜(Date)**에서 현재 날짜 및 시간 옆에 있는 연필 아이콘을 선택합니다. 그런 다음 새 날짜 및 시간을 입력합니다.

   1.  **채우기(Fill)**에서 열 아래의 드롭다운을 선택한 다음 주석에서 음영을 사용하는 방법을 지정합니다. **없음(None) **, **위(Above)**, **사이(Between)** 또는 **아래(Below)**를 선택할 수 있습니다. **사이(Between)**를 선택한 경우 새 레이블 및 값 필드가 나타납니다.
**작은 정보**  
 주석 옆의 색상 정사각형을 선택하여 채우기 색상을 변경할 수 있습니다.
**참고**  
 이 단계를 반복하여 동일한 그래프에 여러 세로 주석을 추가할 수 있습니다.

   1.  주석을 숨기려면 그래프에서 숨기려는 주석 옆의 확인란을 선택 취소합니다.

   1.  주석을 삭제하려면 **작업(Actions)** 열에서 **x**를 선택합니다.

1.  Y축을 사용자 지정하려면 **그래프 옵션(Graph options)**을 선택합니다. ***왼쪽 Y축(Left Y-axis)***에 **레이블(Label)**에 대한 사용자 지정 레이블을 입력할 수 있습니다. 그래프가 오른쪽 Y축의 값을 표시하는 경우 해당 레이블도 사용자 지정할 수 있습니다. 그래프에 지정한 값의 범위만 표시되도록 Y축 값에 최솟값과 최댓값을 설정할 수도 있습니다.

1.  변경을 마치면 **위젯 업데이트(Update widget)**를 선택합니다.

**그래프 범례의 위치를 숨기거나 변경하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  편집하려는 그래프 오른쪽 상단 모서리에 마우스를 가져간 다음 **위젯 작업(Widget actions)**을 선택합니다. **범례(Legend)**를 선택하고 **숨김(Hidden)**, **하단(Bottom)** 또는 **오른쪽(Right)**을 선택합니다.

**대시보드의 그래프에서 지표를 일시적으로 숨기려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  그래프의 바닥글에서 숨기려는 지표의 색상 정사각형을 선택합니다. 색상 사각형에 마우스를 가져가면 ***X***가 표시되고 정사각형을 선택하면 회색으로 바뀝니다.

1.  숨겨진 지표를 복원하려면 회색 사각형의 **X**를 지웁니다.

------

# CloudWatch 대시보드에서 그래프 이름 바꾸기
<a name="rename_graph_dashboard"></a>

CloudWatch가 대시보드에서 그래프에 할당한 기본 이름을 변경할 수 있습니다.

**대시보드에서 그래프 이름을 변경하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 그래프 제목 위로 마우스를 이동하고 **위젯 작업(Widget actions)**, **편집(Edit)**을 선택합니다.

1. **그래프 편집(Edit graph)** 화면의 위쪽에서 그래프의 제목을 선택합니다.

1. **제목(Title)**에 새 이름을 입력하고 **확인(Ok)**(체크 표시)을 선택합니다. **그래프 편집(Edit graph)** 화면의 우측 하단 모서리에서 **위젯 업데이트(Update widget)**를 선택합니다.

# CloudWatch 대시보드에서 그래프 이동
<a name="move_graph_dashboard"></a>

**대시보드에서 그래프를 이동시키려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 다음 중 하나를 수행하세요.
   + 선택 아이콘이 나타날 때까지 그래프 제목에 마우스 포인터를 둡니다. 원하는 그래프를 선택하고 대시보드의 새로운 위치로 드래그합니다.
   + 위젯을 대시보드의 왼쪽 상단 또는 왼쪽 하단으로 이동하려면 위젯의 오른쪽 상단에 있는 세로 줄임표를 선택하여 **위젯 작업** 메뉴를 엽니다. 그런 다음 **이동**을 선택하고 위젯을 이동할 위치를 선택합니다.

1. **대시보드 저장**을 선택합니다.

## CloudWatch 대시보드에서 그래프 크기 변경
<a name="resize_graph_dashboard"></a>

**그래프의 크기를 변경하려면 다음을 수행하세요.**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 크기를 늘리거나 줄이려면 그래프에 마우스 포인터를 두고 그래프의 오른쪽 하단 모서리를 드래그합니다. 원하는 크기가 되면 모서리 드래그를 중지합니다.

1. **대시보드 저장(Save dashboard)**을 선택합니다.

## CloudWatch 대시보드에서 일시적으로 그래프 크기 변경
<a name="resize_graph_temp_dashboard"></a>

**그래프를 일시적으로 확대하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 그래프를 선택합니다. 또는 그래프 제목에 마우스 포인터를 놓고 **위젯 작업(Widget actions)**과 **확대(Enlarge)**를 선택합니다.

# CloudWatch 대시보드에 지표 탐색기 위젯 추가
<a name="add_metrics_explorer_dashboard"></a>

다음 단계에서는 콘솔을 사용하여 대시보드에 지표 탐색기 위젯을 추가하는 방법을 설명합니다. 프로그래밍 방식으로 또는 CloudFormation을 사용하여 위젯을 추가할 수도 있습니다. 자세한 내용은 [지표 탐색기 위젯 객체 정의](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CloudWatch-Dashboard-Body-Structure.html#CloudWatch-Dashboard-Properties-Metric-Explorer-Object) 및 [AWS::CloudWatch::Dashboard](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-dashboard.html) 단원을 참조하세요.

**대시보드에 지표 탐색기 위젯을 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택합니다.

1. 지표 탐색기 위젯을 추가하려는 대시보드의 이름을 선택합니다.

1. **\$1** 기호를 선택합니다.

1. **탐색기(Explorer)**를 선택한 후 **다음(Next)**을 선택합니다.
**참고**  
지표 탐색기 위젯을 추가하려면 새 대시보드 보기를 옵트인해야 합니다. 옵트인하려면 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 페이지 상단의 배너에서 **새 인터페이스 사용해 보기(try out the new interface)**를 선택합니다.

1. 다음 중 하나를 수행하세요.
   + 템플릿을 사용하려면 **미리 채워진 탐색기 위젯(Pre-filled Explorer widget)**을 선택한 다음, 사용할 템플릿을 선택합니다.
   + 사용자 지정 시각화를 생성하려면 **빈 탐색기 위젯(Empty Explorer widget)**을 선택합니다.

1. **생성(Create)**을 선택합니다.

   템플릿을 사용한 경우 위젯이 선택한 지표와 함께 대시보드에 나타납니다. 탐색기 위젯 및 대시보드가 ​​마음에 들면 **대시보드 저장**을 선택합니다.

   템플릿을 사용하지 않은 경우 다음 단계를 계속 진행합니다.

1. **탐색기(Explorer)** 아래의 새 위젯에 있는 **지표(Metrics)** 상자에서 단일 지표 또는 서비스에서 사용 가능한 모든 지표를 선택합니다.

   지표를 선택한 후 필요에 따라 이 단계를 반복하여 더 많은 지표를 추가할 수 있습니다.

1. 선택한 각 지표에 대해 CloudWatch는 지표 이름 바로 뒤에 사용할 통계를 표시합니다. 이를 변경하려면 통계 이름을 선택한 다음, 원하는 통계를 선택합니다.

1. **다음에서(From)**에서 결과를 필터링할 태그 또는 리소스 속성을 선택합니다.

   이 작업을 수행한 후 필요에 따라 이 단계를 반복하여 더 많은 태그 또는 리소스 속성을 선택할 수 있습니다.

   EC2 인스턴스 유형 두 개와 같이 속성이 동일한 값을 여러 개 선택하는 경우 탐색기에는 선택한 속성 중 하나와 일치하는 리소스가 모두 표시됩니다. 이는 OR 연산으로 처리됩니다.

   **Production** 태그 및 M5 인스턴스 유형과 같이 서로 다른 속성 또는 태그를 선택하는 경우 이러한 모든 선택 사항과 일치하는 리소스만 표시됩니다. 이는 AND 연산으로 처리됩니다.

1. (선택 사항) **집계 기준(Aggregate by)**에서 지표 집계에 사용할 통계를 선택합니다. 그런 다음, **대상(for)** 옆에 있는 목록에서 지표를 집계하는 방법을 선택합니다. 현재 표시된 모든 리소스를 함께 집계하거나 단일 태그 또는 리소스 속성을 기준으로 집계할 수 있습니다.

   선택하는 집계 방법에 따라 결과가 단일 시계열 또는 다중 시계열이 될 수 있습니다.

1. **분할 기준(Split by)**에서 다중 시계열의 단일 그래프를 여러 그래프로 분할하도록 선택할 수 있습니다. **분할 기준(Split by)**에서 선택하는 다양한 기준에 따라 분할을 수행할 수 있습니다.

1. **그래프 옵션(Graph options)**에서 기간, 그래프 유형, 범례 배치, 레이아웃을 변경하여 그래프를 구체화할 수 있습니다.

1. 탐색기 위젯 및 대시보드가 ​​마음에 들면 **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에 선형 그래프 위젯 추가
<a name="add_line_dashboard"></a>

**대시보드에 선 위젯 추가**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  **\$1** 기호를 선택하고 **행(Line)**을 선택합니다.

1.  [**지표(Metrics)**]를 선택합니다.

1.  **검색(Browse)**을 선택한 다음 그래프로 표시할 지표를 선택합니다.

1.  **위젯 생성(Create widget)**을 선택한 다음 **대시보드 저장(Save dashboard)**을 선택합니다.

# CloudWatch 대시보드에서 선형 그래프 위젯 제거
<a name="remove_line_dashboard"></a>

**대시보드에서 선형 그래프 위젯을 제거하려면 다음을 수행하세요.**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  제거하려는 선 위젯의 오른쪽 상단에서 **위젯 작업(Widget actions)**을 선택한 다음 **삭제(Delete)**를 선택합니다.

1.  **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에 숫자 위젯 추가
<a name="add_number_dashboard"></a>

**참고**  
 스파크라인 기능은 새 인터페이스에서만 지원됩니다. 숫자 위젯을 생성하면 스파크라인 기능이 자동으로 포함됩니다.

**대시보드에 숫자 위젯을 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1.  **\$1** 기호를 선택하고 **숫자(Number)**를 선택합니다.

1.  **찾아보기** 탭에서 표시하려는 지표를 검색하거나 찾아봅니다.

1.  (선택 사항) 스파크라인 기능의 색상을 변경하려면 **그래프로 표시된 지표(Graphed metrics)**를 선택하고 지표 레이블 옆에 있는 색상 상자를 선택합니다. 다른 색상을 선택하거나 6자리 16진수 색상 코드를 입력하면 색상을 지정할 수 있는 메뉴가 표시됩니다.

1.  (선택 사항) 스파크라인 기능을 끄려면 **옵션(Options)**을 선택합니다. ***스파크라인(Sparkline)*** 아래에서 확인란을 선택합니다.

1.  (선택 사항) 숫자 위젯의 시간 범위를 변경하려면 위젯의 상단 영역에서 미리 정의된 시간 범위 중 하나를 선택합니다. 이 범위는 ***1시간(1h)***, ***3시간(3h)***, ***12시간(12h)***, ***1일(1d)***, ***3일(3d)***, ***1주(1w)*** 중에서 선택할 수 있습니다.

    고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

   1. (선택 사항) 나중에 대시보드의 나머지 시간 범위가 변경되더라도 이 위젯에는 선택한 이 시간 범위가 계속 사용되게 하려면 **시간 범위 유지**를 선택합니다.

1.  (선택 사항) 숫자 위젯에서 집계 표시(**1시간****, **3시간****, **12시간****, **1일****, **3일**** 또는 **1주****).

    고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

   1. (선택 사항) 이 위젯에서 최근 값이 아닌 전체 시간 범위의 평균 지표 값을 표시하려면 **옵션**, **시간 범위 값에 전체 시간 범위의 값 표시**를 차례로 선택합니다.

1.  **위젯 생성(Create widget)**을 선택한 다음 **대시보드 저장(Save dashboard)**을 선택합니다.

**작은 정보**  
 대시보드 화면의 숫자 위젯에서 스파크라인 기능을 끌 수 있습니다. 수정하려는 숫자 위젯의 오른쪽 상단 모서리에서 **위젯 작업(Widget actions)**을 선택합니다. **스파크라인(Sparkline)**을 선택한 다음 **스파크라인 숨기기(Hide sparkline)**를 선택합니다.

# CloudWatch 대시보드에서 숫자 위젯 제거
<a name="remove_number_dashboard"></a>

**대시보드에서 숫자 위젯 제거**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음 삭제하려는 숫자 위젯이 포함된 대시보드를 선택합니다.

1.  제거하려는 숫자 위젯의 오른쪽 상단에서 **위젯 작업(Widget actions)**을 선택한 다음 **삭제(Delete)**를 선택합니다.

1.  **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에 게이지 위젯 추가
<a name="add_gauge_dashboard"></a>

**참고**  
 CloudWatch 콘솔의 새 인터페이스만 게이지 위젯 생성을 지원합니다. 이 위젯을 생성하는 경우 게이지 범위를 설정해야 합니다.

**대시보드에 게이지 위젯 추가**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 대시보드 화면에서 **\$1** 기호를 선택한 다음 **게이지(Gauge)**를 선택합니다.

1.  **검색(Browse)**을 선택한 다음 그래프로 표시할 지표를 선택합니다.

1.  **옵션(Options)**을 선택합니다. ***게이지 범위(Gauge range)***에서 **최솟값(Min)**과 **최댓값(Max)**을 설정합니다. CPU 사용률과 같은 백분율의 경우 `Min` 값을 `0`으로 `Max` 값을 `100`으로 설정하는 것이 좋습니다.

1.  (선택 사항) 게이지 위젯의 색상을 변경하려면 **그래프로 표시된 지표(Graphed metrics)**를 선택하고 지표 레이블 옆에 있는 색상 상자를 선택합니다. 다른 색상을 선택하거나 6자리 16진수 색상 코드를 입력하면 색상을 지정할 수 있는 메뉴가 표시됩니다.

1.  **위젯 생성(Create widget)**을 선택한 다음 **대시보드 저장(Save dashboard)**을 선택합니다.

# CloudWatch 대시보드에서 게이지 위젯 제거
<a name="remove_gauge_dashboard"></a>

**대시보드에서 게이지 위젯 제거**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1.  탐색 창에서 **대시보드(Dashboards)**를 선택한 다음 삭제하려는 게이지 위젯이 포함된 대시보드를 선택합니다.

1.  삭제하려는 게이지 위젯의 오른쪽 상단에서 **위젯 작업(Widget actions)**을 선택한 다음 **삭제(Delete)**를 선택합니다.

1.  **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 사용자 지정 위젯 사용
<a name="add_custom_widget_dashboard"></a>

*사용자 지정 위젯*은 사용자 지정 파라미터를 사용하여 AWS Lambda 함수를 호출할 수 있는 CloudWatch 대시보드 위젯입니다. 이 위젯은 함수 호출 후 반환된 HTML 또는 JSON을 표시합니다. 사용자 지정 위젯은 대시보드에서 사용자 지정 데이터 보기를 구축하는 간단한 방법입니다. Lambda 코드를 작성하고 HTML을 생성할 수 있다면 유용한 사용자 지정 위젯을 생성할 수 있습니다. 또한 Amazon은 코드 없이도 생성할 수 있는 사전 구축된 사용자 지정 위젯을 몇 가지 제공합니다.

사용자 지정 위젯으로 사용할 Lambda 함수를 생성할 경우에는 함수 이름에 **customWidget** 접두사를 포함하는 것이 좋습니다. 이렇게 하면 대시보드에 사용자 지정 위젯을 추가할 때 어떤 Lambda 함수를 사용하는 것이 안전한지 알 수 있습니다.

사용자 지정 위젯은 대시보드의 다른 위젯처럼 동작합니다. 새로 고침 및 자동 새로 고침, 크기 조정, 이동할 수 있습니다. 사용자 지정 위젯은 대시보드의 시간 범위에 반응합니다.

CloudWatch 콘솔 교차 계정 기능을 설정한 경우 한 계정에서 생성한 사용자 지정 위젯을 다른 계정의 대시보드에 추가할 수 있습니다. 자세한 내용은 [교차 계정 교차 리전 CloudWatch 콘솔](Cross-Account-Cross-Region.md) 단원을 참조하세요.

또한 CloudWatch 대시보드 공유 기능을 사용하여 자체 웹 사이트에서 사용자 지정 위젯을 사용할 수도 있습니다. 자세한 내용은 [CloudWatch 대시보드 공유](cloudwatch-dashboard-sharing.md) 섹션을 참조하세요.

**Topics**
+ [CloudWatch의 사용자 지정 위젯에 대한 세부 정보입니다.](add_custom_widget_dashboard_about.md)
+ [사용자 지정 CloudWatch 위젯을 위한 보안 및 JavaScript](add_custom_widget_dashboard_security.md)
+ [CloudWatch의 사용자 지정 위젯의 상호 작용](add_custom_widget_dashboard_interactivity.md)
+ [CloudWatch 대시보드에 대한 사용자 지정 위젯 생성](add_custom_widget_dashboard_create.md)
+ [CloudWatch 대시보드에 대한 샘플 사용자 지정 위젯](add_custom_widget_samples.md)

# CloudWatch의 사용자 지정 위젯에 대한 세부 정보입니다.
<a name="add_custom_widget_dashboard_about"></a>

사용자 지정 위젯은 다음과 같이 작동합니다.

1. CloudWatch 대시보드는 위젯 코드가 포함된 Lambda 함수를 호출합니다. 그리고 위젯에 정의된 사용자 지정 파라미터를 전달합니다.

1. Lambda 함수는 HTML, JSON 또는 Markdown 문자열을 반환합니다. Markdown은 다음 형식의 JSON으로 반환됩니다.

   ```
   {"markdown":"markdown content"}
   ```

1. 대시보드는 반환된 HTML 또는 JSON을 표시합니다.

함수가 HTML을 반환하는 경우 대부분의 HTML 태그가 지원됩니다. Cascading Style Sheets(CSS) 스타일 및 Scalable Vector Graphics(SVG)를 사용하여 정교한 보기를 구축할 수 있습니다.

링크 및 테이블과 같은 HTML 요소의 기본 스타일은 CloudWatch 대시보드의 스타일 지정을 준수합니다. `<style>` 태그를 활용하여 인라인 스타일을 사용함으로써 이 스타일을 사용자 지정할 수 있습니다. 또한 `cwdb-no-default-styles` 클래스와 함께 단일 HTML 요소를 포함하여 기본 스타일을 비활성화할 수도 있습니다. 예를 들어 `<div class="cwdb-no-default-styles"></div>`는 기본 스타일을 비활성화합니다.

Lambda에 대한 사용자 지정 위젯의 모든 호출에는 Lambda 함수 개발자에게 유용한 컨텍스트 정보를 제공하는 다음 내용이 들어 있는 `widgetContext` 요소가 포함됩니다.

```
{
  "widgetContext": {
    "dashboardName": "Name-of-current-dashboard",
    "widgetId": "widget-16",
    "accountId": "012345678901",
    "locale": "en",
    "timezone": {
      "label": "UTC",
      "offsetISO": "+00:00",
      "offsetInMinutes": 0
    },
    "period": 300,
    "isAutoPeriod": true,
    "timeRange": {
      "mode": "relative",
      "start": 1627236199729,
      "end": 1627322599729,
      "relativeStart": 86400012,
      "zoom": {
        "start": 1627276030434,
        "end": 1627282956521
      }
    },
    "theme": "light",
    "linkCharts": true,
    "title": "Tweets for Amazon website problem",
    "forms": {
      "all": {}
    },
    "params": {
      "original": "param-to-widget"
    },
    "width": 588,
    "height": 369
  }
}
```

## 기본 CSS 스타일 지정
<a name="add_custom_widget_styling"></a>

사용자 지정 위젯은 다음과 같은 기본 CSS 스타일 지정 요소를 제공합니다.
+ CSS 클래스 [**btn**]을 사용하여 버튼을 추가할 수 있습니다. 다음 예와 같이 앵커(`<a>`)를 버튼으로 바꿉니다.

  ```
  <a class="btn" href=https://amazon.com”>Open Amazon</a>
  ```
+ CSS 클래스 [**btn btn-primary**]를 사용하여 기본 버튼을 추가할 수 있습니다.
+ [**table**], [**select**], [**headers(h1, h2, h3)**], [**preformatted text(pre)**], [**input**], [**text area**]와 같은 요소는 기본적으로 스타일이 지정됩니다.

## describe 파라미터 사용
<a name="add_custom_widget_describe"></a>

빈 문자열만 반환하는 경우에도 함수에서 [**describe**] 파라미터를 지원하는 것이 좋습니다. 이 파라미터를 지원하지 않고 사용자 지정 위젯에서 호출하면 위젯 콘텐츠가 문서인 것처럼 표시됩니다.

[**describe**] 파라미터를 포함하는 경우 Lambda 함수는 문서를 Markdown 형식으로 반환하고 그 밖에 아무것도 하지 않습니다.

콘솔에서 사용자 지정 위젯을 생성할 때 Lambda 함수를 선택하면 [**문서 가져오기(Get documentation)**] 버튼이 표시됩니다. 이 버튼을 선택하면 함수가 [**describe**] 파라미터와 함께 호출되고 함수의 문서가 반환됩니다. 문서의 형식이 올바른 Markdown인 경우 CloudWatch는 YAML에서 세 개의 단일 백틱 문자(```)로 둘러싸인 문서의 첫 번째 항목을 구문 분석합니다. 그런 다음, 파라미터의 문서를 자동으로 채웁니다. 다음은 이러한 형식이 잘 지정된 문서의 예입니다.

```
``` yaml
echo: <h1>Hello world</h1>
```
```

# 사용자 지정 CloudWatch 위젯을 위한 보안 및 JavaScript
<a name="add_custom_widget_dashboard_security"></a>

보안상의 이유로 반환된 HTML에는 JavaScript가 허용되지 않습니다. JavaScript를 제거하면 Lambda 함수 작성자가 대시보드에서 위젯을 보는 사용자보다 더 높은 권한으로 실행할 수 있는 코드를 삽입하는 권한 에스컬레이션 문제를 방지할 수 있습니다.

반환된 HTML에 JavaScript 코드 또는 기타 알려진 보안 취약성이 포함되어 있다면 해당 코드 또는 취약성은 대시보드에서 렌더링되기 전에 HTML에서 제거됩니다. 예를 들어 **<iframe>** 및 **<use>** 태그는 허용되지 않으며 제거됩니다.

사용자 정의 위젯은 기본적으로 대시보드에서 실행되지 않습니다. 대신 호출하는 Lambda 함수를 신뢰하는 경우 사용자 정의 위젯이 실행되도록 명시적으로 허용해야 합니다. 개별 위젯과 전체 대시보드 모두에 대해 한 번 허용하거나 항상 허용하도록 선택할 수 있습니다. 개별 위젯 및 전체 대시보드에 대한 권한을 거부할 수도 있습니다.

# CloudWatch의 사용자 지정 위젯의 상호 작용
<a name="add_custom_widget_dashboard_interactivity"></a>

JavaScript가 허용되지는 않지만 반환된 HTML과의 상호 작용을 허용하는 다른 방법이 있습니다.
+ 팝업에 정보를 표시하고 클릭 시 확인을 요청하며 해당 요소가 선택되었을 때 Lambda 함수를 호출할 수 있는 `<cwdb-action>` 태그의 특수 구성으로 반환된 HTML의 요소에 태그를 지정할 수 있습니다. 예를 들어 Lambda 함수를 사용하여 AWS API를 호출하는 버튼을 정의할 수 있습니다. 기존 Lambda 위젯의 콘텐츠를 대체하거나 모달 내부에 표시되도록 반환된 HTML을 설정할 수 있습니다.
+ 반환된 HTML에 새 콘솔을 열거나 다른 고객 페이지를 열거나 다른 대시보드를 로드하는 링크를 포함할 수 있습니다.
+ HTML에는 사용자가 해당 요소 위로 마우스를 가져가면 추가 정보를 제공하는 요소에 대한 `title` 속성이 포함될 수 있습니다.
+ 요소에 애니메이션 또는 기타 CSS 효과를 호출할 수 있는 `:hover`와 같은 CSS 선택기를 포함할 수 있습니다. 또한 페이지에서 요소를 표시하거나 숨길 수도 있습니다.

## <cwdb-action> 정의 및 사용법
<a name="add_custom_widget_dashboard_cwdb"></a>

`<cwdb-action>` 요소는 바로 이전 요소에 대한 동작을 정의합니다. `<cwdb-action>`의 내용은 표시할 HTML이거나 Lambda 함수에 전달할 파라미터의 JSON 블록입니다.

다음은 `<cwdb-action>` 요소의 예입니다.

```
<cwdb-action 
     action="call|html" 
     confirmation="message" 
     display="popup|widget" 
     endpoint="<lambda ARN>" 
     event="click|dblclick|mouseenter">  
 
     html | params in JSON
</cwdb-action>
```
+ **action** - 유효한 값은 Lambda 함수를 호출하는 `call`이거나 `<cwdb-action>` 내에 포함된 HTML을 표시하는 `html`입니다. 기본값은 `html`입니다.
+ **confirmation** - 작업을 수행하기 전에 확인해야 하는 확인 메시지를 표시하며, 이를 통해 고객이 취소할 수 있습니다.
+ **display** - 유효한 값은 `popup` 및 `widget`으로, 위젯 자체의 콘텐츠를 대체합니다. 기본값은 `widget`입니다.
+ **endpoint** - 호출할 Lambda 함수의 Amazon 리소스 이름(ARN)입니다. `action`이 `call`인 경우 이 값은 필수입니다.
+ **event** - 작업을 호출하는 이전 요소의 이벤트를 정의합니다. 유효한 값은 `click`, `dblclick`, `mouseenter`입니다. `mouseenter` 이벤트는 `html` 작업과 함께 사용해야만 합니다. 기본값은 `click`입니다.

**예제**

다음은 `<cwdb-action>` 태그를 사용하여 Lambda 함수 호출을 사용함으로써 Amazon EC2 인스턴스를 재부팅하는 버튼을 생성하는 방법의 예입니다. 팝업에 호출 성공 또는 실패를 표시합니다.

```
<a class="btn">Reboot Instance</a>
<cwdb-action action="call" endpoint="arn:aws:lambda:us-east-1:123456:function:rebootInstance" display="popup">  
       { "instanceId": "i-342389adbfef" }
</cwdb-action>
```

다음 예는 팝업에 추가 정보를 표시합니다.

```
<a>Click me for more info in popup</a>
<cwdb-action display="popup"> 
   <h1>Big title</h1>
   More info about <b>something important</b>.
</cwdb-action>
```

이 예는 위젯의 콘텐츠를 Lambda 함수에 대한 호출로 바꾸는 [**다음(Next)**] 버튼입니다.

```
<a class="btn btn-primary">Next</a>
<cwdb-action action="call" endpoint="arn:aws:lambda:us-east-1:123456:function:nextPage"> 
   { "pageNum": 2 }
</cwdb-action>
```

# CloudWatch 대시보드에 대한 사용자 지정 위젯 생성
<a name="add_custom_widget_dashboard_create"></a>

사용자 지정 위젯을 생성하려면 AWS에서 제공하는 샘플 중 하나를 사용하거나 직접 생성하면 됩니다. AWS 샘플은 JavaScript와 Python 샘플을 모두 포함하며 AWS CloudFormation 스택에 의해 생성됩니다. 샘플 목록은 [CloudWatch 대시보드에 대한 샘플 사용자 지정 위젯](add_custom_widget_samples.md) 단원을 참조하세요.

**CloudWatch 대시보드에서 사용자 지정 위젯을 생성하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. **\$1** 기호를 선택합니다.

1. [**사용자 지정 위젯(Custom widget)**]을 선택합니다.

1. 다음 방법 중 한 가지를 선택하세요.
   + AWS에서 제공하는 샘플 사용자 지정 위젯을 사용하려면 다음을 수행합니다.

     1. 드롭다운 상자에서 샘플을 선택합니다.

        CloudFormation 콘솔이 새 브라우저에서 시작됩니다. CloudFormation 콘솔에서 다음을 수행합니다.

     1. (선택 사항) CloudFormation 스택 이름을 사용자 지정합니다.

     1. 샘플에 사용되는 파라미터를 선택합니다.

     1. **I acknowledge that AWS CloudFormation might create IAM resources**(에서 IAM 리소스를 생성할 수 있음을 인정합니다)를 선택하고 **Create stack**(스택 생성)을 선택합니다.
   + AWS에서 제공하는 자체 사용자 지정 위젯을 생성하려면 다음을 수행합니다.

     1. **다음**을 선택합니다.

     1. 목록에서 Lambda 함수 선택 또는 Amazon 리소스 이름(ARN) 입력을 선택합니다. 목록에서 선택하는 경우 함수가 있는 리전 및 사용할 버전도 지정합니다.

     1. [**파라미터(Parameters)**]에서 함수에 사용되는 파라미터를 선택합니다.

     1. 위젯의 제목을 입력합니다.

     1. [**업데이트 시점(Update on)**]에서 위젯을 업데이트해야 하는 시점(Lambda 함수를 다시 호출해야 하는 시점)을 구성합니다. 대시보드가 ​​자동으로 새로 고쳐질 때 업데이트하려면 [**새로 고침(Refresh)**], 위젯 크기가 조정될 때마다 업데이트하려면 [**크기 조정(Resize)**] 또는 그래프를 확대했을 때를 포함하여 대시보드의 시간 범위가 조정될 때마다 업데이트하려면 [**시간 범위(Time Range)**]를 선택하되 하나 이상을 선택할 수 있습니다.

     1. 미리 보기가 ​​마음에 들면 [**위젯 생성(Create widget)**]을 선택합니다.

# CloudWatch 대시보드에 대한 샘플 사용자 지정 위젯
<a name="add_custom_widget_samples"></a>

AWS는 JavaScript 및 Python 샘플 사용자 지정 위젯을 모두 제공합니다. 아래에 있는 목록의 각 위젯에 대한 링크를 사용하여 이러한 샘플 위젯을 생성할 수 있습니다. 또는 CloudWatch 콘솔을 사용하여 위젯을 생성하고 사용자 지정할 수 있습니다. 아래에 있는 목록의 링크는 AWS CloudFormation 콘솔을 열고 CloudFormation 빠른 생성 링크를 사용하여 사용자 지정 위젯을 생성합니다.

또한 [GitHub](https://github.com/aws-samples/cloudwatch-custom-widgets-samples)에서 사용자 지정 위젯 샘플에 액세스할 수도 있습니다.

이 목록 다음에는 각 언어에 대한 Echo 위젯의 전체 예가 나와 있습니다.

------
#### [ JavaScript ]

**JavaScript 샘플 사용자 지정 위젯**
+ [ Echo](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetEcho-js&template=customWidgets/customWidgetEcho-js.yaml&param_DoCreateExampleDashboard=Yes) - 새 위젯을 작성할 필요 없이 HTML이 사용자 지정 위젯에 어떻게 표시되는지 테스트하는 데 사용할 수 있는 기본 Echo 샘플입니다.
+ [ Hello world](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetHelloWorld-js&template=customWidgets/customWidgetHelloWorld-js.yaml&param_DoCreateExampleDashboard=Yes) – 매우 기본적인 시작 위젯입니다.
+ [ 사용자 위젯 디버거](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetDebugger-js&template=customWidgets/customWidgetDebugger-js.yaml&param_DoCreateExampleDashboard=Yes) – Lambda 런타임 환경에 관한 유용한 정보를 표시하는 디버거 위젯입니다.
+ [ CloudWatch Logs Insights 쿼리](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetLogsInsightsQuery-js&template=customWidgets/customWidgetLogsInsightsQuery-js.yaml&param_DoCreateExampleDashboard=Yes) – CloudWatch Logs Insights 쿼리를 실행하고 편집합니다.
+ [ Amazon Athena 쿼리 실행](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetAthenaQuery-js&template=customWidgets/customWidgetAthenaQuery-js.yaml&param_DoCreateExampleDashboard=Yes) – Athena 쿼리를 실행하고 편집합니다.
+ [AWS API 호출](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetAwsCall-js&template=customWidgets/customWidgetAwsCall-js.yaml&param_DoCreateExampleDashboard=Yes) – 읽기 전용 AWS API를 호출하고 결과를 JSON 형식으로 표시합니다.
+ [ 빠른 CloudWatch 비트맵 그래프](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetCloudWatchBitmapGraph-js&template=customWidgets/customWidgetCloudWatchBitmapGraph-js.yaml&param_DoCreateExampleDashboard=Yes) – 빠른 표시를 위해 서버 측에서 사용하는 CloudWatch 그래프를 렌더링합니다.
+ [ CloudWatch 대시보드의 텍스트 위젯](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetIncludeTextWidget-js&template=customWidgets/customWidgetIncludeTextWidget-js.yaml&param_DoCreateExampleDashboard=Yes) – 지정된 CloudWatch 대시보드의 첫 번째 텍스트 위젯을 표시합니다.
+ [ 테이블로 CloudWatch 지표 데이터 표시](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetCloudWatchMetricDataTable-js&template=customWidgets/customWidgetCloudWatchMetricDataTable-js.yaml&param_DoCreateExampleDashboard=Yes) – 원시 CloudWatch 지표 데이터를 테이블로 표시합니다.
+ [ Amazon EC2 테이블](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetEc2Table-js&template=customWidgets/customWidgetEc2Table-js.yaml&param_DoCreateExampleDashboard=Yes) – CPU 사용률을 기준으로 상위 EC2 인스턴스를 표시합니다. 이 위젯에는 기본적으로 사용 중지된 재부팅 버튼도 포함되어 있습니다.
+ [AWS CodeDeploy 배포](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetCodeDeploy-js&template=customWidgets/customWidgetCodeDeploy-js.yaml&param_DoCreateExampleDashboard=Yes) – CodeDeploy 배포를 표시합니다.
+ [AWS Cost Explorer](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetCostExplorerReport-js&template=customWidgets/customWidgetCostExplorerReport-js.yaml&param_DoCreateExampleDashboard=Yes) 보고서 – 선택한 시간 범위에 대한 각 AWS 서비스의 비용에 관한 보고서를 표시합니다.
+ [ 외부 URL의 내용 표시](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetFetchURL-js&template=customWidgets/customWidgetFetchURL-js.yaml&param_DoCreateExampleDashboard=Yes) – 외부에서 액세스할 수 있는 URL의 내용을 표시합니다.
+ [ Amazon S3 객체 표시](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetS3GetObject-js&template=customWidgets/customWidgetS3GetObject-js.yaml&param_DoCreateExampleDashboard=Yes) – 계정의 Amazon S3 버킷에 있는 객체를 표시합니다.
+ [ 단순 SVG 파이 차트](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetSimplePie-js&template=customWidgets/customWidgetSimplePie-js.yaml&param_DoCreateExampleDashboard=Yes) – 그래픽 SVG 기반 위젯의 예입니다.

------
#### [ Python ]

**Python 샘플 사용자 지정 위젯**
+ [ Echo](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetEcho-py&template=customWidgets/customWidgetEcho-py.yaml&param_DoCreateExampleDashboard=Yes) - 새 위젯을 작성할 필요 없이 HTML이 사용자 지정 위젯에 어떻게 표시되는지 테스트하는 데 사용할 수 있는 기본 Echo 샘플입니다.
+ [ Hello world](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetHelloWorld-py&template=customWidgets/customWidgetHelloWorld-py.yaml&param_DoCreateExampleDashboard=Yes) – 매우 기본적인 시작 위젯입니다.
+ [ 사용자 위젯 디버거](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetDebugger-py&template=customWidgets/customWidgetDebugger-py.yaml&param_DoCreateExampleDashboard=Yes) – Lambda 런타임 환경에 관한 유용한 정보를 표시하는 디버거 위젯입니다.
+ [AWS API 호출](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetAwsCall-py&template=customWidgets/customWidgetAwsCall-py.yaml&param_DoCreateExampleDashboard=Yes) – 읽기 전용 AWS API를 호출하고 결과를 JSON 형식으로 표시합니다.
+  [ 빠른 CloudWatch 비트맵 그래프](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetCloudWatchBitmapGraph-py&template=customWidgets/customWidgetCloudWatchBitmapGraph-py.yaml&param_DoCreateExampleDashboard=Yes) – 빠른 표시를 위해 서버 측에서 사용하는 CloudWatch 그래프를 렌더링합니다.
+  [ 이메일로 대시보드 스냅샷 전송](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetEmailDashboardSnapshot-py&template=customWidgets/customWidgetEmailDashboardSnapshot-py.yaml&param_DoCreateExampleDashboard=Yes) – 현재 대시보드의 스냅샷을 생성하여 이메일 수신자에게 전송합니다.
+  [ Amazon S3에 대시보드 스냅샷 전송](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetSnapshotDashboardToS3-py&template=customWidgets/customWidgetSnapshotDashboardToS3-py.yaml&param_DoCreateExampleDashboard=Yes) – 현재 대시보드의 스냅샷을 생성하여 Amazon S3에 저장합니다.
+ [ CloudWatch 대시보드의 텍스트 위젯](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetIncludeTextWidget-py&template=customWidgets/customWidgetIncludeTextWidget-py.yaml&param_DoCreateExampleDashboard=Yes) – 지정된 CloudWatch 대시보드의 첫 번째 텍스트 위젯을 표시합니다.
+ [ 외부 URL의 내용 표시](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetFetchURL-py&template=customWidgets/customWidgetFetchURL-py.yaml&param_DoCreateExampleDashboard=Yes) – 외부에서 액세스할 수 있는 URL의 내용을 표시합니다.
+ [ RSS 리더](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetRssReader-py&template=customWidgets/customWidgetRssReader-py.yaml&param_DoCreateExampleDashboard=Yes) - RSS 피드를 표시합니다.
+ [ Amazon S3 객체 표시](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetS3GetObject-py&template=customWidgets/customWidgetS3GetObject-py.yaml&param_DoCreateExampleDashboard=Yes) – 계정의 Amazon S3 버킷에 있는 객체를 표시합니다.
+ [ 단순 SVG 파이 차트](https://console.aws.amazon.com/cloudwatch/cfn.js?region=us-east-1&action=create&stackName=customWidgetSimplePie-py&template=customWidgets/customWidgetSimplePie-py.yaml&param_DoCreateExampleDashboard=Yes) – 그래픽 SVG 기반 위젯의 예입니다.

------

**JavaScript Echo 위젯**

다음은 JavaScript Echo 샘플 위젯입니다.

```
const DOCS = `
## Echo
A basic echo script. Anything passed in the \`\`\`echo\`\`\` parameter is returned as the content of the custom widget.
### Widget parameters
Param | Description
---|---
**echo** | The content to echo back
 
### Example parameters
\`\`\` yaml
echo: <h1>Hello world</h1>
\`\`\`
`;
 
exports.handler = async (event) => {
    if (event.describe) {
        return DOCS;   
    }
    
    let widgetContext = JSON.stringify(event.widgetContext, null, 4);
    widgetContext = widgetContext.replace(/</g, '&lt;');
    widgetContext = widgetContext.replace(/>/g, '&gt;');
    
    return `${event.echo || ''}<pre>${widgetContext}</pre>`;
};
```

**Python Echo 위젯**

다음은 Python Echo 샘플 위젯입니다.

```
import json
     
DOCS = """
## Echo
A basic echo script. Anything passed in the ```echo``` parameter is returned as the content of the custom widget.
### Widget parameters
Param | Description
---|---
**echo** | The content to echo back
     
### Example parameters
``` yaml
echo: <h1>Hello world</h1>
```"""
 
def lambda_handler(event, context):
    if 'describe' in event:
        return DOCS
        
    echo = event.get('echo', '')
    widgetContext = event.get('widgetContext')
    widgetContext = json.dumps(widgetContext, indent=4)
    widgetContext = widgetContext.replace('<', '&lt;')
    widgetContext = widgetContext.replace('>', '&gt;')
        
    return f'{echo}<pre>{widgetContext}</pre>'
```

**Java Echo 위젯**

다음은 Java Echo 샘플 위젯입니다.

```
package example;
 
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
 
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
 
public class Handler implements RequestHandler<Event, String>{
 
  static String DOCS = ""
    + "## Echo\n"
    + "A basic echo script. Anything passed in the ```echo``` parameter is returned as the content of the custom widget.\n"
    + "### Widget parameters\n"
    + "Param | Description\n"
    + "---|---\n"
    + "**echo** | The content to echo back\n\n"
    + "### Example parameters\n"
    + "```yaml\n"
    + "echo: <h1>Hello world</h1>\n"
    + "```\n";
 
  Gson gson = new GsonBuilder().setPrettyPrinting().create();
 
  @Override
  public String handleRequest(Event event, Context context) {
 
    if (event.describe) {
      return DOCS;
    }
     
    return (event.echo != null ? event.echo : "") + "<pre>" + gson.toJson(event.widgetContext) + "</pre>";
  }
}
     
class Event {
 
    public boolean describe;
    public String echo;
    public Object widgetContext;
 
    public Event() {}
 
    public Event(String echo, boolean describe, Object widgetContext) {
        this.describe = describe;
        this.echo = echo;
        this.widgetContext = widgetContext;
    }
}
```

# CloudWatch 대시보드에 텍스트 위젯 추가
<a name="add_text_dashboard"></a>

**대시보드에 텍스트 위젯을 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. **\$1** 기호를 선택합니다.

1. **텍스트**를 선택합니다.

1. **마크다운**에서 텍스트를 추가하고 [마크다운](https://docs.aws.amazon.com/general/latest/gr/aws-markdown.html)을 사용하여 서식을 지정하고 **위젯 생성**을 선택합니다.

1. 텍스트 위젯을 투명하게 만들려면 **투명 배경**을 선택합니다.

1. **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 텍스트 위젯 편집
<a name="edit_text_dashboard"></a>

**대시보드에서 텍스트 위젯을 편집하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 텍스트 블록의 오른쪽 상단 모서리에 마우스를 가져가서 **위젯 작업(Widget actions)**을 선택합니다. 그런 다음 **편집(Edit)**을 선택합니다.

1. 필요에 따라 텍스트를 업데이트하고 **위젯 업데이트**를 선택합니다.

1. **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 텍스트 위젯 제거
<a name="remove_text_dashboard"></a>

**대시보드에서 텍스트 위젯을 제거하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 텍스트 블록의 오른쪽 상단 모서리에 마우스를 가져가서 **위젯 작업(Widget actions)**을 선택합니다. 그런 다음 **삭제**를 선택합니다.

1. **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에 경보 추가
<a name="add_alarm_dashboard"></a>

**대시보드에 그래프를 포함하여 단일 경보를 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **경보**를 선택하고 추가할 경보를 선택한 다음 **대시보드에 추가**를 선택합니다.

1. 대시보드를 선택하고, 위젯 유형(**행**, **누적 면적** 또는 **번호**)을 선택한 다음 **대시보드에 추가**를 선택합니다.

1. 대시보드에 경보를 표시하려면 탐색 창에서 **대시보드**를 선택하고 해당 대시보드를 선택합니다.

1. (선택 사항) 경보 그래프를 일시적으로 확대하려면 해당 그래프를 선택합니다.

1. (선택 사항) 위젯 유형을 변경하려면 그래프 제목 위로 마우스를 가져가 **위젯 작업**을 선택한 다음** 위젯 유형**을 선택합니다.

# CloudWatch 대시보드에 경보 상태 위젯 추가
<a name="add_alarm_widget_dashboard"></a>

**대시보드에 경보 상태 위젯을 추가하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. **\$1** 기호를 선택합니다.

1. **경보 상태(Alarm status)**를 선택합니다.

1. 위젯에 추가하려는 경보 옆의 확인란을 선택한 다음, **위젯 생성(Create widget)**을 선택합니다.

1. **대시보드에 추가**를 선택합니다.

# CloudWatch 대시보드에서 경보 위젯 제거
<a name="remove_alarm_dashboard"></a>

**대시보드에서 경보 위젯을 제거하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 위젯 위로 마우스를 가져가 **위젯 작업**을 선택한 다음 **삭제**를 선택합니다.

1. **대시보드 저장**을 선택합니다. 변경 사항을 저장하기 전에 대시보드에서 다른 곳으로 이동하려고 시도하면 변경 사항을 저장하거나 삭제하라는 메시지가 나타납니다.

# CloudWatch 대시보드에서 데이터 테이블 위젯 사용
<a name="add_remove_table_dashboard"></a>

**테이블 속성**

데이터 테이블에는 옵션이나 소스를 변경할 필요가 없는 기본 속성 세트가 있습니다. 이러한 속성에는 스티키 레이블 열, 활성화된 모든 요약 열, 반올림된 데이터 포인트, 변환된 단위 등이 포함됩니다.

각 데이터 테이블 위젯은 다음 속성을 가질 수 있습니다. 각 속성에 대한 정보에는 대시보드의 JSON 소스에서 속성을 구성하는 방법이 포함됩니다. 대시보드 JSON에 대한 자세한 내용은 [Dashboard Body Structure and Syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CloudWatch-Dashboard-Body-Structure.html)를 참조하세요.

**요약**  
요약 열은 데이터 테이블 위젯에 도입된 새로운 속성입니다. 이러한 열은 현재 테이블 요약의 특정 하위 세트입니다. 예를 들어, **합계** 요약은 해당 행에 표시된 모든 데이터 포인트의 합계입니다. 요약 열은 CloudWatch 통계와 다릅니다. 소스에서 다음과 같이 표시됩니다.  

```
 "table": {
        "summaryColumns": [
            "MIN",
            "MAX",
            "SUM",
            "AVG"
        ]
    },
```

**임곗값**  
이를 사용하여 테이블에 임곗값을 적용합니다. 데이터 포인트가 임곗값 내에 속하면 해당 셀이 임곗값 색상으로 강조 표시됩니다. 소스에서 다음과 같이 표시됩니다.  

```
"annotations": {
    "horizontal": [
        {
            "label": string,
            "value": int,
            "fill": "above" | "below"
        }
    ]
}
```

레이블 열의 단위  
지표와 관련된 단위를 표시하려면 이 옵션을 활성화하여 레이블 옆의 레이블 열에 단위를 표시합니다. 소스에서 다음과 같이 표시됩니다.  

```
"yAxis": {
    "left": {
        "showUnits": true | false
    }
}
```

**행 및 열 반전**  
이렇게 하면 테이블이 변환되어 데이터 포인트가 열에서 행으로 바뀌고 지표가 열이 됩니다. 소스에서 다음과 같이 표시됩니다.  

```
 "table": {
    "layout": "vertical" | "horizontal"
}
```

**스티키 요약 열**  
이렇게 하면 요약 열이 고정되어 스크롤하는 동안 요약 열이 계속 표시됩니다. 레이블은 이미 고정되어 있습니다. 소스에서 다음과 같이 표시됩니다.  

```
"table": {
    "stickySummary": true | false
}
```

**요약 열만 표시**  
이렇게 하면 레이블 및 요약 열만 표시되도록 데이터 포인트의 열이 표시되지 않습니다. 소스에서 다음과 같이 표시됩니다.  

```
 "table": {
    "showTimeSeriesData": false | true
}
```

**라이브 데이터**  
아직 완전히 집계되지 않았더라도 가장 최근의 데이터 포인트를 표시합니다. 소스에서 다음과 같이 표시됩니다.  

```
"liveData": true | false
```

**숫자 위젯 형식**  
반올림하여 변환하기 전에 셀에 들어갈 수 있는 자릿수만큼 표시합니다. 소스에서 다음과 같이 표시됩니다.  

```
"singleValueFullPrecision": true | false
```

# CloudWatch 대시보드에 데이터 테이블 위젯 추가
<a name="add_table_dashboard"></a>

**대시보드에 데이터 테이블 위젯 추가**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드**를 선택한 다음, 대시보드를 선택합니다.

1. **\$1** 버튼을 선택하고 **데이터 테이블**을 선택한 후 **다음**을 선택합니다.

1. **찾아보기** 탭에서 테이블 위젯에 표시하려는 지표를 검색하거나 찾아봅니다. 그런 다음, 지표를 선택합니다.

1. (선택 사항) 테이블의 레이아웃을 변경하려면 **옵션** 탭을 선택하고 **행 및 열 반전**을 선택합니다.

   또한 **옵션** 탭을 사용하여 테이블에 나타나는 열을 변경하고 **레이블** 열에 사용 중인 단위를 표시할 수 있습니다.
**작은 정보**  
임곗값을 더 정확하게 표시하려면 **반올림 전에 들어갈 수 있는 자릿수 표시**를 선택합니다.

1. (선택 사항) 데이터 테이블 위젯의 시간 범위를 변경하려면 위젯의 상단 영역에서 미리 정의된 시간 범위 중 하나를 선택합니다. 시간 범위는 1시간에서 1주일입니다. 고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

1. (선택 사항) 데이터 테이블 위젯의 시간 범위를 변경하려면 위젯의 상단 영역에서 미리 정의된 시간 범위 중 하나를 선택합니다. 시간 범위는 1시간에서 1주일입니다. 고유한 시간 범위를 설정하려면 **사용자 지정**을 선택합니다.

1. (선택 사항) 나중에 대시보드의 나머지 시간 범위가 변경되더라도 이 위젯에는 선택한 시간 범위가 계속 사용되게 하려면 **시간 범위 유지**를 선택합니다.

1. **위젯 생성**을 선택한 다음 **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 데이터 테이블 위젯 제거
<a name="remove_table_dashboard"></a>

**대시보드에서 데이터 테이블 위젯을 제거하려면 다음을 수행하세요.**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. 제거하려는 위젯의 오른쪽 상단에서 **위젯 작업**, **삭제**를 선택합니다.

1. **대시보드 저장**을 선택합니다.

# CloudWatch 대시보드에서 그래프 연결
<a name="link_graphs_dashboard"></a>

시간에 따른 변화가 모든 그래프에 반영되도록 CloudWatch 대시보드의 그래프를 링크합니다.

**대시보드에서 그래프들을 링크하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. **작업**을 선택한 후 **그래프 연결**을 선택합니다.

# CloudWatch 대시보드에서 그래프 연결 해제
<a name="unlink_graphs_dashboard"></a>

**대시보드에서 그래프들의 링크를 해제하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **대시보드(Dashboards)**를 선택한 다음, 대시보드를 선택합니다.

1. **작업**과 **그래프 연결**의 선택을 차례로 취소합니다.