posthog

Oct 2, 2026

Changes in this version

type Capture

+ Library string

type Exception

+ Library string

Sep 22, 2026

Changes in this version

type Config

+ FlagDefinitionCacheProvider FlagDefinitionCacheProvider

+ type FlagDefinitionCacheProvider interface

+ GetFlagDefinitions func(ctx context.Context) (json.RawMessage, error)

+ OnFlagDefinitionsReceived func(ctx context.Context, data json.RawMessage) error

+ ShouldFetchFlagDefinitions func(ctx context.Context) (bool, error)

+ Shutdown func(ctx context.Context) error

Sep 22, 2026

Changes in this version

type Client

+ Flush func() error

+ FlushWithContext func(context.Context) error

Jul 23, 2026

Changes in this version

+ type DebugImage struct

+ Arch string

+ CodeFile string

+ CodeID string

+ DebugID string

+ ImageAddr string

+ ImageSize uint64

+ ImageVmaddr string

+ Type string

+ type DebugImageProvider interface

+ GetDebugImages func() []DebugImage

type DefaultStackTraceExtractor

+ func (d DefaultStackTraceExtractor) GetDebugImages() []DebugImage

type Exception

+ DebugImages []DebugImage

type ExceptionInApiProperties

+ DebugImages []DebugImage

type StackFrame

+ ClientResolved bool

+ ImageAddr string

+ Inline bool

+ InstructionAddr string

+ Lang string

+ SymbolAddr string

Jul 20, 2026

Changes in this version

type CommonResponseFields

+ MinimalFlagCalledEvents bool

type FeatureFlagsResponse

+ MinimalFlagCalledEvents bool

Jul 15, 2026

Changes in this version

type FeatureFlag

+ HasExperiment *bool

type FlagMetadata

+ HasExperiment *bool

Jul 15, 2026

Changes in this version

+ const DefaultMaxQueueSize

+ var ErrNoSecretKey = errors.New("no SecretKey provided")

+ var ErrQueueFull = errors.New("the message queue is full, the message was dropped")

type Config

+ MaxQueueSize int

+ SecretKey string

Jul 5, 2026

Changes in this version

+ const DefaultMaxAttempts

Jun 29, 2026

Changes in this version

type Config

+ FeatureFlagRequestMaxRetries *int

Jun 29, 2026

Changes in this version

+ type CaptureEventError struct

+ Details string

+ EventUUID string

+ Exhausted bool

+ Result string

+ func (e *CaptureEventError) Error() string

+ type CaptureMode uint8

+ const CaptureModeAnalyticsV1

+ const CaptureModeLegacy

+ type CaptureRequestError struct

+ Code string

+ Description string

+ Err error

+ StatusCode int

+ func (e *CaptureRequestError) Error() string

+ func (e *CaptureRequestError) Unwrap() error

type CompressionMode

+ const CompressionBrotli

+ const CompressionDeflate

+ const CompressionZstd

+ func (m CompressionMode) String() string

type Config

+ CaptureMode CaptureMode

Jun 19, 2026

Changes in this version

+ type BeforeSendFunc func(Message) Message

type Config

+ BeforeSend BeforeSendFunc

Jun 8, 2026

Changes in this version

type Filter

+ EarlyExit bool

Jun 3, 2026

Changes in this version

type Alias

+ IsServer bool

type AliasInApiProperties

+ IsServer *bool

type Capture

+ IsServer bool

type Config

+ IsServer *bool

+ func (c Config) GetIsServer() bool

type Exception

+ IsServer bool

type ExceptionInApiProperties

+ IsServer *bool

type GroupIdentify

+ IsServer bool

type Identify

+ IsServer bool

May 28, 2026

Changes in this version

type Client

+ Close func() error

May 26, 2026

Changes in this version

+ const HeaderPostHogDistinctID

+ const HeaderPostHogSessionID

+ func EnqueueWithContext(ctx context.Context, client EnqueueClient, msg Message) error

+ func NewRequestContextMiddleware(next http.Handler, opts ...RequestContextOption) http.Handler

+ func WithFreshRequestContext(ctx context.Context, requestContext RequestContext) context.Context

+ func WithRequestContext(ctx context.Context, requestContext RequestContext) context.Context

type FeatureFlagEvaluations

+ func EvaluateFlagsWithContext(ctx context.Context, client Client, payload EvaluateFlagsPayload) (*FeatureFlagEvaluations, error)

+ type RequestContext struct

+ DistinctId string

+ Properties Properties

+ SessionId string

+ func ExtractRequestContext(r *http.Request, captureTracingHeaders bool) RequestContext

+ func RequestContextFromContext(ctx context.Context) (RequestContext, bool)

+ type RequestContextOption func(*RequestContextOptions)

+ func WithCapturePanics(client EnqueueClient) RequestContextOption

+ func WithCaptureTracingHeaders(enabled bool) RequestContextOption

+ type RequestContextOptions struct

+ CapturePanics bool

+ CaptureTracingHeaders bool

+ PanicCaptureClient EnqueueClient

May 8, 2026

Changes in this version

+ var ErrNoDistinctID = errors.New("no distinct_id provided")

+ var ErrSDKDisabled = errors.New("posthog SDK is disabled because project API key is missing")

type Capture

+ Flags *FeatureFlagEvaluations

type Client

+ EvaluateFlags func(EvaluateFlagsPayload) (*FeatureFlagEvaluations, error)

+ type EvaluateFlagsPayload struct

+ DeviceId *string

+ DisableGeoIP *bool

+ DistinctId string

+ FlagKeys []string

+ GroupProperties map[string]Properties

+ Groups Groups

+ OnlyEvaluateLocally bool

+ PersonProperties Properties

type FeatureFlagCondition

+ AggregationGroupTypeIndex *uint8

+ type FeatureFlagEvaluations struct

+ func (e *FeatureFlagEvaluations) GetFlag(key string) interface{}

+ func (e *FeatureFlagEvaluations) GetFlagPayload(key string) string

+ func (e *FeatureFlagEvaluations) IsEnabled(key string) bool

+ func (e *FeatureFlagEvaluations) Keys() []string

+ func (e *FeatureFlagEvaluations) Only(keys []string) *FeatureFlagEvaluations

+ func (e *FeatureFlagEvaluations) OnlyAccessed() *FeatureFlagEvaluations

type FlagsRequestData

+ FlagKeysToEvaluate []string

Apr 20, 2026

Changes in this version

type Exception

+ Properties Properties

type ExceptionInApiProperties

+ Custom Properties

+ func (p ExceptionInApiProperties) MarshalJSON() ([]byte, error)

type Properties

+ func SlogAttrsAsProperties(_ context.Context, r slog.Record) Properties

type SlogOption

+ func WithPropertiesFn(fn func(ctx context.Context, r slog.Record) Properties) SlogOption

Mar 26, 2026

Changes in this version

type AliasInApiProperties

+ func (ctx AliasInApiProperties) ToProperties() Properties

type ExceptionInApiProperties

+ func (ctx ExceptionInApiProperties) ToProperties() Properties

type FeatureFlagsPoller

+ func (poller *FeatureFlagsPoller) GetFeatureFlagWithPayload(flagConfig FeatureFlagPayload) flagValueAndPayload

type Filter

+ DecodedPayloads map[string]string

+ VariantLookupTable []FlagVariantMeta

type PropertyGroup

+ ParsedValues []parsedPropertyValue

Feb 4, 2026

Changes in this version

+ const FeatureFlagErrorEvaluationFailed

+ var ErrFlagNotFound = errors.New("feature flag not found")

type Client

+ GetFeatureFlagResult func(FeatureFlagPayload) (*FeatureFlagResult, error)

type FeatureFlag

+ BucketingIdentifier *string

type FeatureFlagPayload

+ DeviceId *string

type FeatureFlagPayloadNoKey

+ DeviceId *string

type FeatureFlagResult

+ Enabled bool

+ Key string

+ RawPayload *string

+ Variant *string

+ func (r *FeatureFlagResult) GetPayloadAs(v interface{}) error

type FlagDetail

+ Failed *bool

type FlagsRequestData

+ DeviceId *string

type SendFeatureFlagsOptions

+ DeviceId *string

Jan 21, 2026

Changes in this version

type Alias

+ Uuid string

type AliasInApi

+ Uuid string

+ type CompressionMode uint8

+ const CompressionGzip

+ const CompressionNone

type Config

+ Compression CompressionMode

type Exception

+ Uuid string

type ExceptionInApi

+ Uuid string

type GroupIdentify

+ Uuid string

type GroupIdentifyInApi

+ Uuid string

type Identify

+ Uuid string

type IdentifyInApi

+ Uuid string

Jan 13, 2026

Changes in this version

+ const DefaultBatchSubmitTimeout

+ const DefaultBatchUploadTimeout

+ const DefaultIdleConns

+ const DefaultIdleConnsPerHost

+ const DefaultMaxEnqueuedRequests

+ const FeatureFlagErrorAPIErrorPrefix

+ const FeatureFlagErrorConnectionError

+ const FeatureFlagErrorErrorsWhileComputing

+ const FeatureFlagErrorFlagMissing

+ const FeatureFlagErrorQuotaLimited

+ const FeatureFlagErrorTimeout

+ const FeatureFlagErrorUnknownError

+ type APIError struct

+ Message string

+ StatusCode int

+ func NewAPIError(statusCode int, message string) *APIError

+ func (e *APIError) Error() string

type Client

+ CloseWithContext func(context.Context) error

type Config

+ BatchSubmitTimeout time.Duration

+ BatchUploadTimeout time.Duration

+ MaxEnqueuedRequests int

+ ShutdownTimeout time.Duration

+ type FeatureFlagResult struct

+ Err error

+ ErrorsWhileComputingFlags bool

+ EvaluatedAt *int64

+ FlagDetail *FlagDetail

+ FlagMissing bool

+ QuotaLimited bool

+ RequestID *string

+ Value interface{}

+ func (r *FeatureFlagResult) GetErrorString() string

Dec 23, 2025

Changes in this version

+ func Ptr[T any](v T) *T

+ type Backoff struct

+ func DefaultBackoff() *Backoff

+ func NewBackoff(base time.Duration, factor uint8, jitter float64, cap time.Duration) *Backoff

+ func (b *Backoff) Duration(attempt int) time.Duration

+ func (b *Backoff) NewTicker() *Ticker

+ func (b *Backoff) Sleep(attempt int)

type CommonResponseFields

+ EvaluatedAt *int64

type Config

+ MaxRetries *int

Oct 21, 2025

Changes in this version

+ type RequiresServerEvaluationError struct

+ func (e *RequiresServerEvaluationError) Error() string

Sep 4, 2025

Changes in this version

+ func SimpleInAppDecider(frame runtime.Frame) bool

+ type DefaultStackTraceExtractor struct

+ InAppDecider InAppDecider

+ func (d DefaultStackTraceExtractor) GetStackTrace(skip int) *ExceptionStacktrace

+ type DescriptionExtractor interface

+ ExtractDescription func(r slog.Record) string

+ type EnqueueClient interface

+ Enqueue func(Message) error

+ type ErrorExtractor struct

+ ErrorKeys []string

+ Fallback string

+ func (e ErrorExtractor) ExtractDescription(r slog.Record) string

+ type Exception struct

+ DisableGeoIP bool

+ DistinctId string

+ ExceptionFingerprint *string

+ ExceptionList []ExceptionItem

+ Timestamp time.Time

+ Type string

+ func NewDefaultException(timestamp time.Time, distinctID, title, description string) Exception

+ func (msg Exception) APIfy() APIMessage

+ func (msg Exception) Validate() error

+ type ExceptionInApi struct

+ Event string

+ Library string

+ LibraryVersion string

+ Properties ExceptionInApiProperties

+ Timestamp time.Time

+ Type string

+ type ExceptionInApiProperties struct

+ DisableGeoIP bool

+ DistinctId string

+ ExceptionFingerprint *string

+ ExceptionList []ExceptionItem

+ Lib string

+ LibVersion string

+ type ExceptionItem struct

+ Mechanism *ExceptionMechanism

+ Stacktrace *ExceptionStacktrace

+ Type string

+ Value string

+ func (msg ExceptionItem) Validate() error

+ type ExceptionMechanism struct

+ Handled *bool

+ Synthetic *bool

+ type ExceptionStacktrace struct

+ Frames []StackFrame

+ Type string

+ type InAppDecider func(frame runtime.Frame) bool

+ type SlogCaptureHandler struct

+ func NewSlogCaptureHandler(next slog.Handler, client EnqueueClient, opts ...SlogOption) *SlogCaptureHandler

+ func (h *SlogCaptureHandler) Enabled(ctx context.Context, level slog.Level) bool

+ func (h *SlogCaptureHandler) Handle(ctx context.Context, r slog.Record) error

+ func (h *SlogCaptureHandler) WithAttrs(attrs []slog.Attr) slog.Handler

+ func (h *SlogCaptureHandler) WithGroup(name string) slog.Handler

+ type SlogOption func(*captureConfig)

+ func WithDescriptionExtractor(extractor DescriptionExtractor) SlogOption

+ func WithDistinctIDFn(fn func(ctx context.Context, r slog.Record) string) SlogOption

+ func WithFingerprintFn(fn func(ctx context.Context, r slog.Record) *string) SlogOption

+ func WithMinCaptureLevel(l slog.Level) SlogOption

+ func WithSkip(n int) SlogOption

+ func WithStackTraceExtractor(extractor StackTraceExtractor) SlogOption

+ type StackFrame struct

+ Filename string

+ Function string

+ InApp bool

+ LineNo int

+ Platform string

+ Synthetic bool

+ type StackTraceExtractor interface

+ GetStackTrace func(skip int) *ExceptionStacktrace

Aug 25, 2025

Changes in this version

type FlagProperty

+ DependencyChain []string

Jul 24, 2025

Changes in this version

+ type SendFeatureFlagsBool bool

+ func (b SendFeatureFlagsBool) GetOptions() *SendFeatureFlagsOptions

+ func (b SendFeatureFlagsBool) ShouldSend() bool

+ type SendFeatureFlagsOptions struct

+ GroupProperties map[string]Properties

+ OnlyEvaluateLocally bool

+ PersonProperties Properties

+ func (opts *SendFeatureFlagsOptions) GetOptions() *SendFeatureFlagsOptions

+ func (opts *SendFeatureFlagsOptions) ShouldSend() bool

+ type SendFeatureFlagsValue interface

+ GetOptions func() *SendFeatureFlagsOptions

+ ShouldSend func() bool

+ func SendFeatureFlags(enabled bool) SendFeatureFlagsValue

+ func SendFeatureFlagsWithOptions(opts *SendFeatureFlagsOptions) SendFeatureFlagsValue

Jun 10, 2025

Changes in this version

+ var ErrNoPersonalAPIKey = errors.New("no PersonalAPIKey provided")

type Config

+ func (c *Config) Validate() error

type FeatureFlagsPoller

+ Logger Logger

type Logger

+ Debugf func(format string, args ...interface{})

+ Warnf func(format string, args ...interface{})

May 23, 2025

Changes in this version

+ const SDKName

type Alias

+ DisableGeoIP bool

type AliasInApiProperties

+ DisableGeoIP bool

type Config

+ DisableGeoIP *bool

+ func (c Config) GetDisableGeoIP() bool

type FlagsRequestData

+ DisableGeoIP bool

type GroupIdentify

+ DisableGeoIP bool

type Identify

+ DisableGeoIP bool

May 13, 2025

Changes in this version

+ const CACHE_DEFAULT_SIZE

May 1, 2025

Changes in this version

+ type FlagsRequestData struct

+ ApiKey string

+ DistinctId string

+ GroupProperties map[string]Properties

+ Groups Groups

+ PersonProperties Properties

+ type FlagsResponse struct

+ FeatureFlagPayloads map[string]string

+ FeatureFlags map[string]interface{}

+ Flags map[string]FlagDetail

+ func (r *FlagsResponse) UnmarshalJSON(data []byte) error

Apr 2, 2025

Changes in this version

+ type CommonResponseFields struct

+ ErrorsWhileComputingFlags bool

+ QuotaLimited *[]string

+ RequestId string

type DecideResponse

+ Flags map[string]FlagDetail

+ func (r *DecideResponse) UnmarshalJSON(data []byte) error

+ type FlagDetail struct

+ Enabled bool

+ Key string

+ Metadata FlagMetadata

+ Reason *FlagReason

+ Variant *string

+ func NewFlagDetail(key string, value interface{}, payload *string) FlagDetail

+ func (f FlagDetail) GetValue() interface{}

+ type FlagMetadata struct

+ Description *string

+ ID int

+ Payload *string

+ Version int

+ type FlagReason struct

+ Code string

+ ConditionIndex int

+ Description string

Feb 27, 2025

Changes in this version

type DecideResponse

+ QuotaLimited *[]string

Feb 13, 2025

Changes in this version

+ const SdkName

type Client

+ GetRemoteConfigPayload func(string) (string, error)

Sep 16, 2024

Changes in this version

type Config

+ HistoricalMigration bool

Aug 22, 2024

Changes in this version

type Capture

+ Uuid string

type CaptureInApi

+ Uuid string

Aug 13, 2024

Changes in this version

type Client

+ GetFeatureFlagPayload func(FeatureFlagPayload) (string, error)

type DecideResponse

+ FeatureFlagPayloads map[string]string

type FeatureFlagsPoller

+ func (poller *FeatureFlagsPoller) GetFeatureFlagPayload(flagConfig FeatureFlagPayload) (string, error)

type Filter

+ Payloads map[string]string

Aug 13, 2024

Changes in this version

type Config

+ DefaultEventProperties Properties

type Properties

+ func (p Properties) Merge(props Properties) Properties

Aug 8, 2024

Changes in this version

+ const DefaultBatchSize

+ const DefaultEndpoint

+ const DefaultFeatureFlagRequestTimeout

+ const DefaultFeatureFlagsPollingInterval

+ const DefaultInterval

+ const LONG_SCALE

+ const SIZE_DEFAULT

+ const Version

+ var ErrClosed = errors.New("the client was already closed")

+ var ErrMessageTooBig = errors.New("the message exceeds the maximum allowed size")

+ var ErrTooManyRequests = errors.New("too many requests are already in-flight")

+ type APIMessage interface

+ type Alias struct

+ Alias string

+ DistinctId string

+ Timestamp time.Time

+ Type string

+ func (msg Alias) APIfy() APIMessage

+ func (msg Alias) Validate() error

+ type AliasInApi struct

+ Event string

+ Library string

+ LibraryVersion string

+ Properties AliasInApiProperties

+ Timestamp time.Time

+ Type string

+ type AliasInApiProperties struct

+ Alias string

+ DistinctId string

+ Lib string

+ LibVersion string

+ type Backo struct

+ func DefaultBacko() *Backo

+ func NewBacko(base time.Duration, factor uint8, jitter float64, cap time.Duration) *Backo

+ func (b *Backo) NewTicker() *Ticker

+ func (backo *Backo) Duration(attempt int) time.Duration

+ func (backo *Backo) Sleep(attempt int)

+ type Callback interface

+ Failure func(APIMessage, error)

+ Success func(APIMessage)

+ type Capture struct

+ DistinctId string

+ Event string

+ Groups Groups

+ Properties Properties

+ SendFeatureFlags bool

+ Timestamp time.Time

+ Type string

+ func (msg Capture) APIfy() APIMessage

+ func (msg Capture) Validate() error

+ type CaptureInApi struct

+ DistinctId string

+ Event string

+ Library string

+ LibraryVersion string

+ Properties Properties

+ SendFeatureFlags bool

+ Timestamp time.Time

+ Type string

+ type Client interface

+ Enqueue func(Message) error

+ GetAllFlags func(FeatureFlagPayloadNoKey) (map[string]interface{}, error)

+ GetFeatureFlag func(FeatureFlagPayload) (interface{}, error)

+ GetFeatureFlags func() ([]FeatureFlag, error)

+ GetLastCapturedEvent func() *Capture

+ IsFeatureEnabled func(FeatureFlagPayload) (interface{}, error)

+ ReloadFeatureFlags func() error

+ func New(apiKey string) Client

+ func NewWithConfig(apiKey string, config Config) (cli Client, err error)

+ type Config struct

+ BatchSize int

+ Callback Callback

+ DefaultFeatureFlagsPollingInterval time.Duration

+ Endpoint string

+ FeatureFlagRequestTimeout time.Duration

+ Interval time.Duration

+ Logger Logger

+ NextFeatureFlagsPollingTick func() time.Duration

+ PersonalApiKey string

+ RetryAfter func(int) time.Duration

+ Transport http.RoundTripper

+ Verbose bool

+ type ConfigError struct

+ Field string

+ Reason string

+ Value interface{}

+ func (e ConfigError) Error() string

+ type DecideRequestData struct

+ ApiKey string

+ DistinctId string

+ GroupProperties map[string]Properties

+ Groups Groups

+ PersonProperties Properties

+ type DecideResponse struct

+ FeatureFlags map[string]interface{}

+ type FeatureFlag struct

+ Active bool

+ EnsureExperienceContinuity *bool

+ Filters Filter

+ IsSimpleFlag bool

+ Key string

+ RolloutPercentage *uint8

+ type FeatureFlagCondition struct

+ Properties []FlagProperty

+ RolloutPercentage *uint8

+ Variant *string

+ type FeatureFlagPayload struct

+ DistinctId string

+ GroupProperties map[string]Properties

+ Groups Groups

+ Key string

+ OnlyEvaluateLocally bool

+ PersonProperties Properties

+ SendFeatureFlagEvents *bool

+ type FeatureFlagPayloadNoKey struct

+ DistinctId string

+ GroupProperties map[string]Properties

+ Groups Groups

+ OnlyEvaluateLocally bool

+ PersonProperties Properties

+ SendFeatureFlagEvents *bool

+ type FeatureFlagsPoller struct

+ Endpoint string

+ Errorf func(format string, args ...interface{})

+ func (poller *FeatureFlagsPoller) ForceReload()

+ func (poller *FeatureFlagsPoller) GetAllFlags(flagConfig FeatureFlagPayloadNoKey) (map[string]interface{}, error)

+ func (poller *FeatureFlagsPoller) GetFeatureFlag(flagConfig FeatureFlagPayload) (interface{}, error)

+ func (poller *FeatureFlagsPoller) GetFeatureFlags() ([]FeatureFlag, error)

+ type FeatureFlagsResponse struct

+ Cohorts map[string]PropertyGroup

+ Flags []FeatureFlag

+ GroupTypeMapping *map[string]string

+ type FieldError struct

+ Name string

+ Type string

+ Value interface{}

+ func (e FieldError) Error() string

+ type Filter struct

+ AggregationGroupTypeIndex *uint8

+ Groups []FeatureFlagCondition

+ Multivariate *Variants

+ type FlagProperty struct

+ Key string

+ Negation bool

+ Operator string

+ Type string

+ Value interface{}

+ type FlagVariant struct

+ Key string

+ Name string

+ RolloutPercentage *uint8

+ type FlagVariantMeta struct

+ Key string

+ ValueMax float64

+ ValueMin float64

+ type GroupIdentify struct

+ DistinctId string

+ Key string

+ Properties Properties

+ Timestamp time.Time

+ Type string

+ func (msg GroupIdentify) APIfy() APIMessage

+ func (msg GroupIdentify) Validate() error

+ type GroupIdentifyInApi struct

+ DistinctId string

+ Event string

+ Library string

+ LibraryVersion string

+ Properties Properties

+ Timestamp time.Time

+ type Groups map[string]interface

+ func (p Groups) Set(name string, value interface{}) Groups

+ func NewGroups() Groups

+ type Identify struct

+ DistinctId string

+ Properties Properties

+ Timestamp time.Time

+ Type string

+ func (msg Identify) APIfy() APIMessage

+ func (msg Identify) Validate() error

+ type IdentifyInApi struct

+ DistinctId string

+ Event string

+ Library string

+ LibraryVersion string

+ Properties Properties

+ Set Properties

+ Timestamp time.Time

+ Type string

+ type InconclusiveMatchError struct

+ func (e *InconclusiveMatchError) Error() string

+ type Logger interface

+ Errorf func(format string, args ...interface{})

+ Logf func(format string, args ...interface{})

+ func StdLogger(logger *log.Logger) Logger

+ type Message interface

+ APIfy func() APIMessage

+ Validate func() error

+ type Properties map[string]interface

+ func (p Properties) Set(name string, value interface{}) Properties

+ func NewProperties() Properties

+ type PropertyGroup struct

+ Type string

+ Values []any

+ type SizeLimitedMap struct

+ type Ticker struct

+ C <-chan time.Time

+ func (t *Ticker) Stop()

+ type Variants struct

+ Variants []FlagVariant