isabella232 / tracing-workshop-go

Honeycomb Tracing Workshop Materials

This repository is intended to accompany Honeycomb's Always Bee Tracing workshop.

It requires Go 1.9+ and has intentionally included the vendor directory in hopes of simplifying dependencies. It should require no additional setup or installation beyond cloning this into your $GOPATH.

If you'd like to manage / install dependencies yourself, you may want to use dep.

If you are new to go...

If you have never run go before, here is the short path to setting up go on Mac OSX. Skip this section if you have a go environment set up already.

brew install go
mkdir -p $HOME/go/{src,bin,pkg}
export GOPATH=$HOME/go
cd $GOPATH
go get github.com/honeycombio/tracing-workshop-go/...
cd src/github.com/honeycombio/tracing-workshop-go

Running the main application

Run our sample wall service with:

# Will run on port 8080
cd wall
go run ./wall.go

Interacting with your application

You may either use the web UI to read and write messages:

View contents of wall	Write new message on wall

Or curl the contents of your wall directly:

# Fetch the contents of your wall
curl localhost:8080

# Write a new message to your wall
curl localhost:8080 -d "message=i'm #tracing with @honeycombio"

Running the analysis service

Over the course of the workshop, you will run a second service, analysis, with:

# Will run on port 8088
cd analysis
go run ./analysis.go

But you won't be interacting with it directly; the wall service will simply ping localhost:8088 in hopes of the analysis service being alive.

Security fine print

Any API keys included in this repository are included for ease of use during the workshop and will be rendered null and void after the event on January 24th, 2019.