A Container Insights-ügynök kezelése

  • Cikk

A tároló Elemzések a Log Analytics-ügynök linuxos tárolóalapú verzióját használja. After initial deployment, you might need to perform routine or optional tasks during its lifecycle. Ez a cikk azt 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.

Megjegyzés:

Ha már üzembe helyezett egy AKS-fürtöt, és engedélyezte a monitorozást az Azure CLI vagy a Resource Manager-sablon használatával, nem használhatja kubectl az ügynök frissítésére, törlésére, ismételt üzembe helyezésére vagy üzembe helyezésére. A sablont ugyanabban az erőforráscsoportban kell üzembe helyezni, mint a fürtöt.

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

A tároló Elemzések 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 Arc-kompatibilis Kubernetes felügyelt Kubernetes-fürtökön.

Ha az ügynök frissítése meghiúsul az AKS-ben üzemeltetett fürtök esetében, 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.

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

Az ügynök AKS-fürtön való frissítésének folyamata két lépésből áll. Első lépésként tiltsa le a monitorozást a Container Insights használatával az Azure CLI használatával. Kövesse a Tárolóelemzések letiltása a Kubernetes-fürtről szóló cikkben leírt lépéseket. Az Azure CLI használatával anélkül távolíthatja el az ügynököt a fürt csomópontjairól, hogy az hatással van 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. 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.

A második lépés az ügynök új verziójának telepítése. A folyamat befejezéséhez kövesse a figyelés engedélyezése az Azure CLI használatával című cikkben leírt lépéseket.

A monitorozás újrakonfigurálása után körülbelül 15 percbe telhet, mire megtekintheti a fürt frissített állapotmetrikáit. Két módszere van az ügynök sikeres frissítésének ellenőrzésére:

  • Run the command kubectl get pod <ama-logs-agent-pod-name> -n kube-system -o=jsonpath='{.spec.containers[0].image}'. A visszaadott állapotban jegyezze fel az Azure Monitor-ügynök képe alatti értéket a kimenet Tárolók szakaszában.
  • A Csomópontok lapon válassza ki a fürtcsomópontot. 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.

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

Hajtsa végre az alábbi lépéseket az ügynök frissítéséhez egy kubernetes-fürtön, amelyen fut:

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

Ha a Log Analytics-munkaterület 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 a 21Vianet által üzemeltetett Microsoft Azure-ban 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

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

A tároló Elemzések összegyűjti a podon futó tárolók környezeti változóit, és a Tárolók nézetben a kijelölt tároló tulajdonságpanelé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 környezeti változó AZMON_COLLECT_ENVbeállításával. Ez a funkció a ciprod11292018 és újabb ügynökverzióból érhető el.

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 változó AZMON_COLLECT_ENV értékét False 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 alkalmazásához az Azure Red Hat OpenShiften kívüli Kubernetes-fürtökre: kubectl apply -f <path to yaml file>. A ConfigMap szerkesztéséhez és a módosítás Azure Red Hat OpenShift-fürtökhöz való alkalmazásához futtassa a következő parancsot:

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

Ez a parancs 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 Tárolók nézetben a Container Insightsban. A tulajdonságpanelen bontsa ki a Környezeti változók elemet. A szakasznak csak a korábban létrehozott változót kell megjelenítenie, azaz .AZMON_COLLECT_ENV=FALSE Az összes többi 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 újravehető felderítéséhez alkalmazza ugyanazt a folyamatot, amelyet korábban használt, és módosítsa az értéket a következőre FalseTrue: . Ezután futtassa újra a kubectl parancsot a tároló frissítéséhez.

- name: AZMON_COLLECT_ENV  
  value: "True"

A Container Insights-ügynök verziójának szemantikai verziófrissítése

A tároló Elemzések a rendszerkép verzióját és az elnevezési konvenciót [szemver formátum] (https://semver.org/) értékre módosította. A SemVer segít a fejlesztőknek nyomon követni a szoftver fejlesztési fázisában történt minden változást, és biztosítja, hogy a szoftververziók egységesek és értelmezhetőek legyenek. A régi verzió ciprod timestamp-commitId és win-ciprod<<timestamp-commitId<>> formátumú volt, első képverzióink a Semver formátumot használva a 3.1.4-es linuxos és a win-3.1.4-es windowsos verziót használták.><>

A Semver egy univerzális szoftververziós séma, amely a MAJOR formátumban van definiálva. KISEBB. PATCH, amely a következő korlátozásokat követi:

  1. Inkompatibilis API-módosítások esetén növelje a FŐ verziót.
  2. Növelje a MINOR verziót, ha visszamenőlegesen kompatibilis módon ad hozzá funkciókat.
  3. Ha visszamenőlegesen kompatibilis hibajavításokat készít, növelje a PATCH-verziót.

A Kubernetes és az OSS-ökoszisztéma növekedésével a Container Elemzések migrálni a Semver-rendszerkép használatára a K8s által ajánlott szabvány szerint, ahol minden egyes alverzió bevezetésekor minden kompatibilitástörő módosítást nyilvánosan dokumentálni kellett minden új Kubernetes-kiadással.

Ismétlődő ügynökök javítása

Ha 2022 októbere előtt manuálisan engedélyezte a Tároló Elemzések egyéni metódusokkal, az ügynök több verziója is futhat együtt. A duplikáció törléséhez kövesse az alábbi lépéseket.

  1. Gyűjtsön adatokat az egyéni beállításokról, például az omsagent tárolók memória- és CPU-korlátairól.

  2. Tekintse át az ama-naplók alapértelmezett erőforráskorlátait, és állapítsa meg, hogy megfelelnek-e az igényeinek. Ha nem, előfordulhat, hogy létre kell hoznia egy támogatási témakört a memória/processzorkorlátok vizsgálatához és váltásához. Ez segíthet elháríteni azokat a méretezési korlátozásokat, amelyeket egyes ügyfelek korábban OOMKilled kivételeket eredményeztek.

    OS Vezérlő neve Alapértelmezett korlátok
    Linux ds-cpu-limit-linux 500m
    Linux ds-memory-limit-linux 750Mi
    Linux rs-cpu-limit 1
    Linux rs-memory-limit 1.5Gi
    Ablakok ds-cpu-limit-windows 500m
    Ablakok ds-memory-limit-windows 1Gi

  3. Erőforrások törlése az előző előkészítésből:

    Ha korábban helm-diagramot használt:

    Listázz minden kiadást a névterek között a következő paranccsal:

     helm list --all-namespaces

    Törölje a Container Insightshoz telepített diagramot a következő paranccsal:

    helm uninstall <releaseName> --namespace <Namespace>

    Ha korábban yaml-telepítést használt:

    Töltse le az előző egyéni üzembehelyezési yaml-fájlt a következő paranccsal:

    curl -LO raw.githubusercontent.com/microsoft/Docker-Provider/ci_dev/kubernetes/omsagent.yaml

    Törölje a régi omsagent diagramot a következő paranccsal:

    kubectl delete -f omsagent.yaml

  4. A Container Insights letiltása az összes kapcsolódó erőforrás megtisztításához a Container Insights letiltása a Kubernetes-fürtön

  5. A Container Insights újbóli előkészítése a Kubernetes-fürtön a Container Insights engedélyezése útmutatóval

További lépések

Ha problémákat tapasztal az ügynök frissítésekor, tekintse át a hibaelhárítási útmutatót a támogatáshoz.