在 Docker 上配置 Instana 后端

settings.hcl 文件是在安装过程中生成的。 该文件包含所有配置，例如下载密钥、销售密钥，以及与 Instana 相关的配置，如配置文件、租户名称、单位名称和环境的主机名。 安装 Instana 后端需要这些配置。 您可以配置此文件，然后 Instana-console 使用该文件来安装自托管经典版（ Docker ）。

如果需要，请通过运行以下命令创建具有缺省 (空) 值的 settings.hcl 文件:

instana settings template
 

安装期间将填充以下参数的值:

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>"
}
 

如果要更改参数，请运行 vi settings.hcl 命令。 要将新配置设置应用到您的经典版 ，请运行 instana update 该命令。

Instana 默认采用以下目录结构：

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

所有数据存储器都需要认证。 可选: 配置凭证。 初始生成未指定的凭证并将其添加到 settings.hcl 文件。 您可以通过在 settings.hcl 文件中更新密码来更改密码。

要应用更改，请运行以下命令:

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"
}
...
 

要在全局范围内启用 HTTP 严格传输安全 ( HSTS )，请在 文件 settings.hcl 根目录下添加以下标记：

hsts_enabled = true
 

本地开放式 API 规范的 URL 地址为 https://{onpremhost}/docs/openapi （自本地版本 170 起）。 有关如何配置 REST API 客户端的更多信息，请参阅 Web REST API 文档。

要将现有证书替换为其他证书，请使用以下命令更新 settings.hcl 文件中证书文件的路径:

cert {
...
}
 

然后，通过运行以下命令来更新系统:

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

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

如果 Instana 无法验证您的 SMTP 服务器提供的证书，您可能会看到以下 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
 

要配置您的 Instana 安装，使其能够使用自定义证书成功将数据发送至Webhook，请提供一个包含您的JVM证书的自定义 Java™ 密钥库（jssecacerts）。

请按照以下步骤配置您的 Instana 安装：

1. 从 JVM 中复制当前的 JVM$JAVA_HOME/lib/security/cacerts密钥库。

2. 请使用 JVM 的keytool工具，通过以下命令将您的自定义证书导入此密钥库：

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

3. 通过在 settings.hcl 文件的根目录中设置 custom_keystore 配置密钥，添加密钥库的绝对路径。

   custom_keystore="<path_to_javakeystore>"