Installation du webhook d' AutoTrace

Modifier en ligne

Vous pouvez installer le webhook Instana AutoTrace dans un environnement en ligne ou hors ligne (air-gapped). Pour plus d'informations, voir les sections suivantes :

Avant de commencer, assurez-vous de vérifier les environnements d'exécution pris en charge et les prérequis pour le webhook AutoTrace. Pour plus d'informations, consultez la section Avant l'installation.

Installation dans un environnement en ligne

Modifier en ligne

Pour installer le webhook AutoTrace dans un environnement en ligne, exécutez la commande suivante avec les privilèges d'administrateur pour votre cluster :

helm install --create-namespace --namespace instana-autotrace-webhook instana-autotrace-webhook \
  --repo https://agents.instana.io/helm instana-autotrace-webhook \
  --set webhook.imagePullCredentials.password=<download_key>

Remplacez <download_key> dans le script par une clé d'agent ou une clé de téléchargement valide d' Instana.

Si vous installez le webhook AutoTrace sur Red Hat OpenShift, vous devez ajouter l'argument Helm suivant :

--set openshift.enabled=true

Pour plus d'options de configuration du webhook, consultez la section Configuration du webhook d' AutoTrace.

Le script installe le webhook AutoTrace dans votre cluster.

Après avoir installé le webhook AutoTrace, vérifiez que l'installation s'est déroulée correctement et que le webhook fonctionne. Pour plus d'informations, consultez la section Vérification de l'installation du webhook.

Installation sur des packs d' IBM Cloud

Modifier en ligne

Pour installer le webhook « AutoTrace » sur IBM Cloud Pak, vous devez exclure le déploiement Zen de l'instrumentation du webhook en désactivant l'instrumentation de Ruby.

Pour désactiver l'instrumentation d' Ruby, ajoutez l'argument d' Helm suivant :

--set autotrace.ruby.enabled=false

Pour les applications qui utilisent l' Ruby, vous pouvez envisager d'autres options, telles que l'ignorance des espaces de noms, l'activation ou la désactivation de cette fonctionnalité, ou encore l'ignorance de certaines ressources.

Pour obtenir des instructions détaillées sur l'installation du webhook Autotrace d' Instana sur les packs d' IBM Cloud s et les options d'exclusion, consultez Comment configurer le webhook Instana AutoTrace dans un environnement Cloud Pak.

Installation dans un environnement isolé

Modifier en ligne

Pour installer le webhook AutoTrace dans des environnements isolés, vous devez fournir le graphique instana-autotrace-webhookHelm, l'image instana-autotrace-webhook du conteneur et l'image instrumentation du conteneur dans votre environnement.

  1. Pour télécharger la dernière version du graphique Helm dans votre répertoire de travail actuel, exécutez la commande suivante :

    helm pull instana-autotrace-webhook --repo https://agents.instana.io/helm instana-autotrace-webhook

    Pour modifier le répertoire de destination de cette commande, utilisez l'option -d <DESTINATION_PATH>. Remplacez <DESTINATION_PATH> par le répertoire de destination souhaité.

  2. Pour télécharger la dernière instana-autotrace-webhook image, exécutez la commande suivante :

    docker pull containers.instana.io/instana/release/agent/instana-autotrace-webhook:latest

  3. Pour télécharger la dernière image d'instrumentation, exécutez la commande suivante :

    docker pull icr.io/instana/instrumentation:latest

    Assurez-vous que les deux images de conteneur sont disponibles dans votre Container Registry.

  4. Pour installer le webhook Instana AutoTrace, exécutez la commande suivante :

    Assurez-vous que l'archive du tableau d' Helm s est disponible sur le système qui exécute la helm install commande.

    helm install --create-namespace \
--namespace instana-autotrace-webhook \
--set webhook.image=<INSTANA_AUTOTRACE_WEBHOOK_IMAGE_PATH> \
--set autotrace.instrumentation.image=<INSTRUMENTATION_IMAGE_PATH> \
instana-autotrace-webhook <PATH_TO_HELM_CHART_ARCHIVE>

Pour plus d'options de configuration du webhook, consultez la section Configuration du webhook d' AutoTrace.

La commande installe le webhook AutoTrace dans votre système isolé.

Après avoir installé le webhook AutoTrace, vérifiez que l'installation s'est déroulée correctement et que le webhook fonctionne. Pour plus d'informations, consultez la section Vérification de l'installation du webhook.

Container Registry authentification

Modifier en ligne

Le instrumentation L'image du Container Registry est utilisée comme initContainer dans tous les pods d'application. Si votre application ( Container Registry ) nécessite la ressource ( imagePullSecret ), celle-ci doit être disponible dans tous les espaces de noms de l'.

Vérification de l'installation du webhook

Modifier en ligne

Pour vérifier que le webhook fonctionne correctement, procédez comme suit :

  1. Pour vérifier que le instana-autotrace-webhook dans l'espace instana-autotrace-webhook de noms fonctionne comme prévu, exécutez la commande suivante :

    kubectl get pods -n instana-autotrace-webhook

    Exemple de résultat :

    NAME                                         READY   STATUS    RESTARTS   AGE
instana-autotrace-webhook-7c5d5bf6df-82w7c   1/1     Running   0          12m
instana-autotrace-webhook-7c5d5bf6df-nlq5t   1/1     Running   0          12m

  2. Utilisez le webhook Instana AutoTrace. Si le webhook Instana AutoTrace est en cours d'exécution, déployez un pod Node.js. Instana AutoTrace est automatiquement activé dans le pod Node.js. Dans le journal du pod, vous pouvez voir une étiquette qui indique que l' InstanaAutoTrace a été appliquée au pod Node.js :

    kubectl get pod test-nodejs -n test-apps -o=jsonpath='{.metadata.labels.instana-autotrace-applied}'
true

Si vous avez installé l'agent hôte Instana à l'aide du graphique instana/agentHelm, le processus Node.js apparaît dans votre tableau de bord Instana. Pour plus d'informations, consultez la section Installation de l'agent hôte sur Kubernetes.

Cependant, si vous ne voyez pas les instana-autotrace-applied étiquettes apparaître sur vos conteneurs, consultez la section Dépannage du webhook AutoTrace.