在 Docker 上配置 Instana 后端

为 settings.hcl 文件创建模板

settings.hcl 文件是在安装过程中生成的。 此文件具有所有配置，例如，下载密钥，销售密钥， Instana 相关配置 (例如，概要文件，租户名称，单元名称和环境主机名)。 安装 Instana 后端需要这些配置。 您可以配置此文件，然后 Instana-console 使用此文件来安装 Self-Hosted Classic Edition (Docker)。

如果要安装 Instana ，那么需要安装 settings.hcl 文件。

如果需要，请通过运行以下命令创建具有缺省 (空) 值的 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"
}
...

数据保留

retention {
  metric_roll_up_5     = 86400
  metric_roll_up_60    = 2678400
  metric_roll_up_300   = 8035200
  metric_roll_up_3600  = 34214400
}

env_var "FLAGS_retention_10s"{
  value="86400"
}
env_var "FLAGS_retention_60s"{
  value="2678400"
}
env_var "FLAGS_retention_300s"{
  value="8035200"
}
env_var "FLAGS_retention_3600s"{
  value="34214400"
}

retention {
  app_data_short_term  = 7
}

设置

docker_repository {
  base_url = "my.mirror.internal/v2/artifact-public.instana.io"
  username = "user"
  password = "pass"
}

eum {
  tracking_base_url     = "https://mobile.acmecorp.com/eum/"
}

email {
  smtp {
    from      = "notif@acmecorp.com"
    host      = "relay-1.acme.internal"
    port      = 25
    user      = "ops-notif@acmecorp.com"
    password  = "yUnoEm41l"
    use_ssl   = true
    start_tls = false
  }
}

o_auth {
  client_id     = "123456-1n574n4adgjlmnop.apps.googleusercontent.com"
  client_secret = "XNLV-fpf_deadBeEf1234"
}

proxy {
  host     = "10.9.4.13"
  port     = 8080
  user     = "anonymous"
  password = "P4ssword1234"
  non_proxyHosts = ["google.com"]
}

启用 HSTS

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

hsts_enabled = true

生成 REST API 客户端

本地开放式 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 $JAVA_HOME/lib/security/cacerts复制当前 JVM 密钥库。

2. 通过使用带有以下命令的 JVM 密钥工具，将定制证书导入到此密钥库中:

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