= Hawkular Data Mining
ifdef::env-github[] [link=https://travis-ci.org/hawkular/hawkular-datamining] image:https://travis-ci.org/hawkular/hawkular-datamining.svg?branch=master["Build Status", link="https://travis-ci.org/hawkular/hawkular-datamining"]{nbsp} image:https://badges.gitter.im/Join%20Chat.svg[link="https://gitter.im/hawkular/hawkular-datamining?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"] endif::[]
== About Data Mining is time series prediction engine for Hawkular. It autonomously selects best model for time series being modelled. Produced prediction can be used for alert prediction or in predictive charts in UI.
Module is split into several artifacts:
hawkular-datamining-forecast
- lightweight time series forecasting libraryhawkular-datamining-rest
- standalone web application with link:http://www.hawkular.org/docs/rest/rest-datamining.html[REST API]hawkular-datamining-dist
- web application dedicated for deployment into Hawkular== Build & Run
To run standalone instance of Data Mining:
$ mvn install -Pdev
$ hawkular-datamining-rest/target/wildfly-*/bin/standalone.sh
To run Hawkular with Data Mining, clone and build link:https://github.com/hawkular/hawkular/tree/datamining[Hawkular]
branch datamining
and run the server. Predictive charts are located in Explorer tab.
$ git clone -b datamining git@github.com:hawkular/hawkular.git $ cd hawkular $ mvn install -Pdev
$ dist/target/hawkular-*/bin/standalone.sh
== Time Series Forecasting Library hawkular-datamining-forecast
All models uses non-linear optimization algorithm to estimate best parameters of the model. Models and
Forecasters are designed for online learning.
== Enable prediction in Hawkular In Hawkular prediction can be enabled directly in UI by increasing forecasting horizon or through REST call by creating Relationship from Tenant to Metric, MetricType or Tenant.
Source and target are canonical paths.
.Source
.Target
== Documentation
mvn install -Pdocgen
, it is located in hawkular-datamining-rest/target/generated/rest-datamining.adoc
== License
Hawkular-datamining is released under Apache License, Version 2.0 as described in the link:LICENSE[LICENSE] document
Copyright 2015 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
During build if you are getting Some files do not have the expected license header
just run mvn license:format
.