attribution

Documentation

Overview

Package attribution implements value attribution from docs/design/value-attribution.md

Index

• Variables
• type BucketUsage
• type DB
• type Info

Variables

var ErrBucketNotAttributed = errs.Class("bucket not attributed")

ErrBucketNotAttributed is returned if a requested bucket not attributed(entry not found).

Types

type BucketUsage

type BucketUsage struct {
	UserAgent    []byte
	ProjectID    []byte
	BucketName   []byte
	ByteHours    float64
	SegmentHours float64
	ObjectHours  float64
	EgressData   int64
	Hours        int
}

BucketUsage is the usage data for a single bucket.

type DB

type DB interface {
	// Get retrieves attribution info using project id and bucket name.
	Get(ctx context.Context, projectID uuid.UUID, bucketName []byte) (*Info, error)
	// Insert creates and stores new Info.
	Insert(ctx context.Context, info *Info) (*Info, error)
	// UpdateUserAgent updates bucket attribution data.
	UpdateUserAgent(ctx context.Context, projectID uuid.UUID, bucketName string, userAgent []byte) error
	// QueryAttribution queries partner bucket attribution data.
	QueryAttribution(ctx context.Context, userAgent []byte, start time.Time, end time.Time) ([]*BucketUsage, error)
	// QueryAllAttribution queries all partner bucket usage data.
	QueryAllAttribution(ctx context.Context, start time.Time, end time.Time) ([]*BucketUsage, error)
}

DB implements the database for value attribution table.

architecture: Database

type Info

type Info struct {
	ProjectID  uuid.UUID
	BucketName []byte
	UserAgent  []byte
	CreatedAt  time.Time
}

Info describing value attribution from partner to bucket.