Skip to content
The Things Stack documentation home
Getting Started Concepts Cloud Enterprise Integrations API Hardware
Getting Started Concepts
Cloud Enterprise
Integrations API Hardware
Get The Things Stack

    Recent searches

      Popular pages

      • Getting Started
      • Adding Gateways
      • Adding Devices
      • Payload Formatters
      • Webhooks
      • Authentication

      No results for “”.

      • Check the spelling, or try fewer or more general words.
      • Ask the community on The Things Network Forum
      • Contact support
      ↑↓ to navigate ↵ to open Esc to close

      Integrations

      • Overview
      • Adding Applications
      • Data Formats
      • Payload Formatters
      • Webhooks
      • Storage Integration
      • Integrate with popular IoT platforms
        • akenza
        • AllThingsTalk Maker
        • AnyViz
        • AWS IoT
        • Azure IoT Central
        • Azure IoT Hub
        • Blockbax
        • Blynk
        • Cayenne
        • Cloud Studio
        • Daizy
        • Datacake
        • Delmation Products
        • deZem
        • evrlast
        • Homey
        • InfluxDB Cloud 2.0
        • IoT in a Box
        • IoT Wonderland
        • Kaa
        • Losant IoT Platform
        • MClimate
        • my IoT open Tech
        • Qubitro
        • TagoIO
        • Telemetry2U
        • Tellsens
        • thethings.iO
        • Thinger.io
        • ThingsBoard
        • ThingSpeak
        • TTN Mapper
        • Ubidots
        • UIB
        • UnaConnect
        • Widgelix
        • Withthegrid
        • Zoho IoT
      • Other integrations
      • Application Packages
      • Examples

      Kaa

      Updated 20 January 2025 Edit on GitHub
      Copy page
      • View as MarkdownThis page as plain text
      • Open in ChatGPTAsk questions about this page
      • Open in ClaudeAsk questions about this page

      Kaa is an IoT platform that provides device management, data collection, data processing and analytics, alerts, data visualization, configuration management, command execution, over-the-air updates and more. Kaa provides comprehensive multi-tenancy with full isolation of each tenant’s data, users, permissions, dashboards, solutions, etc. It is modular by design and built upon cloud-native microservices that you can easily swap, customize, or integrate with third-party solutions. Also, Kaa features a modern-looking, intuitive, and fully customizable web dashboard.

      This tutorial shows how to integrate The Things Stack with the Kaa platform for observing your device’s telemetry on the Kaa UI.

      Prerequisites

      1. A user account in the Kaa Cloud. Click here to register for free.

      Setup The Things Stack

      Go to the MQTT integration section on the left hand menu in The Things Stack and generate an API key to access The Things Stack application from Kaa.

      Generate API key

      Set the rights for the API key by selecting Grant all current and future rights. The Kaa platform requires this level of access in order to be able to query The Things Stack for application parameters and information on registered devices in that application.

      After that, go to the Payload formatters section on the left hand menu in The Things Stack, select Uplink and choose the Custom Javascript formatter. Leave the formatter code as it is suggested by default:

      function decodeUplink(input) {
        return {
          data: {
            bytes: input.bytes,
          },
          warnings: [],
          errors: [],
        };
      }
      

      Setup Kaa

      Create Application

      First, you need to create an application in the Kaa Cloud, that will correspond to the application inside The Things Stack.

      To do so, navigate to the Device management → Applications and add a new application by clicking the Add application button.

      Next, create at least one version of that application by clicking the plus button.

      Create Kaa application

      Create Application Integration

      Next, you can create the integration between Kaa and The Things Stack applications.

      Navigate to the Device management → Integrations and click the Add integration button. Fill in the following fields:

      • TTN username - The Things Stack MQTT username
      • TTN API key - the API key that you created in steps above
      • Identity Server Host - The Things Stack Identity Server host address (see the Server Addresses section for more info)
      • MQTT Server Host - The Things Stack MQTT public address
      Create application integration

      Create Device Integration

      Now, you need to create device integration, i.e. mappings between The Things Stack devices and Kaa endpoints.

      Go to the created application integration and create a device integration by choosing the application version and The Things Stack device that you want to integrate. You can see the device integration in the Devices list after its creation.

      Device integrations

      By navigating to Device management → Devices, you will find the Kaa endpoint that was automatically created during the device integration creation. All incoming data from The Things Stack device will be ingested under that endpoint.

      Created endpoint

      Visualize Device Data

      Next, you can visualize data coming from The Things Stack on Kaa UI.

      Edit the application configuration for the Endpoint Time Series service (EPTS). EPTS is a Kaa platform component responsible for transforming raw data samples into well-structured time series. It also stores the time series data and provides access to API for other services, including the Web Dashboard.

      Go to the Device management → Applications, expand the application used for integration, click on EPTS and enable auto-extraction.

      Enable time series auto extract

      With this function enabled, Kaa will automatically create a time series for each numeric field that it encounters at the root of data samples submitted by your endpoints. You will then be able to view these time series in the Kaa UI, with no extra configuration required.

      Now navigate to the device details page of the endpoint created in previous steps. To do that, go to the Devices page in the Device management section and click on the corresponding row. The data coming from The Things Stack device will be displayed on the Device telemetry widget.

      Endpoint with no telemetry data

      Let’s assume that The Things Stack device is sending temperature measurements in the next format:

      { "temp": 20 }
      

      Convert this payload to a byte array in HEX (7B 22 74 65 6D 70 22 3A 32 30 7D), go to the End devices → your device’s Overview page → Messaging in The Things Stack Console and paste the byte array into the Payload field.

      As a result, you should be able to see the data on Kaa UI.

      Endpoint with telemetry data

      Congratulations, you have successfully integrated The Things Stack with Kaa and visualized your data on the Kaa UI!

      Next Steps

      Explore more Kaa features by completing the Getting Started tutorials cycle with short tutorials on the main Kaa features.

      ← IoT Wonderland Losant IoT Platform →

      On this page

      • Prerequisites
      • Setup The Things Stack
      • Setup Kaa
      • Visualize Device Data
      • Next Steps

      Sections

      Getting Started

      Concepts

      Cloud

      Enterprise

      Integrations

      API

      Hardware

      Sitemap

      View our Sitemap

      Contributing

      GitHub

      About Us

      The Things Industries

      Privacy Policy

      Cookie settings

      Cookie Settings

      We use cookies to enhance your experience, analyze site traffic and deliver personalized content. Read our Privacy Policy.

      Cookie categories