The "Python SDK" module (hereafter: the PySDK) provides a lightweight, efficient, reliable input point to Alooma. The module provides a library of methods to record events and send them to Alooma from any Python application.
The module contains two main classes:
- The PySDK: Enqueues events to be reported to the Alooma pipeline. Events are queued into a concurrent queue, from which they are later pulled by the Sender module to be sent to your dedicated Alooma server.
- The Sender: Dequeues messages and sends them to your dedicated Alooma serve. The Sender also runs as a daemon in the background.
When initialized, the PySDK instantiates a Sender. The Sender starts a separate thread on which a TCP connection is opened. Any disconnection, send error, or other event does not interfere with other code nor crash the service. The module handles errors automatically. Upon disconnection, the module attempts to renew the socket and connection.
To integrate the PySDK, follow these simple steps:
pip install alooma_pysdkto install the SDK. Alternatively, the source can be downloaded directly from Alooma's GitHub repository.
- Import the module by adding the following line in your Python file:
- Log in to your Alooma account and add an "Python App" input.
- Give your input a label (name), and copy the generated token.
- Initialize a PySDK instance by adding the following line in your Python file:
sdk = alooma_pysdk.PythonSDK(YOUR_TOKEN)
token- The unique identifier for this input you got at step 4.
- There are many more useful parameters that can be supplied to this function. Here are some key ones (refer to the in-file method documentation for more):
servers- The server to send data to - only needed if indicated by Alooma support.
port- The remote port to connect to - only needed if indicated by Alooma support.
event_type- A string or callable which receives each event and returns a string. The event type for each event is placed in a
_metadata.event_typefield, which determines the type of the event in the Alooma Mapper screen.
callback_func- A callback function can be provided to be called whenever a log message is emitted from the PySDK.
- To report an event to Alooma simply add this one-liner to your code:
Alternatively, to report multiple events in one function call, use:
sdk.report_many([event_dict, event_dict, ...])
In both cases, each event must be a valid Python dictionary or a string. If not, it will be discarded and the callback function, if provided, will be called with an appropriate message.
- To ensure all internal SDK queues are flushed before closing your program, make sure to call
That's it, you're ready to send events to Alooma! As always, contact us with any questions.