Go installation instructions

Use the installation instructions below if you're installing Helios in a standard Go service.

The first step when instrumenting your Go service is to configure a trace provider, so that traces are sent to the Helios backend.

Since instrumentation in Go cannot be done automatically, you have to manually create and set a tracer provider that creates spans containing the token provided by Helios, and sends these spans to the Helios collector.

Start by installing the OpenTelemetry dependencies.

From your project's root directory run:

go get github.com/helios/go-sdk

Now you can define the trace provider by using:

import (
    "github.com/helios/go-sdk/sdk"
)

sdk.Initialize("your-service-name-goes-here","YOUR HELIOS TOKEN GOES HERE", sdk.WithEnvironment("your-env-name-goes-here"));

The instrumentation will take place at build time. Before running go build, run the helios-instrumentor executable (Linux / macOS (ARM) / macOS (x86) / Windows) inside your project root folder. Make sure to update the executable's permissions with: chmod a+x <FILE_PATH>, then use: ./helios-instrumentor go get & go build.

๐Ÿ‘

All set

After setup is complete and once the service is up and running, it will show up in the Helios application.