Docker での Instana バックエンドの設定

settings.hcl ファイルは、インストール・プロセス中に生成されます。 このファイルには、ダウンロードキー、セールスキー、プロファイル、テナント名、ユニット名、環境のホスト名など、 Instana に関連するすべての設定が含まれています。 Instana バックエンドをインストールするには、これらの設定が必要です。 このファイルを設定すると、このファイルを使用してセルフホスト型クラシックエディション（ DockerInstana-console ）がインストールされます。

必要に応じて、以下のコマンドを実行して、デフォルト (空) 値を使用して 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 コマンドを実行します。 新しい設定を Classic Edition に適用するには、コマンド 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 のStrict Transport Security（ 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 にある現在の $JAVA_HOME/lib/security/cacertsJVM キーストアをコピーしてください。

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