이 섹션에서는 일반적인 Cloud Service Mesh 사이드카 프록시 문제와 해결 방법을 설명합니다.
추가 지원이 필요하면 지원 받기를 참조하세요.
OOM 이벤트로 인해 istio-proxy 컨테이너가 종료됩니다.
이 섹션에서는 istio-proxy 컨테이너가 SystemOOM 이벤트로 인해 종료되지 않고 Kubernetes 노드가 MemoryPressure 조건이 아니라고 가정합니다.
istio-proxy 사이드카 컨테이너에는 기본적으로 리소스 한도가 있습니다.
istio-proxy 컨테이너가 Reason: OOMKilled로 종료되는 경우 Envoy가 메모리를 소비하는 이유를 이해해야 합니다.
프로덕션 중단이 발생하는 경우 빠른 해결 방법은 IstioOperator를 사용하여 모든 컨테이너의 한도를 올리는 것입니다.
특정 워크로드에서 이 문제가 발생하면 다음 annotations을 추가하여 해당 워크로드에 대한 제한을 변경할 수 있습니다.
sidecar.istio.io/proxyMemory
sidecar.istio.io/proxyMemoryLimit
기본값보다 작은 한도가 없는지 확인하세요.
장기적인 해결책은 istio-proxy 사이드카 컨테이너의 메모리 사용 공간을 줄이는 것입니다. 기본적으로 모든 사이드카 프록시는 메시의 다른 워크로드 인스턴스에 연결하는 데 필요한 구성으로 프로그래밍됩니다.
Istio는 사이드카 프록시로 프로그래밍된 엔드포인트 수를 제한하여 istio-proxy 컨테이너의 메모리 소비를 줄이기 위한 커스텀 리소스 정의 Sidecar를 제공합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["Resolving sidecar proxies issues in Cloud Service Mesh\n\nThis section explains common Cloud Service Mesh sidecar proxies problems and how to\nresolve them.\nIf you need additional assistance, see [Getting support](/service-mesh/docs/getting-support).\n\nThe `istio-proxy` container is killed because of a OOM event\n\nIn this section we assume that the `istio-proxy` container is not killed by a\n`SystemOOM` event, and the kubernetes node is not in `MemoryPressure` condition.\nThe `istio-proxy` sidecar container has by default [resource limits](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#requests-and-limits).\nIf the istio-proxy container gets killed with `Reason: OOMKilled` it is necessary\nto understand why Envoy is consuming the memory.\n\nIf you are facing a production outage, a quick workaround is to raise the limits\nfor all containers using `IstioOperator`: \n\n ---\n apiVersion: install.istio.io/v1alpha1\n kind: IstioOperator\n spec:\n values:\n global:\n proxy:\n resources:\n requests:\n memory: 128Mi\n limits:\n memory: 1Gi\n\nIf you are facing this issue with specific workloads, you can change the limit\njust on those workloads by adding the following\n[annotations](https://istio.io/v1.26/docs/reference/config/annotations/).\n\n- `sidecar.istio.io/proxyMemory`\n- `sidecar.istio.io/proxyMemoryLimit`\n\nPlease make sure you don't have limits that are lower of the default values.\n| **Note:** because this container is injected at the Pod creation, this setting will be effective only for newly created Pods.\n\nThe long term solution is to reduce the memory footprint of your `istio-proxy`\nsidecar containers. By default all sidecar proxies are programmed with the\nnecessary configuration to reach any other workload instance in the mesh.\nIstio provides the [custom resource definition `Sidecar`](https://istio.io/v1.26/docs/reference/config/networking/sidecar/)\nto limit the number of endpoints programmed to sidecar proxies, and therefore\nreduce the memory consumption of the `istio-proxy` container."]]