Requisito

Installare OpenTelemetry Operator nel cluster K8s.

Sono disponibili tre diverse opzioni tra cui scegliere: Grafico timbro operatore, File manifesto di rilascio operatore o Hub operatore.

Nella maggior parte dei casi, è necessario installare un cert-manager. Se si utilizza l'opzione del grafico helm, è possibile generare un certificato con firma automatica.

Opzione 1: grafico helm operatore

Questa opzione consente di utilizzare il grafico helm per installare l'operatore OpenTelemetry.

1. Aggiungere il repository del grafico helm.

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

2. Crea lo spazio di nomi Kubernetes per l'operatore OpenTelemetry.

   kubectl create namespace opentelemetry-operator-system

3. Installare l'operatore 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

Opzione 2: file manifesto di rilascio dell'operatore

Questa opzione consente di utilizzare i file YAML per installare l'operatore 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

Distribuisci agente Dotnet APM

Per distribuire l'agente Dotnet APM, effettuare le operazioni riportate di seguito.

1. Crea una risorsa personalizzata (CR) Kubernetes.

   Per gestire la strumentazione automatica, è necessario che all'operatore OpenTelemetry vengano fornite informazioni sull'agente Dotnet APM e sulla relativa configurazione che viene eseguita utilizzando la definizione di risorse personalizzate (CRD).

   Questa risorsa personalizzata verrà utilizzata dall'operatore per copiare l'agente nel pod e aggiungervi la configurazione richiesta.

   Eseguire il comando seguente per creare la CR sul 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

   Where:

   • <data-upload-endpoint> è l'URL dell'endpoint di caricamento dati generato quando viene creato il dominio APM. Per informazioni, vedere Ottenere l'endpoint di caricamento dati e le chiavi dati.
   • <private-data-key> è la chiave dati privata di installazione dell'agente Dotnet APM generata quando viene creato il dominio APM. Per informazioni, vedere Ottenere l'endpoint di caricamento dati e le chiavi dati.
   È possibile eseguire la query sulla CR creata eseguendo il seguente comando:

   kubectl get otelinst -n opentelemetry-operator-system

   Tutti gli endpoint e le variabili di ambiente devono essere corretti affinché la strumentazione automatica funzioni correttamente.
2. Aggiungere l'annotazione Kubernetes.

   L'operatore OpenTelemetry utilizza l'annotazione Kubernetes per decidere quali pod devono essere iniettati automaticamente con l'agente Dotnet APM.

   L'annotazione può essere aggiunta a uno spazio di nomi. In tal caso, tutti i pod all'interno di tale spazio di nomi verranno iniettati. L'annotazione può essere aggiunta anche a singoli oggetti PodSpec, disponibili come parte di Distribuzione, Statefulset e altre risorse.

   Annotazione per x64 glibc:

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

   Annotazione per x64 musl:

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

   Per iniziare a modificare lo spazio di nomi, effettuare le operazioni riportate di seguito.

   • Eseguire il comando:

     kubectl edit namespace <your-namespace-name>

   • Dopo aver eseguito il comando precedente, modificare lo spazio dei nomi una volta aperto l'editor. Ad esempio, utilizzare l'editor vi.
   • Aggiungere l'annotazione allo spazio di nomi. Tenere presente che il rientro è molto importante per renderlo un file YAML valido.
   Di seguito è riportato un esempio di spazio di nomi con l'annotazione aggiunta.

   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. Riavviare il pod Kubernetes.

   Per riavviare il pod in cui si desidera inserire automaticamente l'agente Dotnet APM, eseguire le operazioni riportate di seguito.

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

4. Verificare il pod Kubernetes.
   Per verificare che il pod sia stato iniettato automaticamente con l'agente APM Dotnet dopo il riavvio, eseguire le operazioni riportate di seguito.

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

È ora possibile passare al passo successivo: Verifica distribuzione agente Dotnet APM.