diff --git a/content/ko/docs/guides/asset-inventory/metric-explorer.md b/content/ko/docs/guides/asset-inventory/metric-explorer.md index f40a4f12..005492f0 100644 --- a/content/ko/docs/guides/asset-inventory/metric-explorer.md +++ b/content/ko/docs/guides/asset-inventory/metric-explorer.md @@ -31,17 +31,17 @@ title: 리소스 분석 ##### **3. 옵션 활용** -![](/guides/asset_inventory/metric-explorer-view-01-ko.png) +![](/guides/asset_inventory/metric-explorer-view-01-02_ko.png) -➊ 연산자: 총합(Sum) / 평균값(Average) / 최대값(Max) / 최소값(Min)중에 하나를 선택합니다. +➊ **연산자**: 총합(Sum) / 평균값(Average) / 최대값(Max) / 최소값(Min)중에 하나를 선택합니다. -➋ 세부 기준: 일별 또는 월별 데이터 확인이 가능합니다. +➋ **세부 기준**: 일별 또는 월별 데이터 확인이 가능합니다. -➌ 기간: 선택한 '세부 기준'에 따라 그에 맞는 기간을 선택할 수 있습니다. +➌ **기간**: 선택한 '세부 기준'에 따라 그에 맞는 기간을 선택할 수 있습니다. -➍ 필터: 다양한 옵션을 활용하여, 원하는 데이터로 필터하여 확인할 수 있습니다. +➍ **필터**: 다양한 옵션을 활용하여, 원하는 데이터로 필터하여 확인할 수 있습니다. -➎ 그룹별 통계: 다중의 Group-by를 클릭하여 주요 데이터를 빠르게 확인할 수 있습니다. +➎ **그룹별 통계**: 다중의 Group-by를 클릭하여 주요 데이터를 빠르게 확인할 수 있습니다.
@@ -49,11 +49,7 @@ title: 리소스 분석 * 선(Line) 그래프/ 바(Bar) 차트 / 트리맵 / 도넛 차트 등 다양한 차트 타입으로 데이터를 확인해 볼 수 있습니다. -![](/guides/asset_inventory/metric-explorer-view-02.png) - -* 소스 코드 아이콘 클릭 시, 해당 메트릭의 쿼리를 확인할 수 있습니다. - -![](/guides/asset_inventory/metric-explorer-view-02_2.png) +![](/guides/asset_inventory/metric-explorer-view-02-02_ko.png)
@@ -65,52 +61,77 @@ title: 리소스 분석

-## 사용자 정의 메트릭(지표) +## 예제 추가/관리 -제공하는 메트릭 외에도 사용자가 직접 정의한 지표를 추가할 수 있습니다. +메트릭 별로 연산자, 기간, 필터 등과 같은 옵션값을 가지는 예제 데이터를 생성할 수 있습니다.
-**방법 1) 기존의 메트릭을 '복제' 하여 새로 생성** +##### **1. 예제 추가** -우측 상단 \[복제] 버튼을 통해서 기존의 메트릭을 복제할 수 있습니다. +특정 메트릭 페이지의 '`연산자`', '`세부 기준`', '`기간`', '`필터`', '`그룹별 통계`' 값을 지정한 후, 우측 상단에 **\[+ 예제 추가]** 버튼을 통해 저장 시, 세부 설정값들이 데이터에 모두 포함되어 저장됩니다. -![](/guides/asset_inventory/metric-explorer-duplicate-ko.png) +![](/guides/asset_inventory/metric-explorer-add-example-02-ko.png) -**방법 2) 쿼리를 통한 직접 생성** +* 추가된 예제는 해당 메트릭의 하위에 위치하게 됩니다. -좌측 사이드바의 \[+] 버튼을 통해 사용자 쿼리를 입력하고 새로운 지표를 생성할 수 있습니다. +![](/guides/asset_inventory/metric-explorer-add-02-example-ko.png) -![](/guides/asset_inventory/metric-explorer-add-query-01-ko.png) +* 생성 후에도 여러 설정 값을 변경하여 바로 **\[저장]** 하거나, **\[다른 이름으로 저장]** 할 수 있습니다. -![](/guides/asset_inventory/metric-explorer-add-query-02-ko.png) +![](/guides/asset_inventory/metric-explorer-add-04-example-ko.png) -위와 같이 직접 생성 또는 복제된 메트릭의 경우, 쿼리를 수정할 수 있습니다. +* 예제는 이름 수정 및 삭제가 가능합니다. -![](/guides/asset_inventory/metric-explorer-edit-query-ko.png) +![](/guides/asset_inventory/metric-explorer-add-03-example.png)

-## 샘플 데이터 생성/관리 +## 사용자 정의 메트릭(지표) -메트릭 별로 연산자, 기간, 필터 등과 같은 옵션값을 가지는 샘플 데이터를 생성할 수 있습니다. +제공하는 메트릭 외에도 사용자가 직접 정의한 지표를 추가할 수 있습니다.
-##### **1. 샘플 데이터 추가** +**방법 1) 기존의 메트릭을 '복제' 하여 새로 생성** -특정 메트릭 페이지의 '`연산자`', '`세부 기준`', '`기간`', '`필터`', '`그룹별 통계`' 값을 지정한 후, 우측 상단에 **\[+ 샘플 추가]** 버튼을 통해 저장 시, 세부 설정값들이 데이터에 모두 포함되어 저장됩니다. +기본 제공하는 메트릭의 경우 쿼리 수정이 불가합니다. 대신, 메트릭을 복제하게 되면 직접 쿼리를 수정할 수 있습니다. -![](/guides/asset_inventory/metric-explorer-add-example-ko.png) +우측 상단 \[복제] 버튼을 통해서 기존의 메트릭을 복제할 수 있습니다. -* 추가된 샘플은 해당 메트릭의 하위에 위치하게 됩니다. +![](/guides/asset_inventory/metric-explorer-duplicate-02-ko.png) -![](/guides/asset_inventory/metric-explorer-add-02-example-ko.png) +**방법 2) 쿼리 입력을 통한 직접 생성** -* 생성 후에도 여러 설정 값을 변경하여 바로 **\[저장]** 하거나, **\[다른 이름으로 저장]** 할 수 있습니다. +특정 네임스페이스 선택시, 좌측 사이드바의 **\[+]** 버튼을 확인할 수 있습니다. 이는 해당 네임스페이스에 **사용자 정의 메트릭**을 추가하기 위한 버튼입니다. -![](/guides/asset_inventory/metric-explorer-add-04-example-ko.png) +![](/guides/asset_inventory/metric-explorer-add-query-01-ko.png) -* 메트릭 샘플의 이름 수정 및 삭제가 가능합니다. +![](/guides/asset_inventory/metric-explorer-add-query-02-ko.png) -![](/guides/asset_inventory/metric-explorer-add-03-example.png) +위와 같이 **직접 생성** 또는 **복제**된 사용자 지정 메트릭의 경우, \[쿼리 수정] 버튼을 통해 해당 쿼리를 수정할 수 있습니다. + +![](/guides/asset_inventory/metric-explorer-edit-query-02-ko.png) + +
+ +다음의 가이드 대로 쿼리를 작성할 수 있습니다. + +
+ +**\[지원하는 API 참고]** + +* **cost-analysis** + * Cost.analyze: `TIME-SERIES` + * BudgetUsage.analyze: `TIME-SERIES` +* **inventory** + * CloudService.analyze: `REAL-TIME` + * Metric.analyze: `TIME-SERIES` + * CloudServiceStats.analyze: `TIME-SERIES` → `TO BE DPRECATED` + +| Parameter | Type | Description | Example | +| --------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| unwind | list of object | 특정 Array 타입 필드를 별도 Row로 분리.

a = data.listeners = \[{…}, {…}, {…}]

# 아래와 같이 변경
a1 = data.listeners = {…}
a2 = data.listeners = {…}
a3 = data.listeners = {…}
| 
{
  "unwind": {
    "path": "data.listeners"
  }
}
| +| group\_by | list of string | 데이터를 그룹화하는 조건으로 API 마다 지원 범위가 다름. | 
{
  "group\_by": \[
    "product",
    "region\_code",
    "..."
  ]
}
| +| filter | list of object | 데이터를 필터링하는 조건으로 기존 쿼리 필터와 동일함. | 
{
  "filter": \[
    {
      "k": "...",
      "v": "...",
      "o": "..."
    },
    {
      "k": "...",
      "v": "...",
      "o": "..."
    }
  ]
}
| +| fields | object | 리턴 되는 데이터를 정의하는 항목으로 각 operator 별로 사용 방법이 다름.

\[지원되는 operator]

**sum**
int 또는 float 필드만 지원

**average**
int 또는 float 필드만 지원

**max**
int 또는 float 필드만 지원

**min**
int 또는 float 필드만 지원

만약 Array Data에 대한 sum, average, max, min 연산 시 `data_type: array` 추가 필요

**count**
key를 필요로하지 않음
고급 operator 주의 필요!

**push**
- 일부 필드 들을 추출하여 Array of Object로 설정
- sub\_group 지원하지 않음
- key 또는 fields 지정 가능
# key 지정 시
\[, , ...]

# fields 지정 시
\[{: , : }, ...]

**add\_to\_set**
- 선언된 필드에 대해 중복 제거하여 Array로 변경
- sub\_group 지원하지 않음 | 
{
  "fields": {
    "usd\_cost\_sum": {
      "key": "usd\_cost",
      "operator": "sum"
    },
    "usd\_cost\_avg": {
      "key": "usd\_cost",
      "operator": "average"
    },
    "usage\_quantity\_max": {
      "key": "usage\_quantity",
      "operator": "max"
    },
    "usd\_cost\_row\_count": {
      "operator": "count"
    },
    "total\_disk\_size": {
      "key": "data.disks.size",
      "operator": "sum",
      "data\_type": "array"
    },
    "cost\_tags": {
      "operator": "push",
      "fields": {
        "name": "tags.Name",
        "service": "tags.Service"
      }
    },
    "cost\_region\_codes": {
      "key": "region\_code",
      "operator": "push"
    },
    "cost\_product\_list": {
      "key": "product",
      "operator": "add\_to\_set"
    }
  }
}
| diff --git a/static/guides/asset_inventory/metric-explorer-add-example-02-en.png b/static/guides/asset_inventory/metric-explorer-add-example-02-en.png new file mode 100644 index 00000000..c071623c Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-add-example-02-en.png differ diff --git a/static/guides/asset_inventory/metric-explorer-add-example-02-ja.png b/static/guides/asset_inventory/metric-explorer-add-example-02-ja.png new file mode 100644 index 00000000..cae9e496 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-add-example-02-ja.png differ diff --git a/static/guides/asset_inventory/metric-explorer-add-example-02-ko.png b/static/guides/asset_inventory/metric-explorer-add-example-02-ko.png new file mode 100644 index 00000000..42b1217d Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-add-example-02-ko.png differ diff --git a/static/guides/asset_inventory/metric-explorer-duplicate-02-en.png b/static/guides/asset_inventory/metric-explorer-duplicate-02-en.png new file mode 100644 index 00000000..6abc6585 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-duplicate-02-en.png differ diff --git a/static/guides/asset_inventory/metric-explorer-duplicate-02-ja.png b/static/guides/asset_inventory/metric-explorer-duplicate-02-ja.png new file mode 100644 index 00000000..43d3fcb5 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-duplicate-02-ja.png differ diff --git a/static/guides/asset_inventory/metric-explorer-duplicate-02-ko.png b/static/guides/asset_inventory/metric-explorer-duplicate-02-ko.png new file mode 100644 index 00000000..71489a5f Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-duplicate-02-ko.png differ diff --git a/static/guides/asset_inventory/metric-explorer-edit-query-02-en.png b/static/guides/asset_inventory/metric-explorer-edit-query-02-en.png new file mode 100644 index 00000000..a7d9f25c Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-edit-query-02-en.png differ diff --git a/static/guides/asset_inventory/metric-explorer-edit-query-02-ja.png b/static/guides/asset_inventory/metric-explorer-edit-query-02-ja.png new file mode 100644 index 00000000..8d1f437e Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-edit-query-02-ja.png differ diff --git a/static/guides/asset_inventory/metric-explorer-edit-query-02-ko.png b/static/guides/asset_inventory/metric-explorer-edit-query-02-ko.png new file mode 100644 index 00000000..4e5b50c0 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-edit-query-02-ko.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-01-02_en.png b/static/guides/asset_inventory/metric-explorer-view-01-02_en.png new file mode 100644 index 00000000..33c1d022 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-01-02_en.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-01-02_ja.png b/static/guides/asset_inventory/metric-explorer-view-01-02_ja.png new file mode 100644 index 00000000..2e7f7eb5 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-01-02_ja.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-01-02_ko.png b/static/guides/asset_inventory/metric-explorer-view-01-02_ko.png new file mode 100644 index 00000000..0b06061b Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-01-02_ko.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-02-02_en.png b/static/guides/asset_inventory/metric-explorer-view-02-02_en.png new file mode 100644 index 00000000..81000e46 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-02-02_en.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-02-02_ja.png b/static/guides/asset_inventory/metric-explorer-view-02-02_ja.png new file mode 100644 index 00000000..78761163 Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-02-02_ja.png differ diff --git a/static/guides/asset_inventory/metric-explorer-view-02-02_ko.png b/static/guides/asset_inventory/metric-explorer-view-02-02_ko.png new file mode 100644 index 00000000..e91638ec Binary files /dev/null and b/static/guides/asset_inventory/metric-explorer-view-02-02_ko.png differ