Class AdminEmailHandler

django/utils/log.py:81–183

An exception log handler that emails log entries to site admins. If the request is passed as the first argument to the log record, request data will be provided in the email report.

class AdminEmailHandler(logging.Handler):
    """An exception log handler that emails log entries to site admins.

    If the request is passed as the first argument to the log record,
    request data will be provided in the email report.
    """

    def __init__(
        self, include_html=False, email_backend=None, reporter_class=None, using=None
    ):
        super().__init__()

        # RemovedInDjango70Warning: email_backend arg and connection error.
        if email_backend:
            if using:
                raise ImproperlyConfigured(
                    "The 'email_backend' argument is not compatible with 'using'."
                )
            if mail.mailers._is_configured:
                raise ImproperlyConfigured(
                    "The 'email_backend' argument is not valid when "
                    "settings.MAILERS is defined."
                )
            warnings.warn(
                "The 'email_backend' argument is deprecated. Use 'using' instead.",
                RemovedInDjango70Warning,
                skip_file_prefixes=django_file_prefixes(),
            )
        if hasattr(self, "connection"):
            raise AttributeError(
                "The undocumented AdminEmailHandler.connection() method is no longer "
                "used."
            )

        self.include_html = include_html
        self.email_backend = email_backend
        self.using = using
        self.reporter_class = import_string(
            reporter_class or settings.DEFAULT_EXCEPTION_REPORTER
        )

    def emit(self, record):
        # Early return when no email will be sent.
        if (
            not settings.ADMINS
            # Method not overridden.
            and self.send_mail.__func__ is AdminEmailHandler.send_mail
        ):
            return
        try:
            request = record.request
            subject = "%s (%s IP): %s" % (
                record.levelname,
                (
                    "internal"
                    if request.META.get("REMOTE_ADDR") in settings.INTERNAL_IPS
                    else "EXTERNAL"
                ),