gosd is a Go Runtime stats exporter into Stackdriver.
gosd can monitor these stats to better understand the overall health and performance of Go programs.
To run the library, you must first set up authentication by creating a service account and setting an environment variable.
Create service account with write acccess for Monitoring, download the key and set this environment variable:
export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
Note: you may skip this step if you are running your Go application on GCP and it has access to Stackdriver Monitoring API.
import "github.com/plutov/gosd"
func main() {
// This goroutine will send stats on your behalf
go gosd.Run(gosd.Config{
ProjectID: "PROJECT_ID",
Logger: os.Stdout,
Labels: map[string]string{"app": "my-web-app"},
})
}
In Stackdriver go to Resources -> Metrics Explorer and find these metrics:
- custom.googleapis.com/gosd/goroutines
- custom.googleapis.com/gosd/cgocalls
- custom.googleapis.com/gosd/mstats/*
gosd adds around 5Mi to your program memory usage.