⚠ This is a work in progress, originally forked from the appoptics-apm-go repository.
ℹ️ Check out the usage examples to see how easy it is to get started. The following code snippets are adapted from the http example.
To use in your Go project:
// Initialize the SolarWinds APM library
cb, err := swo.Start(
// Optionally add service-level resource attributes
semconv.ServiceName("my-service"),
semconv.ServiceVersion("v0.0.1"),
attribute.String("environment", "testing"),
)
if err != nil {
// Handle error
}
// This function returned from `Start()` will tell the apm library to
// shut down, often deferred until the end of `main()`.
defer cb()
Many packages have instrumentation-enabled versions. We provide a simple
wrapper for net/http
server requests. Here's an example:
// Create a new handler to respond to any request with the text it was given
echoHandler := http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
if text, err := io.ReadAll(req.Body); err != nil {
// The `trace` package is from the OpenTelemetry Go SDK. Here we
// retrieve the current span for this request...
span := trace.SpanFromContext(req.Context())
// ...so that we can record the error.
span.RecordError(err)
span.SetStatus(codes.Error, "failed to read body")
w.WriteHeader(http.StatusInternalServerError)
} else {
// If no error, we simply echo back.
_, _ = w.Write(text)
}
})
mux := http.NewServeMux()
// Wrap the route handler with otelhttp instrumentation, adding the route tag
mux.Handle("/echo", otelhttp.WithRouteTag("/echo", echoHandler))
// Wrap the mux (base handler) with our instrumentation
http.ListenAndServe(":8080", swohttp.WrapBaseHandler(mux, "server"))
There are many instrumented libraries available. Here are the libraries we currently support:
- Any of the instrumentation in opentelemetry-go-contrib
- Caveat: For
net/http
servers, it's best to use our wrapper (as seen in the above example) to correctly attribute distributed trace data.
- Caveat: For
- For SQL: XSAM/otelsql
OpenTelemetry provides a registry for these libraries, just note that each is at a different maturity level, as the OpenTelemetry landscape is developing at a rapid pace.
You may also manually instrument your code using the OpenTelemetry SDK and it will be properly propagated to SolarWinds Observability.
The only environment variable you need to set before kicking off is the service key:
Variable Name | Required | Description |
---|---|---|
SW_APM_SERVICE_KEY | Yes | The service key identifies the service being instrumented within your Organization. It should be in the form of <api token>:<service name> . |
We support the same environments as OpenTelemetry-Go.
Copyright (C) 2023 SolarWinds, LLC
Released under Apache License 2.0