
type SystemEventV1 struct {
	Id            string               `json:"id" bson:"_id"`
	Time          time.Time            `json:"time" bson:"time"`
	CorrelationId string               `json:"correlation_id" bson:"correlation_id"`
	Source        string               `json:"source" bson:"source"`
	Type          string               `json:"type" bson:"type"`
	Severity      int                  `json:"severity" bson:"severity"`
	Message       string               `json:"message" bson:"message"`
	Details       cdata.StringValueMap `json:"details" bson:"details"`
}

// EventLogTypeV1
const Restart = "restart"
const Failure = "failure"
const Warning = "warning"
const Transaction = "transaction"
const Other = "other"

// EventLogSeverityV1
const Critical = 0
const Important = 500
const Informational = 1000

interface IEventLogV1 {
    GetEvents(correlationId: string, filter: FilterParams, paging: PagingParams, 
        callback: (err: any, page: DataPage<SystemEventV1>) => void): void;
    
    LogEvent(correlationId: string, event: SystemEventV1, 
        callback?: (err: any, event: SystemEventV1) => void): void;
}

Get

Get the client library source from GitHub:

git clone https://github.com/pip-services-infrastructure2/client-eventlog-go.git

Use

Inside your code get the reference to the client SDK

import (
	eventlog1 "github.com/pip-services-infrastructure2/client-eventlog-go/version1"
)

var client *eventlog1.EventLogHttpClientV1

Define client configuration parameters that match configuration of the microservice external API

// Client configuration
httpConfig := cconf.NewConfigParamsFromTuples(
    "connection.protocol", "http",
    "connection.port", "3000",
    "connection.host", "localhost",
)

client = eventlog1.NewEventLogHttpClientV1()
client.Configure(ctx, httpConfig)

Instantiate the client and open connection to the microservice


// Connect to the microservice
err := client.Open(ctx, "")
 if (err) {
        panic("Connection to the microservice failed");
    }
defer client.Close(ctx, "")
// Work with the microservice

Now the client is ready to perform operations

// Log system event
event1 := &eventlog1.SystemEventV1{
    Type: "restart",
    Source: "server1",
    Message: "Restarted server",
}

err := client.LogEvent(ctx, "", event1);

var now = time.Now();

// Get the list system events
page, err1 := client.getEvents(ctx, 
    "",
    cdata.NewFilterParamsFromTuples(
        "from_time": new Date(now.getTime() - 24 * 3600 * 1000),
        "to_time": now,
        "source": "server1"
    ), cdata.NewEmptyPagingParams(),
);

Develop

For development you shall install the following prerequisites:

Golang 1.18+
Visual Studio Code or another IDE of your choice
Docker

In order to retrieve dependencies from the private repository you shall set the following environment variable:

GOPRIVATE=github.com/pip-services-infrastructure2/*

Install dependencies:

make install

Compile the code:

make build

Run automated tests:

make test

Generate API documentation:

./docgen.ps1

Before committing changes run dockerized build and test as:

./build.ps1
./test.ps1
./clear.ps1

Contacts

This client SDK was created and currently maintained by Sergey Seroukhov and Michael Wright.