Add utility to get metrics handler for a Nexus operation (#1559)

This is work done by @pdoerner in #1544 that was lost in the nexus feature branch merge.

Co-authored-by: pdoerner <122412190+pdoerner@users.noreply.github.com>

Author: bergundy

internal/cmd/build/main.go

@@ -265,7 +265,7 @@ func (b *builder) unitTest() error {
 	log.Printf("Running unit tests in dirs: %v", testDirs)
 	for _, testDir := range testDirs {
 		// Run unit test
-		args := []string{"go", "test", "-tags", "protolegacy", "-count", "1", "-race", "-v", "-timeout", "10m"}
+		args := []string{"go", "test", "-tags", "protolegacy", "-count", "1", "-race", "-v", "-timeout", "15m"}
 		if *runFlag != "" {
 			args = append(args, "-run", *runFlag)
 		}

internal/internal_nexus_task_handler.go

@@ -36,6 +36,7 @@ import (
 	"go.temporal.io/api/common/v1"
 	nexuspb "go.temporal.io/api/nexus/v1"
 	"go.temporal.io/api/workflowservice/v1"
+
 	"go.temporal.io/sdk/converter"
 	"go.temporal.io/sdk/internal/common/metrics"
 	"go.temporal.io/sdk/log"
@@ -109,14 +110,19 @@ func (h *nexusTaskHandler) Execute(task *workflowservice.PollNexusTaskQueueRespo
 }
 
 func (h *nexusTaskHandler) execute(task *workflowservice.PollNexusTaskQueueResponse) (*nexuspb.Response, *nexuspb.HandlerError, error) {
+	metricsHandler, handlerErr := h.metricsHandlerForTask(task)
+	if handlerErr != nil {
+		return nil, handlerErr, nil
+	}
 	log, handlerErr := h.loggerForTask(task)
 	if handlerErr != nil {
 		return nil, handlerErr, nil
 	}
 	nctx := &NexusOperationContext{
-		Client:    h.client,
-		TaskQueue: h.taskQueueName,
-		Log:       log,
+		Client:         h.client,
+		TaskQueue:      h.taskQueueName,
+		MetricsHandler: metricsHandler,
+		Log:            log,
 	}
 	header := nexus.Header(task.GetRequest().GetHeader())
 	if header == nil {
@@ -317,6 +323,7 @@ func (h *nexusTaskHandler) loggerForTask(response *workflowservice.PollNexusTask
 	return log.With(h.logger,
 		tagNexusService, service,
 		tagNexusOperation, operation,
+		tagTaskQueue, h.taskQueueName,
 	), nil
 }
 

internal/nexus_operations.go

@@ -34,15 +34,18 @@ import (
 	nexuspb "go.temporal.io/api/nexus/v1"
 	"go.temporal.io/api/operatorservice/v1"
 	"go.temporal.io/api/workflowservice/v1"
+
 	"go.temporal.io/sdk/converter"
+	"go.temporal.io/sdk/internal/common/metrics"
 	"go.temporal.io/sdk/log"
 )
 
 // NexusOperationContext is an internal only struct that holds fields used by the temporalnexus functions.
 type NexusOperationContext struct {
-	Client    Client
-	TaskQueue string
-	Log       log.Logger
+	Client         Client
+	TaskQueue      string
+	MetricsHandler metrics.Handler
+	Log            log.Logger
 }
 
 type nexusOperationContextKeyType struct{}

temporalnexus/operation.go

@@ -44,11 +44,32 @@ import (
 
 	"github.com/nexus-rpc/sdk-go/nexus"
 	"go.temporal.io/api/common/v1"
+
 	"go.temporal.io/sdk/client"
 	"go.temporal.io/sdk/internal"
+	"go.temporal.io/sdk/internal/common/metrics"
+	"go.temporal.io/sdk/log"
 	"go.temporal.io/sdk/workflow"
 )
 
+// GetMetricsHandler returns a metrics handler to be used in a Nexus operation's context.
+func GetMetricsHandler(ctx context.Context) metrics.Handler {
+	nctx, ok := internal.NexusOperationContextFromGoContext(ctx)
+	if !ok {
+		panic("temporalnexus GetMetricsHandler: Not a valid Nexus context")
+	}
+	return nctx.MetricsHandler
+}
+
+// GetLogger returns a logger to be used in a Nexus operation's context.
+func GetLogger(ctx context.Context) log.Logger {
+	nctx, ok := internal.NexusOperationContextFromGoContext(ctx)
+	if !ok {
+		panic("temporalnexus GetLogger: Not a valid Nexus context")
+	}
+	return nctx.Log
+}
+
 type syncOperation[I, O any] struct {
 	nexus.UnimplementedOperation[I, O]
 

test/nexus_test.go

@@ -42,6 +42,7 @@ import (
 	historypb "go.temporal.io/api/history/v1"
 	nexuspb "go.temporal.io/api/nexus/v1"
 	"go.temporal.io/api/operatorservice/v1"
+
 	"go.temporal.io/sdk/client"
 	"go.temporal.io/sdk/internal/common/metrics"
 	ilog "go.temporal.io/sdk/internal/log"
@@ -320,6 +321,11 @@ func TestSyncOperationFromWorkflow(t *testing.T) {
 	tc := newTestContext(t, ctx)
 
 	op := temporalnexus.NewSyncOperation("op", func(ctx context.Context, c client.Client, outcome string, o nexus.StartOperationOptions) (string, error) {
+		require.NotPanicsf(t, func() {
+			temporalnexus.GetMetricsHandler(ctx)
+			temporalnexus.GetLogger(ctx)
+		}, "Failed to get metrics handler or logger from operation context.")
+
 		switch outcome {
 		case "successful":
 			return outcome, nil
@@ -445,6 +451,11 @@ func TestAsyncOperationFromWorkflow(t *testing.T) {
 		}
 	}
 	op := temporalnexus.NewWorkflowRunOperation("op", handlerWorkflow, func(ctx context.Context, action string, soo nexus.StartOperationOptions) (client.StartWorkflowOptions, error) {
+		require.NotPanicsf(t, func() {
+			temporalnexus.GetMetricsHandler(ctx)
+			temporalnexus.GetLogger(ctx)
+		}, "Failed to get metrics handler or logger from operation context.")
+
 		if action == "fail-to-start" {
 			return client.StartWorkflowOptions{}, nexus.HandlerErrorf(nexus.HandlerErrorTypeInternal, "fake internal error")
 		}
@@ -677,6 +688,11 @@ func TestReplay(t *testing.T) {
 
 func TestWorkflowTestSuite_NexusSyncOperation(t *testing.T) {
 	op := nexus.NewSyncOperation("op", func(ctx context.Context, outcome string, opts nexus.StartOperationOptions) (string, error) {
+		require.NotPanicsf(t, func() {
+			temporalnexus.GetMetricsHandler(ctx)
+			temporalnexus.GetLogger(ctx)
+		}, "Failed to get metrics handler or logger from operation context.")
+
 		switch outcome {
 		case "ok":
 			return outcome, nil
@@ -765,6 +781,11 @@ func TestWorkflowTestSuite_WorkflowRunOperation(t *testing.T) {
 		"op",
 		handlerWF,
 		func(ctx context.Context, id string, opts nexus.StartOperationOptions) (client.StartWorkflowOptions, error) {
+			require.NotPanicsf(t, func() {
+				temporalnexus.GetMetricsHandler(ctx)
+				temporalnexus.GetLogger(ctx)
+			}, "Failed to get metrics handler or logger from operation context.")
+
 			return client.StartWorkflowOptions{ID: opts.RequestID}, nil
 		})