Skip to content

plutov/gosd

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

gosd

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.

Monitored Stats

Setting up authentication

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.

Usage

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"},
	})
}

Stackdriver Metrics

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/*

Memory Consumption

gosd adds around 5Mi to your program memory usage.

Stackdriver Dashboard

dashboard.png

About

Go Runtime stats exporter into Stackdriver

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages