Light

fuyufjh / splunk-hec-go Goto Github PK

View Code? Open in Web Editor NEW

17.0 3.0 14.0 40 KB

Splunk HTTP Event Collector (HEC) Golang library

Home Page: http://dev.splunk.com/view/event-collector/SP-CAAAE6M

License: Apache License 2.0

Go 100.00%

splunk golang-library

splunk-hec-go's Introduction

Splunk HEC Golang Library

Golang library for Splunk HTTP Event Collector (HEC).

Build

You need install glide before build.

Install all dependencies

glide install

Build the example

go build -o build/example ./example/main.go

Features

Support HEC JSON mode and Raw mode
Send batch of events
Customize retrying times
Cut big batch into chunk less than MaxContentLength
Indexer acknowledgement
Streaming data via HEC Raw

Example

client := hec.NewCluster(
	[]string{"https://127.0.0.1:8088", "https://localhost:8088"},
	"00000000-0000-0000-0000-000000000000",
)
client.SetHTTPClient(&http.Client{Transport: &http.Transport{
	TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
}})

event1 := hec.NewEvent("event one")
event1.SetTime(time.Now())
event2 := hec.NewEvent("event two")
event2.SetTime(time.Now().Add(-time.Minute))

err := client.WriteBatch([]*hec.Event{event1, event2})
if err != nil {
	log.Fatal(err)
}

See hec.go for more usages.

splunk-hec-go's People

Contributors

Stargazers

Watchers

Forkers

antifuchs danielris aristanetworks nishanth-pinnapareddy gnarlyman francop-eb spectrumjade sookoor nstonesplunk gtrevg jhop310 billyevans minnanalee

splunk-hec-go's Issues

Cut input into batches less than MaxContentLength

Ensure request size less than max_content_length

# $SPLUNK_HOME/etc/system/default/limits.conf

[http_input]
# The max request content length.
max_content_length = 1000000

Support Indexer acknowledgement

See http://dev.splunk.com/view/event-collector/SP-CAAAE8X for details.

Retrying Policy

Support retrying if http request failed (e.g. Got Server is busy)
Support customize retrying policy

Replace package satori/go.uuid

This issue has been opened automaticaly because we think you are using satori/uuid in your code. Unfortunately, satori/uuid has a critical defect where it doesn't generate random UUIDV4s satori/go.uuid#73 and should be replaced as the maintainer has been unresponsive for 5 months with the bug still open. Alternative packages you should consider: https://github.com/google/uuid https://github.com/pborman/uuid

Streaming via HEC Raw

HEC Raw mode receives raw bytes and do event breaking & timestamp extraction. It's possible to wrapper it into a stream reader, similar to Splunk Modular Input.

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.