4. 로그프레소 설정
단계 1: 앱 설치
앱 설치하기 문서를 참고해 구글 워크스페이스 앱을 설치합니다.
Caution
기존 버전에서 1.9.2610.0 이상으로 업그레이드할 때는 업그레이드 전에 구글 워크스페이스 수집기를 모두 비활성화하고, 업그레이드가 끝난 뒤 다시 활성화하세요. 실행 중인 상태로 업그레이드하면 수집기가 오류로 멈출 수 있습니다. 이미 멈췄다면 비활성화했다가 다시 활성화하면 됩니다. 수집기는 마지막 수집 시점부터 이어서 수집하므로 로그가 누락되지 않습니다.
단계 2: 접속 프로파일 추가
접속 프로파일 문서를 참고해 시스템 > 접속 프로파일에서 사용할 인증 방식의 접속 프로파일을 추가합니다. 알림 센터만 서비스 계정 방식으로 수집하려면 두 방식의 프로파일을 모두 만듭니다.
서비스 계정 방식
| 항목 | 필수 | 입력값 |
|---|---|---|
| 이름 | 필수 | 접속 프로파일을 식별할 이름 |
| 식별자 | 필수 | 쿼리와 수집기에서 쓸 식별자 (예: gws_sa) |
| 유형 | 필수 | 구글 워크스페이스 |
| 고객 ID | 선택 | 도메인·사용자·그룹 확장 명령어에서만 사용. 비워 두면 위임된 계정이 속한 조직 사용 |
| 위임된 계정 | 필수 | 관리자 역할을 할당한 연동 전용 계정의 이메일 |
| 서비스 키 | 필수 | 서비스 계정 JSON 키 파일 내용 전체 |
| HTTP 프록시 | 선택 | 프록시를 거쳐 접속할 때 IP:PORT |
고객 ID를 직접 지정하려면 관리 콘솔 계정 > 계정 설정에서 확인합니다.
위임된 계정에는 2. 구글 워크스페이스 준비의 단계 1에서 만든 연동 전용 계정의 이메일을 입력합니다.
사용자 계정 OAuth 방식
-
서비스 키에 넣을 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//로 시작) -
다음과 같이 입력합니다.
항목 입력값 이름, 식별자 예: gws_oauth유형 구글 워크스페이스 고객 ID 비워 둠 (동의한 계정이 속한 조직 사용) 위임된 계정 비워 둠 (OAuth 방식에서는 사용하지 않음) 서비스 키 위에서 작성한 JSON. 저장 후에는 가려지니 원본을 따로 보관
Note
1.9.2610.0 미만 버전에서는 고객 ID와 위임된 계정이 필수 항목이므로 임의 값(예:
dummy)을 입력하세요.
단계 3: 수집기 추가
수집기 문서를 참고해 사용할 수집기를 추가합니다. 테이블 이름은 아래 접두어로 시작해야 앱의 데이터셋과 대시보드에 표시됩니다.
| 수집 모델 | 테이블 이름 (접두어) |
|---|---|
| Google Workspace Admin Activity | GOOGLE_ADMIN |
| Google Workspace Login | GOOGLE_LOGIN |
| Google Drive Activity | GOOGLE_DRIVE |
| Google Meet Activity | GOOGLE_MEET |
| Google Chat Activity | GOOGLE_CHAT |
| Google Workspace Alert Center | GOOGLE_ALERT |
모든 수집기의 공통 입력 항목은 다음과 같습니다.
| 항목 | 입력값 |
|---|---|
| 이름 | 수집기를 식별할 이름 |
| 주기 | 60초 이상 권장 |
| 적재 위치 / 수집 위치 | 로그프레소 플랫폼 구성에 맞는 노드 |
| 수집 모델 | 위 표의 수집 모델 |
| 테이블 | 위 표의 접두어로 시작하는 이름 |
| 접속 프로파일 | 앞에서 만든 접속 프로파일의 식별자. 알림 센터 수집기는 서비스 계정 방식 프로파일 |
수집기나 확장 명령어에서 오류가 나면 문제 해결을 참고하세요.


