1. Les méthodes de collecte #
OneAgent n'est pas la seule porte d'entrée.
Panorama #
| Méthode | Usage |
|---|---|
| OneAgent | Instrumentation automatique complète (hôte, processus, traces, logs) |
| OpenTelemetry (OTLP) | Applications déjà instrumentées, langages non couverts |
| Prometheus | Métriques d'exporters, via ActiveGate ou Kubernetes |
| Extensions | Bases de données, réseau, SNMP, JMX |
| API d'ingestion | Métriques, logs, événements, données métier |
Voir aussi l'article « OpenTelemetry vs Dynatrace OneAgent » pour comparer les deux approches.
2. Installer OneAgent #
Linux en exemple.
Commandes #
# Jeton avec la permission « PaaS integration - Installer download »
wget -O Dynatrace-OneAgent-Linux.sh \
"https://abc12345.live.dynatrace.com/api/v1/deployment/installer/agent/unix/default/latest?arch=x86" \
--header="Authorization: Api-Token $DT_PAAS_TOKEN"
sudo /bin/sh Dynatrace-OneAgent-Linux.sh \
--set-monitoring-mode=fullstack \
--set-app-log-content-access=true \
--set-host-group=prod_web \
--set-host-tag=env=prod \
--set-host-property=team=boutique| Option | Rôle |
|---|---|
| Mode Full-Stack | Hôte, processus, services, traces : supervision complète |
| Mode Infrastructure | Hôte et processus seulement, moins coûteux |
| Groupe d'hôtes (host group) | Regroupe des hôtes qui partagent la même configuration ; détermine les groupes de processus |
| Tags et propriétés | Métadonnées pour filtrer, router les alertes, définir les propriétaires |
Erreur Courante : Le groupe d'hôtes influence le découpage des groupes de processus et des services : choisissez une convention (par exemple env_application) avant de déployer en masse, car le changer plus tard recrée des entités.Reconfigurer sans réinstaller #
ONEAGENTCTL=/opt/dynatrace/oneagent/agent/tools/oneagentctl
sudo $ONEAGENTCTL --get-host-group
sudo $ONEAGENTCTL --set-host-group=prod_web --restart-service
sudo $ONEAGENTCTL --set-host-tag=equipe=paiement
sudo $ONEAGENTCTL --set-host-property=dt.owner=team-paiementLe détail des options de oneagentctl est dans l'article « Dynatrace OneAgent : tags, props, vars CLI ».
3. Docker et Kubernetes #
Le Dynatrace Operator.
Installation #
helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
--create-namespace --namespace dynatrace --atomic
kubectl -n dynatrace create secret generic dynakube \
--from-literal=apiToken=$DT_OPERATOR_TOKEN --from-literal=dataIngestToken=$DT_INGEST_TOKENapiVersion: dynatrace.com/v1beta3 # la version de l'API dépend de celle de l'opérateur
kind: DynaKube
metadata:
name: dynakube
namespace: dynatrace
spec:
apiUrl: https://abc12345.live.dynatrace.com/api
metadataEnrichment: { enabled: true }
oneAgent:
cloudNativeFullStack: {} # injection dans les pods + supervision des nœuds
activeGate:
capabilities: [routing, kubernetes-monitoring, dynatrace-api]| Mode | Principe |
|---|---|
| cloudNativeFullStack | Supervision des nœuds et injection de l'instrumentation dans les pods (recommandé) |
| applicationMonitoring | Injection dans les pods seulement, sans supervision des nœuds |
| hostMonitoring | Nœuds seulement |
| classicFullStack | Ancien mode, OneAgent en DaemonSet |
Bonne Pratique : Pour Docker hors Kubernetes, installez OneAgent sur l'hôte : il instrumente automatiquement les processus des conteneurs.
4. Santé du OneAgent #
Vérifier que la collecte fonctionne.
Contrôles #
- Page Deployment status (ou application Infrastructure & Operations) : version, mode, dernière connexion de chaque agent.
- Processus marqués « redémarrage requis » : l'instrumentation complète n'est active qu'après le redémarrage du processus.
- Versions obsolètes : configurez la mise à jour automatique ou des fenêtres de mise à jour.
- Journaux de l'agent :
/var/log/dynatrace/oneagent/.
sudo systemctl status oneagent
sudo $ONEAGENTCTL --get-server --get-tenant