metrics

type AnalyticsRequest struct {
	Event string      `json:"event"`
	Body  interface{} `json:"body"`
}

type Client interface {
	// WithCliVersionFunc sets the docker cli version func
	// that returns the docker cli version (com.docker.cli)
	WithCliVersionFunc(f func() string)
	// SendUsage sends the command to Docker Desktop.
	//
	// Note that metric collection is best-effort, so any errors are ignored.
	SendUsage(CommandUsage)
	// Track creates an event for a command execution and reports it.
	Track(CmdResult)
}

type CmdResult struct {
	// ContextType is `moby` for Docker or the name of a cloud provider.
	ContextType string
	// Args minus the process name (argv[0] aka `docker`).
	Args []string
	// Status based on exit code as a descriptive value.
	//
	// Deprecated: used for usage, events rely exclusively on exit code.
	Status string
	// ExitCode is 0 on success; otherwise, failure.
	ExitCode int
	// Start time of the process (UTC).
	Start time.Time
	// Duration of process execution.
	Duration time.Duration
}

type CommandUsage struct {
	Command string `json:"command"`
	Context string `json:"context"`
	Source  string `json:"source"`
	Status  string `json:"status"`
}

type DockerCLIEvent struct {
	Command      string    `json:"command,omitempty"`
	Subcommand   string    `json:"subcommand,omitempty"`
	Usage        bool      `json:"usage,omitempty"`
	ExitCode     int32     `json:"exit_code"`
	StartTime    time.Time `json:"start_time"`
	DurationSecs float64   `json:"duration_secs,omitempty"`
}

type FailureCategory struct {
	MetricsStatus string
	ExitCode      int
}

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

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

type Reporter interface {
	// Heartbeat reports a metric for aggregation.
	Heartbeat(cmd CommandUsage)

	// Event reports an analytics action.
	Event(cmd DockerCLIEvent)
}

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