JarCastingVMware has ended active development of this project, this repository will no longer be updated.
loginsight-java-api
VMware vRealize LogInsight provides a REST API. For more information on REST API, refer to Steve Flanders blog post Log Insight 3.3: Query API
We are providing an easy to use java wrapper to interact with VMware vRealize LogInsight. This loginsight-java-api currently supports
- message queries
- aggregate queries and
- ingesion
Join us @gitter to discuss on any issues on using this API.
Usage
Getting the jar
Functionality of this package is contained in Java package com.vmware.loginsightapi. To use the package, you need to use following Maven dependency:
<dependency>
<groupId>com.vmware.loginsightapi</groupId>
<artifactId>loginsight-java-api</artifactId>
<version>0.1.1</version>
</dependency>
In case of gradle project please use the following
compile group: 'com.vmware.loginsightapi', name: 'loginsight-java-api', version: '0.1.1'
API
####1. Connecting to LogInsight
LogInsightClient client = new LogInsightClient("host-name", "username", "password");
####2. Ingestion of messages to LogInsight
IngestionRequest request = new IngestionRequestBuilder()
.message(new Message("message line 1"))
.message(new MessageBuilder("message line 2")
.field("field1", "content 1").build())
.build();
CompletableFuture<IngestionResponse> responseFuture = client.ingest(request);
####3. Event Queries
MessageQuery mqb = (MessageQuery) new MessageQuery()
.addConstraint("field_1", FieldConstraint.Operator.EQ, "value1")
.addContentPackField("test");
CompletableFuture<MessageQueryResponse> responseFuture = client.messageQuery(mqb.toUrlString());
####4. Aggregation Queries
Default aggregation function is COUNT as defined by LogInsight API.
AggregateQuery aqb = (AggregateQuery) new AggregateQuery()
.addConstraint("field_1", FieldConstraint.Operator.EQ,"value1")
.addContentPackField("test");
CompletableFuture<AggregateQueryResponse> responseFuture = client.aggregateQuery(aqb.toUrlString());
Build from source
Prerequisites
- Java 8 JDK installed and set your JAVA_HOME to home of Java8 JDK
- vRealize LogInsight 3.3 onwards
Build & Run
$ ./gradlew clean build
Contributing
The loginsight-java-api project team welcomes contributions from the community. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ. For more detailed information, refer to CONTRIBUTING.md.
License
Copyright © 2016 VMware, Inc. All Rights Reserved.
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
Some files may be comprised of various open source software components, each of which has its own license that is located in the source code of the respective component.
