AppDynamics IoT Java SDK

Table of Contents

• Overview
• What is included
• Getting Started
• Download the released jar
• Building the SDK
• Building the Javadocs
• Documentation
• Versioning
• Copyright and License

Overview

This repository contains the AppDynamics IoT Java SDK that can be used in embedded applications to monitor network perfomance, errors, and business metrics.

What is Included

• sdk - The Appdynamics Java SDK for IoT.
• sample-apps - A sample application showing how to use the SDK.
• docs - The Javadoc for the SDK. It can also be viewed online.

Getting Started

The best way to understand how to use the SDK is to run the sample application.

1. Clone or download the repo https://github.com/Appdynamics/iot-java-sdk.git in <MY_SOURCE_FOLDER>.

2. Get an EUM App Key and a Collector URL. Note: If you do not have an AppDynamics account, you can sign up for one here.

3. Add your EUM app key and Collector URL to your sample app by making the following edits to <MY_SOURCE_FOLDER>/iot-java-sdk/sample-apps/src/main/java/com/appdynamics/iotapps/MyIoTSampleApp.java:

   public static final String APP_KEY = "<YOUR-APP-KEY>";  
   public static final String COLLECTOR_URL = "<YOUR-COLLECTOR-URL>";

4. Build the sample-app by running the following commands. (It also builds the SDK.)

   cd <MY_SOURCE_FOLDER>/iot-java-sdk
   ./gradlew -p sample-apps clean distTar

5. Create a new folder where you'll run the deployed code.

   mkdir <MY_DEPLOY_FOLDER>

6. Copy the distribution tar file that includes the sample app and the AppDynamics IoT Java SDK to this deployment folder.

   cp ./sample-apps/build/distributions/appd-iot-sample-app.tar <MY_DEPLOY_FOLDER>

7. Un-tar and run the application.

   cd <MY_DEPLOY_FOLDER> 
   tar xvf appd-iot-sample-app.tar  
   ./appd-iot-sample-app/bin/sample-apps

8. Confirm the IoT Data was reported to the EUM Collector.

Download the Released JAR

The released version of the SDK can be downloaded from https://github.com/Appdynamics/iot-java-sdk/releases.

Build the SDK

1. Clone or download the repo https://github.com/Appdynamics/iot-java-sdk.git in <MY_SOURCE_FOLDER>.
2. Make any modifications to the SDK, if desired.
3. Run the following command from a terminal

   cd <MY_SOURCE_FOLDER>/iot-java-sdk 
   ./gradlew -p sdk/ clean assemble test

Build the Javadocs

1. Clone or download the repo https://github.com/Appdynamics/iot-java-sdk.git in <MY_SOURCE_FOLDER>.
2. Make any modifications, if desired.
3. Run the following command from a terminal

   cd <MY_SOURCE_FOLDER>/iot-java-sdk  
   ./gradlew -p sdk/ clean assemble test generateZippedJavadocs

Documentation

• Javadoc
• REST API docs - provides the payload structure sent to the Appdynamics EUM Collector.
• User Documents - provides an overview about the IoT monitoring capabilities.
• Support for other languages:
  • C++ SDK and Sample App
  • Python Sample Code

Code Inspection

• Code Coverage

  The build.gradle file has a task to track code coverage using jacoco

  • Generate the report with the following gradlew command:

    cd <MY_SOURCE_FOLDER>/iot-java-sdk
    ./gradlew test jacocoTestReport

  • View the report by opening the file <MY_SOURCE_FOLDER>/iot-java-sdk/sdk/build/jacocoHtml/index.html in a browser.

• Code Quality

  The build.gradle file has a task to track code quality using findbugs

  • Generate report with the following gradlew command:

    cd <MY_SOURCE_FOLDER>/iot-java-sdk
    ./gradlew check

  • View the report by opening the files

  <MY_SOURCE_FOLDER>/iot-java-sdk/sdk/build/reports/findbugs/main.html <MY_SOURCE_FOLDER>/iot-java-sdk/sdk/build/reports/findbugs/test.html <MY_SOURCE_FOLDER>/iot-java-sdk/sample-apps/build/reports/findbugs/main.html

• Coding Standards Inspection The build.gradle file has a task to track code quality using checkstyle

  • Generate the report with the following gradlew command

  cd <MY_SOURCE_FOLDER>/iot-java-sdk
  ./gradlew check

  • View the reports in <MY_SOURCE_FOLDER>/iot-java-sdk/*/build/reports/checkstyle/

Versioning

Versioning of releases of this project is maintained under the Semantic Versioning Guidelines

Copyright and License

The code is released under the Apache 2.0 License. Copyright (c) 2018 AppDynamics LLC and its affiliates.