이메일

Zabbix v7.4번역일: 2026-09-09원본 보기

개요

이메일을 메시지 전송 채널로 사용하려면 이메일을 미디어 유형으로 구성하고 사용자에게 특정 주소를 할당해야 합니다.

단일 이벤트에 대한 여러 알림은 동일한 이메일 스레드로 그룹화됩니다.

구성

이메일을 미디어 유형으로 구성하려면:

Alerts > Media types로 이동합니다.
Create media type을 클릭합니다 (또는 미리 정의된 미디어 유형 목록에서 Email을 클릭합니다).

Media type 탭에는 일반적인 미디어 유형 속성이 포함되어 있습니다:

필수 입력 필드는 빨간색 별표로 표시됩니다.

이메일 미디어 유형 구성을 내보낼 때 비밀번호는 평문으로 내보내집니다.

다음 매개변수는 이메일 미디어 유형에 특화된 것입니다:

매개변수	설명
Email provider	이메일 제공업체를 선택합니다: Generic SMTP, Gmail, Gmail relay, Office365, 또는 Office365 relay. Gmail/Office365 관련 옵션을 선택하는 경우 발신자 이메일 주소와 비밀번호만 입력하면 됩니다. SMTP server, SMTP server port, SMTP helo, Connection security와 같은 옵션은 Zabbix가 자동으로 채웁니다. 참고: Automated Gmail/Office365 media types.
SMTP server	발신 메시지를 처리할 SMTP 서버를 설정합니다. 이 필드는 이메일 제공업체로 Generic SMTP를 선택한 경우에 사용할 수 있습니다.
SMTP server port	발신 메시지를 처리할 SMTP 서버 포트를 설정합니다. 이 필드는 이메일 제공업체로 Generic SMTP를 선택한 경우에 사용할 수 있습니다.
Email	여기에 입력한 주소는 발송되는 메시지의 From 주소로 사용됩니다. 위 스크린샷의 Zabbix_info <zabbix@company.com>에서 "Zabbix_info"처럼 실제 이메일 주소와 함께 발신자 표시 이름을 추가하는 것이 지원됩니다. Zabbix 이메일의 표시 이름에는 RFC 5322에서 허용하는 것과 비교했을 때 다음 예시와 같은 제한 사항이 있습니다: 유효한 예시: zabbix@company.com (이메일 주소만, 꺾쇠괄호 불필요) Zabbix_info <zabbix@company.com> (표시 이름과 꺾쇠괄호로 감싼 이메일 주소) ∑Ω-monitoring <zabbix@company.com> (표시 이름에 UTF-8 문자 사용) 유효하지 않은 예시: Zabbix HQ zabbix@company.com (표시 이름은 있지만 이메일 주소를 감싸는 꺾쇠괄호 없음) "Zabbix@<H(comment)Q>" <zabbix@company.com> (RFC 5322에서는 유효하지만 Zabbix 이메일에서는 인용된 쌍과 주석이 지원되지 않음)
SMTP helo	올바른 SMTP helo 값을 설정합니다. 일반적으로 도메인 이름입니다. 비어 있으면 이메일의 도메인 이름이 전송됩니다 (즉, Email 필드에서 `@` 뒤에 오는 부분). 도메인 이름을 가져올 수 없는 경우 디버그 수준 경고가 기록되고 서버 호스트 이름이 HELO 명령의 도메인으로 전송됩니다. 이 필드는 이메일 제공업체로 Generic SMTP를 선택한 경우에 사용할 수 있습니다.
Connection security	연결 보안 수준을 선택합니다: None - CURLOPT_USE_SSL 옵션을 사용하지 않음 STARTTLS - CURLUSESSL_ALL 값으로 CURLOPT_USE_SSL 옵션 사용 SSL/TLS - CURLOPT_USE_SSL 사용은 선택 사항
SSL verify peer	SMTP 서버의 SSL 인증서를 검증하려면 체크박스를 선택합니다. 인증서 검증을 위해 "SSLCALocation" 서버 구성 지시어의 값을 CURLOPT_CAPATH에 입력해야 합니다. 이는 cURL 옵션 CURLOPT_SSL_VERIFYPEER를 설정합니다.
SSL verify host	SMTP 서버 인증서의 Common Name 필드 또는 Subject Alternate Name 필드가 일치하는지 확인하려면 체크박스를 선택합니다. 이는 cURL 옵션 CURLOPT_SSL_VERIFYHOST를 설정합니다.
Authentication	인증 수준을 선택합니다: None - cURL 옵션이 설정되지 않음 Username and password - "AUTH="를 의미하며 인증 메커니즘 선택은 cURL에 맡겨짐 OAuth* - OAuth 인증 Office365 relay 이메일 제공업체는 OAuth 인증을 지원하지 않습니다.
Username	인증에 사용할 사용자 이름입니다. 이는 CURLOPT_USERNAME 값을 설정합니다. 사용자 매크로가 지원됩니다.
Password	인증에 사용할 비밀번호입니다. 이는 CURLOPT_PASSWORD 값을 설정합니다. 사용자 매크로가 지원됩니다. 여기에 입력한 값은 미디어 유형 구성을 내보낼 때 그대로 내보내집니다. 내보낸 파일에서 민감한 자격 증명이 노출되지 않도록 하려면 리터럴 비밀번호 대신 사용자 매크로(예: `{$EMAIL_SMTP_PASSWORD}`)를 사용하세요. 매크로 참조가 내보내지고, 실제 비밀 값은 대상 시스템에서 (다시) 구성해야 합니다.
OAuth tokens	새 창에서 OAuth 토큰을 가져오기 위한 매개변수를 설정하려면 Configure를 클릭합니다. 이 필드는 Authentication 필드에서 "OAuth"를 선택한 경우에만 사용할 수 있습니다.
Message format	메시지 형식을 선택합니다: HTML - HTML로 전송 Plain text - 일반 텍스트로 전송

SMTP 인증을 활성화하려면 Zabbix 서버가 --with-libcurl 컴파일 옵션으로 컴파일되어야 하며, 이는 libcurl을 필요로 합니다(버전 세부 정보는 서버 요구 사항 참조).

기본 메시지 및 알림 처리 옵션 구성 방법에 대한 자세한 내용은 공통 미디어 유형 매개변수를 참고하세요.

OAuth 토큰

OAuth 토큰을 가져오려면 다음 매개변수가 필요합니다:

이메일 미디어 유형 구성을 내보낼 때 클라이언트 비밀은 평문으로 내보내집니다.

매개변수	설명
Redirection endpoint	OAuth 서비스가 OAuth 인가를 리디렉션할 Zabbix 프론트엔드 URL을 입력합니다(형식: `https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize`). 프론트엔드 URL이 정의되어 있으면 새 이메일 미디어 유형에 대해 자동으로 설정됩니다.
Client ID	OAuth 인가 서버에 등록된 클라이언트 앱의 고유 식별자를 입력합니다.
Client secret	OAuth 인가 서버에 등록된 클라이언트 앱의 비공개 비밀을 입력합니다.
Authorization endpoint	사용자 인가를 요청하기 위한 OAuth 인가 서버 URL을 입력합니다.
Authorization parameters	인가 엔드포인트에 대한 매개변수를 입력합니다.
Authorization code	인가 코드를 입력합니다: Automatic - 리디렉션 페이지를 통해 코드가 자동으로 가져와집니다 Manual - 자동 가져오기가 실패하면 코드를 수동으로 입력합니다
Token endpoint	인가 코드를 액세스 토큰과 리프레시 토큰으로 교환하기 위한 OAuth 인가 서버 URL을 입력합니다.
Token parameters	액세스 토큰에 대한 매개변수를 입력합니다.

OAuth 토큰 가져오기는 Gmail, Gmail relay, Office365 이메일 제공업체에 대해 자동화 기능을 제공합니다. Redirection endpoint, Client ID, Client secret 매개변수 값만 입력하면 됩니다. Zabbix가 다른 필수 값을 자동으로 채워줍니다(제공업체별 OAuth URL 기본값 참고).

OAuth 액세스 및 리프레시 토큰 가져오기

OAuth 매개변수를 제출한 후:

브라우저 팝업이 열리며 사용자를 Authorization endpoint로 이동시킵니다.
사용자가 OAuth 서비스에서 Zabbix를 인가합니다.
OAuth 서비스가 인가 코드와 scope 값을 포함하여 사용자를 Zabbix 프론트엔드 액션 oauth.authorize로 리디렉션합니다.
응답으로 Zabbix는 Token endpoint에 요청을 보내 인가 코드를 액세스 토큰과 리프레시 토큰으로 교환합니다.

테스트

구성된 이메일 미디어 유형이 올바르게 작동하는지 테스트하려면:

미디어 유형 목록에서 해당 이메일을 찾습니다.
목록의 마지막 열에서 Test를 클릭합니다(테스트 창이 열립니다).
Send to 수신자 주소, 메시지 본문, 필요하면 제목을 입력합니다.
Test를 클릭하여 테스트 메시지를 전송합니다.

테스트 성공 또는 실패 메시지가 동일한 창에 표시됩니다:

사용자 미디어

이메일 미디어 유형이 구성되면 Users > Users 섹션으로 이동하여 사용자 프로필을 편집해 이메일 미디어를 사용자에게 할당합니다. 모든 미디어 유형에 공통되는 사용자 미디어 설정 단계는 Media types 페이지에 설명되어 있습니다.