mirror of
https://github.com/prometheus/prometheus.git
synced 2024-12-26 22:19:40 -08:00
b5c833ca21
* Update go.mod dependencies before release Signed-off-by: Julius Volz <julius.volz@gmail.com> * Add issue for showing query warnings in promtool Signed-off-by: Julius Volz <julius.volz@gmail.com> * Revert json-iterator back to 1.1.6 It produced errors when marshaling Point values with special float values. Signed-off-by: Julius Volz <julius.volz@gmail.com> * Fix expected step values in promtool tests after client_golang update Signed-off-by: Julius Volz <julius.volz@gmail.com> * Update generated protobuf code after proto dep updates Signed-off-by: Julius Volz <julius.volz@gmail.com>
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
[![GoDoc](https://godoc.org/github.com/go-stack/stack?status.svg)](https://godoc.org/github.com/go-stack/stack)
|
|
[![Go Report Card](https://goreportcard.com/badge/go-stack/stack)](https://goreportcard.com/report/go-stack/stack)
|
|
[![TravisCI](https://travis-ci.org/go-stack/stack.svg?branch=master)](https://travis-ci.org/go-stack/stack)
|
|
[![Coverage Status](https://coveralls.io/repos/github/go-stack/stack/badge.svg?branch=master)](https://coveralls.io/github/go-stack/stack?branch=master)
|
|
|
|
# stack
|
|
|
|
Package stack implements utilities to capture, manipulate, and format call
|
|
stacks. It provides a simpler API than package runtime.
|
|
|
|
The implementation takes care of the minutia and special cases of interpreting
|
|
the program counter (pc) values returned by runtime.Callers.
|
|
|
|
## Versioning
|
|
|
|
Package stack publishes releases via [semver](http://semver.org/) compatible Git
|
|
tags prefixed with a single 'v'. The master branch always contains the latest
|
|
release. The develop branch contains unreleased commits.
|
|
|
|
## Formatting
|
|
|
|
Package stack's types implement fmt.Formatter, which provides a simple and
|
|
flexible way to declaratively configure formatting when used with logging or
|
|
error tracking packages.
|
|
|
|
```go
|
|
func DoTheThing() {
|
|
c := stack.Caller(0)
|
|
log.Print(c) // "source.go:10"
|
|
log.Printf("%+v", c) // "pkg/path/source.go:10"
|
|
log.Printf("%n", c) // "DoTheThing"
|
|
|
|
s := stack.Trace().TrimRuntime()
|
|
log.Print(s) // "[source.go:15 caller.go:42 main.go:14]"
|
|
}
|
|
```
|
|
|
|
See the docs for all of the supported formatting options.
|