--- title: Single Step Instrumentation for Backend Error Tracking description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: >- Docs > Error Tracking > Backend Error Tracking > Getting Started > Single Step Instrumentation for Backend Error Tracking --- # Single Step Instrumentation for Backend Error Tracking ## Overview{% #overview %} Install or update a Datadog Agent with the **Enable APM Instrumentation** and **Error Tracking Standalone** options to enable standalone Backend Error Tracking. This allows you to automatically instrument your application, without any additional installation or configuration steps. ## Install standalone Backend Error Tracking{% #install-standalone-backend-error-tracking %} The following examples show how it works for each deployment type. {% tab title="Linux host or VM" %} For a Linux host: 1. Run the one-line installation command: ```shell DD_API_KEY= DD_SITE="" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2,js:5,dotnet:3,php:1" DD_APM_ERROR_TRACKING_STANDALONE=true DD_ENV= bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)" ``` Replace `` with your [Datadog API key](https://app.datadoghq.com/organization-settings/api-keys), `` with your [Datadog site](https://docs.datadoghq.com/getting_started/site/), and `` with the environment your Agent is installed on (for example, `staging`). 1. Restart the services on the host or VM. {% /tab %} {% tab title="Kubernetes" %} You can enable Backend Error Tracking by installing the Agent with either: - Datadog Operator - Datadog Helm chart {% alert level="info" %} Single Step Instrumentation doesn't instrument applications in the namespace where you install the Datadog Agent. It's recommended to install the Agent in a separate namespace in your cluster where you don't run your applications. {% /alert %} ### Requirements{% #requirements %} - Kubernetes v1.20+ - [Helm](https://v3.helm.sh/docs/intro/install/) for deploying the Datadog Operator. - [Kubectl CLI](https://kubernetes.io/docs/tasks/tools/install-kubectl/) for installing the Datadog Agent. {% collapsible-section %} #### Installing with Datadog Operator Follow these steps to enable Single Step Instrumentation across your entire cluster using the Datadog Operator. This enables tracing for all applications written in supported languages. 1. Install the [Datadog Operator](https://github.com/DataDog/helm-charts/tree/master/charts/datadog-operator) v1.14.0+ with Helm: ```shell helm repo add datadog https://helm.datadoghq.com helm repo update helm install my-datadog-operator datadog/datadog-operator ``` 1. Create a Kubernetes secret to store your Datadog [API key](https://app.datadoghq.com/organization-settings/api-keys): ```shell kubectl create secret generic datadog-secret --from-literal api-key= ``` 1. Create `datadog-agent.yaml` with the spec of your Datadog Agent deployment configuration. The simplest configuration is as follows: ```yaml apiVersion: datadoghq.com/v2alpha1 kind: DatadogAgent metadata: name: datadog spec: global: site: tags: - env: credentials: apiSecret: secretName: datadog-secret keyName: api-key env: - name: DD_CORE_AGENT_ENABLED value: "false" features: apm: errorTrackingStandalone: enabled: true instrumentation: enabled: true libVersions: java: "1" dotnet: "3" python: "2" js: "5" php: "1" ``` Replace `` with your [Datadog site](https://docs.datadoghq.com/getting_started/site/) and `` with the environment your Agent is installed on (for example, `env:staging`). 1. Run the following command: ```shell kubectl apply -f /path/to/your/datadog-agent.yaml ``` 1. Wait a few minutes for the Datadog Cluster Agent changes to apply, then restart your applications. {% /collapsible-section %} {% collapsible-section %} #### Installing with Helm Follow these steps to enable Single Step Instrumentation across your entire cluster using Helm. This enables tracing for all applications written in supported languages. 1. Add the Helm Datadog repo: ```shell helm repo add datadog https://helm.datadoghq.com helm repo update ``` 1. Create a Kubernetes secret to store your Datadog [API key](https://app.datadoghq.com/organization-settings/api-keys): ```shell kubectl create secret generic datadog-secret --from-literal api-key= ``` 1. Create `datadog-values.yaml` and add the following configuration: ```yaml agents: containers: agent: env: - name: DD_CORE_AGENT_ENABLED value: "false" datadog: processAgent: enabled: false containerCollection: false apiKeyExistingSecret: datadog-secret site: tags: - env: apm: errorTrackingStandalone: enabled: true # Required to enable Single-Step Instrumentation instrumentation: enabled: true libVersions: java: "1" dotnet: "3" python: "2" js: "5" php: "1" ``` Replace `` with your [Datadog site](https://docs.datadoghq.com/getting_started/site/) and `` with the environment your Agent is installed on (for example, `env:staging`). 1. Run the following command to deploy the agent: ```shell helm install datadog-agent -f datadog-values.yaml datadog/datadog ``` 1. Wait a few minutes for the Datadog Cluster Agent changes to apply, then restart your applications. {% /collapsible-section %} {% /tab %} ## Further Reading{% #further-reading %} - [Error Tracking Issue States and Workflows](https://docs.datadoghq.com/error_tracking/issue_states/) - [Learn about the Error Tracking Explorer](https://docs.datadoghq.com/error_tracking/explorer) - [Enable infrastructure monitoring](https://docs.datadoghq.com/error_tracking/guides/enable_infra) - [Enable APM](https://docs.datadoghq.com/error_tracking/guides/enable_apm)