telemetry

package

v1.21.0 Latest Latest Go to latest Published: May 2, 2026 License: MIT Imports: 12 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/nmelo/initech

Links

Open Source Insights

Documentation ¶

Overview ¶

Package telemetry provides anonymous usage tracking via PostHog. Events are fire-and-forget: sends are non-blocking and failures are silently discarded. No PII is collected.

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Client ¶

type Client struct {
	// contains filtered or unexported fields
}

Client sends anonymous telemetry events to PostHog. Zero value is not usable; call Init to create a client.

func Init ¶

func Init(version string) *Client

Init creates a telemetry client and starts the background sender. Pass the initech version string.

func (*Client) DeviceID ¶ added in v1.18.3

func (c *Client) DeviceID() string

DeviceID returns the stable device identifier used as PostHog distinct_id.

func (*Client) Duration ¶

func (c *Client) Duration() time.Duration

Duration returns the session duration since Init.

func (*Client) SessionID ¶

func (c *Client) SessionID() string

SessionID returns the random session identifier for event correlation.

func (*Client) Shutdown ¶

func (c *Client) Shutdown()

Shutdown flushes pending events and stops the background sender. Safe to call multiple times. Blocks until the sender exits or 5s elapses.

func (*Client) Track ¶

func (c *Client) Track(name string, props map[string]any)

Track enqueues an event for async delivery. Non-blocking: if the buffer is full, the event is dropped silently.

Source Files ¶

View all Source files

telemetry.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL