---
title: Go pprof scraper
description: Collect profiles from Go programs via the /debug/pprof endpoint
breadcrumbs: Docs > Integrations > Go pprof scraper
---

# Go pprof scraper
Supported OS Integration version1.0.6
## Overview{% #overview %}

This check collects profiles from Go applications which expose the [`/debug/pprof`](https://pkg.go.dev/net/http/pprof) endpoint.

**NOTE**: Prefer instrumenting services with the [dd-trace-go](https://docs.datadoghq.com/profiler/enabling/go.md) profiling client library. The client library offers better integration with other Datadog services, such as through [code hotspots and endpoint filtering](https://docs.datadoghq.com/profiler/connect_traces_and_profiles.md). Use this integration for services for which you do not control the source code.

**NOTE**: Using this integration results in billing for hosts under Datadog's [Continuous Profiler](https://docs.datadoghq.com/profiler.md) service. For more on Continuous Profiler billing, consult our [billing documentation](https://docs.datadoghq.com/account_management/billing/apm_tracing_profiler.md).

## Setup{% #setup %}

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates](https://docs.datadoghq.com/agent/kubernetes/integrations.md) for guidance on applying these instructions.

### Installation{% #installation %}

If you are using an Agent version >= 7.21/6.21, follow the instructions below to install the `go_pprof_scraper` check on your host. See the dedicated Agent guide for [installing community integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations.md?tab=agentv721v621) to install checks with an [Agent version < v7.21/v6.21](https://docs.datadoghq.com/agent/guide/use-community-integrations.md?tab=agentearlierversions) or the [Docker Agent](https://docs.datadoghq.com/agent/guide/use-community-integrations.md?tab=docker):

1. [Download and launch the Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest).

1. Run the following command to install the integrations wheel with the Agent:

   ```shell
   datadog-agent integration install -t datadog-go-pprof-scraper==<INTEGRATION_VERSION>
   ```

You can find the latest version on the [Datadog Integrations Release Page](https://github.com/DataDog/integrations-extras/tags)

**Note**: If necessary, prepend `sudo -u dd-agent` to the install command.

### Configuration{% #configuration %}

1. Edit the `go_pprof_scraper.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your Go performance data. See the [sample go_pprof_scraper.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/go_pprof_scraper/datadog_checks/go_pprof_scraper/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `go_pprof_scraper` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The Go-pprof-scraper integration does not create any metrics.

### Events{% #events %}

The Go-pprof-scraper integration does not include any events.

### Service Checks{% #service-checks %}

The Go-pprof-scraper integration does not include any service checks.

**go\_pprof\_scraper.can\_connect**

Returns `CRITICAL` if the check cannot reach the pprof endpoint or if APM is not enabled, returns `OK` otherwise.

*Statuses: ok, critical*

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).