파워팩 위젯

파워팩 위젯 (Powerpack Widget)

출처: 문서

본문

개요 (Overview)

파워팩(Powerpack)은 재사용 가능한 대시보드 구성 블록으로 그래프 작성 전문성을 확장해주는, 템플릿화된 위젯 그룹이에요. 파워팩은 사전 설정(프리셋, Datadog이 만들고 모든 고객이 사용 가능) 또는 사용자 지정(Datadog 사용자가 만들고 해당 조직 내에서만 사용 가능) 중 하나예요. 파워팩 모범 사례에 대한 자세한 내용은 파워팩으로 그래프 작성 전문성 확장하기(Scale Graphing expertise with Powerpacks) 가이드를 참고하세요.

참고: 파워팩 위젯은 스크린보드에서 지원되지 않아요.

설정 (Setup)

파워팩 만들기 (Creating a Powerpack)

대시보드의 기존 그룹에서 파워팩을 만들 수 있어요.

1. 대시보드 그룹 헤더에서 파워팩으로 저장(Save as Powerpack) 아이콘을 클릭해요.
2. 조직에서 파워팩을 찾을 수 있도록 세부 정보를 입력해요.
3. 검색 카테고리 추가(Add Search Categories)에서 태그를 추가해 파워팩을 정리해요. 이렇게 하면 팀원들이 대시보드에 추가할 올바른 파워팩을 찾을 수 있어요.
4. 파워팩 사용자에게 구성 가능하게 할 필터를 선택해요.

참고: 파워팩을 만들면 원래 그룹은 파워팩 인스턴스로 대체돼요.

파워팩 업데이트 (Updating a Powerpack)

파워팩에 대한 변경 사항은 파워팩이 사용되는 모든 대시보드에 동기화돼요.

파워팩의 모양 또는 레이아웃을 변경하려면:

1. 헤더에 마우스를 올리고 케밥 메뉴를 클릭해요.
2. Powerpack 작업(Powerpack Actions) 메뉴에서 파워팩 레이아웃 편집(Edit Powerpack Layout)을 선택해요. 참고: 파워팩 레이아웃은 타임보드에서 편집할 수 없어요.
3. 파워팩 레이아웃 또는 개별 위젯에 원하는 변경 사항을 적용하고 변경 사항 확인(Confirm Changes)을 선택해요.
4. 이 파워팩이 여러 대시보드에서 사용되는 경우, 이 업데이트의 영향을 받는 파워팩 인스턴스를 확인하는 프롬프트가 열려요.

파워팩 세부 정보(Details)를 변경하려면:

1. 헤더에 마우스를 올리고 케밥 메뉴를 클릭해요.
2. Powerpack 작업 메뉴에서 파워팩 세부 정보 편집(Edit Powerpack Details)을 선택해요.
3. 파워팩 정보, 검색 카테고리 또는 필터 구성을 변경하고 파워팩 업데이트(Update Powerpack)를 선택해요.
4. 이 파워팩이 여러 대시보드에서 사용되는 경우, 이 업데이트의 영향을 받는 파워팩 인스턴스를 확인하는 프롬프트가 열려요.

참고: 파워팩을 업데이트하거나 권한을 수정하려면 편집 권한이 있어야 해요.

파워팩 사용 (Using Powerpacks)

파워팩 인스턴스 추가 또는 제거 (Add or remove a Powerpack instance)

파워팩을 만든 후에는 해당 파워팩의 인스턴스를 여러 대시보드에 추가할 수 있어요.

대시보드에 파워팩 인스턴스를 추가하려면:

1. 위젯 추가(Add Widgets)를 클릭해 위젯 트레이를 열어요.
2. Powerpacks 탭을 클릭해 사용 가능한 파워팩을 확인해요. 텍스트 또는 사전 정의된 태그로 검색할 수 있어요.
3. 원하는 파워팩을 클릭해서 파워팩 인스턴스 구성을 열어요.
4. 필터 값과 필터 제어 방식을 선택해요.
   • 파워팩 필터 - 선택한 값이 파워팩 인스턴스 내부의 위젯에 적용돼요.
   • 대시보드 필터 - 대시보드 템플릿 변수로 제어돼요.
5. 확인(Confirm)을 클릭해요.

대시보드에서 파워팩 인스턴스를 제거하려면:

1. 인스턴스 헤더의 케밥 메뉴를 클릭해요.
2. 대시보드에서 제거(Remove from Dashboard)를 선택해요.

파워팩 인스턴스 사용자화 (Customizing a Powerpack instance)

파워팩 인스턴스에 대한 변경 사항은 다른 대시보드의 다른 파워팩 인스턴스에는 적용되지 않아요.

대시보드에 표시된 파워팩 인스턴스를 사용자화하려면:

1. 인스턴스 헤더의 케밥 메뉴를 클릭해요.
2. Powerpack 작업 메뉴에서 옵션을 선택해요.
   1. 표시 옵션 편집(Edit Display Options): 그룹 헤더 스타일, 표시 색상, 이름을 사용자화해요.
   2. 인스턴스 분리(Detach Instance): 인스턴스를 원래 파워팩에서 연결 해제해요.
   3. 대시보드에서 제거(Remove from Dashboard): 대시보드에서 인스턴스를 제거해요.
   4. 파워팩 레이아웃 편집(Edit Powerpack Layout): 인스턴스의 위젯 레이아웃을 사용자화해요.
   5. 파워팩 세부 정보 편집(Edit Powerpack Details): 제목, 설명, 연결된 태그를 사용자화해요.
3. 헤더의 새로운 스타일 옵션을 선택하고, 그룹 제목을 업데이트하거나, 파워팩이 사용하는 필터를 구성해요.
4. 파워팩 인스턴스의 태그 값을 구성해요.

파워팩 삭제 (Deleting a Powerpack)

파워팩을 삭제할 수 있는 사람은 작성자뿐이에요. 파워팩을 삭제한 후에도 기존 파워팩 인스턴스는 그대로 유지되지만, 파워팩이 삭제되었음을 나타내는 알림을 표시해요. 이 알림을 제거하려면 인스턴스를 분리하고 위젯 그룹으로 변환하세요.

파워팩을 삭제하려면:

1. 위젯 추가(Add Widgets)를 클릭해 위젯 트레이를 열어요.
2. 파워팩 삭제(Delete Powerpack)를 선택해요.

파워팩 권한 (Powerpack permissions)

파워팩의 편집 권한을 변경하려면:

1. 헤더에 마우스를 올리고 케밥 메뉴를 클릭해요.
2. Powerpack 작업 메뉴에서 권한 수정(Modify Permissions)을 선택해요.
3. 파워팩에 대해 편집 권한을 가질 사용자를 업데이트해요.

API

이 위젯은 **대시보드 API**와 함께 사용할 수 있어요. 위젯 JSON 스키마 정의에 대해서는 다음 표를 참고하세요.

예시:

{
  "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"
}

더 알아보기 (Learn more)

• 파워팩으로 그래프 작성 전문성 확장하기 (Scale Graphing Expertise with Powerpacks)
• 파워팩으로 대시보드 위젯을 재사용 가능한 그룹으로 저장하기
• 그룹 위젯 (Group Widget)
• JSON을 사용해서 대시보드 만들기 (Building Dashboards using JSON)