akenza.io
WebsiteAPI DocumentationWhat's newLogin
  • Overview
  • Getting Started
    • Connect a Device
  • Changelog
  • General
    • Applications
    • Organization context
    • Workspace Context
    • Users
      • User Roles
  • Device Management
    • Managing an organization
      • API keys
      • Users (Organization)
        • Add & removing users from your organization
    • Managing a workspace
      • General Settings
        • Device Lifecycle Reports
        • Workspace properties
        • Occupancy settings
        • Device Setup Assistant
      • Custom fields
      • Tags
      • Users (Workspace)
    • Devices
      • Device
      • Device Simulator
      • Bulk actions
      • Bulk import CSV templates
    • Rules
      • Input
      • Logic blocks
        • Comparison
        • Custom Logic
          • Logic Block Scripting
      • Timed Rules
      • Rule Actions
        • Downlink
    • Data Flows
      • Device Connectors
        • Device Security
          • Using Device Credentials
            • Creating Public/Private Key Pairs
            • Using JSON Web Tokens (JWTs)
              • Python
              • Java
        • HTTP
        • MQTT
        • CoAP
        • LoRaWAN
          • Connectivity Management
          • Swisscom LoRaWAN
          • The Things Network
          • Loriot
          • Actility’s ThingPark Wireless
          • EWZ
          • Cibicom
          • Helium
          • ChirpStack
        • NB-IoT
        • mioty
        • Disruptive Technologies
        • VergeSense
        • Spaceti
        • Haltian
      • Device Types
        • Custom Device Types
          • Uplink
          • Downlink
          • Scripting
        • Library
      • Output Connectors
        • Databases
          • akenza DB
          • InfluxDB
          • SQL Databases
        • Streaming
          • Webhook
          • Azure IoT Hub
          • AWS Kinesis
          • Google Cloud Pub/Sub
          • Apache Kafka
        • Notifications
          • E-Mail
          • SMS
          • Microsoft Teams
          • Slack
    • Custom Components
    • Integrations
    • Reference
      • REST API
        • Filtering
        • Querying Device Data
      • WebSocket API
      • Scripting
        • Stateful Operations
        • Utility Functions
      • Payload Templating
  • Reference
  • Dashboard Builder
    • Managing Dashboards
      • Embedding dashboards
    • Components
      • Map
      • Floorplan
  • Device Setup Assistant
    • Device Setup Assistant - Overview
  • Tutorials
    • BI Tools
      • Grafana Data Source Plugin
      • How to build a dashboard with Retool
      • How to analyze data with AWS QuickSight
    • Devices
      • How to integrate the XDK device from Legic via MQTT on akenza
      • How to connect the Disruptive Technologies-cloud on akenza
      • How to send Downlinks to the Kuando Busylight device
      • How to integrate an Arduino device via MQTT on akenza
      • Integrate a MClimate Vicki LoRaWAN Radiator Thermostat on akenza
      • How to integrate an ERS Elsys device with Loriot on akenza
      • How to integrate the IAM Decentlab device with TTN on akenza
      • How to integrate the Seeed SenseCAP T1000 tracker on akenza
      • How to integrate a Swisscom Multisense device on akenza
    • Notifications
      • How to send SMS notifications
      • How to send notifications to Slack
      • How to send notifications to Microsoft Teams
    • Enterprise solutions
      • How to send data to Azure IoT Hub
      • How to send data to the Google Cloud Pub/Sub
      • How to send data to InfluxDB
      • How to send data to AWS Kinesis
      • How to send data to Azure Event Hubs with Apache Kafka
    • IoT Starter Kits
      • How to integrate the IAQ Kit with Actility on akenza
      • How to integrate the CoWork Kit with Actility on akenza
      • How to integrate the Smart Building Kit with Actility on akenza
      • How to integrate the Pepperl+Fuchs Kit with Actility on akenza
  • Support Center
    • FAQ
    • Status Page
    • Service Desk
    • Request a feature
  • Deprecated
    • SIM-Cards
    • Everynet
    • Sigfox
    • How to connect the Yanzi Lifecycle cloud on akenza
Powered by GitBook
On this page

Was this helpful?

  1. Device Management
  2. Data Flows
  3. Output Connectors
  4. Databases

InfluxDB

Send data to an InfluxDB

Previousakenza DBNextSQL Databases

Last updated 5 months ago

Was this helpful?

The InfluxDB Output connector can be used to forward data to an InfluxDB. The InfluxDB connector is available in both Data Flow and Rule Engine.

The InfluxDB connector requires

  • the URL or IP address under which the database can be reached

  • the Influx Organization: ID or email

  • the bucket where the data should be stored

  • the Influx API Token with write access to the bucket

  • the Measurement Name is an optional value. If it is not set, the topic of the data sample is used

  • the Mode which is either Event (triggered when a data sample is arriving) or Aggregation (the data is sent every 1 hour with an aggregated value (which?)).

  • The last value that can be set is the custom payload. If no custom payload is set, the data part of the sample will be used. All data keys present in the sample will be saved as fields in InfluxDB.

  • If a subset of the data keys or differently named data keys should be saved, the custom payload templated can be used.

The tags akenzaDeviceId, deviceId and deviceId are automatically created and populated.

Standard Example

Send a data sample to the InfluxDB without Measurement and without payload formatting:

// Translates to line protocol
// general format
<measurement>,[tags] <data key name>=<data key value> <timestamp>
// This example translates to
default,akenzaDeviceId=02b12aa91a7494eb,deviceId=C81758FFFE09845A,deviceName=desksensor occupancy=0 1765286099000

Advanced Example

Save a field named 'desk_occupancy' to InfluxDB. Adapt the custom payload as follows:

// Custom payload
{
 "desk_occupancy": {{data.occupancy}} 
}

Restrictions and Troubleshooting

Measurement names, tags, fields must not begin with underscore (_).

Be aware of duplicates, make sure a point is always structured in the same way, as conflicts or errors can arise if data types or field sets are changing. If the output connector throws an error, check in the InfluxDB console or UI where it comes from. Resolving an error might include deleting some inconsistent data first.

Be aware of changing data types. A field must always use the same types. A common error is a field saved in a different data type once and the output connector will be unable to save this field in a new data type. If the output connector is unable to write, check the affected field for a different data type. This can happen if the payload template can not be resolved completely and an error message is saved as field value.

A tutorial about "How to send data to InfluxDB" can be found .

here
InfluxDB template