Pré-requisitos

Instale o Operador OpenTelemetry no cluster K8s.

Há três opções diferentes disponíveis para escolha: Gráfico de helm do operador, Manifesto de release do operador ou Hub do Operador.

Na maioria dos casos, um cert-manager deve ser instalado. Se a opção de gráfico helm for usada, haverá uma opção para gerar um certificado autoassinado.

Opção 1: Gráfico helm do operador

Esta opção é usar o gráfico helm para instalar o operador OpenTelemetry.

1. Adicionar repositório de gráficos helm.

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

2. Crie o namespace do Kubernetes para o operador OpenTelemetry.

   kubectl create namespace opentelemetry-operator-system

3. Instalar 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

Opção 2: Manifesto de release do operador

Esta opção é usar arquivos YAML para instalar o 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

Implantar o Agente de Dotnet do APM

Para implantar o agente Dotnet do APM, siga estas etapas:

1. Criar um Recurso Personalizado (CR) do Kubernetes.

   Para gerenciar a instrumentação automática, o Operador OpenTelemetry precisa receber informações sobre o agente de Dotnet do APM e sua configuração, que é feita usando a CRD (Definição de Recurso Personalizado).

   Este Recurso Personalizado será usado pelo operador para copiar o agente no pod e adicionar a ele a configuração necessária.

   Execute o seguinte comando para criar o CR no cluster do 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

   Em que:

   • <data-upload-endpoint> é o URL do ponto final de upload de dados que é gerado quando o domínio do APM é criado. Para obter informações, consulte Obter Ponto Final de Upload de Dados e Chaves de Dados.
   • <private-data-key> é a chave de dados privada de instalação do agente Dotnet do APM que é gerada quando o domínio do APM é criado. Para obter informações, consulte Obter Ponto Final de Upload de Dados e Chaves de Dados.
   O CR criado pode ser consultado executando o seguinte comando:

   kubectl get otelinst -n opentelemetry-operator-system

   Todos os pontos finais e variáveis de ambiente precisam estar corretos para que a instrumentação automática funcione corretamente.
2. Adicione a anotação do Kubernetes.

   O operador OpenTelemetry usa a anotação do Kubernetes para decidir quais pods devem ser injetados automaticamente com o agente Dotnet do APM.

   A anotação pode ser adicionada a um namespace. Nesse caso, todos os pods dentro desse namespace serão injetados. A anotação também pode ser adicionada a objetos PodSpec individuais, disponíveis como parte da Implantação, Statefulset e outros recursos.

   Anotação para x64 glibc:

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

   Anotação 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 começar a editar seu namespace, faça o seguinte:

   • Execute o comando:

     kubectl edit namespace <your-namespace-name>

   • Depois de executar o comando acima, edite o namespace assim que o editor for aberto. Por exemplo, usando o editor vi.
   • Adicione a anotação ao namespace. Lembre-se de que o recuo é muito importante para torná-lo um arquivo YAML válido.
   Veja abaixo um exemplo de namespace com a anotação adicionada:

   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 o pod do Kubernetes.

   Para reiniciar o pod no qual você deseja injetar automaticamente o agente de Dotnet do APM, execute o seguinte:

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

4. Verifique o pod do Kubernetes.
   Para verificar se seu pod foi injetado automaticamente com o agente Dotnet do APM após ser reiniciado, execute o seguinte:

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

Agora você pode ir para a próxima etapa: Verificar Implantação do Agente de Dotnet do APM.