Gmail 활동 감사 로그
| # | 필드명 | 타입 | 표시명 | 설명 |
|---|---|---|---|---|
| 1 | _time | DATE | 시각 | |
| 2 | src_ip | IP | 출발지IP | 수신 배송 단계는 보낸 서버 IP, 행동은 사용자 IP |
| 3 | src_country | COUNTRY | 출발지국가 | 예: KR |
| 4 | src_city | STRING | 출발지도시 | 예: Seoul |
| 5 | src_asn | STRING | 출발지ASN | |
| 6 | user | STRING | 계정 | 예: user@example.com |
| 7 | mail_event_type | STRING | 메일이벤트유형 | 예: SENT, RECEIVED, VIEWED |
| 8 | action_type | STRING | 처리유형 | 예: ACCEPTED, ACTED, USER_INBOX_ACTION |
| 9 | mail_subject | STRING | 제목 | |
| 10 | mail_to | STRING | 수신자 | 예: user@example.com |
| 11 | mail_size | LONG | 메시지크기 | |
| 12 | mail_attachment_count | INT | 첨부파일수 | |
| 13 | is_spam | BOOL | 스팸여부 | |
| 14 | is_success | BOOL | 성공여부 | |
| 15 | msg | STRING | 처리메시지 | 예: 250 2.0.0 OK |
| 16 | mail_link_domains | STRING | 링크도메인 | 예: example.com |
| 17 | mail_delivery_service | STRING | 전달서비스 | 예: gmail-ui |
| 18 | duration | DOUBLE | 소요시간 | |
| 19 | msg_id | STRING | 메시지ID | RFC 2822 Message-ID |
| 20 | type | STRING | 로그유형 | delivery_type |
| 21 | action | STRING | 작업 | delivery |
필드 참고
- src_ip: 수신 메일의 배송 단계, RECEIVED, 스팸 분류는 보낸 쪽 메일 서버 IP이고(Gmail에서 보낸 메일은 구글 IP), 사용자 행동과 발신은 사용자 IP입니다. FIRST_REPLIED, 자동 전달로 보낸 SENT 등 일부 이벤트는 비어 있습니다.
- user: 이벤트가 기록된 계정입니다. 메일 시스템 이벤트는 /hd/domain/도메인 형식이고, 그룹 주소로 보낸 메일은 그룹 주소로 기록됩니다.
- mail_to: 수신자가 여러 명이면 줄바꿈으로 구분합니다. 받는사람, 참조, 숨은참조는 구분되지 않습니다.
- mail_attachment_count: SENT와 배송 단계에만 값이 있습니다. SEND_INITIATED, 첨부 미리보기·다운로드 이벤트는 0입니다.
- mail_link_domains, mail_delivery_service: 여러 개면 줄바꿈으로 구분합니다. mail_delivery_service는 메일을 전달한 구글 내부 경로(서비스:세부분류)입니다.
- duration: 밀리초 단위입니다.
- 보낸 사람 주소, 첨부 파일 이름, 클릭한 링크의 URL은 구글이 제공하지 않아 수집되지 않습니다.
- 읽음 표시, 메일 다운로드, 스팸 신고 시의 발신자 차단은 기록되지 않습니다.
메일 이벤트 유형
mail_event_type은 다음 값 중 하나입니다. 목록에 없는 코드는 숫자 그대로 저장됩니다. Gmail 수집기의 제외할 메일 이벤트 유형 옵션에 이 이름을 씁니다.
| 값 | 의미 |
|---|---|
| UNKNOWN | 메일 배송 단계. 반송도 이 유형으로 기록되며 action_type이 BOUNCED |
| SENT | 메일 발신. 받는 사람마다 1건 |
| RECEIVED | 메일 수신. 받는 사람마다 1건 |
| USER_SPAM_CLASSIFIED | 사용자가 스팸·피싱·스팸 아님으로 직접 분류 |
| POST_DELIVERY_SPAM | 배달 후 Gmail이 스팸으로 분류 |
| QUARANTINED | 격리 |
| QUARANTINE_RELEASED | 격리 해제 |
| FIRST_OPENED | 처음 열람 |
| MARKED_UNREAD | 읽지 않음으로 표시 |
| FIRST_REPLIED | 처음 답장. 전달도 이 유형으로 기록됨 |
| FIRST_FORWARDED | 처음 전달. Gmail 웹에서 전달하면 기록되지 않음 |
| AUTOFORWARDED | 계정의 전달 설정으로 자동 전달 |
| MOVED_TO_INBOX | 받은편지함으로 이동 |
| MOVED_TO_TRASH | 휴지통으로 이동 |
| REMOVED_FROM_TRASH | 휴지통에서 복원 |
| LINK_CLICKED | 본문 링크 클릭 |
| ATTACHMENT_PREVIEW_LINK_CLICKED | 첨부 파일 미리보기에서 링크 클릭 |
| ATTACHMENT_DOWNLOADED | 첨부 파일 다운로드 |
| ATTACHMENT_SAVED_TO_DRIVE | 첨부 파일을 구글 드라이브에 저장 |
| DRIVE_ITEM_SAVED_TO_DRIVE | 메일의 구글 드라이브 항목을 받는 사람의 드라이브에 저장 |
| CLASSIFICATION_LABEL_APPLIED | 메일에 분류 라벨 적용 |
| CLASSIFICATION_LABEL_CHANGED | 메일의 분류 라벨 변경 |
| CLASSIFICATION_LABEL_REMOVED | 메일의 분류 라벨 제거 |
| ATTACHMENT_CLASSIFICATION_LABEL_APPLIED | 모든 첨부 파일에 분류 라벨 적용 |
| ATTACHMENT_CLASSIFICATION_LABEL_CHANGED | 모든 첨부 파일의 분류 라벨 변경 |
| ATTACHMENT_CLASSIFICATION_LABEL_REMOVED | 모든 첨부 파일의 분류 라벨 제거 |
| ARCHIVED | 보관처리 |
| PERMANENTLY_DELETED | 영구 삭제 |
| ATTACHMENT_PREVIEWED | 첨부 파일 미리보기 |
| DRAFT_SAVED | 임시 저장. 작성 중 자동 저장될 때마다 기록 |
| BOUNCED | 반송. 실제로는 UNKNOWN으로 기록됨 |
| VIEWED | 열람. 처음과 이후 열람 모두 포함. 스레드를 열면 이전 메일에도 기록 |
| MESSAGE_DOWNLOADED | 메일 다운로드. Gmail 웹에서 다운로드하면 기록되지 않음 |
| ACCESSED_BY_APP | 앱이 사용자 대신 메일에 접근 |
| RECEIVE_RATE_LIMITED | 수신 속도 제한으로 거부 또는 지연 |
| SEND_INITIATED | 사용자 또는 API가 발신 시작 |
처리 유형
action_type은 메일 처리 단계이며 다음 값 중 하나입니다. 목록에 없는 코드는 숫자 그대로 저장됩니다.
| 값 | 의미 |
|---|---|
| SMTP_INBOUND_RECEIVED | 수신 SMTP 서버가 메일을 받음 |
| ACCEPTED | Gmail이 메일을 받아 배달 준비 |
| ACTED | Gmail이 메일을 처리(사서함 배달, 다른 서버로 발신 등) |
| SMTP_OUTBOUND_SENT | 발신 SMTP 서버가 메일을 보냄 |
| TEMPORARY_ERROR_RETRY | 일시 오류로 재시도 예약 |
| BOUNCED | 배달하지 못해 반송 |
| DROPPED | Gmail이 메일을 버림 |
| GROUPS_ACCEPTED | 구글 그룹스가 배달을 위해 메일을 받음 |
| GROUP_RECIPIENT_EXPANDED | 수신 주소가 구글 그룹이라 구성원에게 배달 |
| RELAY_INBOUND_RECEIVED | 릴레이를 위해 수신 SMTP 서버가 메일을 받음 |
| RELAY_OUTBOUND_SENT | 릴레이로 발신 SMTP 서버가 메일을 보냄 |
| GROUPS_STORED | 구글 그룹스 저장소에 기록 |
| GROUPS_STORAGE_REJECTED | 구글 그룹스 저장소가 메일을 거부 |
| POLICY_REINSERTED | 배달 경로나 수신자를 바꾸는 정책으로 Gmail에 다시 넣음 |
| ACCEPTED_FROM_GMAIL_SERVER | Gmail 서버를 거쳐 온 메일을 받아 배달 준비 |
| USER_SPAM_RECLASSIFIED | 사용자가 Gmail에서 스팸 분류를 변경 |
| POST_DELIVERY_SPAM_RECLASSIFIED | 배달 후 스팸·피싱으로 재분류 |
| USER_INBOX_ACTION | 받은 뒤 사용자가 받은편지함에서 한 행동(열람, 링크 클릭, 첨부 다운로드 등) |