개요

Datadog은 Istio 환경의 모든 부분을 모니터링하므로 다음과 같은 작업을 할 수 있습니다.

• 로그로 Envoy와 Istio 컨트롤 플레인의 서비스 상태를 평가합니다.
• 요청, 대역폭, 리소스 소비 메트릭을 활용해 서비스 메시의 성능을 분석합니다.
• Cloud Network Monitoring을 통해 컨테이너, 포드, 메시를 통한 서비스 간 네트워크 통신을 매핑하세요.
• APM을 사용하여 메시를 통한 애플리케이션 트랜젝션을 위해 배포된 트레이스를 탐색하세요.
• Datadog 앱 및 API 보호를 통해 실시간 위협 탑지와 인프라 에지 차단 기능을 사용하여 Istio 서비스 메시를 안전하게 보호하세요.

Datadog를 통해 Istio 환경을 모니터링하는 방법에 관해 자세히 알아보려면 모니터 블로그 게시물을 참조하세요.

설정

컨테이너화된 환경에서 통합을 구성하는 방법에 대한 일반적인 지침은 Kubernetes 기반 Autodiscovery를 통한 통합 구성 또는 Docker 기반 Autodiscovery를 통한 통합 구성을 참조하세요.

이 OpenMetrics 기반 통합에는 최신 모드(use_openmetrics: true)와 레거시 모드(use_openmetrics: false)가 있습니다. 최신 기능을 모두 사용하려면 Datadog에서 최신 모드를 활성화할 것을 권장합니다. 자세한 내용은 OpenMetrics 기반 통합을 위한 최신 및 레거시 버전 관리를 참조하세요.

Istio 메트릭을 수집하는 Datadog 인스턴스가 여러 개 존재하는 경우 모든 인스턴스에서 동일한 모드를 사용하고 있는지 확인하세요. 그렇지 않으면 Datadog 사이트에서 메트릭 데이터가 변동될 수도 있습니다.

[OpenMetrics V1], [OpenMetrics V2] 또는 [OpenMetrics V1 and V2]로 표시된 메트릭은 해당 Istio 통합 모드에서만 사용할 수 있습니다. Istio v1.5+로 표시된 메트릭은 Istio 버전 1.5 이상에서 수집됩니다.

설치(메트릭)

Istio는 Datadog Agent에 포함되어 있습니다. Datadog Agent를 Istio 서버 또는 클러스터에 설치하고 Istio를 모니터링하도록 설정합니다.

Envoy

Istio에서 Envoy 프록시를 모니터링하려면 Envoy 통합을 구성하세요.

설치(보안 - 앱 및 API 보호)

설치 과정에는 이 통합을 활성화하는 것과는 다른 접근 방식이 필요합니다. 설치 지침은 Istio에 앱 및 API 보호 사용 설명서에서 확인할 수 있습니다.

설정

메트릭 수집

Istio v1.5+를 모니터링할 수 있도록 Prometheus 형식 메트릭을 위한 Istio 아키텍처와 일치하는 두 가지 핵심 구성 요소가 있습니다.

• 데이터 플레인: istio-proxy 사이드카 컨테이너
• 컨트롤 플레인: 프록시 관리 istiod 서비스

모두 istio 에이전트 점검으로 실행되지만 책임은 서로 다르며 별도로 설정됩니다.

데이터 플레인 설정

기본 istio.d/auto_conf.yaml 파일은 각 istio-proxy 사이드카 컨테이너의 모니터링을 자동으로 설정합니다. Agent는 자동으로 감지되는 각 사이드카 컨테이너에 이 검사를 초기화합니다. 이 구성을 통해 이러한 각 사이드카 컨테이너에서 노출되는 데이터의 istio.mesh.* 메트릭을 보고할 수 있습니다.

통합의 데이터 플레인 부분을 커스터마이즈하려면 커스텀 Istio 구성 파일 istio.yaml을 만드세요. 이 파일을 만드는 옵션은 Kubernetes 기반 통합 구성하기 또는 Docker 기반 Autodiscovery 통합 구성하기를 참조하세요.

본 파일에는 다음이 포함되어야 합니다.

ad_identifiers:
  - proxyv2
  - proxyv2-rhel8

init_config:

instances:
  - use_openmetrics: true
    send_histograms_buckets: false
    istio_mesh_endpoint: http://%%host%%:15020/stats/prometheus
    tag_by_endpoint: false

추가 구성으로 이 파일을 커스터마이즈합니다. 사용 가능한 모든 구성 옵션은 샘플 istio.d/conf.yaml을 참조하세요.

컨트롤 플레인 설정

Istio 컨트롤 플레인을 모니터링하고 mixer, galley, pilot, citadel 메트릭을 보고하려면 에이전트가 istiod 배포를 모니터링하도록 설정해야 합니다. Istio v1.5 이상에서는 istio-system 네임스페이스에서 istiod 배포에 다음 포드 어노테이션을 적용합니다.

ad.datadoghq.com/discovery.checks: |
  {
    "istio": {
      "instances": [
        {
          "istiod_endpoint": "http://%%host%%:15014/metrics",
          "use_openmetrics": "true"
        }
      ]
    }
  }

참고: Autodiscovery Annotations v2 구문은 Agent v7.36 이상에서 지원됩니다.

본 어노테이션은 컨테이너 discovery를 지정하여 이 포드의 Istio 컨테이너의 기본 컨테이너 이름과 매칭합니다. 지정합니다. 만약 다른 경우 해당 어노테이션 ad.datadoghq.com/<CONTAINER_NAME>.checks을 Istio 컨테이너의 이름(.spec.containers[i].name)으로 교체합니다.

이러한 주석을 적용하는 방법은 사용하는 Istio 배포 전략(Istioctl, Helm, Operator)에 따라 달라집니다. 이러한 포드 주석을 적용하는 올바른 방법은 Istio 설명서를 참조합니다. 사용 가능한 모든 구성 옵션은 샘플 istio.d/conf.yaml을 참조하세요.

Datadog 에이전트 포드에 대한 사이드카 삽입 비활성화

컨테이너에 Datadog Agent를 설치하는 경우, Datadog에서 먼저 Istio의 사이드카 인젝션을 비활성화하는 것이 좋습니다.

Istio 버전 >= 1.10:

datadog-agent DaemonSet에 sidecar.istio.io/inject: "false" 라벨을 추가합니다.

# (...)
spec:
  template:
    metadata:
      labels:
        sidecar.istio.io/inject: "false"
    # (...)

kubectl patch 명령으로도 해당 작업을 수행할 수 있습니다.

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"labels":{"sidecar.istio.io/inject":"false"}}}}}'

Istio 버전 <= 1.9:

datadog-agent DaemonSet에 sidecar.istio.io/inject: "false" 어노테이션을 추가합니다.

# (...)
spec:
  template:
    metadata:
      annotations:
        sidecar.istio.io/inject: "false"
    # (...)

kubectl patch 명령어를 사용합니다.

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"annotations":{"sidecar.istio.io/inject":"false"}}}}}'

로그 수집

에이전트 버전 > 6.0에서 사용 가능

먼저 Kubernetes에서 로그를 수집하도록 Datadog Agent 을 활성화합니다. Kubernetes 로그 수집을 참조하세요.

Istio 로그

컨트롤 플레인(istiod)에서 Istio 로그를 수집하려면 istio-system 네임스페이스에서 다음 배포용 포드 어노테이션 istiod을 적용합니다.

ad.datadoghq.com/discovery.logs: |
  [
    {
      "source": "istio",
      "service": "<SERVICE_NAME>"
    }
  ]

본 어노테이션은 컨테이너 discovery를 지정하여 이 포드의 Istio 컨테이너의 기본 컨테이너 이름과 매칭합니다. 만약 다른 경우 해당 어노테이션 ad.datadoghq.com/<CONTAINER_NAME>.logs을 Istio 컨테이너의 이름(.spec.containers[i].name)으로 교체합니다.

<SERVICE_NAME>을 원하는 Istio 서비스 이름으로 변경합니다.

Envoy 액세스 로그

Envoy를 수집하려면 데이터 플레인(istio-proxy)에서 로그에 액세스합니다.

1. [Istio 내 Envoy 액세스 로깅] 활성화(https://istio.io/latest/docs/tasks/observability/logs/access-log/)
2. istio-proxy 컨테이너가 삽입된 포드에 다음 어노테이션을 적용합니다.

ad.datadoghq.com/istio-proxy.logs: |
  [
    {
      "source": "envoy",
      "service": "<SERVICE_NAME>"
    }
  ]

본 어노테이션은 컨테이너 istio-proxy를 지정하여 삽입된 Istio 사이드카 컨테이너의 기본 컨테이너 이름과 매칭합니다. 만약 다른 경우 해당 어노테이션 ad.datadoghq.com/<CONTAINER_NAME>.logs을 Istio 사이드카 컨테이너의 이름(.spec.containers[i].name)으로 교체합니다.

<SERVICE_NAME>을 원하는 Istio 프록시 서비스 이름으로 변경합니다.

검증

Agent의 info 하위 명령을 실행하고 확인 섹션에서 istio를 찾습니다.

수집한 데이터

Metrics

이벤트

Istio 점검은 이벤트를 포함하지 않습니다.

서비스 점검

istio.prometheus.health

검사에서 메트릭 엔드포인트에 액세스할 수 없는 경우 CRITICAL을 반환합니다. 그러지 않으면 OK를 반환합니다.

상태: ok, critical

istio.openmetrics.health

Agent에 연결할 수 없는 경우 CRITICAL을 반환하고, 그러지 않으면 OK를 반환합니다.

상태: ok, critical

istio.pilot.prometheus.health

검사에서 메트릭 엔드포인트에 액세스할 수 없는 경우 CRITICAL을 반환합니다. 그러지 않으면 OK를 반환합니다.

상태: ok, critical

istio.galley.prometheus.health

검사에서 메트릭 엔드포인트에 액세스할 수 없는 경우 CRITICAL을 반환합니다. 그러지 않으면 OK를 반환합니다.

상태: ok, critical

istio.citadel.prometheus.health

검사에서 메트릭 엔드포인트에 액세스할 수 없는 경우 CRITICAL을 반환합니다. 그러지 않으면 OK를 반환합니다.

상태: ok, critical

트러블슈팅

잘못된 청크 길이 오류

Istio 통합(Istio 통합 버전 3.13.0 또는 이전 버전)의 레거시 모드에서 다음 오류가 발생한 경우

  Error: ("Connection broken: InvalidChunkLength(got length b'', 0 bytes read)",
  InvalidChunkLength(got length b'', 0 bytes read))

해당 오류를 해결하려면 개방형메트릭 기반 Istio 통합의 최신 모드를 사용합니다.

최소 에이전트 7.31.0 및 파이썬(Python) 3로 업그레이드해야 합니다. 설정 섹션을 참조하여 개방형메트릭을 활성화합니다.

Istio 배포에서 일반 개방형메트릭 통합 사용

Istio 프록시 사이드카 삽입이 활성화된 경우, istio_mesh_endpoint와 동일한 메트릭 엔드포인트를 가진 OpenMetrics 통합을 사용하여 다른 Prometheus 메트릭을 모니터링하면 사용자 지정 메트릭 사용량이 많아지고 메트릭 수집이 중복될 수 있습니다.

개방형메트릭 설정이 메트릭을 과다 수집하지 않도록 하려면 다음 작업 중 하나를 수행합니다.

1. metrics 설정 옵션에서 특정 메트릭 매칭을 사용합니다.
2. metrics에 와일드카드 * 값을 사용하는 경우, 다음 개방형메트릭 통합 옵션을 사용하여 Istio 및 Envoy 통합이 이미 지원하는 메트릭을 제외합니다.

일반 메트릭 수집이 포함된 개방형메트릭 최신 모드 설정

설정에서 Istio 및 Envoy 메트릭을 제외해야 높은 커스텀 메트릭 요금이 청구되지 않습니다. openmetrics_endpoint이 활성화된 경우 exclude_metrics을 사용합니다.

## 모든 인스턴스는 다른 인스턴스와 무관하게 스케줄링됩니다.
#
인스턴스:
  - openmetrics_endpoint: <OPENMETRICS_ENDPOINT>
    metrics:
    - '.*'
    exclude_metrics:
      - istio_.*
      - envoy_.*

일반 메트릭 수집이 포함된 개방형메트릭 레거시 모드 설정

설정에서 Istio 및 Envoy 메트릭을 제외해야 높은 커스텀 메트릭 요금이 청구되지 않습니다. prometheus_url이 활성화된 경우 ignore_metrics을 사용합니다.

instances:
  - prometheus_url: <PROMETHEUS_URL>
    metrics:
      - '*'
    ignore_metrics:
      - istio_*
      - envoy_*

도움이 필요하세요? Datadog 지원 팀에 문의하세요.

참고 자료

기타 유용한 문서, 링크 및 기사:

• Datadog를 사용해 Istio 서비스 메시 모니터링하기
• Datadog에서 Istio 모니터링을 위해 주요 지표를 수집하는 방법 알아보기)
• Datadog으로 Istio 모니터링하는 방법