Docker üzerine Anasistem Aracısı Kurulte ve

YönOrtamıAna aracısı taşıyıcı görüntüsünün çeklması,,-

Instana Agent görüntüsü icr.io/instana/agent:latestadresindeki IBM Cloud Container Registry genel kullanıma açık IBM Cloud Container Registry içinden edinilebilir.

Ayrıca, dinamik ve statik Agent görüntülerine containers.instana.ioadresindeki Container Registry (Taşıyıcı Kaydı) başlıklı sundan ya ... ve Aracı anahtarınızla oturum açın ve uygun resmi çekin:

docker login containers.instana.io -u _ -p <agent_key>

# pull the dynamic image, powered by the Azul JDK
docker pull containers.instana.io/instana/release/agent/dynamic:latest

# download the static image, powered by the Azul JDK
docker pull containers.instana.io/instana/release/agent/static:latest

# pull the dynamic image, powered by the OpenJ9 JDK
docker pull containers.instana.io/instana/release/agent/dynamic:latest-j9

# download the static image, powered by the OpenJ9 JDK
docker pull containers.instana.io/instana/release/agent/static:latest-j9

Kullanılabilir etiketleri listeleme

Kullanılabilir resim etiketlerini listelemek için icr.io genel etiket listesini sorgulayın. Görüntü etiketleri icr.io genel kayıt defteri ve containers.instana.io YönOrtamıyla belki en olan dü ' şme kaydı ile kullanılabilir.

Sorguyu sorgulamak için komut satırı araçları Curl ve çıkışı süzmek için jq gerekir. Kullanılabilir tüm etiketleri listelemek için aşağıdaki komutu girin:

curl https://icr.io/v2/instana/agent/tags/list | jq

Etiketleri bir YönOrtamıana arka uç sürümüne göre süzmek için aşağıdaki komutu girin. Aşağıdaki örnekte <backend_version> yerine YönOrtamıana sürümünü girin:

INSTANA_VERSION=<backend_version> && curl https://icr.io/v2/instana/agent/tags/list | jq '.tags[] | select(. | contains ("'"$INSTANA_VERSION"'"))'

YönOrtamıaracı Taşıyıcısı Görüntüsünün çalıştırılması

Docker , birçok Kubernetestabanlı hizmet, DC/OS ve diğerleri gibi çok sayıda platforma güç sağlar. Bu nedenle, YönOrtamıAracı Docker görüntüsünü çalıştırma yöntemi, kullanılmakta olan platforma bağlıdır. Instana anasistem aracısının kurulabileceği altyapıların listesi için install the Instana host agent belgesine bakın.

Ne tür bir konteynerli çevreye sahipsiniz?

Aracıyı doğrudan Linux Anasisteminekurabilirsiniz; örneğin, çalışan makineleriniz için belirli bir görüntü varsa. Her tür kapsayıcı teknolojisinin şu anda yalnızca Linux üzerinde barındırma işletim sistemi olarak desteklendiğini unutmayın (örneğin, Mac üzerinde Docker-Machine ya da Windows üzerinde Docker desteklenmez).

YönOrtamıcı aracısı taşıyıcı görüntüsünün yükseltilmesi

Bazı durumlarda, Agent Container Image öğesini el ile güncellemek için aşağıdaki komutu çalıştırmanız gerekir. <your-architecture> yerine, mimarinize göre amd64, arm64, s390x ya da ppc64leseçeneklerinden birini koyun:

skopeo inspect docker://icr.io/instana/agent:latest-<your-architecture>-dynamic | jq '.Digest'

OpenJ9 değişkenini çalıştırıyorsanız şu komutu çalıştırın:

skopeo inspect docker://icr.io/instana/agent:latest-<your-architecture>-dynamic-j9 | jq '.Digest'

Bunu kuruluşunuzda kullandığınız ile karşılaştırın. Kurulu olduğunuz YönOrtamıcı Aracı docker görüntüsünü denetlemek için Kubernetes > Kümem > Ad Alanları > instana-aracıöğelerini seçin, bir aracı bölmesi seçin, instana-aracı kapsayıcısını seçin ve Docker gösterge panosunda Image SHA ' yı karşılaştırın.

Helm olanağını en son Helm grafiğine yükseltmek için kullanıyorsanız:

helm upgrade --repo https://agents.instana.io/helm instana-agent --reuse-values --set agent.image.tag=latest --set agent.image.pullPolicy=Always instana-agent

Kubernetes Yaml kullanıyorsanız, ad alanını silin ve aracıyı yeniden kurun:

kubectl apply -f <your-instana-agent-daemonset.yaml>

Herhangi bir sorunuz varsa destek ile iletişim kurun.

Özel kapsayıcılar kullanılarak kurma

Instana tarafından sağlanan Agent Docker kapsayıcıları, YönOrtamıAracı Docker projesindekitanımlamaya göre oluşturulmuştur.

Instana tarafından desteklenmese de, Agent görüntülerimizi daha fazla uyarlamamız için nedenler olabilir. YönOrtamıAracı Docker projesini referans olarak kullanmanızı öneririz.

Kuruluşu

  1. Instana 'da oturum açın, Diğer-> Aracılar-> YönOrtamıcı kuruluşu-> Dockerseçeneklerini tıklatın.

    Aracı anahtarı ve anasistem aracısı uç noktası , tek satırlı komutta önceden doldurulur.

  2. Instana aracısı, aşağıdaki komut kullanılarak ayrıcalıklı bir taşıyıcı olarak yürütülebilir:

    sudo docker run \
      --detach \
      --name instana-agent \
      --volume /var/run:/var/run \
      --volume /run:/run \
      --volume /dev:/dev:ro \
      --volume /sys:/sys:ro \
      --volume /var/log:/var/log:ro \
      --privileged \
      --net=host \
      --pid=host \
      --env="INSTANA_AGENT_KEY=your Instana agent key" \
      --env="INSTANA_AGENT_ENDPOINT=the host agent endpoint" \
      --env="INSTANA_AGENT_ENDPOINT_PORT=the host agent endpoint port" \
      icr.io/instana/agent
    

Çalıştırıldığında, aracı günlüğü aşağıdaki komut kullanılarak kullanılabilir:

docker logs instana-agent

Anasistem aracısının durumunun denetlenmesi

Anasistem aracısını kurduktan sonra, instana kullanıcı arabiriminde ya da anasistemde anasistem aracısının durumunu denetleyebilirsiniz. Daha fazla bilgi için Anasistem aracısının durumunun denetlenmesibaşlıklı konuya bakın.

Aracı Yapılandırması

Gerekli ortam değişkenlerine ek olarak, başlatma sırasında ek değişkenler de yapılandırılabilir:

Değişken Adı Zorunlu Varsayılan Değer Yorum
INSTANA_AGENT_KEY Evet Yok İçgüdü ajan anahtarın.
YÖNORTAMI_ARACI_UÇ NOKTASı Evet Yok Anasistem aracısı uç noktası.
INSTANA_AGENT_ENDPOINT_PORT Evet Yok Anasistem aracısı uç noktası kapısı.
INSTANA_AGENT_ZONE Hayır Yok Anasistemin bölge adı.
INSTANA_AGENT_TAGS Hayır Yok Anasistem etiketlerinin virgülle ayrılmış listesi.
INSTANA_AGENT_MODE Hayır Uygulama Performansı Yönetimi (APM) APM, INFRASTRUCTUREya da AWS.
YÖNORTAMI_YÜKLEME_ANAHTARI Hayır Yok YönOrtamı'nuz yükleme anahtarı.
INSTANA_AGENT_UPDATES_VERSION Hayır Yok Sensör sürümlerini belirli bir SHA ' ya sabitle. Daha fazla bilgi için bkz. Güncelleştirmeler ve sürüm sabitleme.
INSTANA_AGENT_UPDATES_FREQUENCY Hayır gün Algılayıcı güncellemelerinin getirilme sıklığını denetleyin. Daha fazla bilgi için bkz. Güncelleştirmeler ve sürüm sabitleme.
INSTANA_AGENT_UPDATES_TIME Hayır 04:30 Algılayıcı güncellemelerinin getirildiği saati denetleyin. Daha fazla bilgi için bkz. Güncelleştirmeler ve sürüm sabitleme.
INSTANA_AGENT_PROXY_HOST Hayır Yok Bir yetkili sunucunun anasistem adı/adresi.
KANıT_AğLANTıSı KAPıSı Hayır Yok Yetkili sunucunun kapısı.
INSTANA_AGENT_PROXY_PROTOCOL Hayır Yok Yetkili sunucu iletişim kuralı; örneğin, http.
INSTANA_AGENT_PROXY_USER Hayır Yok Yetkili sunucu kimlik doğrulaması kullanıcı adı.
INSTANA_AGENT_PROXY_PASSWORD Hayır Yok Yetkili sunucu kimlik doğrulaması parolası.
INSTANA_AGENT_PROXY_USE_DNS Hayır yanlış Yetkili sunucu DNS de yaparsa Boole değeri.
INSTANA_GIT_REMOTE_REPOSITORY (eşgörünüm_uzak_havuzu) Hayır Yok Gittabanlı yapılandırma yönetimi için anasistem aracısı tarafından kullanılacak Git uzak URL 'si. INSTANA_GIT_REMOTE_BRANCH ayarlandıysa değişken ayarlanmalıdır.
INSTANA_GIT_REMOTE_BRANCH Hayır Yok Git uzak dalı, Gittabanlı yapılandırma yönetimi için anasistem aracısı tarafından izlenecek. INSTANA_GIT_REMOTE_REPOSITORY ayarlandıysa değişken ayarlanmalıdır.
INSTANA_REPOSITORY_PROXY_ENABLED (eşgörünüm_havuz_proxy_etkin) Hayır Yok Özellikle Algılayıcı güncellemeleri için yetkili sunucu ayarlarını geçersiz kılmayı etkinleştirin.
INSTANANIYK yılvariyçıkarvariyvariy_proxy_host Hayır Yok Maven Sensors havuzuna ilişkin bir yetkili sunucunun anasistem adı/adresi.
INSTANA_REPOSITORY_PROXY_PORT (havuz_havuz_proxy_kapısı) Hayır Yok Maven Sensors havuzu için yetkili sunucunun kapısı.
INSTANA_REPOSITORY_PROXY_PROTOCOL Hayır Yok Maven Sensors havuzuna ilişkin yetkili sunucu protokolü.
KURULUş_ORreION_denetler YA DA KULLANıCı IçIN Hayır Yok Maven Sensors havuzu için yetkili sunucu kimlik doğrulaması kullanıcı adı.
INSTANA_REPOSITORY_PROXY_PASSWORD (havuz_havuz_proxy_parolası) Hayır Yok Maven Sensors havuzuna ilişkin yetkili sunucu kimliğinin olanlara belki de parolası.
INSTANA_MVN_REPOSITORY_URL Hayır Yok Dinamik aracı ve algılayıcı paketi karşıdan yüklemelerine ilişkin Maven havuzunun anasistem adı. Daha fazla bilgi için bkz. Aracı havuzu ikizini yapılandırma).
INSTANA_MVN_REPOSITORY_FEATURES_PATH Hayır Yok Özellik güncellemeleri için Maven havuzu yolu. Daha fazla bilgi için bkz. Aracı havuzu ikizini yapılandırma).
INSTANA_MVN_REPOSITORY_SHARED_PATH Hayır Yok Aracı ve algılayıcı paketi için Maven havuz yolu güncellemeleri. Daha fazla bilgi için bkz. Aracı havuzu ikizini yapılandırma).
INSTANA_LOG_LEVEL Hayır BİLGİ INFO, DEBUG, TRACE, WARN, ERROR ya da OFF.

Ana yapılandırma dosyaları /root dizinine takılabilir ve aracı tarball paketi açıldığında yerine kopyalanacak.

Birim bağlamaları ile aracı yapılandırmasının geçersiz kılınması

Docker birim özelliğini kullanarak aracı yapılandırma dosyalarını değiştirebilirsiniz. Aracının resimle birlikte sağlanan configuration.yaml değeri varsayılan değerleri tanımlar ve üzerine yazılmayabilir . configuration-<custom-extension>.yaml adlı özel yapılandırma parçacıkları tarafından şu şekilde genişletilebilir:

--volume <host-path>/configuration-<custom-extension>.yaml:/opt/instana/agent/etc/instana/configuration-<custom-extension>.yaml

Örneğin, MySQL kimlik bilgileri için bir configuration-mysql.yaml olması ve kapsayıcı başlangıcı sırasında bu yapılandırma dosyasının eklenmesi örnek bir kullanım senaryodur.

configuration-mysql.yaml

# Mysql
com.instana.plugin.mysql:
  user: 'mysqlAdmin'
  password: 'mysqlSecretPassword'

docker run volume mount

--volume /opt/instana-agent/etc/instana/configuration-mysql.yaml:/opt/instana/agent/etc/instana/configuration-mysql.yaml

Birden çok arka ucu yapılandırma

Instana anasistem aracısı birden çok arka uca rapor vermek üzere yapılandırılabilir. Yapılandırmayla ilgili genel bilgiler ve notlar için Birden çok arka ucu yapılandırmabaşlıklı konuya bakın.

Instana anasistem aracısı taşıyıcı görüntüleri, com.instana.agent.main.sender.Backend-2.cfggibi arka uç dosyaları takılarak kolayca yapılabilecek şekilde özel olarak yapılandırılır.

Konteynerle alıştırılmış bir aracı için örnek bir bağımsız değişken aşağıdaki gibidir:

--mount type=bind,source=<path-to-additional-backend-config>,target=/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend-2.cfg

Aracı havuzu ikizinin yapılandırılması

Kendi aracı havuzu ikizinizi sağladığınızda, dinamik aracının INSTANA_MVN_REPOSITORY_URL, INSTANA_MVN_REPOSITORY_SHARED_PATH ve INSTANA_MVN_REPOSITORY_FEATURES_PATH ortam değişkenlerini kullanarak yapılandırılması gerekir. Hangi değerlerin yapılandırılacağı hakkında bilgi için lütfen Agent Repository mirror documentation (Aracı havuzu ikizleme belgeleri) içindeki örneğe bakın.

Aracı yetkili sunucu ayarları

Instana Agent iki farklı uç noktaya ulaşır; tüm toplanan verileri gönderen arka uç sistemimiz ve Agent ve Sensor güncellemelerini getirmek için bir havuz. Her ikisi de yetkili sunucu ayarlarını kullanmak üzere yapılandırılabilir (ayrı olarak). 3 seçenek vardır:

  1. Her iki uç nokta için yetkili sunucu ayarları yok-yetkili sunucu ayarları yapılandırmanıza gerek yok

  2. Hem arka uç hem de havuz için aynı yetkili sunucu ayarları-yalnızca 'Aracı' yetkili sunucu ayarlarını yapılandırmanız gerekir

  3. Arka uç ve havuz için farklı yetkili sunucu ayarları-her iki yetkili sunucuyu ayrı ayrı yapılandırın ve INSTANA_REPOSITORY_PROXY_ENABLED=true ayarını tanımladığınızdan emin olun

    Örneğin, yalnızca havuz için yetkili sunucu yapılandırmanız gerekiyorsa aşağıdaki yapılandırmayı kullanın:

    • Tüm INSTANA_AGENT_PROXY_ değişkenlerini "" (boş dizgi) olarak ayarlayın.
    • Belirle INSTANA_REPOSITORY_PROXY_ENABLED=true
    • Tüm INSTANA_REPOSITORY_PROXY_ ' i yetkili sunucu yapılandırmasına gerektiği şekilde ayarlayın.

Havuz için değil, arka uç için bir yetkili sunucu gerekirken, aynı durum diğer türlü de geçerlidir.

Güncellemeler ve sürüm sabitleme

INSTANA_AGENT_UPDATES_VERSION, INSTANA_AGENT_UPDATES_FREQUENCY ve INSTANA_AGENT_UPDATES_TIME ortam değişkenlerini kullanarak aracı algılayıcısı sürümlerinin belirli bir sürüme sabitlenip sabitlenmeyeceğini denetleyebilirsiniz. Bu, yeni güncelleştirmelerin ne zaman getirileceği denetlemenizi sağlar.

Bu ayarlarla ilgili ek bilgi için Agent Configuration (Aracı Yapılandırması) belgelerine bakın.

INSTANA_AGENT_UPDATES_FREQUENCY parametresi için geçerli seçenekler şunlardır:

  • DAY (günlük güncellemeler için)
  • MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ya da SUNDAY

İki nokta üst üste ile ayrılmış olarak birden çok seçenek sağlanabilir.

GPU izlemenin etkinleştirilmesi

Aşağıdaki Nvidia Grafik Kartları desteklenir.

Marka Modeli
Tesla. S1070, S2050, C1060, C2050/70, M2050/70/90, X2070/90, K10, K20, K20X, K40, K80, M40, P40, P100, V100
Quadro. 4000, 5000, 6000, 7000, M2070-Q, K-serisi, M-serisi, P-serisi, RTX serisi
GeForce Tesla ve Quadro ürünlerinden daha az ölçüyle değişen ait 'tan ait ait ürün yardımları

Desteklenen işletim sistemi: Linux.

Önkoşullar:

  • En az Docker sürümü 19.03.
  • Son resmi Nvidia sürücüleri kuruldu. Paket yöneticileri aracılığıyla kurulan sürücüler yeterli değildir.
  • NVIDIA Container Toolkit kuruldu.

GPU izlemesini etkinleştirmek için, bir ya da daha çok GPU ' da YönOrtamıaracı taşıyıcısını başlatın. Aracı, ayrıcalıklı bir kapsayıcı olarak başlatılabilir.

Aracı, aracının kaç GPU çalıştırdığına bakılmaksızın desteklenen tüm sistem genelinde kullanılabilir GPU ' lar için metrikler k-kadarını sistemden k-sistemden toplar.

Toplanan ölçümlerin ayrıntılı bir listesi için GPU belgelergidin görsa yine lerde sa lerde sa.

Aracı kapsayıcısını GPU ' ları kullanarak başlatmanın birkaç yolu vardır:

  • kullanılabilir tüm GPU ' larda başlamak için --gpus all işaretini sağlayın.
  • Tam GPU sayısından başlamak için --gpus <number of gpus to use> işaretini sağlayın.
  • istenen GPU ' ları başlatmak için --gpus '"device=<gpu1-uuid>,<gpu2-uuid>"' işaretini sağlayın.