Kubernetes üzerinde anasistem aracısının kurulması

Desteklenen Sürümler

• Instana, Kubernetes' in mevcut istikrarlı sürümünü destekler. Kubernetes ' in geçerli kararlı sürümü 1.26ise, Kubernetes algılayıcısı 1.24sürümüne sabitlendi. Kubernetes sürüm uyumluluğu garantisi uyarınca, YönOrtamı'nı; 1.26için Kubernetes sürümleri 1.22 destekler. Ancak, bu aralıktaki en düşük 2 sürüm, yumuşak kullanımdan kaldırma olarak kabul edilir.

Kuruluş yöntemleri

Instana aracısını bir Kubernetes kümesine kurmak için kullanılabilecek birkaç yöntem kullanabilirsiniz. Aracıyı bir anasisteme el ile kurarsanız, yalnızca kapsayıcılar ve süreçler izlenir ve Kubernetes verileri toplanmaz. Aracıyı İşletmen' i kullanarak kurmanız önerilir. Diğer yöntemler, Helm Chart ya da YAML file (DaemonSet) konuşlandırmasıdır.

İşletmen kullanılarak kuruluş

Instana, Instana aracısını kurmak ve yönetmek için bir Kubernetes işleci sağlar.

Instana Agent Özel Kaynak Tanımlaması ve ortam değişkenlerini kullanarak ayarlayabileceğiniz yapılandırma seçenekleri için bkz. İşletmen yapılandırması.

Helm Grafiğini Kullanarak Kur

DaemonSetile Helm grafiği, YönOrtamıcı aracısını kümenizdeki tüm zamanlanabilir düğümlere ekler.

1. Instana 'da oturum açın, More-> Agents-> Installing Instana Agents-> Kubernetesseçeneğini tıklatın.

   Bu sayfada, anasistem aracısı uç noktası ve aracı anahtarınızgerekir.

2. Technology (Teknoloji) listesinden Helm chart(Helm grafiği) seçeneğini belirleyin.

3. Küme adını ve (isteğe bağlı olarak) aracı bölgesini girin.

   Küme adı (INSTANA_KUBERNETES_CLUSTER_NAME), bu veri kümesi tarafından izlenen kümenin özelleştirilmiş adıdır.

   Aracı bölgesi (INSTANA_ZONE), altyapı eşleminde görüntülenen bölge gruplamasını uyarlamak için kullanılır.

   Diğer gerekli parametrelerin tümü önceden doldurulmuştur.

4. Helm 3 ile aşağıdaki komutu çalıştırın. Kuruluşu yapılandırmak için, --set işaretini kullanarak komut satırında değerleri belirtin ya da -f işaretini kullanarak değerlerinizi içeren bir yaml dosyası sağlayın.

   Not: Statik anasistem aracısını konuşlandırmak istiyorsanız, dümen kuruluş komutunda —set agent.image.name=containers.instana.io/instana/release/agent/static işaretini ayarlayın.

   kubectl create namespace instana-agent && \
   helm install instana-agent --namespace instana-agent \
   --repo https://agents.instana.io/helm \
   --set agent.key='<your agent key - as described above>' \
   --set agent.endpointHost='<your host agent endpoint - as described above>' \
   --set cluster.name='<your-cluster-name>' \
   --set zone.name='<your-cluster-name>' \
   instana-agent
   

   Tüm yapılandırma parametrelerinin ayrıntılı bir listesi için YönOrtamı'mıza Helm Chartbakın.

--set 'agent.tls.certificate=<YOUR_CERTIFICATE_BASE64_ENCODED>'
--set 'agent.tls.key=<YOUR_PRIVATE_KEY_BASE64_ENCODED>'

helm uninstall instana-agent

DaemonSet olarak kur

Instana aracısını Kubernetes kümenizde DaemonSet olarak kurmak ve yapılandırmak için, instana-agent.yaml dosyasını DaemonSet öğesinin yaratıldığı instana-agent ad alanını yaratacak şekilde özelleştirin. Bu, aracıları hızlı tanımlama için etiketlemenizi ya da ad alanını silerek bunların tümünü durdurmanızı sağlar.

1. Instana 'da oturum açın, More-> Agents-> Installing Instana Agents-> Kubernetesseçeneğini tıklatın.

2. Technology (Teknoloji) listesinden DaemonSet(DaemonSet) seçeneğini belirleyin.

3. Küme adını ve (isteğe bağlı olarak) aracı bölgesinigirin.

   Küme adı (INSTANA_KUBERNETES_CLUSTER_NAME), bu veri kümesi tarafından izlenen kümenin özelleştirilmiş adıdır.

   Aracı bölgesi (INSTANA_ZONE), altyapı eşleminde görüntülenen bölge gruplamasını uyarlamak için kullanılır. Kümenin varsayılan adını da belirler.

   Diğer gerekli parametrelerin tümü önceden doldurulmuştur.

4. Kopyala ' yı tıklatın ve YAML dosyasını kaydedin.

5. Aşağıdaki sarkan tutturucuları gerçek değerlerle değiştirerek YAML dosyasını düzenleyin:

   • *agentKey: Oluşturulan verilerin gönderilmesi gereken kümeye ilişkin base64 kodlanmış YönOrtamıAna anahtarı

     echo YOUR_INSTANA_AGENT_KEY | base64
     

   • *endpointHost: Kuruluşla ilişkili IP adresi ya da anasistem adı.

   • *endpointPort: Kuruluşla ilişkili ağ kapısı.

   • *clusterName: YönOrtamımda kümenize atanacak ad.

   • *zoneName: Kümenizin düğümleriyle ilişkilendirilecek aracı bölgesi .

6. Instana 'yı Kubernetes Cluster ürününüze kurmak için şu komutu çalıştırın:

   kubectl apply -f instana-agent.yaml
   

   Not: instana-agent.yaml ürününde yapacağınız ek düzenlemeler için DaemonSet yeniden oluşturulmalı. Değişiklikleri uygulamak için aşağıdaki komutları çalıştırın:

   kubectl delete -f instana-agent.yaml
   kubectl apply -f instana-agent.yaml
   

kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

kubectl label --overwrite ns instana-agent pod-security.kubernetes.io/enforce=privileged

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.

İzlenen uygulamalar için ağ erişimi yapılandırılması

Bazı uygulama tiplerinin önce aracıya ulaşması gerekir. Şu anda

• Node.js
• Git
• Ruby
• Python
• .NET Çekirdeği

Bu uygulamaların, aracının hangi IP ' de dinlediğini bilmeleri gerekir. Aracı anasistem IP 'sini otomatik olarak dinleyeceği için, bunu bir ortam değişkeninde uygulama bölmesine geçirmek için aşağıdaki Aşağı doğru API parçacığını kullanın:

spec:
  containers:
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP

Ana düğümleri izle

Varsayılan olarak, devreye alma çoğu ana düğümde ayarlanan varsayılan taint node-role.kubernetes.io/master:NoSchedule ' e uyduğu için aracı Kubernetes ana düğümlerinde zamanlanmaz. Bunların üzerine yazmak için aracı veri kümesine aşağıdaki toleransı ekleyin:

kind: DaemonSet
metadata:
  name: instana-agent
  namespace: instana-agent
spec:
  template:
  ...
    spec:
      tolerations:
        - key: "node-role.kubernetes.io/master"
          effect: "NoSchedule"
          operator: "Exists"
    ...

Daha doğrudan denetim için aracıyı ana düğümlere ayrı olarak kurun. Ortamınıza ilişkin öneriler için lütfen destek bölümüyle iletişim kurun.

İzleyici Kubernetes NGINX Giriş

Kubernetes NGINX Ingresinin ve NGINX ölçümlerinin yakalanması için aracımızın nasıl yapılandırılacağı hakkında yönergeler için İzleme NGINX sayfasına bakın. Kubernetes NGINX Ingress, OpenTracing projesi aracılığıyla da izlenebilir, bunun nasıl ayarlanacağına ilişkin yönergeler için Distributed Tracing for NGINX Ingress başlıklı konuya bakın.

Sırları

Kubernetes , hassas bilgilerin depolanması ve yönetilmesi için yerleşik desteğe sahiptir. Ancak, bu yerleşik yeteneği kullanmazsanız, ancak yine de Kubernetes kaynaklarındaki hassas verileri düzenleme yeteneğine gereksinim duyarsanız, aracı güvenlik dizgileri yapılandırması bunu destekleyecek şekilde genişletilir.

Seçilen Kubernetes kaynakları (özellikle ek açıklamalar ve kapsayıcı ortam değişkenleri) için hassas veri düzeltmesini etkinleştirmek üzere, INSTANA_KUBERNETES_REDACT_SECRETS ortam değişkenini aşağıdaki aracı yaml parçacıkında gösterildiği gibi true olarak ayarlayın:

spec:
  containers:
      env:
        - name: INSTANA_KUBERNETES_REDACT_SECRETS
          value: "true"

Daha sonra, aracıyı aracı güvenlik sırları yapılandırmasındaaçıklandığı gibi, eşleşmesi istenen güvenlik sırları listesiyle yapılandırın.

Bu yeteneğin etkinleştirilmesi Kubernetes algılayıcısında performansın düşmesine neden olabilir.

Birden çok arka uca raporla

Kubernetes aracısından birden çok arka uca raporlamayı etkinleştirmek için bkz. docker aracısı yapılandırması.

YönOrtamıaracı güvenliği ile ilgili önemli noktalar

Instana aracısının, konuşlandırıldığı düğümdeki köprü ağlarındaki uygulama bölmelerine bağlanması ve kendi bağlantı noktalarını listemesi/açması gerektiğinden, altyapı ilişkilendirmesi için anasistem ağ erişimi ve anasistem düzeyinde işlem tanıtıcısı araması gerekir. Bu, Linux & Unix üzerinde verilen izinler anasistem ortamlarına eşdeğerdir ve DaemonSet konuşlandırmasında aşağıdaki işaretlerin ayarlanmasını gerektirir:

• privileged: true , üst katman olmadan /proc 'a tam erişim, JVM eki için UID/GID' yi değiştirme ve uygulama ad alanlarına erişim sağlar.
• hostPID: true , altyapı ilişkilendirmesi için gerekli olan /prociçinde anasistem düzeyinde PID ' ler sağlar.
• hostNetwork: true , anasistem düzeyi & köprü ağ arabirimlerine erişim sağlar.

Ayrıca, OpenShift' e konuşlandırma sırasında, sözü edilen izinlere izin vermek için Güvenlik Bağlamı Kısıtlaması (SCC) privileged olarak ayarlanır.

Kubernetes algılayıcısı, Kubernetes kümesinde çalışan tüm kaynakları ve uygulamaları saptamak ve doğru izlendiğinden emin olmak için aşağıdaki küme rolü kurallarını gerektirir:

rules:
  - nonResourceURLs:
    - "/version"
    - "/healthz"
    verbs: ["get"]- apiGroups: ["batch"]
    resources:
      - "jobs"
      - "cronjobs"
    verbs: ["get", "list", "watch"]
  - apiGroups: ["extensions"]
    resources:
      - "deployments"
      - "replicasets"
      - "ingresses"
    verbs: ["get", "list", "watch"]
  - apiGroups: ["apps"]
    resources:
      - "deployments"
      - "replicasets"
      - "daemonsets"
      - "statefulsets"
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources:
      - "namespaces"
      - "events"
      - "services"
      - "endpoints"
      - "nodes"
      - "pods"
      - "replicationcontrollers"
      - "componentstatuses"
      - "resourcequotas"
      - "persistentvolumes"
      - "persistentvolumeclaims"
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources:
      - "endpoints"
    verbs: ["create", "update", "patch"]
  - apiGroups: ["networking.k8s.io"]
    resources:
      - "ingresses"
    verbs: ["get", "list", "watch"]

Örnek YAML dosyası

Tipik bir instana-agent.yaml dosyası, YönOrtamıana genel GitHub havuzu biçiminde karşıdan yüklenebilir. Bu grafik, tipik varsayılan değerlerle Helm grafiğinde görüntülenir. Tek tek özellikler, sonraki adımda olduğu gibi sarkan tutturucular olarak tanımlanır.

Bu dosyayı karşıdan yükleyin ve en son changelogdosyasını görüntüleyin.