Installation de l'agent distant d' Instana

Avant d'installer l'agent distant Instana, assurez-vous que les conditions préalables sont remplies.

Lorsque vous déployez l'agent distant sur Red Hat OpenShift, vous devez ajouter les autorisations SCC (Security Context Constraints) pour l'agent distant en exécutant la commande suivante :

oc adm policy add-scc-to-user anyuid -z instana-agent-remote -n instana-agent
 

Vous pouvez utiliser l'opérateur Kubernetes fourni par Instana pour installer l'agent distant en suivant les étapes suivantes :

1. Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet Agents d' Instana, sélectionnez Installer les agents.

2. Sur la page du catalogue de déploiement des agents, cliquez sur la vignette « Kubernetes - Opérateur ».

3. Déployez l'opérateur comme suit. La commande installe le dernier opérateur.

   kubectl apply -f https://github.com/instana/instana-agent-operator/releases/latest/download/instana-agent-operator.yaml
    

   Après avoir exécuté cette commande, l'opérateur est opérationnel dans l'espace de noms instana-agentet attend la création d'une ressource InstanaAgent personnalisée InstanaAgentRemote ou.

   La latest balise pour l'image de l'opérateur de l'agent Instana dans DockerHub et le registre Red Hat n'est pas prise en charge.

   Pour obtenir une nouvelle version de l'opérateur d'agent « Instana », mettez à jour l'opérateur YAML en téléchargeant la dernière version disponible sur la page « Releases » de l'opérateur à l'adresse GitHub.

4. Créez et modifiez un fichier de configuration de ressource personnalisé instana-agent-remote.yaml ( YAML ) en copiant le modèle YAML fourni ci-dessous.

   • L'interface utilisateur d' Instana fournit un modèle de fichier « YAML » pour l 'agent standard (InstanaAgent), et non pour l'agent distant (InstanaAgentRemote). Par conséquent, utilisez le modèle de fichier « YAML » suivant et copiez uniquement votre clé d'agent, le point de terminaison de l'agent hôte et, si nécessaire, la clé de téléchargement depuis l'interface utilisateur d' Instana.
   • Remplacez <edited-zone> par la zone d'agent à laquelle vous souhaitez que le cluster appartienne. La zone d'agent sert à personnaliser le regroupement de zones qui s'affiche sur la carte de l'infrastructure.
   Remarque : les configurations des capteurs peuvent être définies soit directement dans le fichier de ressource personnalisée ` YAML `, comme le montre cet exemple avec le capteur CVE, soit dans la agent.configuration_yaml section `...`, comme le montre un exemple ultérieur avec le capteur ` Turbonomic `.

   apiVersion: instana.io/v1
   kind: InstanaAgentRemote
   metadata:
     name: remote-agent
     namespace: instana-agent
   spec:
     zone:
       name: edited-zone # name of the zone of the host
     agent:
       key: replace-key # replace with your Instana agent key
       endpointHost: ingress-red-saas.instana.io # replace with your Instana endpoint
       endpointPort: "443"
       env: {}
       configuration_yaml: |
         # Remote Sensor Configurations
         # CVE
         com.instana.plugin.cve:
           enabled: true
           concert:
             base_url: '<INSERT_CONCERT_BASE_URL_HERE>'  # Concert base url
             instance_id: '<INSERT_INSTANCE_ID_HERE>'    # Concert instance id
             api_key: '<INSERT_API_KEY_HERE>'            # Concert API Key
             poll_rate: 10
    

   • La ressource personnalisée de l'agent Instana prend en charge exactement la même configuration que le graphique Instana Helm. Pour obtenir une liste détaillée de tous les paramètres de configuration et des exemples, consultez le tableau « InstanaHelm » (Paramètres de configuration et exemples de configuration).

     Voir également les rubriques suivantes :

     • Configuration de backends supplémentaires
     • Configuration d'un proxy entre les agents Instana et le backend Instana
     • Définition des volumes d' Kubernetes s personnalisés et volumeMounts

   • Si vous souhaitez installer l'agent dans un environnement auto-hébergé et que la clé de l'agent n'a pas l'autorisation de télécharger depuis l'artifactory public Instana, ajoutez la clé de téléchargement sous la forme downloadKey: <your_download_key>. Voir l'exemple suivant :

     agent:
     key: wPYpH7EGK0ucLaO0Nu7BYw
     downloadKey: m007YDoWNload6kE42yukg
     endpointHost: ...
      

   Pour les options de configuration, voir Options de configuration supplémentaires.

5. Appliquez le fichier de ressource personnalisée « YAML » :

   kubectl apply -f instana-agent-remote.yaml
    

   où instana-agent-remote.yaml est le nom de votre fichier de InstanaAgentRemote ressource personnalisée YAML.

   L'opérateur récupère la configuration à partir du fichier de ressource personnalisée « YAML » et déploie l'agent distant « Instana ».

   L'agent distant est installé. Pour plus d'informations sur la configuration de plugins spécifiques, consultez la section « Que faire ensuite? ».

   Pour mettre à jour l'agent distant, consultez la section Mise à jour d'une installation opérateur.

Consultez les options de configuration supplémentaires suivantes :

• Si vous souhaitez ajouter un chiffrement de type « TLS » pour le point de terminaison de l'agent, utilisez un secret existant ou utilisez un certificat et une clé privée :

  • Utiliser un secret existant

    Vous pouvez utiliser un secret existant de type kubernetes.io/tls pour le chiffrement de l' TLS. Mais vous devez fournir ces informations agent.tls.secretName dans le fichier de ressource personnalisée ` YAML `.

  • Utilisez un certificat et une clé privée

    Le certificat et la clé privée doivent être base64-encoded. Pour utiliser cette variante, ajoutez les paramètres suivants au fichier de ressource personnalisée ` YAML ` :

    • agent.tls.certificate
    • agent.tls.key

    Si agent.tls.secretName est défini, alors agent.tls.certificate et agent.tls.key sont ignorés.

• Facultatif : vous pouvez remplacer les valeurs suivantes :

  • agent.env: Utilisez ce champ pour spécifier les variables d'environnement pour l'agent, telles que la configuration du proxy pour l'agent. Pour plus de valeurs d'environnement possibles, consultez la configuration de l'agent. Voir l'exemple suivant :

    spec:
      agent:
        env:
          INSTANA_AGENT_TAGS: staging
     

  • agent.configuration_yaml: Utilisez ce champ pour spécifier un fichier de configuration.yamlconfiguration d'agent. Voir l'exemple suivant :

    spec:
      agent:
        configuration_yaml: |
          # Example of configuration yaml template
          # Turbonomic
          com.instana.plugin.turbonomic:
            enabled: true
            host: '<INSERT_TURBONOMIC_SERVER_HERE>'  # Turbonomic Server Host or IP address
            target: '<INSERT_TURBONOMIC_TARGET_NAME>' # Name of the target (Instana Server) as configured in Turbonomic
            auth:
              username: <INSERT_USERNAME_OF_TURBONOMIC_SERVER_HERE>  # User must have administrator, deployer, or automator authority.
              password: <INSERT_PASSWORD_OF_TURBONOMIC_SERVER_HERE>
            tags:
              - 'turbonomic'
     

    Pour plus d'informations, consultez la section Configuration des agents hôtes à l'aide du fichier de configuration de l'agent.