feat(usage): add PingCheckCtx for cancellable ping loops

PingCheck runs an unbounded ticker loop with no stop mechanism — once
started, it emits ping events for the entire process lifetime. This
prevents consumers from running ping under cancellation-aware constructs
like leader election, where a pod that loses leadership needs its ping
goroutines to stop cleanly. Without a stop signal, ex-leaders leak
goroutines across every transition and continue emitting duplicate
events from pods that should be quiet.

Add PingCheckCtx(ctx, engineName, category, pingImmediately) alongside
PingCheck. Same semantics, but the ticker loop selects on ctx.Done() and
returns cleanly on cancellation. defer ticker.Stop() to avoid a leaked
ticker on the cancellation path.

Refactor PingCheck into a one-line wrapper around
PingCheckCtx(context.Background(), ...) and mark it Deprecated in the
godoc. Backward-compatible: the signature is unchanged, and under
context.Background() ctx.Done() returns a nil channel that blocks
forever, so the select degrades to the same forever-tick loop as
before.

Signed-off-by: Niladri Halder <niladri.halder26@gmail.com>

Author: niladrih

usage/ping.go

@@ -1,22 +1,7 @@
-/*
-Copyright 2023 The OpenEBS Authors.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-	http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
 package usage
 
 import (
+	"context"
 	"fmt"
 	"time"
 
@@ -35,8 +20,15 @@ const (
 	minimumPingPeriod time.Duration = 1 * time.Hour
 )
 
-// PingCheck sends ping events to Google Analytics
+// PingCheck sends ping events to Google Analytics on a fixed cadence.
 func PingCheck(engineName, category string, pingImmediately bool) {
+	PingCheckCtx(context.Background(), engineName, category, pingImmediately)
+}
+
+// PingCheckCtx sends ping events to Google Analytics on a fixed cadence,
+// returning when ctx is cancelled. If pingImmediately is true, one event is
+// sent before the ticker starts; subsequent events fire every getPingPeriod().
+func PingCheckCtx(ctx context.Context, engineName, category string, pingImmediately bool) {
 	// Create a new usage field
 	u := New()
 
@@ -48,14 +40,20 @@ func PingCheck(engineName, category string, pingImmediately bool) {
 			Send()
 	}
 
-	duration := getPingPeriod()
-	ticker := time.NewTicker(duration)
-	for range ticker.C {
-		// Ping periodically, starting at 'duration'.
-		u.CommonBuild(engineName).
-			InstallBuilder(true).
-			SetCategory(category).
-			Send()
+	ticker := time.NewTicker(getPingPeriod())
+	defer ticker.Stop()
+
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-ticker.C:
+			// Ping periodically.
+			u.CommonBuild(engineName).
+				InstallBuilder(true).
+				SetCategory(category).
+				Send()
+		}
 	}
 }