장치 프로필 시작하기 (Getting Started with Device Profiles)

원문 보기 위키 갱신 2026.10.05

SNMP Profile Manager를 사용해 그룹 네트워크 장치에서 Datadog이 수집하는 SNMP 메트릭을 정의하고 관리하는 방법을 안내해요. 단일 장치에서 시작해 메트릭을 탐색·활성화하고, 장치 커버리지를 관리하며, 프로필을 Agent에 배포할 수 있어요.

출처: 문서

본문

다음 Datadog 사이트 사용자에게 중요한 참고 사항: app.ddog-gov.com, us2.ddog-gov.com

이 제품은 선택한 Datadog site에서는 지원되지 않아요.

개요

장치 프로필은 Datadog이 네트워크 장치 그룹에 대해 수집하는 SNMP 메트릭을 정의해요. SNMP Profile Manager는 해당 메트릭을 활성화하고 관리하기 위한 안내형 경험을 제공해요. 단일 장치에서 시작해 다음을 할 수 있어요.

카테고리별로 그룹화된 사용 가능한 메트릭을 탐색하고 한 번의 클릭으로 활성화.
프로필이 다루는 장치를 관리하고 사용 가능한 메트릭을 활성화·비활성화.
AI 기반 대량 메트릭 추천을 위한 메트릭 팩 사용.
내장 감사 뷰와 Agent 상태 점검으로 프로필 변경을 저장하고 Agent에 직접 배포.

고급 프로필 구성은 Build an NDM Profile을 참고해요.

사전 요구 사항

Agent 버전 7.77.0 이상.
조직에 Remote Configuration이 활성화되어 있어야 해요.
필요한 권한:
- NDM Device Profiles View: 프로필 페이지에 대한 읽기 전용 접근을 제공해요. (Datadog Standard Role에 포함)
- NDM Device Profiles Edit: 장치 프로필 편집을 허용해요. (Datadog Admin Role에 포함)

설정

datadog.yaml에서 network_devices.default_scan.enabled: true로 설정해 장치 스캔을 활성화해요.
```
network_devices:
    default_scan:
      enabled: true
```
구성에서 use_remote_config_profiles: true로 설정해요.

SNMP Autodiscovery의 경우 datadog.yaml 파일의 network_devices.autodiscovery 아래에 다음을 추가해요.

network_devices:
    autodiscovery:
      use_remote_config_profiles: true

수동 SNMP 체크의 경우 conf.d/snmp.d/conf.yaml 파일의 init_config 아래에 다음을 추가해요.

init_config:
  use_remote_config_profiles: true

참고: EXOS 33.1.1 장치는 펌웨어 버그로 인해 장치 스캔을 활성화하면 크래시할 수 있어요. 해결 방법으로 장치 스캔을 전역적으로 비활성화하거나(network_devices.default_scan.enabled: false) 장치 펌웨어를 업그레이드해요. 이 문제의 영향을 받으면 Datadog Support에 문의해 도움을 받아요.

Agent에 사용자 정의 프로필이 있으면 Upload custom profiles 지침에 따라 UI에 업로드해요.

메트릭 구성

SNMP Profile Manager의 권장 진입점은 NDM의 단일 장치에서 시작하는 것이에요. 모든 장치는 사용자 정의 프로필 또는 일반적인 Datadog 제공 프로필에 매칭돼요. 장치에서 프로필을 편집하면 자동으로 해당 프로필의 사용자 정의 버전이 생성되므로, 처음부터 프로필을 만들 필요가 없어요.

Infrastructure > Network Devices로 이동해요.
장치를 클릭해 장치 사이드 패널을 열어요.
View all metrics를 클릭해 장치에 대해 자동으로 수집되는 메트릭 목록을 확인해요.
Metrics 탭이 열리며 장치에 대해 수집된 모든 메트릭을 보여줘요. 왼쪽 사이드바를 사용해 Alerting Metrics, Starred Metrics, Key Metrics, Additional Metrics 카테고리별로 탐색해요.
사이드바에서 SNMP Profile을 클릭해 프로필 편집기를 열고 수집할 메트릭을 관리해요.

이렇게 하면 Metrics 탭에서 프로필 편집기가 열리고, 프로필이 다루는 장치에 대한 모든 사용 가능한 메트릭 목록이 이름, MIB, OID, 카테고리, 호환성별로 구성되어 표시돼요. 이것은 Datadog이 장치에서 수집하는 데이터를 제어하는 기본 보기예요. 메트릭 목록을 카테고리별로 필터링하거나 검색 창으로 이름·OID를 검색할 수 있어요.

메트릭을 활성화하려면 메트릭 이름 옆의 Enable 토글을 클릭하고, 비활성화하려면 토글을 다시 클릭해요. 변경 사항은 프로필을 저장·배포할 때까지 적용되지 않아요.

장치 커버리지

Device Coverage 탭은 어떤 네트워크 장치가 프로필과 연관되어 있고 프로필이 어떻게 적용되는지 보여줘요. 이 보기를 사용해 장치 연결을 확인하고, 속성별로 장치를 필터링하며, SNMP 수집 문제를 식별해요.

표 상단의 필터를 사용해 SysObjectID, SysType, 공급업체, 모델, 장치 유형 또는 장치 이름으로 결과를 좁혀요.

프로필과 연관된 장치를 업데이트하려면 Manage Devices를 클릭해요. 여기서 다음을 할 수 있어요.

추가할 장치를 검색하거나 제거할 개체 ID를 선택해요. 개체 ID를 제거하면 해당 ID와 일치하는 모든 장치가 프로필의 커버리지에서 제거돼요.
장치 유형, 이름 또는 기타 특성으로 장치 목록을 필터링해요.

SNMP walk 상태

Last SNMP walk 열은 Datadog이 장치를 성공적으로 쿼리했는지 여부를 나타내요.

Failed: SNMP walk가 성공적으로 완료되지 않았어요. 메트릭이 누락되거나 불완전할 수 있어요.
Timestamp: 마지막 성공적인 SNMP walk의 날짜와 시간을 나타내요.

SNMP walk가 실패하는 경우 다음을 확인해요.

장치에서 SNMP가 올바르게 구성되어 있는지.
네트워크 연결이 SNMP 폴링을 허용하는지.
자격 증명과 포트가 올바른지.

고급 옵션

Advanced Options를 클릭해 장치 메타데이터와 전역 태그 구성에 접근해요. 이러한 설정은 대부분의 사용 사례에 필요하지 않아요.

장치 메타데이터

Device metadata 섹션은 Datadog이 SNMP OID를 장치 속성에 매핑하는 방법을 정의해요. 각 메타데이터 필드는 다음과 같은 표준 장치 속성에 해당해요.

장치 이름
공급업체
모델
OS 버전
위치

값은 SNMP OID를 사용해 정의돼요. 수집 중 Datadog은 이러한 OID를 쿼리해 장치 메타데이터를 채워요. 예를 들어:

1.3.6.1.2.1.1.5.0은 장치 이름에 매핑돼요.
1.3.6.1.2.1.1.1.0은 장치 설명에 매핑돼요.

이 메타데이터는 UI의 장치 세부 정보를 강화하고, 필터링·그룹화를 가능하게 하며, 장치 전반에 일관된 태깅을 제공해요.

연필 아이콘을 클릭해 메타데이터 필드를 편집해요. 메타데이터는 네트워크 장치 모니터링 페이지에서 검색 가능한 패싯으로, 그리고 장치 사이드 패널에 표시돼요.

메타데이터 필드에 대한 다양한 수정 옵션은 다음과 같아요.

Modification	Description
No Modification	장치가 반환한 값이 태그 값으로 직접 사용돼요.
Format	mac_address 또는 ip_address일 수 있어요.
Extract Value	장치가 제공한 SNMP 값에서 태그 값을 추출하는 데 사용되는 정규식이에요.
Mapping	profile format reference를 참고해요.

전역 태그

Global tags를 사용해 프로필과 연관된 장치의 모든 메트릭과 장치 수준 메타데이터에 태그를 적용해요. 전역 태그는 유사한 장치 간의 태깅을 표준화하고 환경, 위치, 소유권 같은 컨텍스트를 추가해요.

메트릭 팩 탐색

메트릭 팩은 대량으로 활성화할 수 있는 큐레이션된 메트릭 세트예요. Metrics 탭에서 접근할 수 있으며 장치를 기반으로 AI 안내 추천을 제공해요.

메트릭 팩을 추가하려면:

Metrics 탭에서 오른쪽 상단의 Metric packs를 클릭하거나 Start with metric packs 배너에서 View All을 클릭해요.
Add metric pack 모달에서 사용 가능한 모든 팩을 탐색하거나 Suggested packs를 클릭해 AI 안내 추천을 확인해요.
팩을 클릭해 포함된 메트릭, 전역 태그, 메타데이터를 미리 봐요.
Add metric pack을 클릭해 팩의 모든 메트릭을 한 번에 활성화해요.

인벤토리 페이지

모든 프로필을 한 곳에서 보려면 Infrastructure > Network Devices > Settings로 이동하고 왼쪽 사이드바에서 SNMP Profile Manager를 클릭해요. 이 페이지에는 Datadog 기본 제공 프로필과 생성한 사용자 정의 프로필이 모두 나열돼요.

Device vendor 필터나 검색 창을 사용해 프로필 이름, 공급업체 또는 장치 이름으로 목록을 좁혀요. Show only profiles with matching devices를 토글해 연관 장치가 없는 프로필을 숨겨요.

Agent가 Remote Config에 대해 잘못 구성된 경우 페이지 상단에 경고 배너가 나타나요. Fix Agents를 클릭해 문제를 해결해요.

프로필 편집기를 열려면 아무 프로필이나 클릭해요. Datadog 제공 프로필의 경우 편집 시 사용자를 대신해 사용자 정의 버전이 생성돼요.

프로필 행 오른쪽의 점 3개 메뉴를 클릭해:

Edit profile: 해당 프로필의 프로필 편집기를 엽니다.
Delete profile: 사용자 정의 프로필을 영구적으로 제거합니다.
Review related devices: 해당 프로필에 매칭된 장치로 필터링된 NDM으로 이동합니다.

프로필 다운로드

프로필을 YAML 파일로 다운로드하려면 페이지 오른쪽 상단의 Download Profiles를 클릭해요. 이렇게 하면 사용자 정의 프로필의 yaml 파일이 포함된 .zip 번들이 생성돼요. 프로필을 Agent에 수동으로 적용하려면:

yaml 파일을 관련 설치된 Agent 각각의 프로필 디렉토리에 배치해요.
Datadog Agent를 재시작해요.
NDM이 매칭된 장치에서 메트릭을 수신하는지 확인해요.

사용자 정의 프로필 업로드

기존 SNMP 프로필을 Profile Manager에 업로드하려면:

Infrastructure > Network Devices > Settings로 이동하고 왼쪽 사이드바에서 SNMP Profile Manager를 클릭해요.
페이지 오른쪽 상단의 Upload Profiles를 클릭해요.
업로드 모달에서 .zip 파일을 끌어다 놓거나 browse files를 클릭해 선택해요. .zip 파일은 .yaml 형식의 SNMP 프로필을 하나 이상 포함해야 해요.
Upload profiles를 클릭해요.

업로드가 완료되면 프로필 편집기에서 프로필을 사용할 수 있어요. 그런 다음 다른 사용자 정의 프로필과 같은 방식으로 업로드된 프로필의 메트릭, 장치 커버리지, 고급 옵션을 관리할 수 있어요.

프로필 상속

프로필 상속은 백그라운드에서 자동으로 발생해요. 프로필을 편집하면 Datadog이 일치하는 프로필의 사용자 정의 확장을 생성해요. 상속을 수동으로 구성할 필요가 없어요. Datadog은 기본 상속 프로필(_base.yaml, _generic-if.yaml, _generic-ip.yaml, _generic-ospf.yaml, _generic-tcp.yaml, _generic-udp.yaml)을 자동으로 포함해요.

고급 상속 구성은 Profile Format Reference를 참고해요.

문제 해결

프로필이란 무엇인가요?

프로필은 장치에서 수집할 메타데이터, 메트릭, 태그를 정의하는 구성 파일이에요. 자세한 내용은 metadata definition을 참고해요.

장치 스캔이란 무엇인가요?

장치 스캔은 장치의 전체 SNMP walk를 수행해 모든 사용 가능한 데이터를 수집하고 Datadog에 전달해 UI에 표시해요. 이 과정은 장치에서 사용 가능한 OID를 식별하고 프로필 편집기의 사용 가능한 메트릭 목록을 채워요.

일치하는 장치가 없는 이유는 무엇인가요?

일치하는 장치가 없다면 다음 이유 때문일 수 있어요.

프로필이 적용되었지만 어떤 장치와도 일치하지 않음:
- 프로필은 SysObjectID를 사용해 장치와 매칭돼요. 프로필의 SysObjectID가 모니터링 중인 장치 중 하나 이상과 일치하는지 확인해요.
여러 프로필이 같은 SysObjectID를 가짐:
- 여러 프로필이 같은 SysObjectID를 공유하면 Agent 수준에서 매칭 충돌이 발생할 수 있어요. 각 SysObjectID가 하나의 프로필에만 할당되었는지 확인해요.

장치가 스캔되지 않는 이유는 무엇인가요?

장치 스캔은 완료하는 데 최대 10분이 걸릴 수 있어요. UI에서 스캔 진행 상황을 모니터링할 수 있어요.

장치가 스캔되지 않는 경우 다음 이유 때문일 수 있어요.

기본 장치 스캔이 비활성화됨: 장치 스캔은 Agent 7.75.2+에서 기본적으로 비활성화돼요. datadog.yaml에서 network_devices.default_scan.enabled: true를 설정해요.
무한 루프 감지됨: 스캔이 무한 루프를 감지해 종료됐어요. Agent 로그에서 next OID 'X' is not after last OID 'Y'를 확인해요. 이는 일부 장치 펌웨어에서 발생할 수 있어요.
알려진 문제: EXOS 33.1.1 펌웨어 버그: EXOS 33.1.1 장치는 장치 스캔이 활성화되면 크래시할 수 있어요. 해결 방법으로 장치 스캔을 비활성화하거나 장치 펌웨어를 업그레이드해요. Datadog Support에 문의해 도움을 받아요.

다음 Datadog 사이트 사용자에게 중요한 참고 사항: app.ddog-gov.com, us2.ddog-gov.com

GovCloud: 장치 스캔은 UI에서 트리거할 수 없어요. 기본 장치 스캔(network_devices.default_scan.enabled: true)을 활성화하고 특정 장치에 대해 Agent에서 스캔을 수동으로 트리거해요.

수집기에 Remote Configuration이 활성화되지 않음

Profile Manager는 다음이 필요해요.

Agent 버전 7.75.2 이상
Remote Configuration 활성화
SNMP 구성에서 use_remote_config_profiles: true
장치 스캔을 위한 network_devices.default_scan.enabled: true

Remote Configuration이 활성화되지 않으면 UI를 통해 장치 스캔을 트리거하거나 프로필을 Agent에 동기화할 수 없어요. 프로필을 수동으로 적용하려면 Download profiles를 참고해요.

Datadog은 전체 UI 기반 경험을 활용하고 수동 Agent 상호작용을 최소화하기 위해 Remote Configuration을 활성화할 것을 권장해요.