Powerpack으로 그래핑 전문성 확장하기
Powerpack은 위젯을 템플릿화한 그룹으로, 그래핑 전문성을 재사용 가능한 대시보드 구성 블록으로 확장해 줘요. 도메인 지식이나 조직별 표준을 포착해 조직 전체에 공유할 수 있는 확장 가능한 방법을 제공하죠. Powerpack을 사용하면 대시보드 제작자가 별도 교육 없이도 다양한 기술 영역의 지식을 기존 대시보드에 통합할 수 있어요.
출처: 문서
본문
개요
Powerpack은 템플릿화된 위젯 그룹으로, 그래핑 전문성을 재사용 가능한 대시보드 구성 블록으로 확장해 줘요. 도메인 지식이나 조직별 표준을 포착해 조직 전체에 공유할 수 있는 확장 가능한 방법을 제공하죠. Powerpack을 사용하면 대시보드 제작자가 추가 교육 없이도 기술 영역에 걸친 지식을 기존 대시보드에 통합할 수 있어요.
Powerpack은 프리셋(preset, Datadog이 생성) 또는 커스텀(custom, 사용자 생성) 중 하나예요.
- 프리셋 Powerpack은 성능 메트릭이나 기능 사용량 같은 일반적인 모니터링 패턴을 위한 즉시 사용 가능한 보기를 제공해요. 특정 제품 또는 통합(예:
RUM Page Views)에 연결되는 경우가 많고 Datadog이 유지 관리해요. - 대시보드 쓰기 권한이 있는 사람은 누구나 커스텀 Powerpack을 만들어 내부 모범 사례를 공유·표준화할 수 있어요. 커스텀 Powerpack에 대한 업데이트는 모든 Powerpack 인스턴스에 동기화되므로 여러 대시보드에서 개별적으로 업데이트할 필요가 없어요.
이 가이드는 커스텀 Powerpack을 만들고 공유하는 모범 사례를 다룹니다.
커스텀 Powerpack을 사용해야 할 때
조직이 성장하면서 전문성과 소유권은 여러 팀에 쉽게 분산되요. Powerpack은 다음과 같은 조직에 가장 잘 맞아요:
- 조직 전반에서 특정 기술(예: Postgres, Kafka, Node.js)이나 이해관계(예: Compliance, Security)를 소유한 팀.
- 이러한 기술이나 이해관계를 풀스택 및 비즈니스 중심 보기에 통합하는 역할을 담당하는 개별 팀.
이 소유권 모델은 팀 간 표준화를 촉진하고, 비즈니스의 핵심 구성요소를 모니터링하기 위한 조직적 모범 사례를 홍보하는 확장 가능한 방법을 제공해요. 운영 메트릭과 KPI 모두에서 기술 라인과 팀 라인을 따라 소유권을 분산하면 on-call 엔지니어, SRE, 임원 같은 핵심 이해관계자가 비즈니스 전반의 대시보드에서 관련 보기에 접근하고 해석할 수 있어요.
Powerpack을 만드는 모범 사례
잘 구성된 Powerpack은 모든 기존 애플리케이션 팀의 대시보드에 보안 옵저버빌리티 추가 같은 새로운 모니터링 패턴을 조직이 빠르게 채택하도록 돕는 데 속도를 내줘요. 명확하고 자족적인(self-contained) Powerpack을 만들어 대시보드 소유자가 문제나 질문을 최소화하면서 콘텐츠를 최대한 활용하도록 하세요.
자명한 콘텐츠 만들기
Powerpack의 콘텐츠는 자명(self-explanatory)해야 해요. Powerpack을 만들 때는 대시보드의 다른 그룹 맥락에서도 대시보드 뷰어가 팩을 해석하고 이해하는 데 필요한 컨텍스트를 포함하세요. 이를 달성하는 몇 가지 도구는 다음과 같아요:
- 그래프가 무엇을 표시하는지 설명하는 명확하고 짧은 제목.
- 추가 컨텍스트가 있는 노트 위젯.
- 예상 및 예상 외 임계값을 표시하는 가로 마커.
노트 위젯은 그래프 해석 방법에 대한 유용한 컨텍스트를 제공할 수 있어요. 예를 들어 RUM Page Views Powerpack은 이번 주 페이지 뷰를 지난주와 비교하는 방법을 설명해요. 노트는 System Resource Utilization 팩처럼 외부 리소스에 연결할 수도 있어요.
{% image source="https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/note_widget_example.101aac876c81eabe2072a95148a233d4.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/note_widget_example.101aac876c81eabe2072a95148a233d4.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An example powerpack titled /checkout Page Views showing several graphs of real user monitoring data. In the top right is a notes widget with a message providing information about one of the graphs" /%}
그래프의 마커(가로 마커, 예측 함수)는 값의 의미에 대한 컨텍스트를 제공할 수 있어요. 예를 들어 Hosts Overview 팩은 그래프에 나타나는 Agent NTP 오프셋을 보여줘요. 가로 마커는 그래프에서 허용 가능한 임계값을 명확히 정의해 뷰어가 해야 하는 시각적 매핑을 줄여줘요.
{% image source="https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/horizontal_marker_example.ce33ac406a77d05d048daba79cadd925.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/horizontal_marker_example.ce33ac406a77d05d048daba79cadd925.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An example powerpack titled hosts overview showing a line graph titled Current Agent NTP offset. The graph is colored green between the values -1 and 1, and these thresholds are marked as offset -1s and offset +1s respectively. The graph is colored yellow between 1 and 3 and also between -1 and -3, and these thresholds are marked as offset -3s and offset +3s respectively. The graph is colored red beyond +3 and -3." /%}
Powerpack을 찾기 쉽게 만들기
Powerpack은 대시보드 위젯 트레이에 나타나며 키워드나 태그 검색으로 찾을 수 있어요. Powerpack 제목, 설명, 태그는 모두 검색 가능한 필드이고, 누군가가 내 Powerpack을 찾는 가장 쉬운 방법을 제공해요.
{% image source="https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/powerpack_keyword_search.b14b26d919a65ba0e88a47697a50e525.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/powerpack_keyword_search.b14b26d919a65ba0e88a47697a50e525.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An example search being done in the Add Widgets menu of a dashboard with the keyword resource" /%}
올바른 사용자가 내 Powerpack을 찾도록 하려면 사용자가 검색할 키워드(예: "performance")를 제목이나 설명에 포함하고, 핵심 기술을 태그하세요.
설명은 80자로 제한돼요. 좋은 설명은 팩이 무엇을 위한 것인지, 어떻게 사용하는지에 대한 간단한 요약을 제공해요. 예를 들어 RUM Feature Usage의 "View usage patterns for a UI action on a specific app page"는 Powerpack이 추적하는 것, 입력으로 기대하는 것(특정 앱 페이지), "usage", "UI", "app" 같은 키워드를 포함해요.
Powerpack 태깅
특정 팩에 대한 핵심 기술이나 검색 문구를 지정하려면 태그를 사용하세요(예: aws, k8s, app). 팩의 콘텐츠를 설명하려면 일반 문자열을 사용하고, 태그 필드에 직접 key:value 쌍을 넣는 것은 피하세요. 태그는 80자로 제한됩니다.
위젯 트레이에서 태그로 Powerpack을 검색하려면 tag:검색문자열 구문을 사용하세요.
{% image source="https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/powerpack_tag_search.04d63c0b7675d12ee23a37a050979beb.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/powerpack_tag_search.04d63c0b7675d12ee23a37a050979beb.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An example search being done in the Add Widgets menu of a dashboard with tag:security" /%}
Powerpack을 커스터마이즈 가능하게 만들기
Powerpack은 각 팀이 자신의 관련 컨텍스트로 커스터마이즈할 수 있을 때 가장 유용해요. 이를 허용하려면 구성 변수를 설정하세요.
Powerpack 생성 모달은 쿼리에 나타나는 공통 필터를 기반으로 팩에 추가할 변수를 제안해요. 제안된 변수에 마우스를 올리면 어떤 그래프에 영향을 주는지 알 수 있어요. 제안되지 않은 변수를 추가하려면 대시보드에서 그래프를 직접 수정해 원하는 변수를 필터나 템플릿 변수로 사용하세요. 다른 사람들이 어떻게 사용해야 할지 명확히 하도록 변수 이름을 수정하세요.
구성 변수는 두 가지 목적을 수행해요. 다음과 같이 할 수 있죠:
- 팀이 팩을 대시보드에 추가하기 전에 한 번에 Powerpack을 자신의 컨텍스트로 범위를 좁히도록 돕는다(예:
service를 선택해 보안 Powerpack이 올바른 서비스에 관련되도록 함). - 사용자가 팩을 대시보드에 추가한 후 Powerpack을 필터링할 수 있도록 한다(예:
prod와staging환경 모두에서 Powerpack의 보안 신호를 보기).
각 Powerpack 사용자는 변수를 대시보드에 저장해 동적 필터링을 허용할지 결정해요. 아래 예시에서 사용자는 템플릿 변수를 통해 대시보드에서 $Environment 값을 변경할 수 있지만, $Service는 항상 agent로 설정돼요.
{% image source="https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/configure_variables.c71c11181cc442e3417a76ef5fb5dc4a.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/guide/powerpacks_best_practices/configure_variables.c71c11181cc442e3417a76ef5fb5dc4a.png?auto=format&fit=max&w=850&dpr=2 2x" alt="A screen showing the option to configure values for tag or attribute variables, with a column for Tag or Attribute, Name, Value, and Use as Template Variable, which shows a checkbox providing the option to Add to dashboard. The Add to dashboard checkbox is checked for $Environment and unchecked for $Service." /%}
Powerpack 업데이트
기존 커스텀 Powerpack에 대한 변경은 해당 Powerpack의 모든 인스턴스에 적용되므로 여러 대시보드에서의 업데이트가 간단해져요. Edit Powerpack Layout을 클릭해 동기화된 Powerpack 인스턴스를 수정하세요.
권한
기본적으로 Powerpack의 편집 권한은 작성자로 제한돼요. 편집 권한은 위젯 트레이의 케밥 메뉴나 Powerpack 인스턴스의 헤더에서 언제든 수정할 수 있어요.
널리 알리기
Powerpack을 만들었다면 조직에 알리세요. 팩에 대해 알리는 것은 팩을 공지하는 동시에 질문을 위한 채널을 제공해요. 이메일이나 메시징 플랫폼 같은 커뮤니케이션 채널을 통해 Powerpack의 이름을 조직과 공유하고, 팩이 누구를 위한 것인지, 어디에 나타날 것으로 예상하는지 설명하세요.
더 알아보기 (Learn more)
도움이 되는 추가 문서, 링크, 아티클이에요: