Google Workspace

다운로드 212
업데이트 2026. 10. 15.

4. 로그프레소 설정

단계 1: 앱 설치

앱 설치하기 문서를 참고해 구글 워크스페이스 앱을 설치합니다.

Caution
기존 버전에서 1.9.2610.0 이상으로 업그레이드할 때는 업그레이드 전에 구글 워크스페이스 수집기를 모두 비활성화하고, 업그레이드가 끝난 뒤 다시 활성화하세요. 실행 중인 상태로 업그레이드하면 수집기가 오류로 멈출 수 있습니다. 이미 멈췄다면 비활성화했다가 다시 활성화하면 됩니다. 수집기는 마지막 수집 시점부터 이어서 수집하므로 로그가 누락되지 않습니다.

단계 2: 접속 프로파일 추가

접속 프로파일 문서를 참고해 시스템 > 접속 프로파일에서 사용할 인증 방식의 접속 프로파일을 추가합니다. 알림 센터만 서비스 계정 방식으로 수집하려면 두 방식의 프로파일을 모두 만듭니다.

서비스 계정 방식

접속 프로파일 설정

항목필수입력값
이름필수접속 프로파일을 식별할 이름
식별자필수쿼리와 수집기에서 쓸 식별자 (예: gws_sa)
유형필수구글 워크스페이스
고객 ID선택도메인·사용자·그룹 확장 명령어에서만 사용. 비워 두면 위임된 계정이 속한 조직 사용
위임된 계정필수관리자 역할을 할당한 연동 전용 계정의 이메일
서비스 키필수서비스 계정 JSON 키 파일 내용 전체
HTTP 프록시선택프록시를 거쳐 접속할 때 IP:PORT

고객 ID를 직접 지정하려면 관리 콘솔 계정 > 계정 설정에서 확인합니다.

위임된 계정에는 2. 구글 워크스페이스 준비의 단계 1에서 만든 연동 전용 계정의 이메일을 입력합니다.

사용자 계정 OAuth 방식

  1. 서비스 키에 넣을 JSON을 작성합니다. 구글 클라우드에서 내려받은 클라이언트 JSON 파일은 형식이 다르니 쓰지 마세요.

    {
      "type": "authorized_user",
      "client_id": "OAuth 클라이언트 ID",
      "client_secret": "OAuth 클라이언트 보안 비밀번호",
      "refresh_token": "리프레시 토큰"
    }
    
    키넣을 값
    client_id, client_secret3-2. 사용자 계정 OAuth 방식의 단계 2에서 만든 OAuth 클라이언트의 클라이언트 ID와 보안 비밀번호. 서비스 계정의 클라이언트 ID가 아닙니다
    refresh_token3-2. 사용자 계정 OAuth 방식의 단계 3에서 발급한 리프레시 토큰 (1//로 시작)
  2. 다음과 같이 입력합니다.

    접속 프로파일 설정

    항목입력값
    이름, 식별자예: gws_oauth
    유형구글 워크스페이스
    고객 ID비워 둠 (동의한 계정이 속한 조직 사용)
    위임된 계정비워 둠 (OAuth 방식에서는 사용하지 않음)
    서비스 키위에서 작성한 JSON. 저장 후에는 가려지니 원본을 따로 보관
Note
1.9.2610.0 미만 버전에서는 고객 ID와 위임된 계정이 필수 항목이므로 임의 값(예: dummy)을 입력하세요.

단계 3: 수집기 추가

수집기 문서를 참고해 사용할 수집기를 추가합니다. 테이블 이름은 아래 접두어로 시작해야 앱의 데이터셋과 대시보드에 표시됩니다.

수집 모델테이블 이름 (접두어)
Google Workspace Admin ActivityGOOGLE_ADMIN
Google Workspace LoginGOOGLE_LOGIN
Google Drive ActivityGOOGLE_DRIVE
Google Meet ActivityGOOGLE_MEET
Google Chat ActivityGOOGLE_CHAT
Google Workspace Alert CenterGOOGLE_ALERT

모든 수집기의 공통 입력 항목은 다음과 같습니다.

항목입력값
이름수집기를 식별할 이름
주기60초 이상 권장
적재 위치 / 수집 위치로그프레소 플랫폼 구성에 맞는 노드
수집 모델위 표의 수집 모델
테이블위 표의 접두어로 시작하는 이름
접속 프로파일앞에서 만든 접속 프로파일의 식별자. 알림 센터 수집기는 서비스 계정 방식 프로파일

수집기 설정 예시 - Google Workspace Admin Activity

수집기나 확장 명령어에서 오류가 나면 문제 해결을 참고하세요.