Apps Script 대시보드를 사용하면 Apps Script 프로젝트를 관리하고 모니터링할 수 있습니다. 대시보드를 사용하여 다음 작업을 수행할 수 있습니다.
- Google Workspace 문서에 첨부된 바인드된 스크립트를 포함하여 기존 Apps Script 프로젝트를 보고 검색합니다.
- 새 프로젝트를 만듭니다.
- 사용하는 OAuth 범위와 같은 프로젝트 세부정보를 확인합니다.
- 스크립트 프로젝트의 상태 및 사용을 모니터링합니다.
- 계정의 사용자 인증 정보를 사용하여 실행되는 프로젝트 및 다른 프로젝트의 실행 로그를 봅니다.
- Apps Script API를 사용 설정 또는 사용 중지하여 앱이 API를 사용하여 스크립트 프로젝트와 상호작용하는 것을 허용하거나 차단합니다.
프로젝트 보기 및 검색
Apps Script 대시보드에는 보거나 수정할 수 있는 모든 스크립트 프로젝트가 나열됩니다. 대시보드의 왼쪽 탐색 메뉴에 이러한 프로젝트가 다음 카테고리로 나뉩니다.
- 별표표시된 프로젝트. monitoring 중인 프로젝트입니다.
- 내 프로젝트. 내가 소유자인 프로젝트입니다.
- 모든 프로젝트. 내가 소유하거나 보기 또는 수정 권한이 있는 프로젝트입니다.
- 공유 문서함. 내가 소유하지 않지만 나와 공유된 프로젝트
- 휴지통. Google Drive에서 삭제한 프로젝트입니다.
프로젝트 목록에는 프로젝트 이름, 소유자, 최종 수정일이 표시됩니다. 프로젝트 이름 옆의 아이콘은 프로젝트가 독립형 프로젝트인지 바인드된 프로젝트인지를 나타냅니다.
프로젝트 세부정보 보기
각 프로젝트에는 프로젝트에 대한 개발자 세부정보를 볼 수 있는 뷰가 포함되어 있습니다. 프로젝트에 대한 세부정보를 보려면 프로젝트 목록에서 행을 클릭합니다.
프로젝트 세부정보 뷰에는 프로젝트에 대한 오류율, 실행, 사용자 데이터와 그래프는 물론 프로젝트를 사용하는 최종 사용자가 요청한 OAuth 범위가 표시됩니다. 데이터 측정항목은 다음과 같이 정의됩니다.
- 오류율. 포착되지 않은 예외로 인해 실행되지 못한 실행의 비율입니다. 실패한 실행을 정의된 기간의 총 실행 수로 나눈 값입니다.
- 실행. 프로젝트가 '실행'되거나 실행된 횟수입니다. 프로젝트를 실행하는 방법에 대한 자세한 내용은 실행 유형을 참고하세요.
- 사용자. 지정된 기간 동안 프로젝트를 한 번 이상 실행한 순 사용자 (계정) 수입니다. 익명 사용자는 추적되지 않으므로 사용자 수 또는 그래프에 반영되지 않습니다.
프로젝트의 각 배포는 데이터 및 그래프 위에 있는 프로젝트 세부정보 페이지에 탭으로 나타납니다. 이 탭을 선택하면 해당 배포에 대한 관련 데이터를 볼 수 있습니다. 모두를 선택하면 Apps Script 코드 편집기 내에서 프로젝트를 실행하는 개발자가 실행한 실행과 프로젝트의 모든 배포에 대한 집계 데이터가 표시됩니다.
프로젝트 모니터링
정기적으로 사용하거나 관리하는 것보다 훨씬 더 많은 Apps Script 프로젝트에 액세스할 수 있습니다. 쉽게 액세스할 수 있도록 프로젝트를 북마크하려면 프로젝트에 별표표시합니다. 프로젝트에 별표표시하면 해당 프로젝트의 총 사용량 및 오류율 통계와 그래프를 모니터링할 수도 있습니다.
프로젝트에 별표표시하려면 프로젝트 행 오른쪽에서 더보기 > 별표 추가를 클릭합니다. 프로젝트 세부정보를 볼 때 더보기 를 클릭하여 프로젝트에 별표표시할 수도 있습니다.
왼쪽 탐색 메뉴에서 별표표시된 프로젝트를 선택하여 북마크한 프로젝트를 볼 수 있습니다. 페이지 상단의 오류율, 실행 또는 사용자 스코어카드를 클릭하여 지난 7일 동안 별표표시된 모든 프로젝트의 관련 그래프를 확인합니다.
프로젝트 행에서 더보기 를 클릭하고 별표 삭제를 선택하여 프로젝트에서 별표를 삭제할 수 있습니다.
실행 관리
Apps Script 대시보드를 사용하여 Apps Script 프로젝트 함수의 개별 실행을 보고 관리할 수 있습니다. 왼쪽 탐색 메뉴에서 My Executions(내 실행) 항목을 선택하면 최근 실행의 전체 로그를 확인할 수 있습니다.
My Executions 패널에는 사용자가 소유자, 편집자, 뷰어인 프로젝트의 모든 이전 실행과 현재 실행 중인 실행 로그가 기본적으로 표시됩니다. 이 목록에는 사용자를 대신하여 실행할 경우 액세스할 수 없는 프로젝트의 함수 실행 (예: 사용자가 설치하고 실행한 부가기능)도 포함될 수 있습니다. 실행 목록에는 실행을 시작하기 위해 호출된 초기 함수만 표시됩니다. 실행 중에 호출된 모든 함수가 표시되지는 않습니다.
뷰 상단에 있는 필터를 사용하여 로그에 보고되는 실행 유형을 제어할 수 있습니다. 로그의 각 행은 단일 실행을 나타냅니다. 시작 시간, 기간, 상태 열에는 실행에 관한 정보가 표시됩니다.
함수 열에는 실행을 시작한 함수의 이름이 표시됩니다. 실행과 관련된 스크립트 프로젝트에 대한 액세스 권한이 없지만 프로젝트가 사용자 대신 실행된 경우 이 열에 이름이 표시되지 않습니다.
유형 열에는 실행을 시작한 항목이 표시됩니다. 여기에 표시되는 값은 다음과 같습니다.
- 부가기능. 부가기능에서 실행되었습니다.
- Execution API 실행은 Apps Script API 호출에서 시작되었습니다.
- 시간 기반. 시간 이벤트로 인해 실행이 발생했습니다.
- 트리거. 트리거 소스에서 실행이 발생했습니다.
- Webapp 배포된 웹 앱에서 실행이 시작되었습니다.
- 편집자. Apps Script 편집기에서 실행된 실행입니다.
실행 종료
현재 진행 중인 장기 실행 실행은 '실행 중' 상태로 표시됩니다. 실행을 중지하려면 프로젝트 행 오른쪽에서 더보기 > 종료를 클릭합니다.
설정
왼쪽 탐색 메뉴에서 설정을 선택하여 대시보드 설정을 조정할 수 있습니다.
설정 패널에는 Apps Script API의 전환 버튼이 있습니다. 이렇게 하면 API에 스크립트 프로젝트에 대한 액세스 권한을 부여할 수 있습니다.
이 전환 버튼을 사용하려면 설정 패널에서 Google Apps Script API 라벨을 클릭하세요. 그러면 경고 텍스트와 전환 스위치가 있는 새 패널이 열립니다. 스크립트 프로젝트에 대한 액세스는 보안 예방 조치로 기본적으로 사용 중지되어 있습니다. 액세스 권한을 부여하면 권한이 부여된 제3자 애플리케이션이 API를 사용하여 스크립트 및 배포를 수정할 수 있습니다. 언제든지 설정 패널에서 이 액세스 권한을 취소할 수 있습니다.
자세한 내용은 Apps Script API 액세스 가이드를 참고하세요.