Administration de l'agent « Instana » sur Red Hat OpenShift

Après avoir installé l'agent, vous pouvez vérifier l'état des pods dans votre déploiement d'agent à l'aide des commandes suivantes :

kubectl get pods -n instana-agent
kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
 

Dans un bon déploiement, le " STATUS de tous les pods de l'espace de noms doit être le " Running. La ressource personnalisée " instana-agent doit également afficher " status: Running, comme le montre l'exemple suivant :

$ kubectl get pods -n instana-agent
NAME                                      READY   STATUS    RESTARTS   AGE
controller-manager-6478cb4c6f-8s29b       1/1     Running   0          70m
instana-agent-8ftnj                       1/1     Running   0          70m
instana-agent-9w4vc                       1/1     Running   0          70m
instana-agent-k8sensor-5bbf568976-5pjk2   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-h96hr   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-lnbsg   1/1     Running   0          3h2m
instana-agent-zpmrj                       1/1     Running   0          70m

$ kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
conditions:
  - lastTransitionTime: "2024-08-06T08:12:03Z"
    message: most recent reconcile of agent CR completed without issue
    observedGeneration: 2

    ...

observedGeneration: 2
oldVersionsUpdated: true
operatorVersion: 0.0.1-dev
status: Running
 

Vous pouvez configurer l'agent Instana pour Kubernetes et Red Hat OpenShift de deux manières différentes, selon la méthode que vous avez utilisée pour installer l'agent.

En fonction de votre environnement Red Hat OpenShift, vous devrez peut-être personnaliser le Red Hat OpenShift Container Registry.

Selon la méthode d'installation utilisée, vous pouvez mettre à jour l'agent « Instana » pour « Red Hat OpenShift » 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 :

• Changer de mode d'agent
• Modification du niveau de journalisation
• Mise à jour des agents
• Agents de réinitialisation
• Agents de redémarrage
• Capteurs de vision
• [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 la 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 é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. Pour plus d'informations sur la surveillance des nœuds du plan de contrôle, consultez la section « Surveillance des nœuds du plan de contrôle ».

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

Pour obtenir des instructions sur la configuration de l'Ingress Kubernetes NGINX et de notre agent permettant de collecter les métriques NGINX, consultez la page de surveillance NGINX. Le traçage d'Ingress sur Kubernetes NGINX est également possible via le projet OpenTracing. Consultez la section « Traçage distribué pour Ingress sur NGINX » pour obtenir des instructions sur la configuration.

Pour ajouter des backends supplémentaires à l'aide d' helm, exécutez la commande suivante. Vous pouvez utiliser des backends supplémentaires pour configurer votre agent Instana ou laisser ce champ vide.

• Utilisation d' 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
   

• Utilisation de l'opérateur :

  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 permettre la transmission de rapports vers plusieurs backends à partir d'un agent Kubernetes, consultez la configuration de l'agent Docker.

Vous pouvez utiliser les Secrets pour stocker et gérer des données sensibles telles que des informations d'identification, des jetons ou des clés. Pour plus d'informations, consultez la page « Kubernetes secrets ».