bytecounter

Documentation

Overview

Package bytecounter contains code to track the number of bytes sent and received by a probe.

Index

• func MaybeWrapConn(conn net.Conn, counter *Counter) net.Conn
• func MaybeWrapHTTPTransport(txp model.HTTPTransport, counter *Counter) model.HTTPTransport
• func MaybeWrapSystemResolver(reso model.Resolver, counter *Counter) model.Resolver
• func MaybeWrapWithContextAwareDialer(enabled bool, dialer model.Dialer) model.Dialer
• func MaybeWrapWithContextByteCounters(ctx context.Context, conn net.Conn) net.Conn
• func WithExperimentByteCounter(ctx context.Context, counter *Counter) context.Context
• func WithSessionByteCounter(ctx context.Context, counter *Counter) context.Context
• func WrapConn(conn net.Conn, counter *Counter) net.Conn
• func WrapHTTPTransport(txp model.HTTPTransport, counter *Counter) model.HTTPTransport
• func WrapSystemResolver(reso model.Resolver, counter *Counter) model.Resolver
• func WrapWithContextAwareDialer(dialer model.Dialer) *contextAwareDialer
• type Counter
  • func ContextExperimentByteCounter(ctx context.Context) *Counter
  • func ContextSessionByteCounter(ctx context.Context) *Counter
  • func New() *Counter
  • func (c *Counter) BytesReceived() int64
  • func (c *Counter) BytesSent() int64
  • func (c *Counter) CountBytesReceived(count int)
  • func (c *Counter) CountBytesSent(count int)
  • func (c *Counter) CountKibiBytesReceived(count float64)
  • func (c *Counter) CountKibiBytesSent(count float64)
  • func (c *Counter) KibiBytesReceived() float64
  • func (c *Counter) KibiBytesSent() float64

Functions

func MaybeWrapConn

func MaybeWrapConn(conn net.Conn, counter *Counter) net.Conn

MaybeWrapConn is like wrap if counter is not nil, otherwise it's a no-op.

func MaybeWrapHTTPTransport

func MaybeWrapHTTPTransport(txp model.HTTPTransport, counter *Counter) model.HTTPTransport

MaybeWrapHTTPTransport takes in input an HTTPTransport and either wraps it to perform byte counting, if this counter is not nil, or just returns to the caller the original transport, when the counter is nil.

func MaybeWrapSystemResolver

func MaybeWrapSystemResolver(reso model.Resolver, counter *Counter) model.Resolver

MaybeWrapSystemResolver takes in input a Resolver and either wraps it to perform byte counting, if this counter is not nil, or just returns to the caller the original resolver, when the counter is nil.

Bug

The returned resolver will only approximately estimate the bytes sent and received by this resolver if this resolver is the system resolver. For more accurate counting when using DNS over HTTPS, you should instead count at the HTTP transport level. If you are using DNS over TCP, DNS over TLS, or DNS over UDP, you should instead count the bytes by just wrapping the connections you're using.

func MaybeWrapWithContextAwareDialer

func MaybeWrapWithContextAwareDialer(enabled bool, dialer model.Dialer) model.Dialer

MaybeWrapWithContextAwareDialer wraps the given dialer with a ContextAwareDialer if the enabled argument is true and otherwise just returns the given dialer.

Bug

This implementation cannot properly account for the bytes that are sent by persistent connections, because they stick to the counters set when the connection was established. This typically means we miss the bytes sent and received when submitting a measurement. Such bytes are specifically not seen by the experiment specific byte counter.

For this reason, this implementation may be heavily changed/removed in the future (<- this message is now ~two years old, though).

func MaybeWrapWithContextByteCounters

func MaybeWrapWithContextByteCounters(ctx context.Context, conn net.Conn) net.Conn

MaybeWrapWithContextByteCounters wraps a conn with the byte counters that have previosuly been configured into a context.

func WithExperimentByteCounter

func WithExperimentByteCounter(ctx context.Context, counter *Counter) context.Context

WithExperimentByteCounter assigns the experiment byte counter to the context.

func WithSessionByteCounter

func WithSessionByteCounter(ctx context.Context, counter *Counter) context.Context

WithSessionByteCounter assigns the session byte counter to the context.

func WrapConn

func WrapConn(conn net.Conn, counter *Counter) net.Conn

WrapConn returns a new conn that uses the given counter.

func WrapHTTPTransport

func WrapHTTPTransport(txp model.HTTPTransport, counter *Counter) model.HTTPTransport

WrapHTTPTransport creates a new byte-counting-aware HTTP transport.

func WrapSystemResolver

func WrapSystemResolver(reso model.Resolver, counter *Counter) model.Resolver

WrapSystemResolver creates a new byte-counting-aware resolver. This function returns a resolver with the same bugs of MaybeWrapSystemResolver.

func WrapWithContextAwareDialer

func WrapWithContextAwareDialer(dialer model.Dialer) *contextAwareDialer

WrapWithContextAwareDialer creates a new ContextAwareDialer. See the docs of MaybeWrapWithContextAwareDialer for a list of caveats.

Types

type Counter

type Counter struct {
	// Received contains the bytes received. You MUST initialize
	// this field, or you can just use the New factory.
	Received *atomic.Int64

	// Sent contains the bytes sent. You MUST initialize
	// this field, or you can just use the New factory.
	Sent *atomic.Int64
}

Counter counts bytes sent and received.

func ContextExperimentByteCounter

func ContextExperimentByteCounter(ctx context.Context) *Counter

ContextExperimentByteCounter retrieves the experiment byte counter from the context

func ContextSessionByteCounter

func ContextSessionByteCounter(ctx context.Context) *Counter

ContextSessionByteCounter retrieves the session byte counter from the context

func New

func New() *Counter

New creates a new Counter.

func (*Counter) BytesReceived

func (c *Counter) BytesReceived() int64

BytesReceived returns the bytes received so far.

func (*Counter) BytesSent

func (c *Counter) BytesSent() int64

BytesSent returns the bytes sent so far.

func (*Counter) CountBytesReceived

func (c *Counter) CountBytesReceived(count int)

CountBytesReceived adds count to the bytes received counter.

func (*Counter) CountBytesSent

func (c *Counter) CountBytesSent(count int)

CountBytesSent adds count to the bytes sent counter.

func (*Counter) CountKibiBytesReceived

func (c *Counter) CountKibiBytesReceived(count float64)

CountKibiBytesReceived adds 1024*count to the bytes received counter.

func (*Counter) CountKibiBytesSent

func (c *Counter) CountKibiBytesSent(count float64)

CountKibiBytesSent adds 1024*count to the bytes sent counter.

func (*Counter) KibiBytesReceived

func (c *Counter) KibiBytesReceived() float64

KibiBytesReceived returns the KiB received so far.

func (*Counter) KibiBytesSent

func (c *Counter) KibiBytesSent() float64

KibiBytesSent returns the KiB sent so far.