Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

pushback

package

v2.4.0 Latest Latest Go to latest Published: Oct 9, 2026 License: AGPL-3.0 Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/grafana/pyroscope

Links

Open Source Insights

Documentation ¶

Overview ¶

Package pushback carries the gRPC retry pushback signal between a query-backend server and its clients.

The client retries RESOURCE_EXHAUSTED, which the server returns when shedding load. gRPC returns the same code when a response exceeds the send limit, which no retry can fix, so the verdict travels out of band, in the trailer gRPC reserves for it (gRFC A6).

Index ¶

func IsMarked(err error) bool
func IsNoRetry(md metadata.MD) bool
func Mark(err error) error
func SetNoRetry(ctx context.Context)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func IsMarked ¶

func IsMarked(err error) bool

IsMarked reports whether err, or any error it wraps, is marked.

func IsNoRetry ¶

func IsNoRetry(md metadata.MD) bool

IsNoRetry reports whether md carries a pushback value that stops gRPC from retrying: a single negative or unparsable value, or any count but one.

func Mark ¶

func Mark(err error) error

Mark records that retrying err cannot succeed, preserving its gRPC status.

func SetNoRetry ¶

func SetNoRetry(ctx context.Context)

SetNoRetry tells the client that repeating this request cannot succeed. Errors are dropped: a lost signal costs a retry, never a response.

Types ¶

This section is empty.

Source Files ¶

View all Source files

pushback.go