Single Step Instrumentation for Backend Error Tracking

Docs > Error Tracking > Backend Error Tracking > Getting Started > Single Step Instrumentation for Backend Error Tracking

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

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

The following examples show how it works for each deployment type.

For a Linux host:

Run the one-line installation command:

DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_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=<AGENT_ENV> bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Replace <YOUR_DD_API_KEY> with your Datadog API key, <YOUR_DD_SITE> with your Datadog site, and <AGENT_ENV> with the environment your Agent is installed on (for example, staging).

Restart the services on the host or VM.

You can enable Backend Error Tracking by installing the Agent with either:

Datadog Operator
Datadog Helm chart

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.

Requirements

Kubernetes v1.20+
Helm for deploying the Datadog Operator.
Kubectl CLI for installing the Datadog Agent.

Installing with Datadog Operator

Coming soon

Installing with Helm

Follow these steps to enable Single Step Instrumentation across your entire cluster with Helm. This automatically sends errors for all applications in the cluster that are written in supported languages.

To enable Single Step Instrumentation with Helm:

Add the Helm Datadog repo:

 helm repo add datadog https://helm.datadoghq.com
 helm repo update

Create a Kubernetes secret to store your Datadog API key:

kubectl create secret generic datadog-secret --from-literal api-key=<YOUR_DD_API_KEY>

Create datadog-values.yaml and add the following configuration:

agents:
  containers:
    agent:
      env:
        - name: DD_CORE_AGENT_ENABLED
          value: "false"
datadog:
  processAgent:
    enabled: false
    containerCollection: false
  apiKeyExistingSecret: datadog-secret
  site: <DATADOG_SITE>
  tags:
    - env:<AGENT_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 <DATADOG_SITE> with your Datadog site and <AGENT_ENV> with the environment your Agent is installed on (for example, env:staging).

Run the following command to deploy the agent:

helm install datadog-agent -f datadog-values.yaml datadog/datadog

After waiting a few minutes for the Datadog Cluster Agent changes to apply, restart your applications.