Requisito

Instale OpenTelemetry Operator en el cluster K8s.

Hay tres opciones diferentes disponibles para elegir: Gráfico de cascos de operador, Manifiesto de versión de operador o Hub de operador.

En la mayoría de los casos, se debe instalar un cert-manager. Si se utiliza la opción de gráfico de timón, hay una opción para generar un certificado autofirmado en su lugar.

Opción 1: Gráfico de cascos de operador

Esta opción es utilizar el gráfico de timón para instalar el operador OpenTelemetry.

1. Agregar repositorio de gráfico de timón.

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

2. Cree el espacio de nombres de Kubernetes para el operador OpenTelemetry.

   kubectl create namespace opentelemetry-operator-system

3. Instale el operador 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

Opción 2: Operator release manifest

Esta opción es utilizar archivos YAML para instalar el operador 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

Despliegue del agente Dotnet de APM

Para desplegar el agente Dotnet de APM, siga estos pasos:

1. Crear un recurso personalizado (CR) de Kubernetes.

   Para gestionar la instrumentación automática, se debe proporcionar al operador OpenTelemetry información sobre el agente Dotnet de APM y su configuración, que se realiza mediante la definición de recursos personalizada (CRD).

   El operador utilizará este recurso personalizado para copiar el agente en el pod y agregarle la configuración necesaria.

   Ejecute el siguiente comando para crear la CR en el cluster de 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

   Donde:

   • <data-upload-endpoint> es la URL de punto final de carga de datos que se genera cuando se crea el dominio de APM. Para obtener información, consulte Obtención del punto final de carga de datos y las claves de datos.
   • <private-data-key> es la clave de datos privada de instalación del agente Dotnet de APM que se genera cuando se crea el dominio de APM. Para obtener información, consulte Obtención del punto final de carga de datos y las claves de datos.
   La CR creada se puede consultar ejecutando el siguiente comando:

   kubectl get otelinst -n opentelemetry-operator-system

   Todos los puntos finales y las variables de entorno deben ser correctos para que la instrucción automática funcione correctamente.
2. Agregue la anotación de Kubernetes.

   El operador OpenTelemetry utiliza la anotación de Kubernetes para decidir qué pods se deben inyectar automáticamente con el agente Dotnet de APM.

   La anotación se puede agregar a un espacio de nombres. En ese caso, todos los pods dentro de ese espacio de nombres se inyectarán. La anotación también se puede agregar a objetos PodSpec individuales, disponibles como parte de Deployment, Statefulset y otros recursos.

   Anotación para x64 glibc:

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

   Anotación para x64 musl:

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

   Para empezar a editar el espacio de nombres, haga lo siguiente:

   • Ejecute el comando:

     kubectl edit namespace <your-namespace-name>

   • Después de ejecutar el comando anterior, edite el espacio de nombres una vez que se abra el editor. Por ejemplo, utilizando el editor vi.
   • Agregue la anotación al espacio de nombres. Tenga en cuenta que la sangría es muy importante para que sea un archivo YAML válido.
   Consulte a continuación un ejemplo de un espacio de nombres con la anotación agregada:

   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. Reinicie el pod de Kubernetes.

   Para reiniciar el pod donde desea inyectar automáticamente el agente Dotnet de APM, ejecute lo siguiente:

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

4. Verifique el pod de Kubernetes.
   Para verificar que el pod se ha inyectado automáticamente con el agente de APM Dotnet después de reiniciarlo, ejecute lo siguiente:

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

Ahora puede ir al siguiente paso: Verify APM Dotnet Agent Deployment.