Getting started


  • Swap content from here with Kotori Handbook
  • Rename this file to “setup/kotori.rst”.
  • How to bring MQTTKit into the mix?


Configure an example application with Kotori based on the MQTTKit communication style.

Getting started

Access Grafana

Configure Kotori application

  • cp /etc/kotori/examples/mqttkit.ini /etc/kotori/apps-available/amazonas.ini
  • Edit:

    realm       = amazonas
    mqtt_topics = amazonas/#
  • Activate:

    ln -s /etc/kotori/apps-available/amazonas.ini /etc/kotori/apps-enabled/
  • Watch Kotori logfile:

    tail -F /var/log/kotori/kotori.log
  • Restart Kotori:

    systemctl restart kotori

Send sample telemetry packet

mosquitto_pub -t amazonas/ecuador/cuyabeno/1/data.json -m '{"temperature": 42.84, "humidity": 94}'


No data in Grafana I

  • Q: I don’t see any data

  • A: Most probably, your system time is wrong or deviates from the time of the system accessing Grafana from. For example, you won’t see any data if the server time is in the future.


    Better install chrony or use other means to keep your system times sound:

    apt install chrony

No data in Grafana II

  • Q: I still don’t see any data
  • A: Try to increase the log level by adding --debug-foobar command line options to /etc/default/kotori and get back to us, stacktrace or GTFO. See /opt/kotori/bin/kotori --help for available options.

Example /etc/default/kotori:

KOTORI_OPTS="--debug-mqtt --debug-influx"