Mirror of Apache Edgent (Incubating)
Java JavaScript Shell Roff HTML XSLT Other
Latest commit ec6ccb2 Feb 28, 2017 @dlaboss dlaboss Merge pull request #292
This closes #292
Permalink
Failed to load latest commit information.
.gradle-wrapper Edgent-253 [gradle] update gradle wrapper to use gradle 3.1 Sep 26, 2016
analytics [Edgent-268] change licensing in gradle files Nov 11, 2016
android [Edgent-268] change licensing in gradle files Nov 11, 2016
api Merge pull request #273 Jan 16, 2017
apps clarify limitations with IotProvider and PublishSubscribeService Feb 25, 2017
binary-release [Edgent-386] improve readability of README Feb 27, 2017
buildTools [Edgent-385] fix stage_release_candidate.sh Feb 27, 2017
connectors [Edgent-387] update iotp sample javadoc Feb 27, 2017
console [EDGENT-200] Console: Add missing tuple counts Jan 5, 2017
ext [WIP] Edgent-261 remove external jars from repo Oct 4, 2016
gradle [Edgent-329] add Apache RAT task to build Dec 28, 2016
licenses [Edgent-380] update MQTT connector to include paho-mqtt 1.1.0 Feb 20, 2017
platform release build fixes Nov 21, 2016
providers Fix javadoc warnings Feb 2, 2017
runtime more cleanup Feb 3, 2017
samples [Edgent-387] update iotp sample javadoc Feb 27, 2017
scripts final cleanup Feb 26, 2017
spi [Edgent-363] clarify / disallow null&empty topology name Jan 5, 2017
test add test of IotProvider.getProvider() Jan 23, 2017
utils [Edgent-268] change licensing in gradle files Nov 11, 2016
.gitignore Use different dir for external jars, improve doc Sep 29, 2016
.mailmap remove mapping of streamsadmin from mailmap Nov 14, 2016
.project Change name from Quarks to Edgent Jul 15, 2016
.travis.yml add more license headers Nov 11, 2016
CONTRIBUTORS [Edgent-383] Update RELEASE_NOTES AND CONTRIBUTORS Feb 21, 2017
DEVELOPMENT.md [Edgent-390] improve java7 test doc Feb 27, 2017
DISCLAIMER Edgent-264 Add DISCLAIMER file Oct 7, 2016
JAVA_SUPPORT.md fix typo Nov 17, 2016
KEYS [WIP] Edgent-274 Add support for distribution signing Oct 12, 2016
LICENSE clarify how jquery is bundled Dec 1, 2016
NOTICE [Edgent-381] update NOTICES for 2017 Feb 20, 2017
README [Edgent-386] improve readability of README Feb 27, 2017
README.md tweak ant msg based on feedback Nov 17, 2016
RELEASE_NOTES tidy up things Feb 26, 2017
build.gradle ignore WIoTP sample *.cfg files in RAT Feb 26, 2017
build.xml release build fixes Nov 21, 2016
common-build.xml QUARKS-236 Rename iotf to iotp Jul 22, 2016
edgent_overview.html [Edgent-387] update iotp sample javadoc Feb 27, 2017
gradle.properties Update next expected ver to 1.1.0 Dec 16, 2016
gradlew gradle: Add gradle wrapper Jun 8, 2016
gradlew.bat gradle: Add gradle wrapper Jun 8, 2016
settings.gradle [Edgent-268] change licensing in gradle files Nov 11, 2016

README.md

Welcome to Apache Edgent!

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 joins 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

Renamed from Apache Quarks

Apache Edgent is the new name. Things are in a state of transition until all of the pieces arrive.

The "incubator-quarks" repository has been fully updated.

Until the Apache infrastructure changes are done, continue to use the Quarks mailing list, website, and repositories:

Code changes:

  • package names have the prefix "org.apache.edgent"
  • jar names have the prefix "edgent"

Users of Edgent will need to update their references to the above. It's recommended that developers of Edgent create a new workspace instead of reusing their Quarks workspace.

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 Edgent 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