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

remotewrite

package module

Go to main page

Versions in this module

v0

v0.1.3

Aug 18, 2026

Changes in this version

+ var ErrDurableClientClosed = errors.New("durable client is closed") — darwin/amd64, linux/amd64

+ var ErrDurableQueueBlocked = errors.New("durable queue is blocked") — darwin/amd64, linux/amd64

+ var ErrDurableRecordCorrupt = errors.New("durable record is corrupt") — darwin/amd64, linux/amd64

+ var ErrDurableRunStarted = errors.New("durable client run loop has already started") — darwin/amd64, linux/amd64

+ var ErrDurableSpoolLocked = errors.New("durable spool is already locked") — darwin/amd64, linux/amd64

+ func IsBodyTooLarge(err error) bool

+ type Client struct

+ func New(cfg Config) (*Client, error)

+ func (c *Client) Close() error

+ func (c *Client) Forward(ctx context.Context, req ForwardRequest) (*http.Response, error)

+ func (c *Client) Push(ctx context.Context, pr PushRequest) error

+ func (c *Client) PushTimeSeries(ctx context.Context, pr PushTimeSeriesRequest) error

+ func (c *Client) RetriesEnabled() bool

+ type Config struct

+ BearerToken string

+ DefaultContentEncoding string

+ DefaultContentType string

+ DefaultRemoteWriteVersion string

+ MaxConnsPerHost int

+ MaxIdleConnsPerHost int

+ RateLimitBytesPerSec int64

+ Retry *RetryConfig

+ TenantHeader string

+ Timeout time.Duration

+ Transport *http.Transport

+ UpstreamURL string

+ UserAgent string

+ type DurableClient struct — darwin/amd64, linux/amd64

+ func NewDurable(cfg DurableConfig) (*DurableClient, error)

+ func (dc *DurableClient) Close() error

+ func (dc *DurableClient) Enqueue(ctx context.Context, req DurableRequest) error

+ func (dc *DurableClient) Push(ctx context.Context, req PushRequest) error

+ func (dc *DurableClient) PushTimeSeries(ctx context.Context, req PushTimeSeriesRequest) error

+ func (dc *DurableClient) Run(ctx context.Context) error

+ type DurableConfig struct — darwin/amd64, linux/amd64

+ Client Config

+ DisablePersistence bool

+ Logger *slog.Logger

+ MaxInMemoryBlocks int

+ MaxPendingBytes int64

+ QueueDir string

+ QueueName string

+ Registerer prometheus.Registerer

+ SendConcurrency int

+ type DurableRequest struct

+ BodyBytes []byte

+ ContentEncoding string

+ ContentType string

+ ExtraHeaders http.Header

+ RemoteWriteVersion string

+ TenantID string

+ type ForwardRequest struct

+ Body io.ReadCloser

+ BodyBytes []byte

+ ContentEncoding string

+ ContentLength int64

+ ContentType string

+ ExtraHeaders http.Header

+ GetBody func() (io.ReadCloser, error)

+ RemoteWriteVersion string

+ TenantID string

+ type PushRequest struct

+ ExternalLabels map[string]string

+ ExtraHeaders http.Header

+ Gatherer prometheus.Gatherer

+ MaxBatchBytes int

+ MaxSeriesPerBatch int

+ Now func() time.Time

+ TenantID string

+ WriteRelabelConfigs []relabel.Config

+ type PushTimeSeriesRequest struct

+ ExtraHeaders http.Header

+ MaxBatchBytes int

+ MaxSeriesPerBatch int

+ TenantID string

+ TimeSeries []prompb.TimeSeries

+ type RateLimiter struct

+ func NewRateLimiter(perSecondLimit int64, stopCh <-chan struct{}) *RateLimiter

+ func (rl *RateLimiter) Enabled() bool

+ func (rl *RateLimiter) Register(ctx context.Context, n int64) error

+ type RetryConfig struct

+ MaxBodySize int64

+ MaxRetries int

+ MaxWait time.Duration

+ MinWait time.Duration

v0.1.2

Apr 19, 2026

v0.1.1

Jan 10, 2026

v0.1.0

Jan 7, 2026