https://github.com/segmentio/analytics-go
Segment analytics client for Go
https://github.com/segmentio/analytics-go
Last synced: 11 months ago
JSON representation
Segment analytics client for Go
- Host: GitHub
- URL: https://github.com/segmentio/analytics-go
- Owner: segmentio
- License: mit
- Created: 2014-04-24T01:15:51.000Z (about 12 years ago)
- Default Branch: v3.0
- Last Pushed: 2024-10-30T20:18:19.000Z (over 1 year ago)
- Last Synced: 2025-08-06T18:47:30.606Z (11 months ago)
- Language: Go
- Homepage: https://segment.com/docs/libraries/go/
- Size: 227 KB
- Stars: 145
- Watchers: 42
- Forks: 93
- Open Issues: 23
-
Metadata Files:
- Readme: Readme.md
- Changelog: History.md
- License: License.md
Awesome Lists containing this project
README
# analytics-go [](https://circleci.com/gh/segmentio/analytics-go/tree/v3.0) [](https://godoc.org/github.com/segmentio/analytics-go)
Segment analytics client for Go.
### ⚠️ Maintenance ⚠️
This library is in maintenance mode. It will send data as intended, but receive no new feature support and only critical maintenance updates from Segment.
## Installation
The package can be simply installed via go get, we recommend that you use a
package version management system like the Go vendor directory or a tool like
Godep to avoid issues related to API breaking changes introduced between major
versions of the library.
To install it in the GOPATH:
```
go get https://github.com/segmentio/analytics-go
```
## Documentation
The links bellow should provide all the documentation needed to make the best
use of the library and the Segment API:
- [Documentation](https://segment.com/docs/libraries/go/)
- [godoc](https://godoc.org/gopkg.in/segmentio/analytics-go.v3)
- [API](https://segment.com/docs/libraries/http/)
- [Specs](https://segment.com/docs/spec/)
## Usage
```go
package main
import (
"os"
"github.com/segmentio/analytics-go"
)
func main() {
// Instantiates a client to use send messages to the segment API.
client := analytics.New(os.Getenv("SEGMENT_WRITE_KEY"))
// Enqueues a track event that will be sent asynchronously.
client.Enqueue(analytics.Track{
UserId: "test-user",
Event: "test-snippet",
})
// Flushes any queued messages and closes the client.
client.Close()
}
```
## License
The library is released under the [MIT license](License.md).