> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/traceable/agent-docs/go.md).

# Go Agent

This section provides comprehensive documentation for the Traceable Go Agent, enabling you to secure and monitor your Go applications with minimal configuration.

## Overview

The Traceable Go Agent provides deep visibility and security for your Go applications by instrumenting your code to monitor API traffic, detect threats, and provide detailed insights into your application's behavior.

## Getting Started

### Prerequisites

* Check the repo's [go.mod](https://github.com/Traceableai/goagent/blob/main/go.mod) for the minimum supported Go version. Since we are dependent on [opentelemetry-go](https://github.com/open-telemetry/opentelemetry-go), it dictates the minimum version.
* OSes supported: all linux OSes including Debian, CentOS, RHEL, Amazon Linux 2 and Alpine.
* Go modules enabled
* Network connectivity to Traceable Platform Agent(TPA)
* Traceable's Go agent is an SDK based Go package. Installing the Go agent requires some code change in the application where you wish to inject the Go agent. Make sure that you have reasonable knowledge of Go language.

## Supported Frameworks

We support the following frameworks in our golang agent.

### Server

* net/http
* gin-gonic/gin
* google.golang.org/grpc
* gorilla/mux

### Client

* net/http
* google.golang.org/grpc
* database/sql
* jackc/pgx

## Installation and Configuration

### [Installation](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Installation.md)

### [Configuration](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Configuration.md)

## Troubleshooting

Troubleshooting guide is available [here](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Troubleshooting.md).

### Common Issues

1. **Agent not capturing traffic**
   * Verify the agent is properly initialized
   * Check network connectivity to Traceable Platform
   * Verify your service name and environment are set correctly
2. **Performance impact**
   * Adjust sampling rate if needed
   * Disable request/response body capture for high-traffic endpoints
   * Monitor memory and CPU usage
3. **Connection issues**
   * Verify network connectivity
   * Check firewall rules
   * Verify TLS configuration

## Quick Links

* [Configuration](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Configuration.md)
* [Installation](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Installation.md)
* [Troubleshooting](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/Troubleshooting.md)
* [Images](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/go/images/README.md)