BranchesTags

Repository files navigation

WhaTap Go API Instrumentation Examples

This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.

Quick Start

All examples follow a common instrumentation pattern:

  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup

Supported Libraries

Web Frameworks

LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper

Note: In addition to middleware patterns, Wrap functions are available for struct field initialization: WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla), WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)

Databases

LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()

Cache & NoSQL

LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()

Message Queues

LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors

HTTP Client

LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()

Cloud & RPC

LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()

Logging

LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()

LLM monitoring

For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):

ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)

For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):

SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)

All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.

Key Features

  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting

Running Examples

Each example can be run with:

cd<example-directory>
go run *.go -whatap

Related Links

About

go-api-example

Resources

Readme
Activity
Custom properties

Stars

2 stars

Watchers

2 watching

Forks

2 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
WhaTap Go API Instrumentation Examples
This repository contains example code demonstrating how to instrument Go applications using the WhaTap Go API.
Quick Start
All examples follow a common instrumentation pattern:
  1. Initialize - Call trace.Init(nil) at application startup
  2. Add Middleware - Add WhaTap middleware to your web framework
  3. Use Context - Pass context to track SQL, HTTP calls, and custom methods
  4. Shutdown - Call defer trace.Shutdown() for graceful cleanup
Supported Libraries
Web Frameworks
LibraryExampleMiddleware Pattern
Gingithub.com/gin-gonic/gin/r.Use(whatapgin.Middleware())
Echo v4github.com/labstack/echo/v4/e.Use(whatapecho.Middleware())
Echo v3github.com/labstack/echo/e.Use(whatapecho.Middleware())
Fiber v2github.com/gofiber/fiber/app.Use(whatapfiber.Middleware())
Chigithub.com/go-chi/chi/r.Use(whatapchi.Middleware) (no parentheses)
Gorilla Muxgithub.com/gorilla/mux/r.Use(whatapmux.Middleware())
FastHTTPgithub.com/valyala/fasthttp/whatapfasthttp.Func(handler) wrapper
net/httpnet/http/server/whataphttp.Func()/WrapHandler() wrapper
Note: In addition to middleware patterns, Wrap functions are available for struct field initialization:
WrapEngine() (Gin), WrapEcho() (Echo), WrapApp() (Fiber), WrapRouter() (Chi/Gorilla),
WrapHandler() (net/http, FastHTTP), WrapConfig() (Sarama), WrapLogger() (logrus)
Databases
LibraryExampleInstrumentation
database/sqldatabase/sql/whatapsql.OpenContext() or manual Start/End
GORM v2github.com/go-gorm/gorm/whatapgorm.OpenWithContext()
GORM v1 (jinzhu)github.com/jinzhu/gorm/whatapgorm.Open()
sqlxgithub.com/jmoiron/sqlx/whatapsqlx.OpenContext()
Cache & NoSQL
LibraryExampleInstrumentation
go-redis v9github.com/redis/go-redis/v9/whatapgoredis.NewClient()
go-redis v8github.com/go-redis/redis/v8/whatapgoredis.NewClient()
Redigogithub.com/gomodule/redigo/whatapredigo.DialContext()
MongoDBgo.mongodb.org/mongo-driver/mongo/whatapmongo.Connect()
Message Queues
LibraryExampleInstrumentation
IBM/sarama (Kafka)github.com/IBM/sarama/Producer/Consumer interceptors
Shopify/sarama (Kafka)github.com/Shopify/sarama/Producer/Consumer interceptors
HTTP Client
LibraryExampleInstrumentation
net/http clientnet/http/client/httpc.Start/End or whataphttp.NewRoundTrip()
Cloud & RPC
LibraryExampleInstrumentation
gRPCgoogle.golang.org/grpc/whatapgrpc interceptors
Kubernetes client-gok8s.io/client-go/kubernetes/whatapkubernetes.NewForConfig()
Logging
LibraryExampleInstrumentation
fmtfmt/whatapfmt.Print/Printf/Println()
LLM monitoring
For an LLM API without a dedicated adapter (custom HTTP endpoint, in-house gateway), use the manual llm.Start API (base go-api, no nested module):
ExamplePathInstrumentation
llm (manual API)llm/llm.Start(ctx, llm.Config{...}) + whataphttp.NewRoundTrip (any HTTP client)
For supported SDKs, use the adapters (in the github.com/whatap/go-api/instrumentation/llm nested module, Go 1.23+):
SDKExampleInstrumentation
sashabaranov/go-openaigithub.com/sashabaranov/go-openai/whatapopenai.WrapClient() (client-level decorator)
anthropics/anthropic-sdk-gogithub.com/anthropics/anthropic-sdk-go/whatapanthropic.WrapAndNewMessage(ctx, client.Messages, params) (service-level)
openai/openai-go (official)github.com/openai/openai-go/whatapopenaigo.WrapAndNewChatCompletion(ctx, client.Chat.Completions, params) (3-step selector)
cloudwego/einogithub.com/cloudwego/eino/whatapeino.WrapChatModel(inner) (ChatModel decorator)
All LLM adapters capture token counts (prompt/completion/total), finish reason, response content, streaming TTFT, and the real endpoint URL (via whataphttp.NewRoundTrip on the SDK's HTTP transport). Auto-inject (whatap-go-inst go build) handles all the wrapping automatically.
Key Features
  • Automatic HTTP transaction tracking - Request/Response details
  • SQL query tracking - Query text, parameters, execution time
  • HTTP client call tracking - Outgoing HTTP calls with httpc.Start/End
  • Custom method tracing - Track any function with method.Start/End
  • Distributed tracing - Multi-transaction trace via trace.GetMTrace(ctx)
  • Error tracking - Automatic error capture and reporting
Running Examples
Each example can be run with:
cd<example-directory>
go run *.go -whatap
Related Links
About
go-api-example
Resources
Readme
Activity
Custom properties
Stars
2 stars
Watchers
2 watching
Forks
2 forks
Report repository
Releases
Packages
Used by
Contributors
Languages