Function trackCommandCompleted

pkg/cmd/root/root.go:289–322

trackCommandCompleted reports how the command ended: success, failure (with the class of the error) or user cancellation.

(
	ctx context.Context,
	cmd *cobra.Command,
	code exitCode,
	err error,
	elapsed time.Duration,
)

// trackCommandCompleted reports how the command ended: success, failure (with
// the class of the error) or user cancellation.
func trackCommandCompleted(
	ctx context.Context,
	cmd *cobra.Command,
	code exitCode,
	err error,
	elapsed time.Duration,
) {
	if cmd == nil || !cmdutil.ShouldTrackUsage(cmd) {
		return
	}
	// An empty command path means PersistentPreRunE never ran (--help,
	// --version, unknown flag or command, failed auth check): no Command
	// Invoked was sent, so don't send an orphan Command Completed either.
	metadata := telemetry.GetEventMetadata(ctx)
	if metadata == nil || metadata.CommandPath == "" {
		return
	}
	client := telemetry.GetTelemetryClient(ctx)
	if client == nil {
		return
	}

	props := map[string]any{
		"succeeded":   code == exitOK,
		"exit_code":   int(code),
		"duration_ms": elapsed.Milliseconds(),
	}
	if err != nil {
		props["error_class"] = telemetry.ErrorClass(err)
		props["user_cancelled"] = cmdutil.IsUserCancellation(err)
	}

	_ = client.Track(ctx, telemetry.EventCommandCompleted, props)
}

// closeTelemetry flushes the pending telemetry events, giving up after a
// short timeout so an unreachable telemetry endpoint never delays exit.