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(내 실행) 패널에는 기본적으로 내가 소유자, 편집자 또는 뷰어인 프로젝트의 모든 이전 실행과 현재 실행 로그가 표시됩니다. 사용자를 대신하여 실행되는 경우 액세스할 수 없는 프로젝트 (예: 사용자가 설치하고 실행한 부가기능)의 함수 실행도 이 목록에 포함될 수 있습니다. 실행 목록에는 실행을 시작하기 위해 호출되는 초기 함수만 표시됩니다. 실행 중에 호출된 모든 함수가 표시되지는 않습니다.
뷰 상단의 필터를 사용하여 로그에 보고되는 실행 유형을 제어할 수 있습니다. 로그의 각 행은 단일 실행을 나타냅니다. Start Time(시작 시간), Duration(기간), Status(상태) 열에는 해당 실행에 관한 정보가 표시됩니다.
함수 열에는 실행을 시작한 함수의 이름이 표시됩니다. 실행의 해당 스크립트 프로젝트에 액세스할 수 없지만 사용자 대신 실행된 경우 이 열에 이름이 없습니다.
유형 열에는 실행이 시작된 항목이 표시됩니다. 여기에 표시되는 값은 다음과 같습니다.
- 부가기능. 부가기능에서 실행이 시작되었습니다.
- 실행 API. Apps Script API의 호출에서 실행되었습니다.
- 시간 기반. 시간 이벤트로 인해 실행이 발생했습니다.
- 트리거. 실행이 트리거 소스에서 시작되었습니다.
- 웹 앱. 배포된 웹 앱에서 실행되었습니다.
- 편집자입니다. Apps Script 편집기에서 실행되었습니다.
실행 종료
현재 진행 중인 장기 실행 실행은 상태가 '실행 중'으로 표시됩니다. 이러한 실행을 중지하려면 프로젝트 행의 오른쪽에서 더보기 > 종료를 클릭합니다.
설정
왼쪽 탐색 메뉴에서 설정을 선택하여 대시보드 설정을 조정할 수 있습니다.
설정 패널에는 Apps Script API 전환 버튼이 있습니다. 이렇게 하면 API에 스크립트 프로젝트에 대한 액세스 권한을 부여할 수 있습니다.
이 전환에 액세스하려면 설정 패널에서 Google Apps Script API 라벨을 클릭합니다. 그러면 경고 텍스트와 전환 스위치가 있는 새 패널이 열립니다. 스크립트 프로젝트에 대한 액세스는 보안 예방 조치를 위해 기본적으로 사용 중지됩니다. 액세스 권한을 부여하면 승인된 모든 서드 파티 애플리케이션에서 API를 사용하여 스크립트와 배포를 수정할 수 있습니다. 언제든지 설정 패널에서 이 액세스 권한을 취소할 수 있습니다.
자세한 내용은 Apps Script API 액세스 가이드를 참고하세요.