Powerpack 위젯

개요

스크린보드는 Powerpack 위젯을 지원하지 않습니다.

Powerpacks는 전문 그래프를 재사용 가능한 대시보드 빌딩 블록으로 규모 조정할 수 있는 템플릿 형식의 위젯 그룹입니다. Powerpacks는 사전 설정(Datadog에서 만들고, 모든 고객이 사용 가능)하거나 커스텀(사용자가 만들고, 조직 내에서만 사용 가능)하여 사용할 수 있습니다. Powerpacks 모범 사례에 관한 자세한 내용은 Powerpacks로 전문 그래프 규모 조정하기 가이드를 참고하세요.

설정

Powerpacks 생성

대시보드 기존 그룹에서 Powerpack 만들기

Save as Powerpack 옵션이 강조 표시된 대시보드 그룹 헤더
  1. 대시보드 그룹 헤더에서 “Save as Powerpack” 아이콘을 클릭합니다.
  2. 조직에서 Powerpack을 찾을 수 있도록 상세 내용을 입력합니다.
  3. “Add Search Categories” 아래에 태그를 추가해 Powerpack을 정리합니다. 이렇게 하면 팀원이 올바른 Powerpack을 대시보드에 추가할 수 있습니다.
  4. Powerpack 사용자가 구성해야 할 필터를 선택합니다.

참고: Powerpack을 생성한 후에는 원래 그룹이 Powerpack 인스턴스로 교체됩니다.

Powerpack 업데이트

Powerpack이 사용된 모든 대시보드에 Powerpack 동기화로 변경

Powerpack 레이아웃과 외형을 변경하는 방법:

  1. 헤더에 마우스 커서를 올리고 케밥 메뉴를 클릭합니다.
  2. Powerpack 작업 메뉴에서 Edit Powerpack Layout을 선택합니다.
  3. Powerpack 레이아웃이나 개별 위젯을 수정한 후 Confirm Changes를 선택합니다.
  4. 여러 대시보드에 사용되는 Powerpack의 경우, 이 업데이트에 영향을 미치는 Powerpack 인스턴스를 확인하는 프롬프트가 표시됩니다.
Powerpack을 업데이트하는 작업 메뉴 옵션과 Powerpack 헤더의 케밥 메뉴로 액세스할 수 있는 Powerpack 인스턴스

Powerpack 상세 내용을 변경하는 방법:

  1. 헤더에 마우스 커서를 올리고 케밥 메뉴를 클릭합니다.
  2. Powerpack 작업 메뉴에서 Edit Powerpack Details를 선택합니다.
  3. Powerpack 정보를 변경하고 카테고리를 검색하거나 구성을 필터링한 후 Update Powerpack을 선택합니다.
  4. 여러 대시보드에 사용되는 Powerpack의 경우, 이 업데이트에 영향을 미치는 Powerpack 인스턴스를 확인하는 프롬프트가 표시됩니다.

참고: Powerpack을 업데이트하거나 권한을 수정하려면 편집 권한이 있어야 합니다.

Powerpacks 사용

Powerpack 인스턴스 추가

Powerpack을 생성한 후 여러 대시보드에 Powerpack 인스턴스를 추가할 수 있습니다.

대시보드에 Powerpack 인스턴스를 추가하는 방법:

  1. 위젯 트레이에서 “Powerpack"을 클릭하고 사용 가능한 Powerpacks를 찾습니다. 텍스트나 사전 정의된 태그로도 검색할 수 있습니다.
  2. 대시보드에 추가하고 싶은 Powerpack을 클릭하고 해당 Powerpack 인스턴스를 구성합니다.
  3. 필터 값과 필터 제어 방법을 선택합니다.
    • Powerpack 필터 - 선택한 값이 Powerpack 인스턴스 내 위젯에 적용됩니다.
    • 대시보드 필터 - 대시보드 템플릿 변수에 의해 제어됩니다.
  4. Confirm을 클릭합니다.

Powerpack 인스턴스 사용자 지정

Powerpack 인스턴스를 변경해도 다른 대시보드에 있는 Powerpack 인스턴스에 적용되지 않습니다.

대시보드에 있는 Powerpack 인스턴스를 사용자 지정하는 방법:

  1. 인스턴스 헤더에 있는 케밥 메뉴를 클릭합니다.
  2. 인스턴스 작업 메뉴에서 Edit Display Options를 클릭합니다.
  3. 헤더에 새 스타일 옵션을 선택하고 그룹 타이틀을 업데이트하거나 내 Powerpack에서 사용되는 필터를 구성합니다.
  4. Powerpack 인스턴스의 태그 값을 구성하세요. Add to dashboard를 확인하고 대시보드 템플릿 변수로 사용하세요.
Powerpack 인스턴스 구성 옵션

Powerpack 권한

Powerpack 편집 권한을 변경하는 방법:

  1. 헤더에 마우스 커서를 올리고 케밥 메뉴를 클릭합니다.
  2. Powerpack 작업 메뉴에서 Modify Permissions를 선택합니다.
  3. Powerpack에 편집 권한을 부여할 사용자를 업데이트합니다.

API

이 위젯은 **대시보드 API**와 함께 사용할 수 있습니다. 위젯 JSON 스키마 정의에 대한 다음 표를 참조하세요.

Expand All

항목

유형

설명

background_color

string

Background color of the powerpack title.

banner_img

string

URL of image to display as a banner for the powerpack.

powerpack_id [required]

string

UUID of the associated powerpack.

show_title

boolean

Whether to show the title or not.

default: true

template_variables

object

Powerpack template variables.

controlled_by_powerpack

[object]

Template variables controlled at the powerpack level.

name [required]

string

The name of the variable.

prefix

string

The tag prefix associated with the variable.

values [required]

[string]

One or many template variable values within the saved view, which will be unioned together using OR if more than one is specified.

controlled_externally

[object]

Template variables controlled by the external resource, such as the dashboard this powerpack is on.

name [required]

string

The name of the variable.

prefix

string

The tag prefix associated with the variable.

values [required]

[string]

One or many template variable values within the saved view, which will be unioned together using OR if more than one is specified.

title

string

Title of the widget.

type [required]

enum

Type of the powerpack widget. Allowed enum values: powerpack

default: powerpack

{
  "background_color": "string",
  "banner_img": "string",
  "powerpack_id": "df43cf2a-6475-490d-b686-6fbc6cb9a49c",
  "show_title": false,
  "template_variables": {
    "controlled_by_powerpack": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ],
    "controlled_externally": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ]
  },
  "title": "string",
  "type": "powerpack"
}

참고 자료