본문 바로가기
WIKI 기술 지식 베이스

Fleet View

원문 보기 위키 갱신

Fleet View에서 플릿 전체의 Datadog Agent와 OpenTelemetry Collector를 살펴보는 방법을 알려드릴게요. 호스트의 관측성 공백, 오래된 Agent나 OTel Collector, 통합 문제가 있는 Agent를 파악하는 데 도움이 돼요.

출처: 문서

본문

app.ddog-gov.com, us2.ddog-gov.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

Fleet View는 Datadog Government 사이트(US1-FED 및 US2-FED)에서 Preview 단계에 있어요. 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 Agent 구성(Configuring Agents), Agent 업그레이드(Upgrading Agents), SDK 업그레이드(Upgrading SDKs) 같은 다른 Fleet Automation 기능이 지원되지 않아요.

Fleet View를 사용해 호스트의 관측성 공백, 오래된 Agent나 OTel Collector, 통합 문제가 있는 Agent에 대한 인사이트를 얻을 수 있어요.

각 Datadog Agent에서 다음을 확인할 수 있어요:

  • Agent 버전
  • 구성되지 않았거나 잘못 구성된 통합이 있는지 여부
  • Agent가 모니터링하는 서비스
  • Agent의 Remote Configuration 상태
  • Agent에서 활성화된 제품
  • 구성 변경, 업그레이드, flare를 포함한 Agent Audit Trail 이벤트

각 OTel Collector에서 다음을 확인할 수 있어요:

  • Collector 버전
  • Collector 배포판(distribution)
  • Collector의 구성 YAML
  • Collector의 파이프라인 및 토폴로지 뷰

사전 요구 사항 (Prerequisites)

  • 구성 뷰는 버전 7.47.0 이상의 Agent 및 OTel Collector에서 기본으로 활성화돼요. 이전 버전에서 수동으로 활성화하려면 Agent 설정 파일에서 inventories_configuration_enabled를 true로 설정하거나 DD_INVENTORIES_CONFIGURATION_ENABLED 환경 변수를 사용하세요.
  • Agent 통합 구성은 Agent 7.49.0 이상에서 기본으로 활성화돼요. 이전 버전에서 수동으로 활성화하려면 Agent 설정 파일에서 inventories_checks_configuration_enabled를 true로 설정하거나 DD_INVENTORIES_CHECKS_CONFIGURATION_ENABLED 환경 변수를 사용하세요.

Fleet Automation은 OpenTelemetry Collector 구성, 파이프라인, 토폴로지를 표시하려면 Datadog Extension이 필요해요. 이 페이지에서 설명하는 OTel Collector 기능을 사용하기 전에 확장을 구성하세요.

Datadog Agent 또는 OpenTelemetry Collector 살펴보기

Datadog Agent나 OTel Collector를 선택하면 해당 구성, 연결된 통합, 감사 이벤트, 원격 flare를 보내는 지원 탭을 볼 수 있어요.

검색 및 필터링

Fleet View 상단의 검색창을 사용해 플릿 전체에서 특정 Agent, OTel Collector 또는 클러스터를 찾을 수 있어요. 다음을 할 수 있어요:

  • 호스트네임이나 클러스터 이름으로 자유 텍스트 검색
  • 운영체제, 환경(env), 팀, 활성화된 제품(products_enabled) 같은 호스트 및 Agent 태그로 필터링

OTel 파이프라인 시각화

OTel Collector의 Configuration 탭에는 Pipeline 및 Topology 뷰가 포함돼요. 이 뷰들은 텔레메트리가 OTel 파이프라인을 통해 흐르는 방식을 종단 간 파악할 수 있게 해 줘요.

이 뷰에 접근하려면:

  1. Fleet Automation으로 이동해요.
  2. OTel Collector로 필터링해요.
  3. Collector를 선택해 세부 정보 패널을 열어요.
  4. Configuration 탭을 클릭해요.
  5. View as 옵션에서 Pipeline 또는 Topology를 선택해요.

Pipeline 뷰

Pipeline 뷰는 단일 OTel Collector의 텔레메트리 파이프라인을 표시해요. Pipeline 뷰를 사용해:

  • 구성된 receivers, processors, exporters 간 텔레메트리 라우팅을 검증해요.
  • Show traffic 토글을 활성화해 데이터 드롭과 병목 같은 데이터 흐름 문제를 식별해요.
  • 컴포넌트 노드에 표시되는 활성 모니터 알림을 살펴보며 파이프라인 알림을 조사해요.

Topology 뷰

Topology 뷰는 DaemonSet과 게이트웨이로 배포된 OTel Collector 간의 전달 체인을 표시해요. Topology 뷰를 사용해:

  • DaemonSet-to-gateway 아키텍처에서 Collector 간 텔레메트리 라우팅을 검증해요.
  • Show traffic 토글을 활성화해 각 엣지에 데이터 흐름 속도를 겹쳐 표시하며 데이터 드롭과 병목을 찾아요.
  • Collector 노드에 표시되는 활성 모니터 알림을 살펴보며 파이프라인 문제를 조사해요.

Agent Audit Trail 이벤트 보기

Audit Events 탭은 선택한 Agent와 연결된 Audit Trail 이벤트를 표시해요. 이 탭을 사용해:

  • 구성 변경, API 키 업데이트, 설치, 업그레이드, 지원 flare를 식별해요
  • 변경이 언제 어디서 이뤄졌는지 파악해요

Audit Trail 이벤트 표시 여부는 플랜에 따라 달라져요. 조직에서 Audit Trail이 활성화되면 Audit Trail 보존 설정에 따라 최대 90일간 Agent 이벤트를 볼 수 있어요. 조직에서 Audit Trail이 활성화되지 않았다면 최근 24시간의 이벤트를 볼 수 있어요.

원격 flare 보내기

Agent에서 Remote Configuration을 활성화한 뒤 Datadog Agent나 DDOT Collector에서 flare를 보낼 수 있어요. 방법은 Datadog 사이트에서 flare 보내기를 참고하세요.

Remote Configuration이 활성화된 상태로 Datadog 지원팀에 문의하면, 지원팀이 문제를 더 빨리 해결하기 위해 여러분의 환경에서 flare를 시작할 수 있어요.

Kubernetes 뷰

Kubernetes 뷰를 사용하면 Kubernetes 환경에서 실행되는 Datadog Agent와 OTel Collector를 볼 수 있어요. 호스트 기반과 컨테이너화된 인프라 전반에 걸친 플릿의 통합 뷰를 제공해요.

기본적으로 Fleet View는 인프라를 개별 호스트로 나열해요. View by infra type 토글을 사용해 Kubernetes 뷰로 전환하면 Agent를 Kubernetes 클러스터별로 표시해줘요.

각 행은 Datadog Operator 또는 Helm 차트로 관리되는 클러스터예요. 클러스터의 Node Agent, Cluster Agent, Cluster Check Runner는 개별 호스트가 아닌 그룹으로 묶여 표시돼요.

Kubernetes 뷰의 사전 요구 사항

대부분의 Kubernetes 뷰 기능은 버전 요구 사항 없이 사용할 수 있어요. 특정 기능에는 다음이 필요해요:

기능 요구 사항
DatadogAgent 구성 보기 Datadog Operator v1.24 이상
Helm Chart 값 보기 Datadog Helm Chart v3.157.0 이상
구성 편집 Remote Configuration 활성화 및 Datadog Operator v1.27 이상
클러스터 이름 없이 구성 편집 Datadog Operator v1.30.0 이상
Cluster Agent의 통합 보기 Agent v7.72.0 이상
Cluster Agent의 통합 상태 보기 Agent v7.79.0 이상

Fleet View에서 구성을 편집하려면 Operator 구성에 remoteConfigEnabled, remoteUpdatesEnabled, createControllerRevisions 플래그를 설정하세요. 편집에는 Datadog API 키와 애플리케이션 키 구성도 필요해요. Fleet View에서 Helm Chart 값을 편집하는 것은 지원되지 않아요.

Datadog Operator v1.30.0 이전 버전에서는 클러스터 이름(clusterName)도 설정해야 해요. 그렇지 않으면 Edit 버튼이 비활성화된 상태로 유지돼요. Datadog Operator v1.30.0부터는 클러스터 이름이 선택 사항이에요.

Datadog Operator를 Helm 차트로 설치했다면 previewFleetRollouts 값으로 필요한 플래그를 함께 활성화할 수 있어요:

helm repo add datadog https://helm.datadoghq.com
helm repo update

helm upgrade --install datadog-operator datadog/datadog-operator \
  --set previewFleetRollouts=true \
  --set apiKeyExistingSecret=datadog-secret \
  --set appKeyExistingSecret=datadog-secret \
  --devel

datadog-secret를 Datadog API 및 애플리케이션 키를 보관하는 Kubernetes Secret의 이름으로 바꾸세요. --devel 플래그는 차트의 최신 개발 릴리즈를 설치해요.

Kubernetes 클러스터 보기

클러스터는 클러스터 이름 기준 알파벳순으로 나열돼요. 테이블에는 각 클러스터의 이름, 배포 방법(Datadog Operator 또는 Helm), 네임스페이스, Agent 버전, Agent pod 상태, 준비 상태, 생성 후 경과 시간, 재시작 횟수가 표시돼요.

특정 클러스터를 찾으려면 클러스터 이름으로 검색할 수 있어요.

클러스터를 클릭하면 다음을 볼 수 있어요:

  • 환경, 태그 같은 클러스터 세부 정보
  • 클러스터 레벨 Agent(Cluster Agent 및 Cluster Check Runners)
  • Node Agent

Configuration 탭에서 구성을 볼 수 있어요:

  • Datadog Operator v1.24 이상: DatadogAgent 커스텀 리소스 구성을 볼 수 있어요. Datadog Operator v1.27 이상에서는 이 탭에서 구성을 편집할 수도 있어요.
  • Datadog Helm Chart v3.157.0 이상: Helm Chart 값(values.yaml)을 볼 수 있어요.

제한 사항 (Limitations)

기본 뷰와 비교해 Kubernetes 뷰에는 다음과 같은 제한 사항이 있어요:

  • 원격 지원 flare를 보낼 수 없어요.
  • 실행 중인 OTel Collector를 볼 수 있지만 Kubernetes 뷰에서는 해당 구성을 볼 수 없어요.
  • Fleet Automation API 접근을 사용할 수 없어요.

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 글: