/telemetry-agent-dotnet

Azure IoT Hub Streaming, Analytics, Alerts generation

Primary LanguageC#MIT LicenseMIT

Build Issues Gitter

Telemetry Agent Overview

This service analyzes the telemetry stream, stores messages from Azure IoT Hub to DocumentDb, and generates alerts according to defined rules. The IoT stream is analyzed using a set of rules defined in the Telemetry service, and generates "alarms" when a message matches some of these rules. The alarms are also stored in DocumentDb.

We provide also a Java version of this project.

Dependencies

How to use the microservice

Quickstart - Running the service with Docker

  1. Install Docker Compose: https://docs.docker.com/compose/install
  2. Create an instance of an Azure IoT Hub
  3. Store the "IoT Hub" connection string in the env-vars-setup script.
  4. Open a terminal console into the project folder, and run these commands to start the Telemetry Agent service
    cd scripts
    env-vars-setup      // (Bash users: ./env-vars-setup).  This script creates your env. variables
    cd docker
    docker-compose up
    

The Docker compose configuration requires the dependencies resolved and environment variables set as described previously. You should now start seeing the stream content in the console.

Contributing to the solution

Please follow our contribution guildelines. We love PRs too.

Troubleshooting

Feedback

Please enter issues, bugs, or suggestions as GitHub Issues here