feat: [#726] Add HTTP server and client telemetry instrumentation [5]

contracts/binding/binding.go

@@ -369,14 +369,14 @@ var (
 				},
 			},
 		},
-		// Telemetry: {
-		// 	Description: "Provides distributed tracing with OpenTelemetry.",
-		// 	PkgPath:     "github.com/goravel/framework/telemetry",
-		// 	Dependencies: []string{
-		// 		Config,
-		// 		Log,
-		// 	},
-		// },
+		Telemetry: {
+			Description: "Provides distributed tracing with OpenTelemetry.",
+			PkgPath:     "github.com/goravel/framework/telemetry",
+			Dependencies: []string{
+				Config,
+				Log,
+			},
+		},
 		Testing: {
 			Description: "Provides tools for testing your application.",
 			PkgPath:     "github.com/goravel/framework/testing",

contracts/foundation/application.go

@@ -26,6 +26,7 @@ import (
 	"github.com/goravel/framework/contracts/route"
 	"github.com/goravel/framework/contracts/schedule"
 	"github.com/goravel/framework/contracts/session"
+	"github.com/goravel/framework/contracts/telemetry"
 	"github.com/goravel/framework/contracts/testing"
 	"github.com/goravel/framework/contracts/translation"
 	"github.com/goravel/framework/contracts/validation"
@@ -174,7 +175,7 @@ type Application interface {
 	// MakeStorage resolves the storage instance.
 	MakeStorage() filesystem.Storage
 	// MakeTelemetry resolves the telemetry instance.
-	// MakeTelemetry() telemetry.Telemetry
+	MakeTelemetry() telemetry.Telemetry
 	// MakeTesting resolves the testing instance.
 	MakeTesting() testing.Testing
 	// MakeValidation resolves the validation instance.

contracts/telemetry/telemetry.go

@@ -9,6 +9,8 @@ import (
 	oteltrace "go.opentelemetry.io/otel/trace"
 )
 
+type Resolver = func() Telemetry
+
 type Telemetry interface {
 	// Logger returns a log.Logger instance for emitting structured log records under the given instrumentation name.
 	// Optional log.LoggerOption parameters allow customization of logger behavior.

errors/list.go

@@ -241,16 +241,18 @@ var (
 	TemplateFailedToFormatGoCode = New("failed to format go code: %v")
 	TemplateFailedToParse        = New("failed to parse template: %v")
 
-	TelemetryPropagatorRequired     = New("telemetry propagator is required").SetModule(ModuleTelemetry)
-	TelemetryExporterNotFound       = New("telemetry exporter not found").SetModule(ModuleTelemetry)
-	TelemetryUnsupportedDriver      = New("unsupported telemetry exporter driver: %s").SetModule(ModuleTelemetry)
-	TelemetryUnsupportedPropagator  = New("unsupported telemetry propagator: %s").SetModule(ModuleTelemetry)
-	TelemetryZipkinEndpointRequired = New("telemetry zipkin endpoint is required").SetModule(ModuleTelemetry)
-	TelemetryServiceNameRequired    = New("telemetry service name is required").SetModule(ModuleTelemetry)
-	TelemetryViaRequired            = New("custom driver requires a factory function to be provided in the 'via' field").SetModule(ModuleTelemetry)
-	TelemetryMetricViaTypeMismatch  = New("custom metrics driver requires func(context.Context) (sdkmetric.Reader, error), received %s").SetModule(ModuleTelemetry)
-	TelemetryTraceViaTypeMismatch   = New("custom traces driver requires func(context.Context) (sdktrace.SpanExporter, error), received %s").SetModule(ModuleTelemetry)
-	TelemetryLogViaTypeMismatch     = New("custom logger driver requires func(context.Context) (sdklog.Exporter, error), received %s").SetModule(ModuleTelemetry)
+	TelemetryPropagatorRequired             = New("telemetry propagator is required").SetModule(ModuleTelemetry)
+	TelemetryExporterNotFound               = New("telemetry exporter not found").SetModule(ModuleTelemetry)
+	TelemetryUnsupportedDriver              = New("unsupported telemetry exporter driver: %s").SetModule(ModuleTelemetry)
+	TelemetryUnsupportedPropagator          = New("unsupported telemetry propagator: %s").SetModule(ModuleTelemetry)
+	TelemetryZipkinEndpointRequired         = New("telemetry zipkin endpoint is required").SetModule(ModuleTelemetry)
+	TelemetryServiceNameRequired            = New("telemetry service name is required").SetModule(ModuleTelemetry)
+	TelemetryViaRequired                    = New("custom driver requires a factory function to be provided in the 'via' field").SetModule(ModuleTelemetry)
+	TelemetryMetricViaTypeMismatch          = New("custom metrics driver requires func(context.Context) (sdkmetric.Reader, error), received %s").SetModule(ModuleTelemetry)
+	TelemetryTraceViaTypeMismatch           = New("custom traces driver requires func(context.Context) (sdktrace.SpanExporter, error), received %s").SetModule(ModuleTelemetry)
+	TelemetryLogViaTypeMismatch             = New("custom logger driver requires func(context.Context) (sdklog.Exporter, error), received %s").SetModule(ModuleTelemetry)
+	TelemetryGrpcServerStatsHandlerDisabled = New("Facade not initialized. gRPC server stats instrumentation is disabled.").SetModule(ModuleTelemetry)
+	TelemetryGrpcClientStatsHandlerDisabled = New("Facade not initialized. gRPC client stats instrumentation is disabled.").SetModule(ModuleTelemetry)
 
 	TestingImageBuildFailed   = New("init %s docker error: %v")
 	TestingImageNoContainerId = New("no container id return when creating %s docker")

facades/facades.go

@@ -27,6 +27,7 @@ import (
 	"github.com/goravel/framework/contracts/route"
 	"github.com/goravel/framework/contracts/schedule"
 	"github.com/goravel/framework/contracts/session"
+	"github.com/goravel/framework/contracts/telemetry"
 	"github.com/goravel/framework/contracts/testing"
 	"github.com/goravel/framework/contracts/translation"
 	"github.com/goravel/framework/contracts/validation"
@@ -139,9 +140,9 @@ func Storage() filesystem.Storage {
 	return App().MakeStorage()
 }
 
-// func Telemetry() telemetry.Telemetry {
-// 	return App().MakeTelemetry()
-// }
+func Telemetry() telemetry.Telemetry {
+	return App().MakeTelemetry()
+}
 
 func Testing() testing.Testing {
 	return App().MakeTesting()

foundation/application_test.go

@@ -922,7 +922,7 @@ func (s *ApplicationTestSuite) TestStart() {
 				// Only trigger cancel for non-panic cases
 				// For panic cases, the error handling will call cancel automatically
 				go func() {
-					time.Sleep(100 * time.Millisecond) // Wait for goroutines to start
+					time.Sleep(2 * time.Second) // Wait for goroutines to start
 					s.cancel()
 				}()
 

go.mod

@@ -28,29 +28,29 @@ require (
 	github.com/spf13/viper v1.21.0
 	github.com/stretchr/testify v1.11.1
 	github.com/urfave/cli/v3 v3.6.2
-	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.65.0
-	go.opentelemetry.io/contrib/propagators/b3 v1.40.0
+	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.64.0
+	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.64.0
+	go.opentelemetry.io/contrib/propagators/b3 v1.39.0
 	go.opentelemetry.io/otel v1.40.0
 	go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc v0.15.0
-	go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp v0.16.0
-	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc v1.40.0
-	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.40.0
-	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.40.0
-	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.40.0
-	go.opentelemetry.io/otel/exporters/stdout/stdoutlog v0.16.0
-	go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.40.0
-	go.opentelemetry.io/otel/exporters/stdout/stdouttrace v1.40.0
-	go.opentelemetry.io/otel/exporters/zipkin v1.39.0
-	go.opentelemetry.io/otel/log v0.16.0
-	go.opentelemetry.io/otel/log/logtest v0.16.0
+	go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp v0.15.0
+	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc v1.39.0
+	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.39.0
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.39.0
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.39.0
+	go.opentelemetry.io/otel/exporters/stdout/stdoutlog v0.15.0
+	go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.39.0
+	go.opentelemetry.io/otel/exporters/stdout/stdouttrace v1.39.0
+	go.opentelemetry.io/otel/log v0.15.0
+	go.opentelemetry.io/otel/log/logtest v0.15.0
 	go.opentelemetry.io/otel/metric v1.40.0
 	go.opentelemetry.io/otel/sdk v1.40.0
-	go.opentelemetry.io/otel/sdk/log v0.16.0
+	go.opentelemetry.io/otel/sdk/log v0.15.0
 	go.opentelemetry.io/otel/sdk/metric v1.40.0
 	go.opentelemetry.io/otel/trace v1.40.0
 	golang.org/x/crypto v0.48.0
-	golang.org/x/exp v0.0.0-20260212183809-81e46e3db34a
-	google.golang.org/grpc v1.79.1
+	golang.org/x/exp v0.0.0-20260112195511-716be5621a96
+	google.golang.org/grpc v1.78.0
 	google.golang.org/protobuf v1.36.11
 	gorm.io/gorm v1.31.1
 	gorm.io/plugin/dbresolver v1.6.2
@@ -61,6 +61,7 @@ require (
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/chigopher/pathlib v0.19.1 // indirect
 	github.com/clipperhouse/uax29/v2 v2.2.0 // indirect
+	github.com/felixge/httpsnoop v1.0.4 // indirect
 	github.com/go-logr/logr v1.4.3 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/google/go-cmp v0.7.0 // indirect
@@ -72,7 +73,6 @@ require (
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mitchellh/go-homedir v1.1.0 // indirect
 	github.com/mitchellh/mapstructure v1.5.0 // indirect
-	github.com/openzipkin/zipkin-go v0.4.3 // indirect
 	github.com/rs/zerolog v1.33.0 // indirect
 	github.com/samber/slog-common v0.20.0 // indirect
 	github.com/spf13/cobra v1.8.1 // indirect