Java Zeus Client

Java client for Cisco Zeus. This allows us to send and receive data to and from Zeus.

How to get started

Refer src/examples/ZeusSampleClient.java for a quick introduction. Edit the file to add your assigned Zeus access token and execute the following commands to post/get sample logs & metrics.

git clone https://github.com/CiscoZeus/java-zeusclient.git
mvn compile
mvn -q exec:java -Dexec.mainClass="com.cisco.zeus.ZeusSampleClient"

For more advanced options and examples, refer files in the src/test directory.

Usage

importcom.cisco.zeus.ZeusAPIClient;
ZeusAPIClientzeusClient = newZeusAPIClient("your-access-token");

// For BucketName HeaderzeusClient.bucket("organization-name/bucket-name").Methods()

Metrics

Post Metrics

Metric name has to start with an alphanumerical variable and it can contain hyphen(-), dot(.) and underscore(_).

MetricListmetric = newMetricList("your_metric_name_here");
metric.addColumns("col1", "col2", ...)
.addValues(3, 3, ...)
.addValues(4, 4, ...) // you can send multiple metrics
.build();
Stringresult = zeusClient.sendMetrics(metric);
System.out.println(result);

List All Metrics

For more information about parameters, please refer to Cisco Zeus API Doc

Parametersparams = newParameters();
// params.add("metric_name", "metric_name_regex");Stringresult = zeusClient.retrieveMetricNames(params);
System.out.println(result);

Get Metric Values

For more information about parameters, please refer to Cisco Zeus API Doc

Parametersparams = newParameters();
// params.add("metric_name", "metric_name_regex");Stringresult = zeusClient.retrieveMetricValues(params);
System.out.println(result); 

Delete Metric

Stringresult = zeusClient.deleteMetrics("your_metric_name_here");
System.out.println(result); 

Logs

Post Logs

Log name must contain only alphanumerical characters.

Loglog = newLog()
.setKeyValues("key1","value1")
.setKeyValues("key2","value2");
Loglog1 = newLog()
.setKeyValues("key3","value3")
.setKeyValues("key4","value4");
LogListloglist = newLogList("your_log_name_here")
.addLog(log)
.addLog(log1);
Stringresult = zeusClient.sendLogs(loglist);
System.out.println(result); 

Get Logs

For more information about parameters, please refer to Cisco Zeus API Doc

Parametersparams = newParameters();
// params.add("log_name", "regular expression to filtering result");Stringresult = zeusClient.retrieveLogs(params);
System.out.println(result);

Contributing

1. Fork it ( https://github.com/CiscoZeus/java-zeusclient/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request