Configuration du backend d' Instana sur Docker

Le fichier settings.hcl est généré lors du processus d'installation. Ce fichier contient toutes les configurations, telles que la clé de téléchargement, la clé de vente, ainsi que les paramètres liés à l' Instana, notamment le profil, le nom du tenant, le nom de l'unité et le nom d'hôte de l'environnement. Ces configurations sont nécessaires pour installer le backend Instana. Vous pouvez configurer ce fichier, puis Instana-console l'utiliser pour installer l'édition Classic en auto-hébergement ( Docker ).

Si nécessaire, créez un fichier settings.hcl avec des valeurs par défaut (vides) en exécutant la commande suivante:

instana settings template
 

Les valeurs des paramètres suivants sont renseignées lors de l'installation:

type      = "single"
profile   = "normal"
tenant    = "<Your-tenancy-identifier>"
unit      = "<Your-backend-identifier>"
agent_key = "<Your-agent-key>"
sales_key = "<Your-sales-key>"
host_name = "<The-FQDN-of-the-machine-the-backend-is-installed-on>"
token_secret = "<max_12_digits>"

cert {
  crt     = "<Path-to-your-signed-certificate>"
  key     = "<Path-to-your-private-key-file>"
}
 

Si vous souhaitez modifier les paramètres, exécutez la commande vi settings.hcl . Pour appliquer les nouveaux paramètres de configuration à votre édition Classic, exécutez instana update la commande.

Instana utilise par défaut les structures de répertoires suivantes :

dir {
  metrics  = "/mnt/metrics"
  traces   = "/mnt/traces"
  data     = "/mnt/data"
  logs     = "/var/log/instana"
}
 

Tous les magasins de données requièrent une authentification. Facultatif: configurez les données d'identification. Les données d'identification qui ne sont pas spécifiées sont initialement générées et ajoutées au fichier settings.hcl . Vous pouvez modifier les mots de passe en les mettant à jour dans le fichier settings.hcl .

Pour appliquer les modifications, exécutez la commande suivante:

instana update
 

...
datastore "cassandra" {
  user     = "cassandra"
  password = "SECURE_PASS"
}
datastore "elasticsearch" {
  user     = "elastic"
  password = "SECURE_PASS"
}
datastore "kafka" {
  user     = "kafka"
  password = "SECURE_PASS"
}
datastore "clickhouse" {
  user     = "clickhouse"
  password = "SECURE_PASS"
}
datastore "postgres" {
  user     = "postgres"
  password = "SECURE_PASS"
}
datastore "aggregator" {
  user     = "aggregator"
  password = "SECURE_PASS"
}
...
 

Pour activer la sécurité de transport stricte ( HSTS ) d' HTTP à l'échelle du système, ajoutez l'indicateur suivant à la racine du settings.hcl fichier :

hsts_enabled = true
 

L' URL, conformément à la spécification locale « open API », est la suivante https://{onpremhost}/docs/openapi (à partir de la version 170 sur site). Pour plus d'informations sur la configuration des clients REST API, consultez la documentation disponible à l'adresse Web REST API.

Pour remplacer des certificats existants par d'autres certificats, mettez à jour les chemins d'accès à vos fichiers de certificat dans le fichier settings.hcl à l'aide de la commande suivante:

cert {
...
}
 

Ensuite, mettez à jour le système en exécutant la commande suivante:

instana update -f /path/to/settings.hcl
 

cert {
  crt = "/mnt/cert/tls.crt"
  key = "/mnt/cert/tls.key"
}
 

Si Instana ne parvient pas à valider le certificat fourni par votre serveur SMTP, le message d'erreur suivant peut s'afficher : TLS

ERROR c.i.email.service.client.JavaMail - Mail could not be send due to an error
javax.mail.MessagingException: Could not convert socket to TLS
 

Pour configurer votre installation d' Instana afin de pouvoir envoyer des données à un webhook à l'aide d'un certificat personnalisé, fournissez un keystore personnalisé Java™ (jssecacerts) contenant votre certificat pour les JVM.

Suivez les étapes suivantes pour configurer votre installation d' Instana :

1. Copiez le fichier de clés actuel « JVM » depuis votre répertoire « JVM $JAVA_HOME/lib/security/cacerts».

2. Importez votre certificat personnalisé dans ce magasin de clés à l'aide de l'outil `keytool` de l' JVM, en utilisant la commande suivante :

   $JAVA_HOME/bin/keytool -importcert -file custom-crt.crt -alias instana.com -keystore cacerts -storepass changeit
    

3. Ajoutez le chemin d'accès absolu du magasin de clés en définissant la clé de configuration custom_keystore dans la racine du fichier settings.hcl .

   custom_keystore="<path_to_javakeystore>"