chore: Add X-Goog-Api-Client metric header to outgoing requests (#655)

jonathanedey · web-flow · commit 4ff081234af2 · 2024-11-21T13:39:28.000-05:00
* chore: Add `X-Goog-Api-Client` metric header to outgoing requests

* Fix lint and test

* Remove App Check headers
diff --git a/auth/auth.go b/auth/auth.go
@@ -21,7 +21,6 @@ import (
 	"errors"
 	"fmt"
 	"os"
-	"runtime"
 	"strings"
 	"time"
 
@@ -134,12 +133,11 @@ func NewClient(ctx context.Context, conf *internal.AuthConfig) (*Client, error)
 		return nil, err
 	}
 
-	goVersion := strings.TrimPrefix(runtime.Version(), "go")
 	hc := internal.WithDefaultRetryConfig(transport)
 	hc.CreateErrFn = handleHTTPError
 	hc.Opts = []internal.HTTPOption{
 		internal.WithHeader("X-Client-Version", fmt.Sprintf("Go/Admin/%s", conf.Version)),
-		internal.WithHeader("x-goog-api-client", fmt.Sprintf("gl-go/%s fire-admin/%s", goVersion, conf.Version)),
+		internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(conf.Version)),
 	}
 
 	baseURL := defaultAuthURL
diff --git a/auth/auth_test.go b/auth/auth_test.go
@@ -23,7 +23,6 @@ import (
 	"log"
 	"net/http"
 	"os"
-	"runtime"
 	"strings"
 	"syscall"
 	"testing"
@@ -1452,11 +1451,9 @@ func checkBaseClient(client *Client, wantProjectID string) error {
 		return fmt.Errorf("version = %q; want = %q", version, wantVersion)
 	}
 
-	goVersion := strings.TrimPrefix(runtime.Version(), "go")
-	xGoogAPIClientHeader := req.Header.Get("x-goog-api-client")
-	wantXGoogAPIClientHeader := fmt.Sprintf("gl-go/%s fire-admin/%s", goVersion, testVersion)
-	if xGoogAPIClientHeader != wantXGoogAPIClientHeader {
-		return fmt.Errorf("x-goog-api-client header = %q; want = %q", xGoogAPIClientHeader, wantXGoogAPIClientHeader)
+	xGoogAPIClientHeader := internal.GetMetricsHeader(testVersion)
+	if h := req.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+		return fmt.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
 	}
 
 	return nil
diff --git a/auth/token_generator.go b/auth/token_generator.go
@@ -175,6 +175,9 @@ func newIAMSigner(ctx context.Context, config *internal.AuthConfig) (*iamSigner,
 	if err != nil {
 		return nil, err
 	}
+	hc.Opts = []internal.HTTPOption{
+		internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(config.Version)),
+	}
 
 	return &iamSigner{
 		mutex:        &sync.Mutex{},
diff --git a/auth/token_generator_test.go b/auth/token_generator_test.go
@@ -122,6 +122,7 @@ func TestIAMSigner(t *testing.T) {
 	conf := &internal.AuthConfig{
 		Opts:             optsWithTokenSource,
 		ServiceAccountID: "test-service-account",
+		Version:          testVersion,
 	}
 	signer, err := newIAMSigner(ctx, conf)
 	if err != nil {
@@ -155,6 +156,7 @@ func TestIAMSignerHTTPError(t *testing.T) {
 	conf := &internal.AuthConfig{
 		Opts:             optsWithTokenSource,
 		ServiceAccountID: "test-service-account",
+		Version:          testVersion,
 	}
 	signer, err := newIAMSigner(context.Background(), conf)
 	if err != nil {
@@ -182,6 +184,7 @@ func TestIAMSignerUnknownHTTPError(t *testing.T) {
 	conf := &internal.AuthConfig{
 		Opts:             optsWithTokenSource,
 		ServiceAccountID: "test-service-account",
+		Version:          testVersion,
 	}
 	signer, err := newIAMSigner(context.Background(), conf)
 	if err != nil {
@@ -208,7 +211,8 @@ func TestIAMSignerUnknownHTTPError(t *testing.T) {
 func TestIAMSignerWithMetadataService(t *testing.T) {
 	ctx := context.Background()
 	conf := &internal.AuthConfig{
-		Opts: optsWithTokenSource,
+		Opts:    optsWithTokenSource,
+		Version: testVersion,
 	}
 
 	signer, err := newIAMSigner(ctx, conf)
@@ -253,7 +257,8 @@ func TestIAMSignerWithMetadataService(t *testing.T) {
 func TestIAMSignerNoMetadataService(t *testing.T) {
 	ctx := context.Background()
 	conf := &internal.AuthConfig{
-		Opts: optsWithTokenSource,
+		Opts:    optsWithTokenSource,
+		Version: testVersion,
 	}
 
 	signer, err := newIAMSigner(ctx, conf)
@@ -340,6 +345,10 @@ func iamServer(t *testing.T, serviceAcct, signature string) *httptest.Server {
 		if r.URL.Path != wantPath {
 			t.Errorf("Path = %q; want = %q", r.URL.Path, wantPath)
 		}
+		xGoogAPIClientHeader := internal.GetMetricsHeader(testVersion)
+		if h := r.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+			t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
+		}
 
 		w.Header().Set("Content-Type", "application/json")
 		b, err := json.Marshal(resp)
diff --git a/auth/user_mgt_test.go b/auth/user_mgt_test.go
@@ -24,7 +24,6 @@ import (
 	"net/http"
 	"net/http/httptest"
 	"reflect"
-	"runtime"
 	"sort"
 	"strconv"
 	"strings"
@@ -2317,7 +2316,7 @@ func echoServer(resp interface{}, t *testing.T) *mockAuthServer {
 		}
 
 		gh = r.Header.Get("x-goog-api-client")
-		wh = fmt.Sprintf("gl-go/%s fire-admin/%s", strings.TrimPrefix(runtime.Version(), "go"), testVersion)
+		wh = internal.GetMetricsHeader(testVersion)
 		if gh != wh {
 			t.Errorf("x-goog-api-client header = %q; want: %q", gh, wh)
 		}
diff --git a/firebase.go b/firebase.go
@@ -115,6 +115,7 @@ func (a *App) InstanceID(ctx context.Context) (*iid.Client, error) {
 	conf := &internal.InstanceIDConfig{
 		ProjectID: a.projectID,
 		Opts:      a.opts,
+		Version:   Version,
 	}
 	return iid.NewClient(ctx, conf)
 }
diff --git a/iid/iid.go b/iid/iid.go
@@ -119,6 +119,9 @@ func NewClient(ctx context.Context, c *internal.InstanceIDConfig) (*Client, erro
 	if err != nil {
 		return nil, err
 	}
+	hc.Opts = []internal.HTTPOption{
+		internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(c.Version)),
+	}
 
 	hc.CreateErrFn = createError
 	return &Client{
diff --git a/iid/iid_test.go b/iid/iid_test.go
@@ -31,6 +31,7 @@ var testIIDConfig = &internal.InstanceIDConfig{
 	Opts: []option.ClientOption{
 		option.WithTokenSource(&internal.MockTokenSource{AccessToken: "test-token"}),
 	},
+	Version: "test-version",
 }
 
 func TestNoProjectID(t *testing.T) {
@@ -83,6 +84,10 @@ func TestDeleteInstanceID(t *testing.T) {
 	if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {
 		t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")
 	}
+	xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)
+	if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+		t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
+	}
 }
 
 func TestDeleteInstanceIDError(t *testing.T) {
@@ -156,6 +161,10 @@ func TestDeleteInstanceIDError(t *testing.T) {
 		if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {
 			t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")
 		}
+		xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)
+		if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+			t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
+		}
 		tr = nil
 	}
 }
@@ -201,6 +210,10 @@ func TestDeleteInstanceIDUnexpectedError(t *testing.T) {
 	if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {
 		t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")
 	}
+	xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)
+	if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+		t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
+	}
 }
 
 func TestDeleteInstanceIDConnectionError(t *testing.T) {
diff --git a/internal/http_client.go b/internal/http_client.go
@@ -23,7 +23,9 @@ import (
 	"io/ioutil"
 	"math"
 	"net/http"
+	"runtime"
 	"strconv"
+	"strings"
 	"time"
 
 	"google.golang.org/api/option"
@@ -441,3 +443,9 @@ func retryNetworkAndHTTPErrors(statusCodes ...int) RetryCondition {
 		return false
 	}
 }
+
+// GetMetricsHeader constructs header value for metrics attribution
+func GetMetricsHeader(sdkVersion string) string {
+	goVersion := strings.TrimPrefix(runtime.Version(), "go")
+	return fmt.Sprintf("gl-go/%s fire-admin/%s", goVersion, sdkVersion)
+}
diff --git a/internal/internal.go b/internal/internal.go
@@ -50,6 +50,7 @@ type HashConfig map[string]interface{}
 type InstanceIDConfig struct {
 	Opts      []option.ClientOption
 	ProjectID string
+	Version   string
 }
 
 // DatabaseConfig represents the configuration of Firebase Database service.
diff --git a/messaging/messaging.go b/messaging/messaging.go
@@ -23,7 +23,6 @@ import (
 	"fmt"
 	"net/http"
 	"regexp"
-	"runtime"
 	"strconv"
 	"strings"
 	"time"
@@ -878,7 +877,7 @@ func NewClient(ctx context.Context, c *internal.MessagingConfig) (*Client, error
 
 	return &Client{
 		fcmClient: newFCMClient(hc, c, messagingEndpoint, batchEndpoint),
-		iidClient: newIIDClient(hc),
+		iidClient: newIIDClient(hc, c),
 	}, nil
 }
 
@@ -894,12 +893,11 @@ func newFCMClient(hc *http.Client, conf *internal.MessagingConfig, messagingEndp
 	client := internal.WithDefaultRetryConfig(hc)
 	client.CreateErrFn = handleFCMError
 
-	goVersion := strings.TrimPrefix(runtime.Version(), "go")
 	version := fmt.Sprintf("fire-admin-go/%s", conf.Version)
 	client.Opts = []internal.HTTPOption{
 		internal.WithHeader(apiFormatVersionHeader, apiFormatVersion),
 		internal.WithHeader(firebaseClientHeader, version),
-		internal.WithHeader("x-goog-api-client", fmt.Sprintf("gl-go/%s fire-admin/%s", goVersion, conf.Version)),
+		internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(conf.Version)),
 	}
 
 	return &fcmClient{
diff --git a/messaging/messaging_test.go b/messaging/messaging_test.go
@@ -21,8 +21,6 @@ import (
 	"net/http"
 	"net/http/httptest"
 	"reflect"
-	"runtime"
-	"strings"
 	"testing"
 	"time"
 
@@ -1396,8 +1394,7 @@ func checkFCMRequest(t *testing.T, b []byte, tr *http.Request, want map[string]i
 	if h := tr.Header.Get("X-FIREBASE-CLIENT"); h != clientVersion {
 		t.Errorf("X-FIREBASE-CLIENT = %q; want = %q", h, clientVersion)
 	}
-	goVersion := strings.TrimPrefix(runtime.Version(), "go")
-	xGoogAPIClientHeader := "gl-go/" + goVersion + " fire-admin/" + testMessagingConfig.Version
+	xGoogAPIClientHeader := internal.GetMetricsHeader(testMessagingConfig.Version)
 	if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
 		t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
 	}
diff --git a/messaging/topic_mgt.go b/messaging/topic_mgt.go
@@ -63,10 +63,13 @@ type iidClient struct {
 	httpClient  *internal.HTTPClient
 }
 
-func newIIDClient(hc *http.Client) *iidClient {
+func newIIDClient(hc *http.Client, conf *internal.MessagingConfig) *iidClient {
 	client := internal.WithDefaultRetryConfig(hc)
 	client.CreateErrFn = handleIIDError
-	client.Opts = []internal.HTTPOption{internal.WithHeader("access_token_auth", "true")}
+	client.Opts = []internal.HTTPOption{
+		internal.WithHeader("access_token_auth", "true"),
+		internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(conf.Version)),
+	}
 	return &iidClient{
 		iidEndpoint: iidEndpoint,
 		httpClient:  client,
diff --git a/messaging/topic_mgt_test.go b/messaging/topic_mgt_test.go
@@ -25,6 +25,7 @@ import (
 	"testing"
 
 	"firebase.google.com/go/v4/errorutils"
+	"firebase.google.com/go/v4/internal"
 )
 
 func TestSubscribe(t *testing.T) {
@@ -198,6 +199,10 @@ func checkIIDRequest(t *testing.T, b []byte, tr *http.Request, op string) {
 	if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {
 		t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")
 	}
+	xGoogAPIClientHeader := internal.GetMetricsHeader(testMessagingConfig.Version)
+	if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {
+		t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)
+	}
 }
 
 func checkTopicMgtResponse(t *testing.T, resp *TopicManagementResponse) {

Original file line number	Diff line number	Diff line change
`@@ -175,6 +175,9 @@ func newIAMSigner(ctx context.Context, config internal.AuthConfig) (iamSigner,`
`175`	`175`	`if err != nil {`
`176`	`176`	`return nil, err`
`177`	`177`	`}`
	`178`	`+ hc.Opts = []internal.HTTPOption{`
	`179`	`+ internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(config.Version)),`
	`180`	`+ }`
`178`	`181`
`179`	`182`	`return &iamSigner{`
`180`	`183`	`mutex: &sync.Mutex{},`
Original file line number	Diff line number	Diff line change
`@@ -115,6 +115,7 @@ func (a App) InstanceID(ctx context.Context) (iid.Client, error) {`
`115`	`115`	`conf := &internal.InstanceIDConfig{`
`116`	`116`	`ProjectID: a.projectID,`
`117`	`117`	`Opts: a.opts,`
	`118`	`+ Version: Version,`
`118`	`119`	`}`
`119`	`120`	`return iid.NewClient(ctx, conf)`
`120`	`121`	`}`
Original file line number	Diff line number	Diff line change
`@@ -119,6 +119,9 @@ func NewClient(ctx context.Context, c internal.InstanceIDConfig) (Client, erro`
`119`	`119`	`if err != nil {`
`120`	`120`	`return nil, err`
`121`	`121`	`}`
	`122`	`+ hc.Opts = []internal.HTTPOption{`
	`123`	`+ internal.WithHeader("x-goog-api-client", internal.GetMetricsHeader(c.Version)),`
	`124`	`+ }`
`122`	`125`
`123`	`126`	`hc.CreateErrFn = createError`
`124`	`127`	`return &Client{`
Original file line number	Diff line number	Diff line change
`@@ -31,6 +31,7 @@ var testIIDConfig = &internal.InstanceIDConfig{`
`31`	`31`	`Opts: []option.ClientOption{`
`32`	`32`	`option.WithTokenSource(&internal.MockTokenSource{AccessToken: "test-token"}),`
`33`	`33`	`},`
	`34`	`+ Version: "test-version",`
`34`	`35`	`}`
`35`	`36`
`36`	`37`	`func TestNoProjectID(t *testing.T) {`
`@@ -83,6 +84,10 @@ func TestDeleteInstanceID(t *testing.T) {`
`83`	`84`	`if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {`
`84`	`85`	`t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")`
`85`	`86`	`}`
	`87`	`+ xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)`
	`88`	`+ if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {`
	`89`	`+ t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)`
	`90`	`+ }`
`86`	`91`	`}`
`87`	`92`
`88`	`93`	`func TestDeleteInstanceIDError(t *testing.T) {`
`@@ -156,6 +161,10 @@ func TestDeleteInstanceIDError(t *testing.T) {`
`156`	`161`	`if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {`
`157`	`162`	`t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")`
`158`	`163`	`}`
	`164`	`+ xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)`
	`165`	`+ if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {`
	`166`	`+ t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)`
	`167`	`+ }`
`159`	`168`	`tr = nil`
`160`	`169`	`}`
`161`	`170`	`}`
`@@ -201,6 +210,10 @@ func TestDeleteInstanceIDUnexpectedError(t *testing.T) {`
`201`	`210`	`if h := tr.Header.Get("Authorization"); h != "Bearer test-token" {`
`202`	`211`	`t.Errorf("Authorization = %q; want = %q", h, "Bearer test-token")`
`203`	`212`	`}`
	`213`	`+ xGoogAPIClientHeader := internal.GetMetricsHeader(testIIDConfig.Version)`
	`214`	`+ if h := tr.Header.Get("x-goog-api-client"); h != xGoogAPIClientHeader {`
	`215`	`+ t.Errorf("x-goog-api-client header = %q; want = %q", h, xGoogAPIClientHeader)`
	`216`	`+ }`
`204`	`217`	`}`
`205`	`218`
`206`	`219`	`func TestDeleteInstanceIDConnectionError(t *testing.T) {`
Original file line number	Diff line number	Diff line change
`@@ -50,6 +50,7 @@ type HashConfig map[string]interface{}`
`50`	`50`	`type InstanceIDConfig struct {`
`51`	`51`	`Opts []option.ClientOption`
`52`	`52`	`ProjectID string`
	`53`	`+ Version string`
`53`	`54`	`}`
`54`	`55`
`55`	`56`	`// DatabaseConfig represents the configuration of Firebase Database service.`