Looker에서 이메일을 예약하고 전송하면 데이터와 통계를 자동으로 배포하여 팀에 정보를 제공할 수 있습니다. 이러한 이메일이 도착하지 않는 경우 이 가이드에서는 전송 프로세스의 문제를 해결하고 문제를 해결하는 방법을 설명합니다.
예약된 이메일의 수명 주기
이메일 전송 프로세스의 단계를 이해하면 오류가 발생한 위치를 파악하는 데 도움이 됩니다.
- 일정 구성: 사용자가 Look 또는 대시보드의 일정을 만들고 저장하며 전송 방법으로 이메일을 선택합니다.
- 작업 생성: Looker 인스턴스가 예약된 작업을 만듭니다.
- 쿼리 실행 및 렌더링: 예약된 시간에 Looker 인스턴스가 콘텐츠의 쿼리를 실행하고 일정 옵션에 지정된 대로 시각화를 렌더링합니다.
- SMTP로 전달: Looker 인스턴스가 지정된 SMTP 서버 (기본 Looker 이메일 서비스 또는 커스텀 SMTP 서버)로 이메일을 전송합니다.
- SMTP 전송: SMTP 서버가 이메일을 수신하고 수신자의 이메일 서버로 전송합니다.
- 게이트웨이 필터링: 수신자의 조직에 있는 보안 소프트웨어 (예: Proofpoint)가 이메일이 사용자에게 도달하기 전에 스팸 또는 악성으로 필터링할 수 있습니다.
- 받은편지함 라우팅: 수신자의 이메일 클라이언트가 이메일을 수신하며, 여기서 로컬 스팸 필터 또는 받은편지함 규칙이 이메일을 정리, 보관 또는 삭제할 수 있습니다.
디버깅 트리
다음 의사 결정 트리를 사용하여 이메일 전송 실패 문제 해결을 시작하세요.
다음 섹션에서는 트리의 시나리오를 자세히 설명합니다.
스케줄러 계획 확인
예약된 이메일을 수신하지 못한 경우 먼저 일정이 존재하고 활성 상태인지 확인합니다.
일정이 생성되었는지 확인
관리자 패널의 일정 페이지로 이동하여 일정이 나열되어 있는지 확인합니다. 인스턴스에서 시스템 활동이 사용 설정된 경우 시스템 활동을 사용할 수도 있습니다.
일정이 표시되지 않으면 다음을 조사합니다.
- 사용자가 일정을 저장했는지 확인합니다.
- 일정이 삭제되거나 일시중지되었는지 확인합니다.
일정이 표시되면 Looker 인스턴스가 이메일을 전송할 계획입니다. 다음 섹션으로 계속 진행합니다.
스케줄러 기록 확인
일정이 있는 경우 실행 상태를 확인합니다.
작업 상태 확인
스케줄러 기록 페이지로 이동하여 전송 실패에 해당하는 작업을 찾습니다.
- 작업 상태가 완료인 경우 Looker가 이메일을 SMTP 서버로 전송했습니다. 다음 단계로 진행합니다.
- 작업 상태가 완료 가 아닌 경우 (예: 실패 인 경우) 다음을 조사합니다.
- 작업의 세부정보 탭을 클릭하여 오류 메시지를 확인합니다.
- 콘텐츠 (Look 또는 대시보드)를 수동으로 실행하여 콘텐츠가 성공적으로 렌더링되는지 또는 오류가 반환되는지 확인합니다. 일반적인 문제로는 데이터베이스 연결 오류 또는 쿼리 시간 초과가 있습니다.
커스텀 SMTP 문제 해결
작업 상태가 완료 이고 커스텀 SMTP를 사용하는 경우 문제는 SMTP 서버 또는 DNS 구성에 있을 가능성이 높습니다.
SMTP 서버 로그 확인
커스텀 SMTP가 사용 설정된 경우 다음을 조사합니다.
- SMTP 서버 로그를 확인하여 서버가 Looker에서 작업을 수신했는지, 서버가 전송을 시도했는지 확인합니다.
- 일반적인 문제로는 인증 실패, 잘못된 포트 설정 또는 SMTP 서버의 비율 제한이 있습니다.
SPF 레코드 확인
SMTP 서버에서 이메일을 전송하지만 수신자가 스팸으로 표시하거나 거부하는 경우 발신자 정책 프레임워크 (SPF) 레코드를 확인합니다. 잘못된 SPF 레코드는 수신 메일 서버가 도메인에서 전송된 이메일을 거부하도록 할 수 있습니다.
SPF 레코드를 테스트하려면 dig 명령줄 도구를 사용하면 됩니다.
- 다음 명령어를 실행하여 도메인의 SPF 레코드를 확인합니다 (DOMAIN_NAME을 도메인으로 바꿈).
bash dig +short txt <var>DOMAIN_NAME</var> | grep spf - 출력에 커스텀 SMTP 서버의 IP 주소 또는 호스트 이름이 포함되어 있는지 확인합니다.
기본 SMTP 문제 해결
Looker의 기본 SMTP 서비스를 사용하는 경우 메일 서버 로그에 직접 액세스할 수 없습니다. 전송 차단을 확인합니다.
전송 차단 확인: 보안 소프트웨어 및 스팸 필터
지원팀에 문의하기 전에 조직의 보안 시스템 또는 이메일 클라이언트 설정에서 이메일을 차단하고 있는지 확인합니다.
보안 소프트웨어 (예: Proofpoint) 또는 이메일 클라이언트 필터는 lookermail.com (Looker의 기본 발신자 도메인)에서 보낸 이메일을 차단할 수 있습니다.
- 조직의 이메일 게이트웨이 로그 (예: Proofpoint 또는
Mimecast)에서
lookermail.com또는looker@lookermail.com에서 보낸 차단된 이메일을 확인합니다. - 수신자의 스팸 또는 정크 폴더를 확인합니다.
- 이메일을 보관하거나 삭제할 수 있는 받은편지함 규칙이 있는지 확인합니다.
- 해결 방법: 이메일 관리자와 협력하여
lookermail.com및 Looker의 기본 이메일 서비스와 연결된 IP 주소를 허용 목록에 추가합니다.
지원팀에 문의
이전 단계를 모두 확인했는데도 이메일을 수신하지 못한 경우 다음을 수행합니다.
- 기본 SMTP를 사용하는 경우 지원팀에 문의하여 작업의 기본 SMTP 로그를 확인합니다. 작업 ID와 수신자 이메일 주소를 제공합니다.