Skip to main content

Go Net/HTTP

Prerequisites​

Installation​

  1. Install dependencies:

    go get go.elastic.co/apm/v2 \
     go.elastic.co/apm/module/apmhttp/v2

  2. Add the highlighted lines below to your project's main.go file:

    package main

    import "go.elastic.co/apm/module/apmhttp/v2"
    import "go.elastic.co/apm/v2"

    func main() {
     
         srv := &http.Server{
     	    Addr:         ":8000",
     	    BaseContext:  func(_ net.Listener) context.Context { return ctx },
     	    ReadTimeout:  time.Second,
     	    WriteTimeout: 10 * time.Second,
     	    Handler:      apmhttp.Wrap(newHTTPHandler()),
         } 
    }
    info

    For more information, refer to the Elastic APM Go agent.

  3. Configure the agent.

    ELASTIC_APM_SERVICE_NAME=<app_name>
    # send traces to CubeAPM
    ELASTIC_APM_SERVER_URL=http://<ip_address_of_cubeapm_server>:3130
    # optional settings
    ELASTIC_APM_ENVIRONMENT=myenv
    ELASTIC_APM_SERVICE_VERSION=1.2.3
    ELASTIC_APM_GLOBAL_LABELS=mykey1=myvalue1,mykey2=myvalue2

Sample Application​

A working example is available at https://github.com/cubeapm/sample_app_go_net_http/tree/elastic.

Troubleshooting​

The following can be used for debugging:

# Print Elastic agent logs on screen
ELASTIC_APM_LOG_FILE=stdout
# Set Elastic agent log level to debug if needed to see detailed logs
ELASTIC_APM_LOG_LEVEL=debug