Skip to main content
  1. Articles/

Setting Up an Asyncio Web Server with Python 3.9 for Aliveness Testing

·471 words·3 mins
article guide python asyncio health check
Wing Tang Wong
Wing Tang Wong
SRE/DevOps/Platform Engineer/Software Engineer
Table of Contents

Introduction #

In this article, we will explore how to quickly set up an asyncio web server using Python 3.9 to handle an aliveness test via a URL. Asynchronous programming with Python’s asyncio library allows us to build efficient web servers that can handle concurrent requests without the need for threads or processes. Aliveness tests are essential for ensuring that our web server is up and running, responding to requests, and is not experiencing any issues.

Prerequisites #

Before we proceed, make sure you have the following:

  1. Python 3.9 (or a higher version) installed on your system.
  2. Basic knowledge of Python and asynchronous programming concepts.

Installing Required Libraries #

The first step is to install the necessary libraries. We will use the aiohttp library, which provides an easy-to-use asynchronous HTTP client/server framework.

pip install aiohttp

Creating the Asyncio Web Server #

Now let’s create a Python script for our asyncio web server. We’ll name it You can use your preferred code editor to create the file.

import asyncio
from aiohttp import web

async def aliveness_handler(request):
    return web.Response(text="Server is alive and kicking!")

async def setup_app():
    app = web.Application()
    app.router.add_get('/check-alive', aliveness_handler)
    return app

if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    app = loop.run_until_complete(setup_app())
    web.run_app(app, host='localhost', port=8080)

Understanding the Code #

  1. We import the required modules: asyncio for asynchronous functionality and aiohttp for creating our web server.
  2. The aliveness_handler function is an asynchronous coroutine that handles incoming requests to the /check-alive URL. It will respond with a simple “Server is alive and kicking!” message.
  3. The setup_app function creates an aiohttp web application, registers the aliveness_handler for the specified URL, and returns the app instance.
  4. In the __main__ block, we get the event loop using asyncio.get_event_loop() and then run the setup_app() coroutine to get the web application instance.
  5. Finally, we run the web application using web.run_app() on the specified host and port (localhost:8080 in this example).

Starting the Server #

To start the asyncio web server, open your terminal, navigate to the directory where is located, and run the following command:


The server will start, and you should see a message similar to:

======== Running on http://localhost:8080 ========
(Press CTRL+C to quit)

Testing the Aliveness Endpoint #

Open your web browser or use a tool like curl or Postman to access the aliveness endpoint:


You should receive the response “Server is alive and kicking!” confirming that your asyncio web server is set up correctly and handling requests.

Conclusion #

Congratulations! You’ve successfully set up an asyncio web server with Python 3.9 to handle an aliveness test via a URL. Asynchronous programming allows your web server to efficiently handle multiple requests concurrently, making it suitable for high-performance applications. You can now build upon this foundation to create more complex and robust web applications using Python’s asyncio and aiohttp libraries.


Exploring Numpy and Pandas in Python 3.9: Installation, Benefits, Data Import, Manipulation, and Export
·767 words·4 mins
article guide python numpy pandas etl data
Introduction # Numpy and Pandas are fundamental libraries for data manipulation and analysis in Python.
Python Installation and Virtual Environments: A Quick Guide
·566 words·3 mins
article guide python venv anaconda conda
Introduction # Python has been a staple programming language for Linux administrators and developers alike.
Installing Python 3.9 and Managing Multiple Versions on Mac OS X and Linux
·577 words·3 mins
articles guide python linux mac osx setup
Introduction # Python is a versatile programming language, and it’s essential to have the latest version installed on your system for leveraging the newest features and improvements.
Gathering and Ingesting Data from Different Sources using Numpy and Pandas
·631 words·3 mins
article guide numpy pandas data
Gathering and Ingesting Data from Different Sources using Numpy and Pandas # Data is the foundation of any data-driven project, and gathering data from various sources is a crucial step in the data analysis pipeline.
Strong Winds In Bay Area Knock Down Powerlines!
·155 words·1 min
news news weather failures
Strong Winds In California March 14th, 2023 # On March 14th, 2023, as I sat in my car at the “Jack in the Box” fast-food drive-through, little did I know I would witness a rather unexpected event.