Installation d' IDOT s dans des clusters d' Kubernetes s via l'opérateur

• Kubernetes 1.24 et plus tard
• Helm 3.9 et plus tard
• kubectl
• Autorisations d'administrateur de cluster pour créer des définitions de ressources personnalisées (CRD)

Pour installer l'opérateur « IDOT » dans un environnement « Kubernetes », procédez comme suit :

1. Facultatif mais recommandé : créez un espace de noms dédié à l'opérateur en exécutant la commande suivante :

   kubectl create namespace instana-otel-operator
    

2. Installez l'opérateur « IDOT » dans l' Kubernetes e en exécutant la commande suivante :

     helm install instana-otel-operator \
     --repo https://instana.github.io/instana-otel-collector instana-otel-collector-chart-operator \
     --namespace instana-otel-operator \
     --create-namespace \
     --set clusterName=<CLUSTER_NAME> \
     --set instanaEndpoint=<INSTANA_ENDPOINT> \
     --set instanaKey=<INSTANA_KEY> \
     --set daemonset.enabled=true \
     --set statefulset.enabled=true

   Tableau 1. Paramètres d'installation

   Paramètre	Description	Obligatoire
   clusterName	Nom de votre cluster « Kubernetes » pour l'afficher dans l'interface utilisateur d' Instana	Oui
   instanaEndpoint	Le point de terminaison « gRPC » de votre environnement Instana	Oui
   instanaKey	Instana clé d'agent permettant de s'authentifier auprès du point de terminaison	Oui

   Comment trouver vos valeurs de configuration :

   Vous trouverez ces paramètres dans l'interface utilisateur d' Instana, sous « Agent & collectors » > « OpenTelemetry Collectors » :

   • Cliquez sur « Installer un collecteur » > « Opérateur Kubernetes ».
   • Dans la commande d'installation :
     • INSTANA_KEY: Recherchez la clé de l'agent après le -a drapeau.
     • INSTANA_OTEL_ENDPOINT_GRPC: Recherchez le point de terminaison « gRPC » après le -e drapeau.
     • INSTANA_OTEL_ENDPOINT_HTTP: Recherchez le point de terminaison « HTTP » après le -H drapeau.
   Remarque : l'option --create-namespace crée l'espace de noms s'il n'existe pas. Vous pouvez omettre cet indicateur si l'espace de noms existe déjà ou a été créé manuellement.

   Pour plus d'informations sur les exigences système complètes, consultez les exigences système IDOT.

3. Vérifiez l'installation de l'opérateur : après l'installation, vérifiez que l'opérateur est correctement installé en exécutant la commande suivante :

   kubectl get pods -n instana-otel-operator
    

   Si l'installation réussit, le message suivant s'affiche :

   NAME                                     READY   STATUS    RESTARTS   AGE
   instana-otel-operator-7d9f8b5c6d-xk2lm   2/2     Running   0          30s
    

   L'âge de votre déploiement et l'ID du pod varient en fonction du moment où vous avez exécuté la commande d'installation.

4. Vérifiez que les définitions de ressources personnalisées (CRD) sont installées en exécutant la commande suivante :

   kubectl get crd | grep opentelemetry
    

   Le CRD de l' OpenTelemetryCollector doit figurer dans la liste des résultats.

Pour mettre à jour la configuration du collecteur, modifiez la ressource personnalisée OpenTelemetryCollector :

kubectl edit opentelemetrycollector idot-daemonset -n instana-otel-operator
kubectl edit opentelemetrycollector idot-statefulset -n instana-otel-operator
 

L'opérateur détecte automatiquement les changements et met à jour les pods collecteurs en conséquence.

Avant d'installer l'opérateur sur un cluster Red Hat OpenShift 4.x, assurez-vous que vous disposez des autorisations d'administrateur de cluster pour créer des CRD et gérer les opérateurs.

Une fois connecté à votre cluster Red Hat OpenShift, procédez comme suit pour installer l'opérateur IDOT :

1. Facultatif mais recommandé : créez un projet dédié à l'opérateur en exécutant la commande suivante :

   oc new-project instana-otel-operator
    

2. Installez l'opérateur « IDOT » dans le cluster « Red Hat OpenShift » en exécutant la commande suivante :

     helm install instana-otel-operator \
     --repo https://instana.github.io/instana-otel-collector instana-otel-collector-chart-operator \
     --namespace instana-otel-operator \
     --create-namespace \
     --set clusterName=<CLUSTER_NAME> \
     --set instanaEndpoint=<INSTANA_ENDPOINT> \
     --set instanaKey=<INSTANA_KEY> \
     --set daemonset.enabled=true \
     --set statefulset.enabled=true
    

3. Vérifiez l'installation d' Red Hat OpenShift : Vérifiez les pods de l'opérateur en exécutant la commande suivante :

   oc get pods -n instana-otel-operator
    

   Vous pouvez également utiliser la kubectl commande si la machine utilisée pour accéder au cluster dispose de la commande installée :

   kubectl get pods -n instana-otel-operator
    

Les paramètres suivants peuvent être définis lors de l'installation ou de la mise à niveau de l'opérateur :

Les paramètres suivants peuvent être configurés dans la ressource personnalisée OpenTelemetryCollector :

Exemple avec des limites de ressources :

apiVersion: opentelemetry.io/v1alpha1
kind: OpenTelemetryCollector
metadata:
  name: instana-collector
  namespace: instana-otel-operator
spec:
  mode: daemonset
  resources:
    limits:
      cpu: 1.5
      memory: 768Mi
    requests:
      cpu: 0.5
      memory: 768Mi
  config: |
    # ... collector configuration ...
 

Si l'opérateur ne crée pas de pods collecteurs, vérifiez les points suivants :

1. Vérifiez que l'opérateur est en cours d'exécution :

   kubectl get pods -n instana-otel-operator
   kubectl logs -n instana-otel-operator -l app.kubernetes.io/name=opentelemetry-operator
    

2. Consultez le site OpenTelemetryCollectors:

   kubectl get opentelemetrycollector -n instana-otel-operator
    

3. Vérifiez que les CRD sont installés :

   kubectl get crd opentelemetrycollectors.opentelemetry.io
    

Si les modules collecteurs ne démarrent pas, vérifiez les points suivants :

1. Vérifiez les événements du pod en exécutant la commande suivante :

   kubectl describe pod -n instana-otel-operator -l app.kubernetes.io/managed-by=opentelemetry-operator
    

2. Vérifiez que la configuration du collecteur est valide en exécutant la commande suivante :

   kubectl get opentelemetrycollector idot-daemonset -n instana-otel-operator -o yaml
   kubectl get opentelemetrycollector idot-statefulset -n instana-otel-operator -o yaml
    

3. Vérifiez les contraintes de ressources en exécutant la commande suivante :

   kubectl top nodes
   kubectl top pods -n instana-otel-operator
    

4. Consultez les journaux du collecteur en exécutant la commande suivante :

   kubectl logs -n instana-otel-operator -l app.kubernetes.io/managed-by=opentelemetry-operator
    

Pour obtenir des conseils supplémentaires sur le dépannage, consultez la page « Dépannage » à l'adresse IDOT.