Package: kotori
Telemetry data acquisition and sensor networks for humans.Status:Usage:Compatibility:AboutKotori is a multi-channel, multi-protocol, telemetry data acquisition and
graphing toolkit fortime-seriesdata processing. Free, open, simple.
It supports scientific environmental monitoring projects,
distributed sensor networks, and likewise scenarios.DetailsKotori is adata historianbased onGrafana,Mosquitto, andInfluxDB,
and is written inPythonwithTwisted.
The best way to find out what you can do with Kotori, is by looking at
some outlinedscenariosand by reading how others are using it at theexample gallery. To learn more about the technical details, have
a look at the usedtechnologies.FeaturesMulti-channel and multi-protocol data-acquisition and -storage. Collect and
store sensor data from different kinds of devices, data sources, and protocols.Built-in sensor adapters, flexible configuration capabilities, durable
database storage and unattended graph visualization.Based on an infrastructure toolkit assembled from different components
suitable for data-acquisition, -storage, -fusion, -graphing and more.Leverage the flexible data acquisition integration framework for building
telemetry data acquisition and logging systems, test benches, or sensor
networks for environmental monitoring systems, as well as other kinds of
data-gathering and -aggregation projects.It integrates well with established hardware-, software- and
data acquisition workflows through flexible adapter interfaces.InstallationKotori can be installed in different ways. You may prefer using a Debian
package, install it from the Python Package Index (PyPI), or run it within
adevelopment sandboxdirectly from the Git repository.Corresponding installation instructions are bundled athttps://getkotori.org/docs/setup/.SynopsisA compact example how to submit measurement data on a specific channel, using
MQTT and HTTP, and export it again.Data acquisitionFirst, let’s define a data acquisition channel:CHANNEL=amazonas/ecuador/cuyabeno/1and some example measurement data:DATA='{"temperature": 42.84, "humidity": 83.1}'Submit with MQTT:MQTT_BROKER=daq.example.org
echo "$DATA" | mosquitto_pub -h $MQTT_BROKER -t $CHANNEL/data.json -lSubmit with HTTP:HTTP_URI=https://daq.example.org/api/
echo "$DATA" | curl --request POST --header 'Content-Type: application/json' --data @- $HTTP_URI/$CHANNEL/dataData exportMeasurement data can be exported in a variety of formats.This is a straight-forward example for CSV data export:http $HTTP_URI/$CHANNEL/data.csvAcknowledgementsThanks a stack to all thecontributorswho helped to co-create and conceive
Kotori in one way or another. You know who you are.Project informationContributionsEvery kind of contribution, feedback, or patch, is much welcome.Create an
issueor submit a patch if you think we should include a new feature, or to
report or fix a bug.DevelopmentIn order to setup a development environment on your workstation, please head over
to thedevelopment sandboxdocumentation. When you see the software tests succeed,
you should be ready to start hacking.ResourcesSource codeDocumentationPython Package Index (PyPI)LicenseThe project is licensed under the terms of the GNU AGPL license, seeLICENSE.