Mirror of Apache Edgent (Incubating)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.mvn/wrapper - Updated Edgent to the latest updates in the Maven Wrapper Sep 28, 2017
analytics [maven-release-plugin] prepare for next development iteration Nov 29, 2017
api - Updated some of the dependencies to more recent versions. Aug 1, 2018
apps [maven-release-plugin] prepare for next development iteration Nov 29, 2017
buildTools release doc tweaks Feb 20, 2018
connectors - Updated some of the dependencies to more recent versions. Aug 1, 2018
console don't reuse console/server test JVMs Dec 11, 2017
distribution - Added Java 7 and Android versions of the RabbitMQ connector Mar 11, 2018
jqassistant - Replaced a lot of the structural variables with constants to eventu… Nov 13, 2017
platforms - Updated some of the dependencies to more recent versions. Aug 1, 2018
providers [Edgent-439] enable console port override Dec 10, 2017
runtime [maven-release-plugin] prepare for next development iteration Nov 29, 2017
spi [maven-release-plugin] prepare for next development iteration Nov 29, 2017
src release doc tweaks Feb 21, 2018
test [Edgent-440] don't deploy edgent-test* projects to Nexus Dec 11, 2017
utils Added missing ASF Header Mar 4, 2018
.editorconfig - Fine-tuned the editorconfig Sep 19, 2017
.gitignore [EDGENT-448] add a new ignore item to filter .DS_Store for mac os x Mar 4, 2018
.mailmap remove mapping of streamsadmin from mailmap Nov 14, 2016
.travis.yml - Removed the site generation on travis as this seems to be having is… Aug 28, 2017
CONTRIBUTORS - Added Java 7 and Android versions of the RabbitMQ connector Mar 11, 2018
DEVELOPMENT.md release doc tweaks Feb 20, 2018
DISCLAIMER Updated the DISCLAIMER to match the version distributed inside each j… Sep 21, 2017
JAVA_SUPPORT.md Fix JAVA_SUPPORT.md markdown Dec 6, 2017
Jenkinsfile comment out samples stuff in Jenkinsfile Nov 23, 2017
KEYS update KEYS with Chris's release signing key Dec 11, 2017
LICENSE LICENSE tweaks for re-addition of d3.legend.js to repo Oct 24, 2017
NOTICE - Removed the "incubator" reference from the NOTICE file as suggested… Dec 11, 2017
PROBLEMS.md work was done on WindowTests Nov 2, 2017
README update doc for samples repo Nov 21, 2017
README.md - Added a reference to the travis build status image to the README.md Nov 5, 2017
RELEASE_NOTES - Added Java 7 and Android versions of the RabbitMQ connector Mar 11, 2018
edgent_overview.html Adjust javadoc overview.html for getting started and samples Sep 26, 2017
mvnw - Updated Edgent to the latest updates in the Maven Wrapper Sep 28, 2017
mvnw.cmd - Updated Edgent to the latest updates in the Maven Wrapper Sep 28, 2017
pom.xml - Updated some of the dependencies to more recent versions. Aug 1, 2018
toolchains-travis.xml - Removed the java8 and java7 profiles Jun 18, 2017

README.md

Welcome to Apache Edgent!

Build Status

Apache Edgent is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Apache Edgent is an open source programming model and runtime for edge devices that enables you to analyze data and events at the device.

Please join us by subscribing to the developer mailing list dev at edgent.incubator.apache.org. To subscribe, send an email to dev-subscribe at edgent.incubator.apache.org.

We want to build a community around Edgent for analytics at the edge, so welcome contributions to any aspect of Edgent including:

  • Feedback from use in IoT and other device environments.
  • Support for more device environments
  • Additional connectors to edge sensors or new message hubs
  • Analytics to be executed at the edge
  • Sample applications
  • Documentation
  • Testing
  • Bug fixing
  • ...

Please Get Involved!

Edgent is released under the Apache License Version 2.0

Edgent

Devices and sensors are everywhere. And more are coming online every day. You need a way to analyze all of the data coming from your devices, but it can be expensive to transmit all of the data from a sensor to your central analytics engine.

Edgent is an open source programming model and runtime for edge devices that enables you to analyze data and events at the device. When you analyze on the edge, you can:

  • Reduce the amount of data that you transmit to your analytics server
  • Reduce the amount of data that you store

An Edgent application uses analytics to determine when data needs to be sent to a back-end system for further analysis, action, or storage. For example, you can use Edgent to determine whether a system is running outside of normal parameters, such as an engine that is running too hot.

If the system is running normally, you don’t need to send this data to your back-end system; it’s an added cost and an additional load on your system to process and store. However, if Edgent detects an issue, you can transmit that data to your back-end system to determine why the issue is occurring or how to resolve the issue.

Edgent enables you to shift from a continuous flow of trivial data to an intermittent trickle of meaningful data. This is especially important when the cost of communication is high, such as when using a cellular network to transmit data, or when bandwidth is limited.

The following use cases describe the primary situations in which you would use Edgent:

  • Internet of Things (IoT): Analyze data on distributed edge devices and mobile devices to:
    • Reduce the cost of transmitting data
    • Provide local feedback at the devices
  • Embedded in an application server instance: Analyze application server error logs in real time without impacting network traffic
  • Server rooms and machine rooms: Analyze machine health in real time without impacting network traffic or when bandwidth is limited

Edge devices and back-end systems

You can send data from an Edgent application to your back-end system when you need to perform analysis that cannot be performed on the edge device, such as:

  • Running a complex analytic algorithm that requires more resources, such as CPU or memory, than are available on the edge device.
  • Maintaining large amounts of state information about a device, such as several hours worth of state information for a patient’s medical device.
  • Correlating data from the device with data from other sources, such as:
    • Weather data
    • Social media data
    • Data of record, such as a patient’s medical history or trucking manifests
    • Data from other devices

Edgent communicates with your back-end systems through the following message hubs:

  • MQTT – The messaging standard for IoT
  • IBM Watson IoT Platform – A cloud-based services that provides a device model on top of MQTT
  • Apache Kafka – An enterprise-level message bus
  • Custom message hubs

Your back-end systems can also use analytics to interact with and control edge devices. For example:

  • A traffic alert system can send an alert to vehicles that are heading towards an area where an accident occurred
  • A vehicle monitoring system can reduce the maximum engine revs to reduce the chance of failure before the next scheduled service if it detects patterns that indicate a potential problem

Runtime environments

Edgent has a language binding for Java. See JAVA SUPPORT for information about the supported Java environments.

Getting Started

See the Edgent website for more information on all aspects of Edgent including Getting Started.

For details about the Edgent sources and contributing to Edgent runtime development see DEVELOPMENT.md

Renamed from Apache Quarks

Apache Quarks was renamed to Apache Edgent.

See the [RELEASE_NOTES](RELEASE_NOTES] for change information if you are converting from "Apache Quarks".