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.