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
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

http

package

Go to main page

Versions in this module

v0

v0.12.1

Dec 22, 2025

v0.12.0

Nov 8, 2025

Changes in this version

+ const ErrorBadData

+ const ErrorCanceled

+ const ErrorExec

+ const ErrorForbidden

+ const ErrorInternal

+ const ErrorNone

+ const ErrorNotAcceptable

+ const ErrorNotFound

+ const ErrorTimeout

+ const ErrorUnauthorized

+ const ErrorUnavailable

+ var ErrInvalidClusterID = errors.New("invalid ceems cluster id")

+ var ErrInvalidQueryField = errors.New("invalid query fields")

+ var ErrInvalidRequest = errors.New("invalid request")

+ var ErrMissingData = errors.New("missing data in the request")

+ var ErrNoAccess = errors.New("user do not have permissions to access this resource")

+ var ErrNoAuth = errors.New("user do not have permissions to view metrics of this job/pod/vm")

+ var ErrNoPrivs = errors.New("current user does not have admin privileges")

+ var ErrNoUser = errors.New("no user identified")

+ var ErrUnavailable = errors.New("tsdb/pyroscope unavailable")

+ func ErrorResponse[T any](w http.ResponseWriter, apiErr *APIError, logger *slog.Logger, data []T)

+ type APIError struct

+ Err error

+ Typ errorType

+ func (e *APIError) Error() string

v0.11.2

Sep 12, 2025

v0.11.1

Sep 6, 2025

v0.11.0

Sep 2, 2025

v0.10.2

Aug 7, 2025

v0.10.1

Jul 22, 2025

v0.10.0

Jul 20, 2025

Changes in this version

+ var ErrMalformedTimeStamp = errors.New("malformed timestamp")

+ var ErrMaxQueryWindow = errors.New("maximum query window exceeded")

+ func AdminUserNames(ctx context.Context, dbConn *sql.DB) ([]string, error)

+ func AdminUsers(ctx context.Context, dbConn *sql.DB) ([]models.User, error)

+ func Compress(level int, types ...string) func(next http.Handler) http.Handler

+ func Querier[T any](ctx context.Context, dbConn *sql.DB, query Query, logger *slog.Logger) ([]T, error)

+ func VerifyOwnership(ctx context.Context, user string, clusterIDs []string, uuids []string, ...) bool

+ type CEEMSServer struct

+ func New(c *Config) (*CEEMSServer, error)

+ func (s *CEEMSServer) Shutdown(ctx context.Context) error

+ func (s *CEEMSServer) Start(_ context.Context) error

+ type Compressor struct

+ func NewCompressor(level int, types ...string) *Compressor

+ func (c *Compressor) Handler(next http.Handler) http.Handler

+ func (c *Compressor) SetEncoder(encoding string, fn EncoderFunc)

+ type Config struct

+ DB db.Config

+ Logger *slog.Logger

+ Web WebConfig

+ type EncoderFunc func(w io.Writer, level int) io.Writer

+ type Query struct

+ type Response struct

+ Data []T

+ Error string

+ ErrorType errorType

+ Status string

+ Warnings []string

+ type WebConfig struct

+ Addresses []string

+ CORSOrigin *regexp.Regexp

+ CompressionLevel int

+ EnableCompression bool

+ EnableDebugServer bool

+ ExternalURL *url.URL

+ HTTPClientConfig config.HTTPClientConfig

+ LandingConfig *web.LandingConfig

+ MaxQueryPeriod model.Duration

+ RequestsLimit int

+ RoutePrefix string

+ URL string

+ UserHeaderNames []string

+ WebConfigFile string

+ WebSystemdSocket bool

+ func (c *WebConfig) UnmarshalYAML(unmarshal func(any) error) error