Docker üzerine Anasistem Aracısı Kurulte ve
- YönOrtamıaracı taşıyıcısı görüntüsünün çekilmesi
- YönOrtamıaracı taşıyıcısı görüntüsünün çalıştırılması
- YönOrtamıcı aracısı taşıyıcı görüntüsünün yükseltilmesi
- Özel kapsayıcılar kullanılarak kurma
- Kuruluş
- Anasistem aracısının durumunun denetlenmesi
- Aracı Yapılanışı
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
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
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.
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:
Her iki uç nokta için yetkili sunucu ayarları yok-yetkili sunucu ayarları yapılandırmanıza gerek yok
Hem arka uç hem de havuz için aynı yetkili sunucu ayarları-yalnızca 'Aracı' yetkili sunucu ayarlarını yapılandırmanız gerekir
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=trueayarı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.
- Tüm
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,SATURDAYya daSUNDAY
İ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 alliş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.