Prérequis

Installez l'opérateur OpenTelemetry dans le cluster K8s.

Vous avez le choix entre trois options différentes : Graphique de barre d'opérateur, Manifeste de version d'opérateur ou Hub d'opérateur.

Dans la plupart des cas, un cert-manager doit être installé. Si l'option de dossier helm est utilisée, il existe une option permettant de générer un certificat autosigné à la place.

Option 1 : Graphique de barre d'opérateur

Cette option permet d'utiliser le graphique helm pour installer l'opérateur OpenTelemetry.

1. Ajoutez un référentiel de graphiques helm.

   helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
   helm repo update

2. Créez un espace de noms Kubernetes pour l'opérateur OpenTelemetry.

   kubectl create namespace opentelemetry-operator-system

3. Installez l'opérateur OpenTelemetry.

   helm install opentelemetry-operator open-telemetry/opentelemetry-operator \
   --namespace opentelemetry-operator-system \
   --set "manager.collectorImage.repository=otel/opentelemetry-collector-k8s"\
   --set admissionWebhooks.certManager.enabled=false\
   --set admissionWebhooks.autoGenerateCert.enabled=true

Option 2 : Manifeste de version de l'opérateur

Cette option permet d'utiliser des fichiers YAML pour installer l'opérateur OpenTelemetry.

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.1/cert-manager.yaml

kubectl apply -f https://github.com/open-telemetry/opentelemetry-operator/releases/latest/download/opentelemetry-operator.yaml

Déploiement de l'agent .NET APM

Pour déployer l'agent Dotnet APM, procédez comme suit :

1. Créez une ressource personnalisée Kubernetes.

   Pour gérer l'instrumentation automatique, l'opérateur OpenTelemetry doit recevoir des informations sur l'agent Dotnet APM et sa configuration, à l'aide de la définition de ressource personnalisée (CRD).

   Cette ressource personnalisée sera utilisée par l'opérateur pour copier l'agent dans le pod et lui ajouter la configuration requise.

   Exécutez la commande suivante pour créer la demande de modification sur votre cluster Kubernetes :

   kubectl apply -f - <<EOF
   apiVersion: opentelemetry.io/v1alpha1
   kind: Instrumentation
   metadata:
     name: inst-apm-dotnet
     namespace: opentelemetry-operator-system
   spec:
     dotnet:
       image: us-ashburn-1.ocir.io/idpyjkbcc9tk/apm-net-agent:latest
       env:
         - name: OTEL_EXPORTER_OTLP_ENDPOINT
           value: <data-upload-endpoint>/20200101/opentelemetry
         - name: OTEL_EXPORTER_OTLP_HEADERS
           value: "Authorization=dataKey <private-data-key>"
         - name: OTEL_LOGS_EXPORTER
           value: "none"
         - name: OTEL_DOTNET_AUTO_TRACES_ADDITIONAL_SOURCES
           value: "OpenTelemetry.ODP"
   EOF

   Où :

   • <data-upload-endpoint> est l'URL d'adresse de téléchargement de données générée lors de la création du domaine APM. Pour plus d'informations, reportez-vous à Obtention de l'adresse de téléchargement de données et des clés de données.
   • <private-data-key> est la clé de données privée d'installation de l'agent Dotnet APM qui est générée lors de la création du domaine APM. Pour plus d'informations, reportez-vous à Obtention de l'adresse de téléchargement de données et des clés de données.
   Vous pouvez interroger le CR créé en exécutant la commande suivante :

   kubectl get otelinst -n opentelemetry-operator-system

   Toutes les adresses et variables d'environnement doivent être correctes pour que l'instrumentation automatique fonctionne correctement.
2. Ajoutez l'annotation Kubernetes.

   L'opérateur OpenTelemetry utilise l'annotation Kubernetes pour décider quels pods doivent être auto-injectés avec l'agent Dotnet APM.

   L'annotation peut être ajoutée à un espace de noms. Dans ce cas, tous les pods de cet espace de noms seront injectés. L'annotation peut également être ajoutée à des objets PodSpec individuels, disponibles dans le cadre du déploiement, de Statefulset et d'autres ressources.

   Annotation pour x64 glibc :

   annotations:
     instrumentation.opentelemetry.io/inject-dotnet: opentelemetry-operator-system/inst-apm-dotnet

   Annotation pour x64 musl :

   annotations:
     instrumentation.opentelemetry.io/inject-dotnet: opentelemetry-operator-system/inst-apm-dotnet
     instrumentation.opentelemetry.io/otel-dotnet-auto-runtime: linux-musl-x64

   Pour commencer à modifier votre espace de noms, procédez comme suit :

   • Exécutez la commande :

     kubectl edit namespace <your-namespace-name>

   • Après avoir exécuté la commande ci-dessus, modifiez l'espace de noms une fois l'éditeur ouvert. Par exemple, à l'aide de l'éditeur vi.
   • Ajoutez l'annotation à l'espace de noms. Gardez à l'esprit que l'indentation est très importante pour en faire un fichier YAML valide.
   Voici un exemple d'espace de noms avec l'annotation ajoutée :

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       kubernetes.io/metadata.name: mynamespace
     annotations:
       instrumentation.opentelemetry.io/inject-dotnet: "opentelemetry-operator-system/inst-apm-dotnet"
     name: mynamespace
   spec:

3. Redémarrez le pod Kubernetes.

   Pour redémarrer le pod dans lequel vous souhaitez injecter automatiquement l'agent Dotnet APM, exécutez la commande suivante :

   kubectl delete pod <your-pod-name> -n <your-namespace-name>

4. Vérifiez le pod Kubernetes.
   Pour vérifier que votre pod a été automatiquement injecté avec l'agent Dotnet APM après son redémarrage, exécutez la commande suivante :

   kubectl get pod <your-pod-name> -n <your-namespace-name> -o yaml

Vous pouvez maintenant passer à l'étape suivante : Vérifier le déploiement de l'agent Dotnet APM.