Мониторинг и отчёты

Отправить алерт по email

Формирует письмо и отправляет его через SMTP, параметры берутся из окружения.

Python Windows macOS Linux Продвинутый
Скачать email_alert.py
Описание

Что делает скрипт

Скрипт собирает письмо из аргументов или файла, подключается к SMTP и при необходимости использует STARTTLS и логин. Без флага --send выполняется только предпросмотр, поэтому случайная отправка исключена. Пароль берется из SMTP_PASSWORD или запрашивается скрыто.

Перед запуском
  • Письмо отправляется только с флагом --send.
Запуск

Быстрый старт

python email_alert.py --to ops@example.com --subject 'Disk warning' --body 'Disk is 91% full'

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python email_alert.py --to ops@example.com --body-file alert.txt --send
  • SMTP_HOST=smtp.example.com ALERT_FROM=monitor@example.com python email_alert.py --to ops@example.com --subject Alert --body 'Check failed' --send
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

email_alert.py

#!/usr/bin/env python3
"""Отправляет письмо-алерт через SMTP."""
from __future__ import annotations

import argparse
import getpass
import os
import smtplib
import ssl
import sys
from email.message import EmailMessage
from pathlib import Path


def read_body(path: str) -> str:
    if path == "-":
        return sys.stdin.read()
    return Path(path).expanduser().read_text(encoding="utf-8")


def main() -> int:
    parser = argparse.ArgumentParser(description="Email-алерт через SMTP")
    parser.add_argument("--to", required=True)
    parser.add_argument("--subject", default="Monitoring alert")
    parser.add_argument("--body", default="")
    parser.add_argument("--body-file", default="")
    parser.add_argument("--host", default=os.environ.get("SMTP_HOST", ""))
    parser.add_argument("--port", type=int, default=int(os.environ.get("SMTP_PORT", "587")))
    parser.add_argument("--from", dest="sender", default=os.environ.get("ALERT_FROM", ""))
    parser.add_argument("--user", default=os.environ.get("SMTP_USER", ""))
    parser.add_argument("--password", default=os.environ.get("SMTP_PASSWORD", ""))
    parser.add_argument("--no-tls", action="store_true")
    parser.add_argument("--send", action="store_true")
    parser.add_argument("--timeout", type=float, default=15.0)
    args = parser.parse_args()

    if args.body_file:
        try:
            body = read_body(args.body_file)
        except OSError as error:
            print(f"ОШИБКА: {error}", file=sys.stderr)
            return 2
    elif args.body:
        body = args.body
    else:
        body = sys.stdin.read()

    if not args.sender:
        args.sender = args.user
    message = EmailMessage()
    message["From"] = args.sender or "monitor@example.com"
    message["To"] = args.to
    message["Subject"] = args.subject
    message.set_content(body or "No details")

    if not args.send:
        print("DRY RUN: письмо не отправлено")
        print(f"From: {message['From']}")
        print(f"To: {message['To']}")
        print(f"Subject: {message['Subject']}")
        print(body or "No details")
        return 0

    if not args.host:
        print("ОШИБКА: задайте SMTP_HOST", file=sys.stderr)
        return 2
    if not args.sender:
        print("ОШИБКА: задайте ALERT_FROM или SMTP_USER", file=sys.stderr)
        return 2

    password = args.password
    if args.user and not password:
        password = getpass.getpass(f"SMTP пароль для {args.user}: ")

    context = ssl.create_default_context()
    try:
        with smtplib.SMTP(args.host, args.port, timeout=args.timeout) as smtp:
            smtp.ehlo()
            if not args.no_tls:
                smtp.starttls(context=context)
                smtp.ehlo()
            if args.user:
                smtp.login(args.user, password)
            smtp.send_message(message)
    except (OSError, smtplib.SMTPException) as error:
        print(f"ОШИБКА: {error}", file=sys.stderr)
        return 2

    print(f"Письмо отправлено: {args.to}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get monitoring-email-alert
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Мониторинг и отчёты

Сбор метрик, проверка доступности, отчёты и уведомления.

Теги