Skip to content

Add more systemd notifications #3419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add more systemd notifications #3419

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5e77214
Implement systemd notify-reload mechanism
zigarn Sep 20, 2025
25a31e7
Add stopping notification to systemd
zigarn Sep 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/source/deploy.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,8 @@ to the newly created unix socket:

[Service]
# gunicorn can let systemd know when it is ready
Type=notify
# if systemd versions >= v253, otherwise use 'Type=notify'
Type=notify-reload
NotifyAccess=main
# the specific user that our service will run as
User=someuser
Expand All @@ -257,7 +258,8 @@ to the newly created unix socket:
RuntimeDirectory=gunicorn
WorkingDirectory=/home/someuser/applicationroot
ExecStart=/usr/bin/gunicorn applicationname.wsgi
ExecReload=/bin/kill -s HUP $MAINPID
# if 'Type=notify' instead of 'Type=notify-reload' (depending on systemd version)
# ExecReload=/bin/kill -s HUP $MAINPID
KillMode=mixed
TimeoutStopSec=5
PrivateTmp=true
Expand Down
3 changes: 3 additions & 0 deletions gunicorn/arbiter.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -251,7 +251,9 @@ def handle_hup(self):
- Gracefully shutdown the old worker processes
"""
self.log.info("Hang up: %s", self.master_name)
systemd.sd_notify("RELOADING=1\nSTATUS=Gunicorn arbiter reloading", self.log)
self.reload()
systemd.sd_notify("READY=1\nSTATUS=Gunicorn arbiter reloaded", self.log)

def handle_term(self):
"SIGTERM handling"
Expand Down Expand Up @@ -340,6 +342,7 @@ def wakeup(self):

def halt(self, reason=None, exit_status=0):
""" halt arbiter """
systemd.sd_notify("STOPPING=1\nSTATUS=Gunicorn arbiter stopping", self.log)
self.stop()

log_func = self.log.info if exit_status == 0 else self.log.error
Expand Down
3 changes: 3 additions & 0 deletions gunicorn/systemd.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@

import os
import socket
import time

SD_LISTEN_FDS_START = 3

Expand Down Expand Up @@ -66,6 +67,8 @@ def sd_notify(state, logger, unset_environment=False):
if addr[0] == '@':
addr = '\0' + addr[1:]
sock.connect(addr)
monotonic_usecs = time.clock_gettime_ns(time.CLOCK_MONOTONIC) // 1000
state = "%s\nMONOTONIC_USEC=%d" % (state, monotonic_usecs)
sock.sendall(state.encode('utf-8'))
except Exception:
logger.debug("Exception while invoking sd_notify()", exc_info=True)
Expand Down