Here we show how to set up a virtual environment and add the required Python packages.

⚙️ Pre-requisites

1️⃣ Credentials

You need an ingestion Token and the Ingestion API URL. Follow these instructions.

2️⃣ Clone Kensu sample code to try the agent

Clone the repository:

Inside find:

• sample programs: script.py and script_with_kensu.py
• data files in: data
• config file:conf.ini

Set up a virtual environment

You need to create a Python virtual environment. This is because on UNIX-based systems, like Mac and Ubuntu, Python 2.x is part of the operating system. So you might get conflicts installing Python packages into that. A virtual environment means one created in the logged-in user's directories instead of system directories.

First, you need to install Python 3. On Mac and Windows systems you can just download that from https://www.python.org/downloads/. On Ubuntu 20.04 and greater, it is already installed. If it is not installed the which python command will say nothing.



Install it with:



Check the version with this:



On Linux systems, like Ubuntu and Debian, you also need to install:



Then create a virtual environment using the command below. Do this in your home directory as it will put it there. In this example, we use the name py38, but you can use any name.



Now activate the environment:



To deactivate the environment just type deactivate.

Set up a virtual environment on Windows

Open the DOS command prompt by running cmd. Create and activate a Python virtual environment like shown below. Here we use the name py310, but you can use any name you like. If it works, the prompt will change to (py310).

Install Python packages

After you have sourced the environment created above, add these three Python packages. Kensu is the Kensu-py package. Since it extends Pandas we will install that as well.