공유 대시보드
공유 대시보드 (Shared Dashboards)
공유 대시보드(Shared Dashboards)는 외부 사용자 또는 로그인을 원하지 않는 사용자가 대시보드를 볼 수 있게 해 주는 Datadog 기능이에요. 각각 고유한 구성 옵션 세트를 가진 여러 공유 대시보드를 만들 수 있어요.
대시보드를 공유하려면 대시보드 페이지 오른쪽 위의 Share를 클릭한 다음 Share dashboard를 선택해요. 기존 공유 대시보드를 보거나 편집하려면 Share를 클릭한 다음 Manage shared dashboards를 선택해요.
출처: 문서
본문
개요
Datadog의 공유 대시보드는 외부 사용자 또는 로그인하지 않고 대시보드를 보려는 사용자가 대시보드를 볼 수 있게 해 주는 기능이에요. 각각 자체 구성 옵션 세트를 가진 여러 공유 대시보드를 만들 수 있어요.
대시보드를 공유하려면 대시보드 페이지 오른쪽 위의 Share를 클릭한 다음 Share dashboard를 선택해요. 기존 공유 대시보드를 보거나 편집하려면 Share를 클릭한 다음 Manage shared dashboards를 선택해요.
조직의 모든 공유 대시보드와 공개 접근 설정은 Shared Dashboards 페이지에 나열돼요. 또한 Public Sharing Settings 페이지에서 특정 공유 유형을 비활성화하거나 초대의 최대 접근 기간(Maximum Access Period)을 설정하는 등 추가 보안 구성을 할 수 있어요.
참고: 공유 대시보드 기능이 비활성화되면 대시보드가 더 이상 공개적으로 접근할 수 없게 돼요. 다만 구성은 계속 보거나 편집할 수 있어요. 이 기능은 개별 대시보드의 활성(Active) 또는 일시 중지(Paused) 상태와는 독립적으로 동작해요. 즉 Active 상태의 공유 대시보드도 공개적으로 접근할 수 없게 돼요.
공유 대시보드는 약 60초마다 새로고침되며, 이 새로고침 속도는 사용자 지정할 수 없어요.
공유 대시보드의 뷰어는 공유자(creator)의 권한에 따라 대시보드에 표시된 모든 원격 측정(telemetry) 데이터를 봐요. 공유하기 전에 대시보드 내용을 검토해서 민감하거나 기밀인 데이터가 노출되지 않도록 해 주세요.
공유 상태
공유 대시보드는 두 가지 공유 상태 중 하나를 가질 수 있어요:
- Active(활성): 공유 대시보드에 특정 URL이 할당되고, 접근하도록 구성된 뷰어가 이용할 수 있어요.
- Paused(일시 중지): 초대된 경우에도 뷰어가 공유 대시보드에 접근할 수 없어요. 다만 공유 대시보드 URL은 대시보드에 계속 연결되어 있고, 대시보드를 Active로 재설정하면 이전 접근이 복원돼요.
대시보드를 공유 해제(Unsharing) 하면 공유 URL이 제거되고 모든 공유 구성 설정이 삭제되어 모든 링크가 무효화돼요. 대시보드를 다시 공유하면 이전 공유 URL이나 설정이 유지되지 않아요.
초대 전용 공유 대시보드 (Invite-only)
초대 전용(Invite-only) 대시보드는 개별 이메일 주소 또는 특정 이메일 도메인과 대시보드를 공유할 수 있게 해 줘요.
하나 이상의 이메일 주소와 대시보드를 공유하려면:
- 공유하려는 대시보드의 오른쪽 위에서 Share 옵션을 클릭해요.
- Share Dashboard를 선택해요.
- Invite only를 선택해요.
- 원하는 시간(Time), 변수(Variable), 색상(Color) 옵션을 구성해요. 자세한 내용은 Configuration Options(구성 옵션)를 참조해요.
- 접근 권한을 부여할 이메일 또는 이메일 도메인을 추가하고, 각 초대의 만료 날짜를 설정해요. 도메인을 추가하면 공개 접근을 방지하고 해당 도메인 주소를 가진 사람에게만 대시보드 접근을 제한할 수 있어요.
- Share Dashboard를 클릭해 공유 URL을 생성하고 특정 초대 대상자에게 접근 링크를 이메일로 보내요. 이메일은 특정 이메일 주소에만 전송돼요. 이메일 도메인의 경우 자동 이메일이 발송되지 않으므로 대시보드 링크를 직접 배포해야 해요.
참고: 초대된 이메일은 만료 날짜의 현지 시간 자정(12:00 a.m.)에 접근 권한을 잃어요.
기본적으로 초대는 만료되지 않아요. 초대가 특정 시간 후에 만료되도록 하려면 조직 관리자가 Organization Settings > Public Sharing에서 Maximum Access Period(최대 접근 기간)을 켜면 돼요. 이 설정을 활성화하면 초대가 유효한 최대 일수를 지정할 수 있어요.
만료 날짜가 없는 초대를 허용하려면 Maximum Access Period를 끄면 돼요. API로 이 설정을 구성하는 경우 값을 null로 설정해요. UI에서는 Maximum Access Period를 0으로 설정하면 설정이 꺼지고 값이 null로 설정돼요.
참고: Maximum Access Period는 정확한 타임스탬프로 적용돼요. 예를 들어 최대 접근 기간이 하루라면, 1월 1일 11:00AM에 생성된 초대는 1월 2일 11:00AM까지 만료되어야 해요.
초대 전용 공유 대시보드 접근하기
공유 대시보드의 초대 대상자에게는 제한된 시간의 접근 링크가 포함된 이메일이 발송돼요. 이메일 수신자는 접근 권한을 얻으려면 1시간 이내에 링크를 클릭해야 해요.
링크를 클릭하면 초대 대상자는 같은 컴퓨터와 브라우저에서 30일 동안 공유 대시보드에 접근할 수 있으며, 이후 접근을 갱신해야 해요. 유효한 수신자로 남아 있고 대시보드가 활성 상태인 한 접근을 계속 갱신할 수 있어요.
새 접근 링크 받기
유효한 수신자는 공유자에게 승인을 요청할 필요 없이 언제든지 새 접근 링크를 요청할 수 있어요. 활성 접근 권한 없이 공유 대시보드를 방문하면 이메일 주소를 입력하라는 메시지가 표시되고, 이를 통해 새 접근 링크를 받을 수 있어요. 이 이메일은 유효한 수신자만 받을 수 있어요.
초대 전용 공유 대시보드 접근 취소하기
공유 대시보드에 대한 접근을 취소하려면 수신자 목록에서 원하는 이메일 주소를 제거하고 변경 사항을 저장해요. 제거된 수신자는 더 이상 접근 권한이 없으며 새 접근 링크를 요청할 수도 없어요.
참고: 초대 전용 대시보드를 공유하는 사용자는 유효한 수신자로 남으며 제거할 수 없어요.
공개 공유 대시보드 (Public)
공개 대시보드(Public)는 링크가 있는 인터넷의 누구에게나 공유 대시보드를 제공할 수 있게 해 줘요.
공개 대시보드를 공유하려면:
- 공유하려는 대시보드의 오른쪽 위에서 Share 옵션을 클릭해요.
- Share Dashboard를 선택해요.
- Select a Share Type 단계에서 Public 옵션을 선택하고, 링크를 가진 누구에게나 대시보드가 접근 가능하다는 점을 확인해요.
- Configure Dashboard 단계에서 원하는 시간, 변수, 색상 옵션을 구성해요.
- Share Dashboard를 클릭해 공유 URL을 만들어요.
기본적으로 공개 대시보드는 1년 동안 접근 가능하며, 이후 만료되어 Paused(일시 중지) 상태로 전환돼요. Select a Share Type 단계에서 만료 날짜를 끄거나 조정할 수 있어요.
임베디드 공유 대시보드 (Embedded)
공유 대시보드를 iFrame을 사용해 웹사이트에 임베드할 수 있어요. 임베디드 대시보드에는 기본(basic)과 보안(secure) 두 가지 유형이 있어요.
기본 임베드 (Basic embed)
기본 임베디드 대시보드는 요청 레퍼러(referrer)의 허용 목록(allowlist)을 기준으로 접근을 제한해요. 이 기능은 Safari 웹 브라우저에서는 지원되지 않아요.
HTTP 요청의 referrer 헤더는 허용 목록 항목과 대조하여 검증돼요. 대부분의 경우 브라우저 콘솔에 window.location.origin을 입력하면 예상되는 referrer를 얻을 수 있어요. 다만 브라우저 헤더에 특별한 조작(예: 브라우저 개인정보 설정)이 있다면 실제 네트워크 요청을 확인해야 해요.
기본 임베디드 대시보드를 공유하려면:
- 대시보드의 오른쪽 위에서 Share를 클릭해요.
- Share Dashboard를 선택해요.
- Select a Share Type 단계에서 Embed 옵션을 선택해요.
- Configure Dashboard 단계에서 원하는 시간, 변수, 색상 옵션을 구성해요.
- 허용 목록에 추가할 referrer를 지정해요.
- Share Dashboard를 클릭해 공유 URL을 만들어요.
보안 임베드 (Secure embed)
보안 임베디드 대시보드는 referrer 허용 목록에 의존하지 않고 각 페이지 로드를 인증하기 위해 백엔드에서 생성한 토큰을 사용해요. 애플리케이션 서버가 자격 증명을 보관하고 세션마다 고유한 iFrame URL을 생성하므로, 자격 증명이 브라우저에 노출되지 않아요. 보안 임베드는 Safari를 포함해 서드파티 쿠키를 차단하는 브라우저에서도 동작해요.
설정 지침은 Secure Embedded Dashboards를 참조해요.
구성 옵션
Configure Dashboard 단계에서 공유 대시보드를 변경해요.
참고: 공유 대시보드에 대한 구성 변경이 모든 뷰어에게 전파되는 데 최대 5분이 걸릴 수 있어요. 변경 사항이 즉시 나타나지 않으면 몇 분 기다린 후 대시보드를 새로고침해요.
- Published Name(게시 이름): 게시 이름은 공유 대시보드에서 대시보드 제목을 대체해요. 이 이름은 Shared Dashboard 목록 페이지에서 공유 대시보드가 나열되는 이름이기도 해요.
- Default Timeframe(기본 시간 범위): 공유 대시보드 뷰어의 기본 시간 범위를 설정해요. "Allow viewers to change the timeframe"(뷰어가 시간 범위를 변경하도록 허용)이 꺼져 있으면 이것이 유일한 시간 범위가 돼요. 켜면 뷰어에게 고정된 시간 범위 옵션 세트를 제공하지만, 사용자 지정 시간 범위와 시간 범위 스크러빙(scrubbing)은 지원되지 않아요.
- Variables(변수): 대시보드의 어떤 템플릿 변수를 뷰어가 사용할 수 있는지 지정해요. 템플릿 변수에 대해 기본값과 사용 가능한 값을 동일하게 설정하면 뷰어가 변경할 수 없어요. 참고: 값이 와일드카드(
*)로 설정된 경우에도 마찬가지예요. 기본적으로 공유 대시보드는 공유자가 현재 사용 중인 선택 값과 사용 가능한 값을 상속해요. - Default Theme(기본 테마): 공유 대시보드가 기본적으로 라이트 모드인지 다크 모드인지 선택할 수 있어요. 뷰어는 언제든지 이 옵션을 재정의할 수 있어요.
공유 대시보드의 제한 사항
비활성화된 사용자는 대시보드를 공유할 수 없음
공유 대시보드는 조직 내 활성 사용자가 공유해야 해요. 공유자가 비활성화되면 활성 사용자가 소유권을 인수할 때까지 공유 대시보드는 더 이상 데이터를 표시하지 않아요. 이 상태에서 공유 대시보드 URL과 구성 옵션은 보존돼요.
모든 위젯 유형을 사용할 수 있는 것은 아님
다음 위젯 유형은 공유 대시보드에서 지원되지 않아요. 이러한 유형의 위젯은 공유 대시보드에서 데이터를 표시하지 않아요.
- Topology Map
- List Widget (모든 데이터 소스)
- 레거시 treemap 위젯
제한된 시간 범위 옵션
공유 대시보드는 제한된 수의 시간 범위 옵션만 지원하며 시간 범위 스크러빙이나 사용자 지정 시간 범위는 허용하지 않아요.
IP 주소 제한
IP 주소를 기준으로 공유 대시보드에 대한 접근을 제한할 수 있어요. IP 주소 허용 목록을 활성화하려면 Datadog 지원에 이메일을 보내 주세요. 활성화 후에는 관리자가 Public Sharing Settings 페이지에서 IP 제한을 관리할 수 있어요.
공유 대시보드 편집
경고: 대시보드의 콘텐츠나 레이아웃을 변경하면 공유 버전에도 즉시 반영돼요. 편집할 때 개인 데이터를 의도치 않게 공유하지 않도록 주의해 주세요.
공유 대시보드의 공유 유형, 구성 또는 수신자를 변경하려면:
- 대시보드의 오른쪽 위에서 Share 옵션을 클릭해요.
- Edit shared dashboard를 선택해요.
- 원하는 설정을 조정해요.
- 변경 사항을 적용하려면 Save를 클릭해요.
이 메뉴에서 공유 대시보드에 대한 접근을 일시적으로 일시 중지하거나 다시 활성화할 수도 있어요.
모든 공유 대시보드 보기
조직의 모든 공유 대시보드와 설정은 Shared Dashboards 페이지에서 확인할 수 있어요. 이 페이지에서 공유 유형, 마지막 접근, 공유자 등으로 대시보드를 쿼리, 필터링, 정렬할 수 있어요. 소유자가 없는 공유 대시보드를 찾아 소유권을 인수할 수도 있어요.