1. Architecture #
Un opérateur, une ressource.
Composants #
| Mode | Principe | Quand |
|---|---|---|
| cloudNativeFullStack | OneAgent en DaemonSet pour l'hôte + injection dans les pods par webhook | Recommandé : visibilité complète |
| applicationMonitoring | Injection dans les pods seulement, sans agent d'hôte | Clusters gérés sans accès privilégié aux nœuds, ou supervision ciblée |
| hostMonitoring | Supervision des nœuds seulement | Infrastructure sans traces applicatives |
| classicFullStack | Ancien mode DaemonSet complet | Existant, à migrer |
2. Installer #
Helm et DynaKube.
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_TOKEN"apiVersion: dynatrace.com/v1beta3
kind: DynaKube
metadata:
name: dynakube
namespace: dynatrace
spec:
apiUrl: https://<environnement>.live.dynatrace.com/api
oneAgent:
cloudNativeFullStack: {}
activeGate:
capabilities: [kubernetes-monitoring, routing]
replicas: 2À savoir : La version de l'API DynaKube (v1beta3,v1beta4...) dépend de la version de l'Operator : générez le manifeste depuis Deploy Dynatrace > Kubernetes pour partir d'un exemple à jour.
3. Dépanner #
Les bons réflexes.
Commandes #
kubectl -n dynatrace get dynakube # état (Running, Error) et versions
kubectl -n dynatrace get pods
kubectl -n dynatrace exec deploy/dynatrace-operator -- dynatrace-operator troubleshoot
kubectl -n dynatrace exec deploy/dynatrace-operator -- dynatrace-operator support-archive --stdout > archive.zip| Symptôme | Cause fréquente |
|---|---|
| Pods non instrumentés | Namespace exclu par namespaceSelector, pod démarré avant l'Operator (redémarrer le pod) |
| DynaKube en erreur de jeton | Jeton sans les permissions requises ou expiré |
| Nœuds sans OneAgent | Taints non tolérées : ajouter les tolerations dans la DynaKube |
Bonne Pratique : Excluez explicitement les namespaces système et ceux des autres outils d'instrumentation : deux injecteurs dans un même pod donnent des traces dupliquées ou des plantages au démarrage.
