Docker ' da Instana arka ucunun Yapılandırılması

settings.hcl dosyası için şablon oluşturma

settings.hcl dosyası, kuruluş işlemi sırasında oluşturulur.

Gerekirse, varsayılan (boş) değerlerle bir settings.hcl dosyası yaratmak için instana settings template komutunu çalıştırın.

Varsayılan yapılandırma

Kuruluş sırasında aşağıdaki parametrelere ilişkin değerler doldurulur.

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

Veri dizinleri

Instana varsayılan olarak aşağıdaki dizin yapılarına ayarlanır.

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

Veri deposu kimlik bilgileri

Tüm veri depoları kimlik doğrulaması gerektirir. Kimlik bilgilerinin yapılandırılması isteğe bağlıdır. Belirtilmeyen kimlik bilgileri başlangıçta oluşturulur ve settings.hcl dosyasına eklenir. Parolalar settings.hcl dosyasında güncelleştirilerek değiştirilebilir. Değişiklikler instana updateçalıştırılarak uygulanır.

Not: Yalnızca parolalar değiştirilebilir, kullanıcılar düzeltilebilir ve değiştirilemez.

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

Veri saklama

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
}

Bildirimler sunucusu ayarları

Aşağıdaki ayarlara bakın:

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

Yetkili sunucu ayarları

Aşağıdaki ayarlara bakın:

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

Docker havuzu ayarları

Aşağıdaki ayarlara bakın:

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

OAuth ayarları

Aşağıdaki ayarlara bakın:

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

Son kullanıcı izleme (EUM) ayarları

Aşağıdaki ayarlara bakın:

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

HSTS ' nin Etkinleştirilmesi

HSTS ' yi genel olarak etkinleştirmek için settings.hcl dosyasının köküne aşağıdaki işareti ekleyin:

hsts_enabled = true

REST API istemcilerinin oluşturulması

Yerel açık API belirtiminin URL 'si şudur: https://{onpremhost}/docs/openapi (şirket içi yayın 170 'ten sonra). REST API istemcilerinin nasıl yapılandırılacağı hakkında ayrıntılı bilgi için bkz. Web REST API belgeleri.

Var olan sertifikaların değiştirilmesi

Var olan sertifikaları diğer sertifikalarla değiştirmek için settings.hcl dosyasındaki sertifika dosyalarınızın yollarını güncelleyin. Daha sonra, instana update -f /path/to/settings.hclkomutu çalıştırılarak sistem güncellenmelidir.

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

Webhook ya da posta bütünleştirmeleri için özel sertifikalar

Instana, SMTP sunucunuzun sunduğu sertifikayı doğrulayamazsa, aşağıdaki TLS hatasını görebilirsiniz:

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 kuruluşunuzu özel bir sertifikayla webhook 'a başarıyla veri gönderecek şekilde yapılandırmak için, JVM sertifikanızı içeren özel bir Java™ anahtar deposu (jssecacerts) sağlayabilirsiniz.

1. JVM $JAVA_HOME/lib/security/cacerts' nizden yürürlükteki bir JVM anahtar deposunu kopyalayın.
2. JVM anahtar aracını aşağıdaki komutla kullanarak özel sertifianızı bu anahtar deposuna aktarın:

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