A Container Insights-ügynök kezelése

A Container Insights a Log Analytics-ügynök linuxos tárolóalapú verzióját használja. A kezdeti üzembe helyezés után előfordulhat, hogy rutinfeladatokat vagy választható feladatokat kell végrehajtania az életciklusa során. Ez a cikk részletesen ismerteti, hogyan frissítheti manuálisan az ügynököt, és hogyan tilthatja le a környezeti változók gyűjtését egy adott tárolóból.

A Container Insights-ügynök frissítése

A Container Insights a Log Analytics-ügynök linuxos tárolóalapú verzióját használja. Az ügynök új verziójának kiadásakor az ügynök automatikusan frissül az Azure Kubernetes Service (AKS) és az Azure Red Hat OpenShift 3.x verzióján üzemeltetett felügyelt Kubernetes-fürtökön. Egy hibrid Kubernetes-fürt és az Azure Red Hat OpenShift 4.x-es verziója esetén az ügynök nincs felügyelve, és manuálisan kell frissítenie az ügynököt.

Ha egy AKS-en vagy az Azure Red Hat OpenShift 3.x-es verzióján üzemeltetett fürt ügynökfrissítése meghiúsul, ez a cikk az ügynök manuális frissítésének folyamatát is ismerteti. A kiadott verziók követéséhez tekintse meg az ügynök kiadási közleményeit.

Ügynök frissítése az AKS-fürtön

Az ügynök AKS-fürtökön való frissítésének folyamata két lépésből áll. Az első lépés a Monitorozás letiltása a Container Insights használatával az Azure CLI használatával. Kövesse a Figyelés letiltása című cikkben leírt lépéseket. Az Azure CLI használatával anélkül távolíthatjuk el az ügynököt a fürt csomópontjairól, hogy ez hatással lenne a megoldásra és a munkaterületen tárolt megfelelő adatokra.

Megjegyzés

A karbantartási tevékenység végrehajtása közben a fürt csomópontjai nem továbbítják az összegyűjtött adatokat, és a teljesítménynézetek nem jelenítik meg az adatokat az ügynök eltávolítása és az új verzió telepítése között.

Az ügynök új verziójának telepítéséhez kövesse az Azure CLI-vel végzett monitorozás engedélyezésének lépéseit a folyamat befejezéséhez.

A monitorozás ismételt engedélyezése után körülbelül 15 percet vehet igénybe, mire megtekintheti a fürt frissített állapotmetrikáit. Az ügynök sikeres frissítésének ellenőrzéséhez a következőkre van lehetőség:

  • Futtassa a következő parancsot: kubectl get pod <omsagent-pod-name> -n kube-system -o=jsonpath='{.spec.containers[0].image}'. A visszaadott állapotban jegyezze fel az omsagent képe alatti értéket a kimenet Tárolók szakaszában.
  • A Csomópontok lapon válassza ki a fürtcsomópontot, és a jobb oldali Tulajdonságok panelen jegyezze fel az Ügynök képcímkéje alatti értéket.

Az ügynök megjelenített verziójának meg kell egyeznie a Kiadási előzmények lapon felsorolt legújabb verzióval.

Ügynök frissítése hibrid Kubernetes-fürtön

A következő lépésekkel frissítheti az ügynököt egy kubernetes-fürtön, amelyen fut:

  • Az Azure-ban üzemeltetett önkiszolgáló Kubernetes-fürtök az AKS Engine használatával.
  • Az Azure Stacken vagy a helyszínen, az AKS Engine használatával üzemeltetett, ön által felügyelt Kubernetes-fürtök.
  • Red Hat OpenShift 4.x verzió

Ha a Log Analytics-munkaterület a kereskedelmi Azure-ban található, futtassa a következő parancsot:

$ helm upgrade --set omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<my_prod_cluster> incubator/azuremonitor-containers

Ha a Log Analytics-munkaterület az Azure China 21Vianetben található, futtassa a következő parancsot:

$ helm upgrade --set omsagent.domain=opinsights.azure.cn,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Ha a Log Analytics-munkaterület az Azure US Governmentben található, futtassa a következő parancsot:

$ helm upgrade --set omsagent.domain=opinsights.azure.us,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Ügynök frissítése az Azure Red Hat OpenShift v4-en

Az alábbi lépéseket követve frissítheti az ügynököt az Azure Red Hat OpenShift 4.x verzióján futó Kubernetes-fürtön.

Megjegyzés

Az Azure Red Hat OpenShift 4.x verziója csak az Azure kereskedelmi felhőben való futtatásokat támogatja.

curl -o upgrade-monitoring.sh -L https://aka.ms/upgrade-monitoring-bash-script
export azureAroV4ClusterResourceId="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/<clusterName>"
bash upgrade-monitoring.sh --resource-id $ azureAroV4ClusterResourceId

Környezeti változók gyűjtésének letiltása tárolón

A Container Insights környezeti változókat gyűjt a podon futó tárolókból, és a Tárolók nézetben a kiválasztott tároló tulajdonságpaneljén jeleníti meg őket. Ezt a viselkedést úgy szabályozhatja, hogy letiltja egy adott tároló gyűjteményét a Kubernetes-fürt üzembe helyezése során, vagy a AZMON_COLLECT_ENV környezeti változó beállításával. Ez a funkció az ügynök verziójában érhető el – a ciprod11292018-as és újabb verzióiban.

Ha le szeretné tiltani a környezeti változók gyűjtését egy új vagy meglévő tárolón, állítsa be a AZMON_COLLECT_ENV változót False értékkel a Kubernetes üzembehelyezési yaml-konfigurációs fájljában.

- name: AZMON_COLLECT_ENV  
  value: "False"  

Futtassa a következő parancsot a módosítás Azure Red Hat OpenShifttől eltérő Kubernetes-fürtökre való alkalmazásához: kubectl apply -f <path to yaml file> A ConfigMap szerkesztéséhez és a módosítás Azure Red Hat OpenShift-fürtökre való alkalmazásához futtassa a következő parancsot:

oc edit configmaps container-azm-ms-agentconfig -n openshift-azure-logging

Ezzel megnyitja az alapértelmezett szövegszerkesztőt. A változó beállítása után mentse a fájlt a szerkesztőbe.

A konfigurációmódosítás érvénybe lépésének ellenőrzéséhez válasszon ki egy tárolót a Container Insights Tárolók nézetében, majd a tulajdonságpanelen bontsa ki a Környezeti változók elemet. A szakaszban csak a korábban létrehozott változónak kell megjelennie – AZMON_COLLECT_ENV=HAMIS. Minden más tároló esetében a Környezeti változók szakasznak fel kell sorolnia az összes felderített környezeti változót.

A környezeti változók felderítésének újbóli engedélyezéséhez alkalmazza ugyanezt a folyamatot korábban, módosítsa az értéket False értékről Igaz értékre, majd futtassa újra a kubectl parancsot a tároló frissítéséhez.

- name: AZMON_COLLECT_ENV  
  value: "True"  

Következő lépések

Ha problémákat tapasztal az ügynök frissítése során, tekintse át a hibaelhárítási útmutatót támogatásért.