在 Docker

建立 settings.hcl 檔的範本

在安裝程序期間會產生 settings.hcl 檔案。

必要的話，請執行指令 instana settings template ，以建立具有預設 (空白) 值的 settings.hcl 檔。

預設配置

在安裝期間，會移入下列參數的值。

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

資料目錄

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
}

通知伺服器設定

請參閱下列設定:

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

Proxy 設定

請參閱下列設定:

proxy {
  host     = "10.9.4.13"
  port     = 8080
  user     = "anonymous"
  password = "P4ssword1234"
}

Docker 儲存庫設定

請參閱下列設定:

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

OAuth 設定

請參閱下列設定:

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

一般使用者監視 (EUM) 設定

請參閱下列設定:

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

啟用 HSTS

若要廣域啟用 HSTS ，請在 settings.hcl 檔案的根目錄中新增下列旗標:

hsts_enabled = true

產生 REST API 用戶端

本端開放式 API 規格的 URL 是 https://{onpremhost}/docs/openapi (在內部部署 170 版之後)。 如需如何配置 REST API 用戶端的詳細資訊，請參閱 Web REST API 文件。

取代現有憑證

若要將現有憑證取代為其他憑證，請更新 settings.hcl 檔案中憑證檔案的路徑。 然後，必須執行 instana update -f /path/to/settings.hcl指令來更新系統。

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

Webhook 或郵件整合的自訂憑證

如果 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 ，您可以提供自訂 Java™ 金鑰儲存庫 (jssecacerts) ，其中包含 JVM 的憑證。

1. 從 JVM $JAVA_HOME/lib/security/cacerts複製現行 JVM 金鑰儲存庫。
2. 使用 JVM keytool 搭配下列指令，將自訂憑證匯入此金鑰儲存庫:

   $JAVA_HOME/bin/keytool -importcert -file custom-crt.crt -alias instana.com -keystore cacerts -storepass changeit
   ```3. Now you must add the absolute path of the keystore by using the configuration key `custom_keystore` in the `settings.hcl` file.
   
   ``` {: codeblock}
   custom_keystore="<path_to_javakeystore>"