Webhook Instana AutoTrace

Le webhook Instana AutoTrace est un webhook de contrôle d'admission compatible avec Kubernetes et Red Hat OpenShift.

Pour plus d'informations, consultez la section « Webhook de modification du contrôleur d'admission ».

Le webhook configure automatiquement le traçage d' Instana s sur les applications Node.js, .NET Core, Ruby et Python qui s'exécutent sur l'ensemble du cluster Kubernetes ou Red Hat OpenShift. De plus, vous pouvez activer le suivi d' Instana pour les déploiements IBM MQ et App Connect qui s'exécutent sur IBM Cloud Pak for Integration.

Avant de procéder à l'installation

Avant d'installer le webhook Instana AutoTrace, assurez-vous de vérifier les limitations, les environnements d'exécution pris en charge et les prérequis.

Limitations

  • Instana AutoTrace Le webhook ne fonctionne qu'avec les nouvelles ressources Kubernetes. Une fois le webhook installé, vous devez créer de nouvelles ressources pour que la transformation prenne effet. Supprimez vos Pods existants ( ReplicaSets, ), vos Deployments ( StatefulStes, ) et vos DeploymentConfigs,, puis recréez-les pour que le webhook Instana AutoTrace puisse achever sa configuration (par exemple, en utilisant kubectl apply).
  • Instana AutoTrace Le webhook ne met pas automatiquement à jour l'instrumentation qu'il installe. Par conséquent, le webhook Instana AutoTrace n'est pas activé par défaut.
  • À partir de la version 1.304.2, le webhook Instana AutoTrace ne modifie par défaut que les pods et les ConfigMaps. Les ressources de niveau supérieur (telles que les déploiements, les daemonsets, les replicasets, les statefulsets et les deploymentconfigs) ne sont modifiées que lorsque le enableHigherLevelResourceMutation drapeau est défini sur true. Pour plus d'informations, consultez la section « Modification des ressources de niveau supérieur ».
  • Lorsque vous désinstallez le webhook Instana AutoTrace, la transformation et l'instrumentation ne sont pas automatiquement supprimées. Pour plus d'informations, consultez la section « Suppression de l'instrumentation ».
  • Si le webhook Instana AutoTrace est installé sur les Paks IBM Cloud ( Cloud Pak for Business Automation et Cloud Pak for Integration ), vous devez exclure Zen de l'instrumentation. Pour plus d'informations, consultez la section « Installation sur des disques Paks d' IBM Cloud ».

Plateformes prises en charge

  • linux/amd64
  • linux/s390x
  • linux/arm64
Remarque : Dans linux/s390x , le webhook Instana AutoTrace n'active la fonctionnalité de traçage que pour les applications Node.js, Ruby, NGINX et Python.

Environnements d'exécution pris en charge

Le webhook Instana AutoTrace prend en charge les technologies suivantes :

Remarque : le webhook Instana AutoTrace ne prend en charge l'instrumentation automatique que sur NGINX 1.19 ou une version ultérieure. À l'heure actuelle, le webhook Instana AutoTrace ne prend pas en charge OpenResty.

Prérequis

Avant d'installer le webhook Instana AutoTrace sur un cluster basé sur Kubernetes, assurez-vous que les conditions préalables suivantes sont remplies :

  • Kubernetes 1.16 ou une version ultérieure est installée.
  • Red Hat OpenShift 4.5 ou une version ultérieure est installée.
  • kubectl 1.16 ou une version ultérieure est installée.
  • Helm 3.2 ou une version ultérieure est installée. (Certaines automatisations s'appuient sur les lookup fonctions d' Helm )
  • Des limites de mémoire suffisantes dans le pod cible pour l'instrumentation de l'application. Le webhook « AutoTrace » charge les bibliothèques d'instrumentation au moment de l'exécution, ce qui entraîne une surcharge mémoire supplémentaire. Veillez à allouer suffisamment de mémoire pour charger les fichiers d'instrumentation dans spec.template.spec.containers[x].resources.limits.memory l'attribut du déploiement cible. Pour plus d'informations, consultez la section « Mémoire insuffisante ».
  • Consultez le modèle de sécurité et les exigences relatives au contrôle d'accès basé sur les rôles (RBAC) pour le webhook « AutoTrace ». Pour plus d'informations, consultez la section « Contrôle d'accès basé sur les rôles (RBAC) requis pour le webhook d' AutoTrace ».

Une fois que vous avez vérifié que toutes les conditions préalables sont remplies, vous pouvez procéder à l'installation du webhook Instana AutoTrace.

Voir les rubriques suivantes pour plus d'informations :

Remarque : le webhook Instana AutoTrace utilise le libinstana_init paquet pour surveiller une technologie. Pour plus d'informations sur libinstana_init les versions des paquets, consultez la section « libinstana_init Versions des paquets »