m365-exchange-mail-flows
마이크로소프트 그래프 메시지 추적 API를 이용하여 익스체인지 메일 흐름 추적 로그를 조회합니다.
Note
앱 버전 1.5.2609.0 부터 마이크로소프트 그래프 메시지 추적 API를 사용합니다. 이전 버전은 오피스 365 리포팅 웹서비스를 사용하며, 출력 필드가 다릅니다.
m365-exchange-mail-flows [profile=PROFILE] [duration=NUM{mon|w|d|h|m|s}] [from=yyyyMMddHHmmss] [to=yyyyMMddHHmmss]
- profile=PROFILE
- 마이크로소프트 365 접속 프로파일 식별자
- duration=NUM{mon|w|d|h|m|s}
- 현재 시각으로부터 일정 시간 범위 이내의 로그로 한정. s(초), m(분), h(시), d(일), mon(월) 단위로 지정할 수 있습니다. 예를 들면, 10s의 경우 현재 시각으로부터 10초 이전까지의 범위를 의미합니다.
- from=yyyyMMddHHmmss
- yyyyMMddHHmmss 포맷으로 범위의 시작을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
- to=yyyyMMddHHmmss
- yyyyMMddHHmmss 포맷으로 범위의 끝을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
조회 기간에 제한이 있습니다. 그래프 메시지 추적은 최근 90일 이내의 데이터만 보관하므로, 90일보다 이전 시각을 지정하면 오류가 반환됩니다. 긴 기간을 지정하면 내부적으로 10일 단위로 나누어 조회합니다.
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| _time | 날짜 | 시각 | |
| profile | 문자열 | 접속 프로파일 | 마이크로소프트 365 접속 프로파일 식별자 |
| mail_from | 문자열 | 보낸 사람 | 이메일 주소 형식 |
| mail_to | 문자열 | 받는 사람 | 이메일 주소 형식 |
| mail_subject | 문자열 | 메일 제목 | |
| size | 64비트 정수 | 크기 | 바이트 단위 |
| status | 문자열 | 상태 | 예: Delivered, Failed, Expanded, Quarantined, FilteredAsSpam |
| src_ip | IP 주소 | 출발지 IP | 발신 메일 서버 IP |
| dst_ip | IP 주소 | 목적지 IP | 수신 도메인 MX의 IP. 수신 메일은 빈 값 |
| index | 32비트 정수 | 인덱스 | 그래프 API 미제공. 리포팅 API 호환 필드 |
| msg_id | 문자열 | 메시지 ID | |
| msg_trace_id | 문자열 | 메시지 추적 식별자 | GUID 형식 |
| organization | 문자열 | 조직 이름 | 그래프 API 미제공. 리포팅 API 호환 필드 |
| start_date | 문자열 | 시작 일시 | 그래프 API 미제공. 리포팅 API 호환 필드 |
| end_date | 문자열 | 종료 일시 | 그래프 API 미제공. 리포팅 API 호환 필드 |