App Analytics

Cette page décrit des fonctionnalités obsolètes, dont la configuration repose sur l'ancienne solution App Analytics, qui peuvent s'avérer utiles pour diagnostiquer des problèmes ou modifier d'anciennes configurations. Pour contrôler tous les aspects de vos traces, utilisez plutôt les contrôles d'ingestion et filtres de rétention.

Adopter les nouvelles options de configuration

Accédez à la page de contrôle de l’ingestion pour visualiser les services dont la configuration est obsolète. Ils sont identifiés par le statut Legacy Setup.

Pour adopter les nouvelles options de configuration, supprimez toutes les options de configuration App Analytics des services avec le statut Legacy Setup. Implémentez ensuite l’Agent Datadog et les mécanismes d’échantillonnage des bibliothèques de tracing pour envoyer des traces.

Configuration d’App Analytics

Les options de configuration App Analytics sont accessibles depuis les bibliothèques de tracing et l’Agent Datadog. Les spans d’analyse de vos services dans les bibliothèques sont générées automatiquement ou manuellement.

Dans les bibliothèques de tracing

Configuration automatique

La fonction App Analytics est disponible à partir de la version 1.11.0 du client de tracing Go. Elle peut être activée de façon globale pour toutes les intégrations Web avec :

  • l’option de démarrage du traceur WithAnalytics. Exemple :

    tracer.Start(tracer.WithAnalytics(true))
    
  • la variable d’environnement DD_TRACE_ANALYTICS_ENABLED=true, à partir de la version 1.26.0.

Configurer d’autres services (facultatif)

Configuration par intégration

En plus du paramètre global, vous pouvez activer ou désactiver la fonction App Analytics pour chaque intégration. Par exemple, pour configurer le paquet net/http de la bibliothèque standard, vous pouvez procéder ainsi :

package main

import (
    httptrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
    tracer.Start()
    defer tracer.Stop()

    mux := httptrace.NewServeMux(httptrace.WithAnalytics(true))
    // ...
}

Services de base de données

Par défaut, le tracing de base de données n’est pas pris en charge par la fonction App Analytics. Vous devez activer la collecte manuellement pour chaque intégration. Par exemple :

// Enregistrer le pilote de base de données avec la fonction Analytics activée.
sqltrace.Register("mysql", &mysql.MySQLDriver{}, sqltrace.WithAnalytics(true))
Instrumentation personnalisée

Pour les instrumentations personnalisées, un tag spécial a été ajouté pour activer la fonction App Analytics sur une span, comme ci-dessous :

span.SetTag(ext.AnalyticsEvent, true)

Ce tag permet de définir la span comme un événement App Analytics.

Dans l’Agent Datadog

Cette section décrit des fonctionnalités obsolètes, dont la configuration repose sur l'ancienne solution App Analytics.

Pour configurer un taux de spans à analyser par service, définissez ce qui suit dans le fichier datadog.yaml :

apm_config:
  analyzed_rate_by_service:
    service_A: 1
    service_B: 0.2
    service_C: 0.05

Pour configurer un taux de spans à analyser par service et par nom d’opération, définissez ce qui suit dans le fichier datadog.yaml :

apm_config:
  analyzed_spans:
    service_A|operation_name_X: 1
    service_A|operation_name_Y: 0.25
    service_B|operation_name_Z: 0.01

Dépannage : limite du nombre d’événements par seconde

Si le message d’erreur suivant apparaît dans vos logs de l’Agent, cela signifie que vos applications génèrent plus de 200 événements de trace par seconde, soit la limite autorisée par défaut par l’APM.

Max events per second reached (current=300.00/s, max=200.00/s). Some events are now being dropped (sample rate=0.54). Consider adjusting event sampling rates.

Pour augmenter la limite de débit de l’APM pour l’Agent, configurez l’attribut max_events_per_second dans le fichier de configuration de l’Agent (sous la section apm_config:). Pour les déploiements conteneurisés (tels que Docker ou Kubernetes), utilisez la variable d’environnement DD_APM_MAX_EPS.

Remarque : l’augmentation de la limite de débit de l’APM pourrait entraîner une augmentation des coûts de la fonction App Analytics.

PREVIEWING: watson/nodejs-docs-update