Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dougefresh/logzio-go
Low level go client for Logz
https://github.com/dougefresh/logzio-go
go golang golang-library golang-package golang-tools logzio
Last synced: about 1 month ago
JSON representation
Low level go client for Logz
- Host: GitHub
- URL: https://github.com/dougefresh/logzio-go
- Owner: dougEfresh
- License: apache-2.0
- Created: 2017-04-24T18:42:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-04T09:14:54.000Z (10 months ago)
- Last Synced: 2024-06-20T11:16:44.784Z (7 months ago)
- Topics: go, golang, golang-library, golang-package, golang-tools, logzio
- Language: Go
- Homepage: https://logz.io/
- Size: 76.2 KB
- Stars: 8
- Watchers: 3
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Logzio Golang API client
Sends logs to [logz.io](https://logz.io) over HTTP
[![GoDoc][doc-img]][doc] [![Build Status][ci-img]][ci] [![Coverage Status][cov-img]][cov] [![Go Report][report-img]][report]
## Installation
```shell
$ go get -u github.com/dougEfresh/logzio-go
```
## Quick Start
```go
package main
import (
"fmt"
"github.com/dougEfresh/logzio-go"
"os"
"time"
)
func main() {
l, err := logzio.New(os.Args[1]) // Token is required
if err != nil {
panic(err)
}
msg := fmt.Sprintf("{ \"%s\": \"%s\"}", "message", time.Now().UnixNano())
err = l.Send([]byte(msg))
if err != nil {
panic(err)
}
l.Stop() //logs are buffered on disk. Stop will drain the buffer
}
```
logzio sender is a low level lib meant to be integrated with other logging libs
## Usage
Setting drain duration (flush logs on disk) : `logzio.New(token, SetDrainDuration(time.Hour))`
Setting url mode: `logzio.New(token, SetUrl(ts.URL))`
Setting debug mode: `logzio.New(token, SetDebug(os.Stderr))`
Setting queue dir: `logzio.New(token, SetSetTempDirectory(os.Stderr))`
## Disk queue
Logzio go client uses [goleveldb](https://github.com/syndtr/goleveldb) and [goqueue](github.com/beeker1121/goque) as a persistent storage.
Every 5 seconds logs are sent to logz.io (if any are available)
## Examples
Uber Zap: [zapz](https://github.com/dougefresh/zapz)
GO kit: [kitz](https://github.com/dougefresh/kitz)
## Prerequisites
go 1.x
## Tests
```shell
$ go test -v
```
See [travis.yaml](.travis.yml) for running benchmark tests
## Deployment
## Contributing
All PRs are welcome
## Authors
* **Douglas Chimento** - [dougEfresh][me]
* **Ido Halevi** - [idohalevi](https://github.com/idohalevi)
## License
This project is licensed under the Apache License - see the [LICENSE](LICENSE) file for details
## Acknowledgments
* [logzio-java-sender](https://github.com/logzio/logzio-java-sender)
### TODO
[doc-img]: https://godoc.org/github.com/dougEfresh/logzio-go?status.svg
[doc]: https://godoc.org/github.com/dougEfresh/logzio-go
[ci-img]: https://travis-ci.org/dougEfresh/logzio-go.svg?branch=master
[ci]: https://travis-ci.org/dougEfresh/logzio-go
[cov-img]: https://codecov.io/gh/dougEfresh/logzio-go/branch/master/graph/badge.svg
[cov]: https://codecov.io/gh/dougEfresh/logzio-go
[glide.lock]: https://github.com/uber-go/zap/blob/master/glide.lock
[zap]: https://github.com/uber-go/zap
[me]: https://github.com/dougEfresh
[report-img]: https://goreportcard.com/badge/github.com/dougEfresh/logzio-go
[report]: https://goreportcard.com/report/github.com/dougEfresh/logzio-go