Fyipe Application Logger
A fyipe application logger that can be used to send logs about your applications created on your fypie dashboard
Installation
Maven Install
You can install to use in your project by adding the following to your pom.xml file:
<dependency>
<groupId>io.hackerbay.fyipe</groupId>
<artifactId>java-sdk</artifactId>
<version>CURRENT_VERSION</version>
</dependency>
Others
Check Maven Central Repository for other modes of installation.
Basic Usage
import com.google.gson.JsonObject;
import io.hackerbay.fyipe.FyipeLogger;
public class SampleClass {
// constructor
FyipeLogger logger = new FyipeLogger(
"API_URL", // https://fyipe.com/api
"APPLICATION_LOG_ID",
"APPLICATION_LOG_KEY"
);
// Logging a string information
public void logStringInformation() {
String content = "Content to be logged";
JsonObject response = logger.log(content); // returns a JsonObject of response
System.out.println(response);
}
// Logging any object of a class
public void logACustomClassInformation(CustomClass customClass) {
String content = new Gson().toJson(customClass); // converts your custom class to a json object
JsonObject response = logger.log(content); // returns a JsonObject of response
System.out.println(response);
}
// Logging a string with a series of tags
public void logStringInformation() {
String content = "Content to be logged";
String [] tags = { "server", "monitoring", "logs" };
JsonObject response = logger.log(content, tags); // returns a JsonObject of response
System.out.println(response);
}
}
API Documentation
Main API to send logs to the server.
Author: HackerBay, Inc.
new FyipeLogger(apiUrl, applicationId, applicationKey)
Create a constructor from the class, which will be used to send logs to the server.
Kind: Constructor Returns: null
| Param | Type | Description |
|---|---|---|
| apiUrl | String |
The Server URL. |
| applicationId | String |
The Application Log ID. |
| applicationKey | String |
The Application Log Key. |
logger.log(log, tags)
Logs a request of type info to the server.
Kind: method of new FyipeLogger Returns: JsonObject - A response of a success or failure.
| Param | Type | Description |
|---|---|---|
| log | String |
The content to the logged on the server. |
| tags | String[] |
The tag(s) to be attached to the logged item on the server. |
logger.warning(warning, tags)
Logs a request of type warning to the server.
Kind: method of new FyipeLogger Returns: JsonObject - A response of a success or failure.
| Param | Type | Description |
|---|---|---|
| warning | String |
The content to the logged on the server. |
| tags | String[] |
The tag(s) to be attached to the logged item on the server. |
logger.error(error, tags)
Logs a request of type error to the server.
Kind: method of new FyipeLogger Returns: JsonObject - A response of a success or failure.
| Param | Type | Description |
|---|---|---|
| error | String |
The content to the logged on the server. |
| tags | String[] |
The tag(s) to be attached to the logged item on the server. |
Contribution
- Clone repository
- run
mvn clean installto install dependencies - run
mvn testto run tests - run
mvn packageto build for production.