Get Workspace Usage 단계

설명

워크스페이스 사용 현황을 프로젝트 테이블에 기록합니다. 시간에 따른 도입 추세를 추적하거나, 부서 또는 팀별 사용 현황을 보고하거나, 자체 대시보드를 구축하거나, 예약된 워크플로에서 활동 감소를 감지하는 데 사용하십시오. 수치는 사용 현황 보고서에 표시되는 수치와 동일합니다.

데이터 세트 세 개는 합계만 담고 있습니다. 멤버를 나타내는 행이 없으며 노트북 경로는 *로 대체됩니다. 나머지 네 개(멤버, 멤버별 일별, 내용, 멤버별 콘텐츠)는 보고용으로 만들어졌습니다. 멤버, 멤버별 일별, 멤버별 콘텐츠에는 멤버 식별 정보(사용자 ID, 사용자 이름, 이메일, 이름과 성, 보안 그룹)가 들어 있으므로 대상 테이블을 멤버 목록과 동일하게 취급하십시오. 이 단계를 실행할 때마다 보안 로그에 기록됩니다.

구성

사용 데이터

데이터 세트는 각 행에 담기는 내용을 선택합니다.

데이터 세트	값	행 단위	식별 정보 포함
항목별 일간	`daily_item`	일, 영역, 이벤트, 대상	아니요
항목별 월간	`monthly_item`	월, 영역, 이벤트, 대상	아니요
월별 합계(기본값)	`monthly_tenant`	월, 영역	아니요
멤버	`members`	워크스페이스의 사용자 1명	예
멤버별 일별	`daily_user`	사용자, 일, 영역	예
내용	`content`	대시보드, 앱 또는 노트북	아니요
멤버별 콘텐츠	`content_user`	사용자와 항목	예

영역은 행을 하나의 영역으로 제한합니다. 모든 영역을 포함하려면 모든 영역으로 두십시오.

영역	값
모든 영역(기본값)	`""`
PlaidCloud 앱	`plaidclient`
대시보드	`superset`
앱	`panel`
앱 방문	`panel_visit`
노트북 서버	`jupyterhub`
노트북	`jupyter`

이 값은 API 또는 AI 어시스턴트를 통해 단계를 만들거나 편집할 때 단계에 저장되는 값입니다.

열

항목별 일간

day, source, event, subject, events.

항목별 월간

month, source, event, subject, users, events, unattributed_events, coverage_start, partial.

월별 합계

month, source, active_users, coverage_start, partial.

partial은 기록이 전체를 포함하지 않는 월에 대해 true이며, coverage_start는 수집이 시작된 날짜입니다. 월은 마감 후 3일이 지나 수치가 안정되면 포함됩니다.

멤버 열

멤버, 멤버별 일별, 멤버별 콘텐츠는 동일한 7개 열로 시작합니다.

열	내용
`user_id`	멤버의 ID입니다.
`user_name`	멤버의 사용자 이름입니다.
`email`	멤버의 이메일 주소이며 소문자입니다.
`first_name`	이름입니다.
`last_name`	성입니다.
`is_active`	멤버가 활성 상태이면 true, 비활성화되었으면 false입니다.
`groups`	멤버의 보안 그룹이며 `;` 로 구분됩니다.

groups에는 최상위 그룹만 나열됩니다. 하위 그룹은 확장되지 않습니다.

멤버

멤버 열 다음에 다음 열이 옵니다.

열	내용
`first_seen`	날짜 범위와 관계없이 멤버가 PlaidCloud를 처음 사용한 날입니다. 영역을 설정하면 해당 영역에서 처음 사용한 날입니다.
`last_seen`	범위 내에서 멤버가 마지막으로 활동한 날입니다.
`active_days`	범위 내에서 활동이 있었던 일수입니다.
`events`	범위 내 활동 이벤트 수입니다.
`active_minutes`	활동 시간(분)입니다. 영역 간에 겹치는 시간은 한 번만 계산됩니다.
`session_minutes`	세션 시간(분)입니다.
`app_open_minutes`	멤버가 패널 앱을 열어 둔 시간(분)입니다.

사용 기록이 삭제된 멤버를 제외하고 모든 멤버에게 행이 있습니다. 서비스 계정과 에이전트는 나열되지 않습니다. 범위 내에 활동이 없는 멤버는 groups 뒤의 값이 비어 있습니다. 이후에 삭제된 멤버를 제외하면 합계는 사용 현황 보고서와 일치합니다.

멤버별 일별

멤버 열 다음에 day, source(영역), events, active_minutes, session_minutes, first_at, last_at(해당 일의 첫 활동 시간과 마지막 활동 시간)가 옵니다.

내용

열	내용
`type`	`dashboard`, `panel_app`, `wasm_app` 또는 `notebook`입니다.
`subject`	항목의 ID입니다. 모든 노트북은 하나의 행을 공유하며 여기에 `*`가 표시됩니다.
`name`	항목의 이름이며 노트북의 경우 `*`입니다.
`deleted`	항목이 이후에 삭제되었으면 true입니다.
`users`	항목을 연 멤버 수입니다.
`opens`	항목을 연 횟수입니다.
`last_used`	마지막으로 사용된 시점입니다.
`app_open_minutes`	패널 앱이 열려 있던 시간(분)입니다.

멤버별 콘텐츠

멤버 열 다음에 type, subject, name(내용과 동일), opens(이 멤버가 항목을 연 횟수), last_day(멤버가 마지막으로 사용한 날)가 옵니다.

멤버 데이터 세트 참고 사항

에이전트, 서비스 계정 및 이후에 삭제된 멤버의 활동은 식별 열이 비어 있습니다. 삭제된 멤버는 user_id만 유지되고 다른 정보는 남지 않습니다.
내용의 열기 횟수는 멤버별 콘텐츠의 열기 횟수 합계보다 클 수 있습니다. 그 차이는 대시보드의 임베디드 보기나 게스트 보기처럼 멤버에게 귀속할 수 없는 열기입니다. 내용은 이를 계산하지만 멤버별 콘텐츠는 계산할 수 없습니다.

예: 부서별 활동 시간

멤버와 멤버별 콘텐츠에는 멤버의 email이 소문자로 들어 있으므로, 인사 또는 조직 마스터 테이블과 같은 자체 테이블에 조인하여 부서별로 보고할 수 있습니다.

데이터 세트를 멤버로 설정하고 usage_members와 같은 대상 테이블을 지정하여 Get Workspace Usage 단계를 추가합니다.
소문자 email 열이 일치하는 곳에서 usage_members를 조직 테이블에 조인하는 테이블: 내부 조인 단계를 추가합니다. 조직 테이블에서는 부서를, usage_members에서는 active_minutes와 events 열을 유지합니다.
같은 단계에서 부서별로 집계하고 active_minutes를 합산합니다.

결과는 부서별 활동 시간입니다. 조직 테이블에 없는 멤버는 내부 조인에서 제외되므로 이들을 확인하려면 왼쪽 조인을 사용하십시오. 멤버별 콘텐츠에 대해 두 번째 단계를 사용하여 같은 방식으로 반복하고 부서별 opens를 합산하면 어느 부서가 어떤 대시보드와 앱을 사용하는지 보고할 수 있습니다.

날짜 범위

범위는 읽을 일자를 선택합니다.

범위	값	읽는 기간
최근 일수(기본값 30)	`last_days`	오늘을 포함한 최근 일수입니다.
이전 달	`previous_month`	마지막으로 완료된 달력 월입니다.
이번 달 누계	`month_to_date`	이번 달 1일부터 오늘까지입니다.
날짜 사이	`dates`	시작 날짜부터 종료 날짜까지입니다. 오늘까지 읽으려면 종료 날짜를 비워 두십시오.

일수와 날짜는 UTC입니다. 일, 시작 날짜, 종료 날짜에는 숫자나 YYYY-MM-DD 날짜뿐 아니라 {report_start}와 같은 변수도 사용할 수 있습니다. 시작은 종료보다 늦어서는 안 됩니다.

사용 대상

대상 테이블이 결과를 받습니다. 이 단계는 테이블에 있던 내용을 대체하며, 행이 없는 경우에도 항상 데이터 세트의 열을 기록합니다.

경고

이러한 경우에는 단계가 실패하지 않습니다. 발생한 상황을 알리는 경고와 함께 완료되며 테이블은 그대로 기록됩니다.

워크스페이스에 대해 사용 현황 수집이 아직 설정되지 않았습니다.
범위 내에 사용 기록이 없었습니다.
범위가 보관된 기간보다 이전에 시작하므로 기록이 시작되는 시점부터 시작하도록 잘렸습니다. 일별 데이터는 180일 동안, 월별 데이터는 25개월 동안 보관됩니다.

보안 로그

실행할 때마다 데이터 세트, 범위, 대상 테이블, 워크플로, 단계, 실행, 기록된 행 수를 담은 항목이 보안 로그에 기록됩니다.