Conditions requises

Installez l'opérateur OpenTelemetry dans la grappe K8s.

Trois options différentes sont disponibles : Graphique d'aide de l'opérateur, Manifeste de version de l'opérateur ou Centre d'exploitation.

Dans la plupart des cas, un gestionnaire de certificats doit être installé. Si l'option de graphique de barre est utilisée, il existe une option pour générer un certificat auto-signé à la place.

Option 1 : Graphique d'aide de l'opérateur

Cette option consiste à utiliser le graphique d'aide pour installer l'opérateur OpenTelemetry.

1. Ajouter un référentiel de graphiques d'aide.

   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 lancement d'opérateur

Cette option consiste à 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éployer l'agent Dotnet APM

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

1. Créer une ressource personnalisée Kubernetes (CR).

   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 le CR sur votre grappe 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 du point d'extrémité de chargement des données générée lors de la création du domaine APM. Pour plus d'informations, voir Obtenir un point d'extrémité de 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, voir Obtenir un point d'extrémité de chargement de données et des clés de données.
   Le CR créé peut être interrogé en exécutant la commande suivante :

   kubectl get otelinst -n opentelemetry-operator-system

   Tous les points d'extrémité et variables d'environnement doivent être corrects 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 injectés automatiquement 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 de la façon suivante :

   • Exécutez la commande suivante :

     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.
   Voir ci-dessous 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 les opérations suivantes :

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

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

   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.