Administration de l'agent « Instana » sur Kubernetes

Une fois l'agent hôte installé, vérifiez son état dans l'interface utilisateur d' Instana ou directement sur l'hôte. Pour plus d'informations, voir Vérification de l'état de l'agent hôte.

Vous pouvez configurer l'agent sur Kubernetes soit à l'aide du fichier de configuration de l'agent, soit à l'aide de variables d'environnement.

Après l'installation de l'agent hôte, les fichiers de configuration suivants sont créés :

/opt/instana/agent/etc/mvn-settings.xml
/opt/instana/agent/etc/org.ops4j.pax.url.mvn.cfg
/opt/instana/agent/etc/instana/com.instana.agent.bootstrap.AgentBootstrap.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.Agent.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.UpdateManager.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend.cfg
/opt/instana/agent/etc/instana/configuration.yaml
 

Vous pouvez personnaliser la configuration de l'agent selon vos besoins. Par exemple, vous pouvez modifier le port et le nom d'hôte d' TCP du backend Instana et des services auxquels votre agent hôte se connecte, configurer l'agent pour qu'il envoie des rapports à plusieurs backends, ou configurer l'utilisation d'un proxy pour la communication indirecte entre l'agent hôte et le backend Instana.

Pour plus d'informations sur la personnalisation de la configuration de l'agent, voir les rubriques suivantes :

• Journalisation de l'agent
• Configuration du backend d' Instana
• Configuration du mode de l'agent hôte
• Configuration des agents hôtes à l'aide du fichier de configuration des agents
• Conversion d'un agent statique en agent dynamique
• Limitation de l'unité centrale et de la mémoire de l'agent hôte
• Récupération de la version actuelle des agents dynamiques
• Mise en place d'un proxy d'agent
• Configuration du chiffrement « TLS » pour le terminal de l'agent
• Intervalle de mise à jour des agents dynamiques
• Épinglage des versions des agents dynamiques

Selon la méthode d'installation utilisée, vous pouvez mettre à jour l'agent « Instana » pour « Kubernetes » de plusieurs façons.

Vous pouvez effectuer les opérations suivantes à l'aide du tableau de bord de gestion des agents dans l'interface utilisateur d' Instana :

• Changement de mode de fonctionnement des agents
• Modifier le niveau d'enregistrement
• Mise à jour des agents
• Réinitialisation des agents
• Agents de redémarrage
• Visualisation des capteurs
• [Gestion de la configuration]
  • Initialisation de la gestion des configurations
  • Mise à jour de la gestion de la configuration
• Surveillance automatique

Pour ouvrir le tableau de bord de gestion des agents, procédez comme suit :

1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
2. Cliquez sur un hôte surveillé spécifique.
3. Sur le tableau de bord de l'hôte, cliquez sur Ouvrir la gestion des agents.

Vous devez configurer l'accès réseau des types d'applications suivants pour qu'elles puissent communiquer avec l'agent :

• Node.js
• Go
• Ruby
• Python
• .NET Core

Ces applications doivent connaître l'adresse IP sur laquelle l'agent est à l'écoute. L'agent hôte écoute automatiquement l'IP de l'hôte. Vous pouvez utiliser l'extrait de code d' API descendante suivant pour transmettre l'adresse IP de l'hôte, via une variable d'environnement, au pod de l'application :

spec:
  containers:
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP
 

Par défaut, l'agent hôte n'est pas planifié sur les nœuds du plan de contrôle d' Kubernetes (anciennement appelés nœuds maîtres), car le déploiement respecte le taint node-role.kubernetes.io/master:NoSchedule par défaut défini sur la plupart des nœuds du plan de contrôle. Pour surveiller les nœuds du plan de contrôle, vérifiez d'abord quel indicateur de contamination est défini sur ces nœuds en exécutant la commande suivante et en recherchant .spec.taints dans la réponse :

kubectl describe node <control-plane-node-name>
 

Ajoutez ensuite la tolérance à l'agent DaemonSet pour la contamination définie sur le nœud du plan de contrôle. Si le nœud du plan de contrôle présente la marque par défaut, la tolérance appropriée pour le Daemonset de l'agent est la suivante :

tolerations:
  - key: "node-role.kubernetes.io/master"
    effect: "NoSchedule"
    operator: "Exists"
 

Une fois que vous avez déterminé le seuil de tolérance requis pour la surveillance des nœuds du plan de contrôle, configurez ce seuil lors de l'installation de l'agent.

Si vous avez installé l'agent à l'aide du graphique « Helm », vous pouvez définir les tolérances de deux manières :

• En utilisant l'indicateur --set agent.pod.tolerations

• En créant un values.yaml fichier contenant le texte suivant, puis en transmettant ce fichier à la commande d'installation de Helm à l'aide de l'option -f values.yaml:

agent:
  pod:
    # agent.pod.tolerations are tolerations to influence agent pod assignment.
    #   https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

Si vous avez installé l'agent à l'aide de l'opérateur, ajoutez les tolérances dans la ressource personnalisée sous .spec.agent.pod.tolerations dans le instana-agent.customresource.yaml fichier. Voir l'exemple suivant :

spec:
  agent:
   pod:
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

Appliquez ensuite la nouvelle ressource personnalisée au cluster en exécutant la commande suivante :

kubectl apply -f instana-agent.customresource.yaml
 

Pour un contrôle plus direct, installez l'agent hôte séparément sur les nœuds du plan de contrôle.

Pour configurer l'Ingress Kubernetes NGINX et l'agent hôte afin de collecter les métriques NGINX, consultez la page Surveillance NGINX.

Pour activer le traçage distribué pour l'Ingress Kubernetes NGINX, consultez la section « Traçage distribué pour l'Ingress NGINX ».

Kubernetes dispose d'une prise en charge intégrée pour le stockage et la gestion des informations sensibles. Toutefois, si vous n'utilisez pas cette fonctionnalité intégrée mais que vous avez tout de même besoin de pouvoir masquer les données sensibles dans les ressources d' Kubernetes, vous pouvez configurer les secrets de l'agent.

Pour activer la masquage des données sensibles pour certaines ressources d' Kubernetes s (notamment les annotations et les variables d'environnement des conteneurs), procédez comme suit :

1. Définissez la variable INSTANA_KUBERNETES_REDACT_SECRETS d'environnement comme true indiqué dans l'extrait de code suivant concernant l' YAML d'un agent :

   spec:
     containers:
         env:
           - name: INSTANA_KUBERNETES_REDACT_SECRETS
             value: "true"
    

2. Configurez l'agent hôte avec la liste de secrets souhaitée, comme décrit dans la section consacrée à la configuration des secrets de l'agent.

Pour l'agent hôte installé à l'aide de l'Operator ou du tableau « Helm », vous pouvez ajouter des backends supplémentaires en exécutant la commande suivante :

• Pour l'agent hôte installé à l'aide de la carte Helm:

     helm install instana-agent \
     --repo https://agents.instana.io/helm \
     --namespace instana-agent \
     --create-namespace \
     --set agent.key=my-key \
     --set agent.endpointHost='<your_host_agent_endpoint>' \
     --set agent.endpointPort=443 \
     --set cluster.name='<your_cluster_name>' \
     --set zone.name='zone-name' \
     --set "agent.additionalBackends[0].endpointHost=<your_host_agent_endpoint>" \
     --set "agent.additionalBackends[0].key=<your_agent_key>" \
     --set "agent.additionalBackends[0].endpointPort=443" \
     --set "agent.additionalBackends[1].endpointHost=<your_other_host_agent_endpoint>" \
     --set "agent.additionalBackends[1].key=<your_other_agent_key>" \
     --set "agent.additionalBackends[1].endpointPort=443" \
     instana-agent
   

• Pour l'agent hôte installé à l'aide d'Operator :

  apiVersion: instana.io/v1
  kind: InstanaAgent
  metadata:
    name: instana-agent
    namespace: instana-agent
  spec:
    zone:
      name: edited-zone # (optional) name of the zone of the host
    cluster:
      name: my-cluster
    agent:
      endpointHost: <your_host_agent_endpoint>
      endpointPort: "443"
      env: {}
      key: <your_agent_key>
      additionalBackends:
      - endpointHost: <your_host_agent_endpoint>
        endpointPort: "443"
        key: <your_agent_key>
      configuration_yaml: |
        # You can leave this empty, or use this to configure your instana agent.
        # See https://github.com/instana/instana-agent-operator/blob/main/config/samples/instana_v1_extended_instanaagent.yaml for the extended version.
   

Pour plus d'informations sur la transmission de rapports vers plusieurs backends à partir d'un agent d' Kubernetes, consultez la section « Configuration d'un backend d' Instana ».