Datadog MCP 서버에서 사용할 수 있는 도구는 다음과 같습니다. 각 항목에 필수 도구 세트, 권한 및 프롬프트 예시가 포함되어 있습니다. 도구는 도구 세트 기준으로 그룹화되어 있어서 필요한 도구만 사용할 수 있으므로 귀중한 컨텍스트 윈도가 절약됩니다.
제품별 도구를 활성화하려면 Datadog MCP 서버에 연결하는 데 사용하는 엔드포인트 URL 끝에 toolsets 쿼리 파라미터를 포함하세요. 예를 들어, 선택한 Datadog 사이트() 기준으로 다음 URL은 APM 및 Agent Observability 도구_만_ 활성화합니다.
?toolsets=apm,llmobs
또한 omit_tools 쿼리 파라미터를 사용하여 특정 도구를 제외할 수 있습니다.
MCP 서버 연결, 도구 세트 활성화 및 특정 도구 제외에 대한 자세한 내용은 Datadog MCP 서버 설정을 참조하세요.
Datadog MCP 서버 도구는 현재 중요한 개발 과정을 진행 중이며 변경될 수 있습니다. 각종 피드백, 사용 사례 또는 프롬프트 및 쿼리를 사용하다가 발생한 이슈를 공유하려면
이 피드백 양식을 사용하세요.
로그, 메트릭, 트레이스, 대시보드, 모니터, 인시던트, 호스트, 서비스, 이벤트, 노트북의 기본 도구 세트입니다.
search_datadog_events
도구 세트: core
필수 권한: Events 및 Timeseries
모니터 경보, 배포 알림, 인프라 변경 사항, 보안 발견 사항 및 서비스 상태 변경 사항과 같은 이벤트를 검색합니다.
- 지난 24시간 동안의 모든 배포 이벤트를 보여줘.
- 우리 프로덕션 환경과 관련이 있고 오류 상태를 포함한 이벤트를 찾아 줘.
- 지난 한 시간 동안의
service:api로 태그된 이벤트를 가져와.
참고: 자세한 내용은 Event Management API를 참조하세요.
get_datadog_incident
도구 세트: core
필수 권한: Incidents Read
인시던트에 대한 상세 정보를 검색합니다.
- 인시던트 ABC123의 세부 정보를 가져와.
- 인시던트 ABC123의 상태는 뭐야?
- 어제 Redis 인시던트에 관한 전체 정보를 검색해 줘.
참고: 도구가 작동하지만, 인시던트 타임라인 데이터를 포함하지 않습니다.
get_datadog_metric
도구 세트: core
필수 권한: Cloud Cost Management Read 또는 Metrics 또는 Timeseries
과거 또는 실시간 메트릭 데이터를 쿼리하고 분석하며, 사용자 지정 쿼리 및 집계를 지원합니다.
- 지난 4시간 동안의 모든 호스트 CPU 활용률 메트릭을 보여줘.
- 프로덕션 환경의 Redis 지연 시간 메트릭을 가져와.
- 1월부터 2월까지 클라우드 비용이 얼마나 달라졌어?
get_datadog_metric_context
도구 세트: core
필수 권한: Cloud Cost Management Read 또는 Metrics
메타데이터, 사용 가능한 태그 및 필터링과 그룹화용 태그 값 등 메트릭에 관한 상세 정보를 검색합니다.
system.cpu.user 메트릭에 사용할 수 있는 태그는 뭐야?redis.info.latency_ms에서 env 태그에 가능한 모든 값을 보여줘.requests.count 메트릭의 메타데이터와 디멘션을 가져와.
search_datadog_monitors
도구 세트: core
필수 권한: Monitors Read
Datadog 모니터의 상태, 임계값 및 경보 조건 등 정보를 검색합니다.
- 현재 경보 중인 모든 모니터를 목록으로 나열해 줘.
- 우리 결제 서비스와 관련된 모니터를 보여줘.
team:infrastructure로 태그된 모니터를 찾아 줘.
get_datadog_trace
도구 세트: core
필수 권한: APM Read
트레이스 ID를 사용하여 Datadog APM에서 완전한 트레이스를 가져옵니다.
- ID 7d5d747be160e280504c099d984bcfe0에 해당하는 완전한 트레이스를 가져와.
- 트레이스 abc123의 모든 스팬과 타이밍 정보를 보여줘.
- ID xyz789의 데이터베이스 쿼리를 포함한 트레이스 세부 정보를 검색해 줘.
참고: 스팬이 수천 개 있는 대규모 트레이스는 잘릴 수 있으며(잘렸다고 표시됨) 모든 스팬을 검색할 방법은 없습니다.
search_datadog_dashboards
도구 세트: core
필수 권한: Dashboards Read 및 User Access Read
사용 가능한 Datadog 대시보드 및 주요 세부 정보를 목록으로 나열합니다.
- 우리 계정에서 사용 가능한 모든 대시보드를 보여줘.
- 인프라스트럭처 모니터링과 관련된 대시보드를 목록으로 나열해 줘.
- 엔지니어링 팀의 공유 대시보드를 찾아 줘.
참고: 이 도구는 관련 대시보드는 목록으로 나열하지만 그 내용에 관한 세부 정보는 한정적으로만 제공합니다. get_datadog_dashboard를 사용해 전체 위젯 정보를 검색하세요.
get_datadog_notebook
도구 세트: core
필수 권한: Notebooks Read
ID(이름, 상태 및 작성자) 기준으로 특정 노트북에 관한 상세한 정보를 검색합니다.
- 노트북 abc-123-def의 세부 정보를 가져와 줘.
- 어제 디버깅 노트북의 내용을 보여줘.
search_datadog_notebooks
도구 세트: core
필수 권한: Notebooks Read
Datadog 노트북을 작성자, 태그 및 내용 기준으로 필터링하여 목록으로 나열하고 검색합니다.
- 플랫폼 팀이 생성한 모든 노트북을 보여줘.
- 성능 조사와 관련된 노트북을 찾아 줘.
incident-response로 태그된 노트북을 목록으로 나열해 줘.
search_datadog_hosts
도구 세트: core
필수 권한: Hosts Read 및 Timeseries
모니터링된 호스트를 목록으로 나열하고 관련 정보를 제공하며, 필터링과 검색을 지원합니다.
- 우리 프로덕션 환경의 모든 호스트를 보여줘.
- 지난 한 시간 동안 보고하지 않은 비정상 호스트를 목록으로 나열해 줘.
role:database로 태그된 모든 호스트를 가져와.
search_datadog_incidents
도구 세트: core
필수 권한: Incidents Read
Datadog 인시던트 목록(상태, 심각도, 메타데이터 포함)을 검색합니다.
- 모든 활성 인시던트를 심각도 기준으로 보여줘.
- 지난 한 주 동안의 해결된 인시던트를 목록으로 나열해 줘.
- 고객에게 영향을 미치는 인시던트를 찾아 줘.
search_datadog_metrics
도구 세트: core
필수 권한: Metrics
사용 가능한 메트릭을 목록으로 나열하며, 필터링 옵션 및 메타데이터를 함께 표시합니다.
- 모든 사용 가능한 Redis 메트릭을 보여줘.
- 우리 인프라의 CPU 관련 메트릭을 목록으로 나열해 줘.
service:api로 태그된 메트릭을 찾아 줘.
search_datadog_services
도구 세트: core
필수 권한: Service Catalog Read
Datadog 카탈로그의 서비스를 세부 정보 및 팀 정보와 함께 나열합니다.
- 우리 마이크로서비스 아키텍처의 모든 서비스를 보여줘.
- 플랫폼 팀이 소유한 서비스를 목록으로 나열해 줘.
- 결제 처리와 관련된 서비스를 찾아 줘.
search_datadog_service_dependencies
도구 세트: core
필수 권한: APM Read, Service Catalog Read 및 Teams Read
서비스 종속성(업스트림/다운스트림) 및 팀이 소유한 서비스를 검색합니다.
- 체크아웃 서비스를 호출하는 모든 업스트림 서비스를 보여줘.
- 결제 API가 종속되는 다운스트림 서비스는 뭐야?
- 플랫폼 팀이 소유한 모든 서비스를 목록으로 나열해 줘.
search_datadog_spans
도구 세트: core
필수 권한: APM Read
서비스, 시간, 리소스 등의 필터를 사용하여 APM 트레이스에서 스팬을 검색합니다.
- 체크아웃 서비스의 오류가 있는 스팬을 보여줘.
- 지난 30분 동안의 느린 데이터베이스 쿼리를 찾아 줘.
- 우리 결제 서비스에 대한 실패한 API 요청의 스팬을 가져와.
analyze_datadog_logs
도구 세트: core
필수 권한: Logs Read Data, Logs Read Index Data 및 Timeseries
계수, 집계 및 숫자 분석을 위해 SQL 쿼리를 사용하여 Datadog 로그를 분석합니다. 이것은 통계 분석에 사용하세요.
- 지난 한 시간 동안의 서비스별 오류 로그 수를 집계해 줘.
- 상위 10개 HTTP 상태 코드와 그 개수를 보여줘.
- 해당 기간 동안 가장 많이 로깅한 서비스는 뭐야?
search_datadog_logs
도구 세트: core
필수 권한: Logs Read Data 및 Logs Read Index Data
필터(시간, 쿼리, 서비스, 호스트, 스토리지 계층 등)를 사용하여 로그를 검색하고 로그 세부 정보를 반환합니다. get_logs에서 이름이 변경되었습니다.
- 지난 한 시간 동안의 nginx 서비스의 오류 로그를 보여줘.
- 우리 API 서비스에서 ‘connection timeout’을 포함하는 로그를 찾아 줘.
- 프로덕션에서 500 상태 코드 로그를 모두 가져와.
search_datadog_rum_events
도구 세트: core, RUM
필수 권한: RUM Apps Read
고급 쿼리 구문을 사용하여 Datadog RUM 이벤트를 검색합니다.
- JavaScript 오류와 콘솔 경고를 RUM에서 표시해 줘.
- 로딩 속도가 느린(3초 초과) 페이지를 찾아 줘.
- 제품 세부 정보 페이지의 최근 사용자 상호 작용을 표시해 줘.
aggregate_rum_events
도구 세트: core, RUM
필수 권한: RUM Apps Read
RUM 이벤트를 집계하여 개수, 합계, 평균, 최소값, 최대값, 카디널리티 및 백분위수를 계산하며 그룹화를 지원합니다. 개별 이벤트를 검사하는 용도가 아닌 통계 분석 및 추세 데이터용으로 사용하세요.
- 지난 24시간 동안 페이지별 JavaScript 오류 수를 집계해 줘.
- 내 기본 RUM 애플리케이션에 대해 국가별로 그룹화된 p95 로딩 시간을 보여줘.
- 이번 주에 Core Web Vitals 실패가 발생한 세션은 몇 개야?
create_datadog_notebook
도구 세트: core
필수 권한: Notebooks Read 및 Notebooks Write
새 Datadog 노트북을 생성합니다.
- 노트북을 생성하고 체크아웃 서비스 지연 시간 스파이크에 대한 조사 내용을 문서로 기록해 줘.
- 우리 주간 성과 리뷰에 사용할 새 노트북을 만들어 줘.
edit_datadog_notebook
도구 세트: core
필수 권한: Notebooks Read 및 Notebooks Write
기존 Datadog 노트북을 편집합니다.
- 노트북 abc-123-def에 최신 로그 분석 결과를 포함한 섹션을 추가해 줘.
- 인시던트 응답 노트북에 오늘의 발견 사항을 업데이트해 줘.
Alerting
모니터를 검증하고 모니터 그룹을 검색, 모니터 템플릿을 검색하는 도구입니다.
validate_datadog_monitor
도구 세트: alerting
필수 권한: Monitors Read
모니터 정의가 올바른지 검증한 후 생성하거나 업데이트합니다.
- 이 모니터 정의를 생성하기 전에 검증해 줘.
- 내 모니터 쿼리 구문이 올바른지 검사해 줘.
get_datadog_monitor_templates
도구 세트: alerting
필수 권한: Monitors Read
사용 가능한 모니터 템플릿을 검색해 모니터 생성에 도움이 됩니다.
- 사용 가능한 모니터 템플릿을 보여줘.
- 새 모니터를 생성하는 데 어느 템플릿을 사용할 수 있어?
search_datadog_monitor_groups
도구 세트: alerting
필수 권한: Monitors Read
모니터 그룹을 이름 또는 기준별로 검색합니다.
- 경보 상태인 모든 모니터 그룹을 보여줘.
- 체크아웃 서비스와 관련된 모니터 그룹을 찾아 줘.
search_datadog_slos
도구 세트: alerting
필수 권한: SLOs Read
이름, 태그 또는 유형으로 Datadog SLO를 검색합니다. 서비스, 팀 또는 기타 속성 기준으로 필터링하기 위한 쿼리 구문을 지원합니다.
service:checkout 관련 SLO를 검색해 줘.team:backend로 태그된 모든 SLO를 목록으로 나열해 줘.- 결제 서비스의 SLO를 목록으로 나열해 줘.
create_datadog_monitor
도구 세트: alerting
필수 권한: Monitors Write
초안 모드에서 Datadog 모니터를 생성합니다. 이 도구로 생성한 모니터는 알림을 보내지 않으며, 우선순위 5(낮음)로 설정됩니다. 생성하기 전에 validate_datadog_monitor를 사용해 정의를 확인하고, 쿼리 구문 예시는get_datadog_monitor_templates를 참조하세요. 생성한 다음, Datadog UI에 모니터를 게시합니다.
- 웹 서비스에서의 높은 CPU 사용량에 대한 메트릭 경보 모니터를 생성해 줘.
- 결제 서비스에서 오류 급증에 대한 로그 경보 모니터를 설정해 줘.
- 체크아웃 엔드포인트에 대해 p95 지연 시간을 추적하는 모니터를 생성해 줘.
get_monitor_coverage
도구 세트: alerting
필수 권한: Monitors Read
서비스 또는 호스트의 모니터링 격차 및 커버리지를 찾습니다. 기존 모니터가 담당하는 신호가 무엇이고(오류율, 지연 시간 및 요청률 등), 무엇이 누락되었는지 반환합니다. 격차를 메우려면 create_datadog_monitor와 함께 사용하세요.
service:checkout의 모니터링 커버리지를 가져와.host:web-01에 대해 어떤 모니터링 격차가 존재해?- 오류율 모니터가 누락된 서비스를 찾아 줘.
APM
심층 APM 트레이스 분석, 스팬 검색, Watchdog 인사이트 및 성능 조사를 위한 도구입니다.
apm_search_spans
도구 세트: apm
필수 권한: APM Read
APM 쿼리 구문을 사용하여 스팬을 검색하며, 페이지 지정 및 태그 필터링이 지원됩니다.
- 지난 한 시간 동안의 체크아웃 서비스 오류가 있는 스팬을 보여줘.
- 2초 넘게 걸리는 느린 데이터베이스 쿼리를 찾아 줘.
service:payments 및 status:error가 있는 스팬을 검색해 줘.
apm_query_trace
도구 세트: apm
필수 권한: APM Read
트레이스의 스팬 데이터를 쿼리하여 스팬을 필터링, 집계 또는 순위화합니다. 예를 들어 가장 높은 자체 시간을 가진 스팬을 찾거나 오류를 발생시킨 원본 서비스를 추적할 수 있습니다.
- 트레이스
abc123에서 자체 시간이 가장 긴 상위 5개 스팬을 찾아 줘. - 트레이스
abc123의 모든 오류 메시지와 해당 오류를 발생시킨 서비스를 표시해 줘. - 이 트레이스에서 500ms보다 오래 걸린 데이터베이스 호출은 뭐야?
도구 세트: apm
필수 권한: APM Read
시간 범위 내 스팬에서 사용 가능한 태그 키를 검색합니다.
service:checkout의 스팬에서 사용할 수 있는 태그는 뭐야?- APM에서 필터링 기준으로 사용할 수 있는 태그 키를 보여줘.
apm_get_primary_tag_keys
도구 세트: apm
필수 권한: APM Read
조직에 대하여 구성된 기본 태그 키를 검색합니다.
apm_search_watchdog_stories
도구 세트: apm
필수 권한: APM Read
특정 시간 범위 내에서 서비스의 Watchdog 이상 탐지 기록을 검색하여 지연 시간, 오류율 및 트래픽 이상 징후에 대해 AI가 생성한 인사이트를 제공합니다.
- 지난 24시간 동안의 체크아웃 서비스 Watchdog 이상치를 보여줘.
- API 서비스에서 탐지된 지연 시간 이상이 있어?
apm_get_watchdog_story
도구 세트: apm
필수 권한: APM Read
특정 Watchdog 스토리에 관한 상세 정보를 ID 기준으로 검색합니다.
- Watchdog 스토리
abc123의 세부 정보를 가져와.
apm_latency_bottleneck_summary
도구 세트: apm
필수 권한: APM Read
이상 징후 기간 동안 여러 트레이스의 자체 시간 계산을 기반으로 지연 시간 병목 현상을 분석합니다. 가장 많은 자체 시간을 소비하는 서비스 및 리소스 조합을 식별하고, 연쇄 호출 패턴을 탐지하며, 지연 시간 급증의 근본 원인을 파악합니다.
- 오늘 오후 2시부터 3시 사이 체크아웃 서비스의 지연 시간 병목 현상을 요약해 줘.
- 이 지연 시간 급증 동안 결제 서비스에서 가장 많은 자체 시간을 소비하는 요소는 뭐야?
- 10:00부터 10:30까지
service:api의 주요 병목 엔드포인트를 파악해 줘.
get_change_stories
도구 세트: apm
APM 서비스에 대한 변경 추적 API의 변경 내역을 조회합니다. 이 기능을 사용하여 특정 기간 동안 무엇이 변경되었는지(배포, Feature Flags, 구성 업데이트, 인프라 이벤트 등)를 확인하고, 해당 변경 사항을 성능 이슈 또는 인시던트와 상호 연결합니다.
- 결제 서비스의 최근 배포 및 변경 사항을 보여줘.
- 이 지연 시간 급증 시점 전후에 어떤 인프라 변경이 발생했어?
- 지난 한 시간 동안 체크아웃 서비스의 기능 플래그와 구성 변경 사항을 찾아 줘.
semantic_search_change_stories
도구 세트: apm
자연어 및 AI 기반 의미 검색을 사용하여 변경 내역을 검색합니다. 이 기능을 사용하여 조사 중인 동작, 사용자 보고 이슈 또는 제품 영역과 관련된 기능 플래그 또는 배포 변경 사항을 찾습니다.
- 체험 사용자의 대시보드 로딩에 영향을 줄 수 있는 최근 변경 사항은 뭐야?
- 청구 설정 페이지의 인증에 영향을 줄 수 있는 플래그는 뭐야?
- 지난주에 누락된 텔레메트리 데이터와 관련된 변경 사항을 찾아 줘.
apm_search_recommendations
도구 세트: apm
필수 권한: APM Read
Datadog에서 APM 권장 사항을 검색합니다.
- 내 서비스에 대한 APM 권장 사항을 보여줘.
- 애플리케이션에 대한 최적화 제안이 있어?
apm_get_recommendation
도구 세트: apm
필수 권한: APM Read
ID별 특정 APM 권장 사항의 전체 세부 정보를 검색합니다.
Audit Trail
Audit Trail 이벤트 검색 및 조회, Audit Trail 검색 쿼리 구성을 포함한 Audit Trail용 도구입니다.
search_audit_events
도구 세트: audit-trail
필수 권한: Audit Trail Read
Datadog 쿼리 구문을 사용하여 Audit Trail 이벤트를 검색하며 페이지 매김을 지원합니다. 특정 속성별로 이벤트를 찾고 필터링해야 할 때 사용하세요. 요청하지 않는 한 메타데이터와 이전 또는 새 자산 값을 제외한 Audit Trail 이벤트를 반환합니다.
- 누가
abc123 모니터를 삭제했어? - 지난주에 Datadog 로그인 실패 시도가 있었어?
- Audit Trail 검색을 통해 이번 달에 API 키 유출 알림이 있었는지 확인해 줘.
list_audit_events
도구 세트: audit-trail
필수 권한: Audit Trail Read
페이지 매김 및 선택적 쿼리를 지원하며 시간 범위 내의 Audit Trail 이벤트를 나열합니다. 최근 Audit Trail 이벤트를 스캔할 때 사용합니다. 요청하지 않는 한 메타데이터와 이전 또는 새 자산 값을 제외한 Audit Trail 이벤트를 반환합니다.
- 지난 한 시간 동안의 Audit Trail 이벤트를 보여줘.
build_audit_trail_query
도구 세트: audit-trail
필수 권한: Audit Trail Read
자연어 설명을 Audit Trail 쿼리 문자열로 번역합니다. Audit Trail 이벤트를 검색할 때 쿼리 구문이 확실하지 않은 경우, 먼저 이 도구를 사용하여 검색하려는 이벤트에 대한 설명을 입력한 후, 반환된 쿼리 및 타임스탬프를 search_audit_events에 직접 전달하세요.
- 지난 2주 동안 누가 새 모니터를 생성했는지 확인하기 위한 Audit Trail 쿼리를 작성해 줘.
- 대시보드
abc123가 언제 삭제되었는지 보여주는 Audit Trail 쿼리를 만들어줘. - Datadog MCP 서버를 통해 어떤 작업이 실행되었는지 확인하기 위한 Audit Trail 쿼리를 생성해 줘.
케이스
Case Management 도구입니다(케이스 생성, 검색 및 업데이트, 프로젝트 관리, Jira 이슈 연결 포함).
search_datadog_cases
도구 세트: cases
필수 권한: Cases Read
상태, 우선순위, 프로젝트, 담당자 등의 필터를 사용하여 Case Management 케이스를 검색합니다. 시간 범위 필터링 및 페이지 지정을 지원합니다.
- 나에게 할당된 모든 진행 중인 케이스를 보여줘.
- 보안 검토 프로젝트에 진행 중인 P1 케이스가 있어?
- 결제 서비스와 관련해 이번 주에 개시된 모든 케이스를 보여줘.
get_datadog_case
도구 세트: cases
필수 권한: Cases Read
ID 또는 제목, 상태, 우선순위, 담당자, 타임스탬프 등의 키를 기준으로 특정 케이스에 관한 상세 정보를 검색합니다. 선택 사항으로 타임라인 활동(코멘트 및 상태 변경)과 사용자 지정 속성을 포함합니다.
- CASE-1234의 최신 업데이트는 뭐야? 전체 타임라인을 보여줘.
- 이 케이스는 누가 작업하고 있고, 지금까지 진행 상황은 어때?
- 데이터베이스 마이그레이션 케이스의 세부 정보 및 모든 코멘트를 가져와.
create_datadog_case
도구 세트: cases
필수 권한: Cases Write
제목, 프로젝트 및 선택 사항 필드(설명, 우선순위, 담당자 등)를 포함한 새 Case Management 케이스를 생성합니다.
- 체크아웃 서비스에서 지연 시간이 급증하고 있어. 조사를 추적할 P2 케이스를 생성해 줘.
- 로그에서 발견한 의심스러운 로그인 활동에 대해 보안 검토 케이스를 열어 줘.
update_datadog_case
도구 세트: cases
필수 권한: Cases Write
상태, 우선순위, 제목, 설명, 담당자, 기한 및 사용자 지정 속성과 같은 기존 케이스의 필드를 업데이트합니다. 제공한 필드만 업데이트됩니다.
- 이 이슈는 이제 고객에게 영향을 미치고 있어. CASE-1234를 P1으로 에스컬레이션해 줘.
- 데이터베이스 마이그레이션 케이스를 해결됨으로 표시해 줘.
- CASE-1234의 기한을 주말로 설정해 줘.
도구 세트: cases
필수 권한: Cases Write
케이스의 타임라인에 코멘트를 추가합니다. 코멘트는 마크다운 형식 지정을 지원합니다.
- 케이스에 우리가 로그와 트레이스에서 발견한 내용을 요약하는 메모를 추가해 줘.
- 핫픽스가 배포되었고 모니터링 중이라는 업데이트를 게시해 줘.
- 이 케이스의 근본 원인 발견 사항을 문서로 기록해 줘.
link_jira_issue_to_datadog_case
도구 세트: cases
필수 권한: Cases Write
- 인프라 마이그레이션에 대한 Jira 티켓을 이 케이스에 연결해서 둘 다 추적할 수 있게 해줘.
- 엔지니어링 팀이 가시성을 확보하도록 PROJ-456을 Datadog 케이스에 연결해 줘.
list_datadog_case_projects
도구 세트: cases
필수 권한: Cases Read
사용 가능한 Case Management 프로젝트를 목록으로 나열하며, 이름 또는 키 기준의 선택적 필터링을 포함합니다.
- Case Management에서는 무슨 프로젝트를 사용할 수 있어?
- Case Management에 보안과 관련된 프로젝트가 있어?
get_datadog_case_project
도구 세트: cases
필수 권한: Cases Read
ID별 특정 케이스 프로젝트의 세부 정보를 가져옵니다.
search_datadog_users
도구 세트: cases
필수 권한: User Access Read
이메일, 이름 또는 핸들 기준으로 Datadog 사용자를 검색합니다. 케이스를 할당할 적임자를 찾는 데 유용합니다.
Cloud Cost Management
예상 일일 절감액을 기준으로 정렬된 비용 절감 권장 사항을 나열하는 기능을 포함한 Cloud Cost Management 도구입니다.
cost_recommendations
도구 세트: cost
필수 권한: Cloud Cost Management Read
Cloud Cost Management 비용 절감 권장 사항을 예상 일일 절감액이 높은 순서대로 나열합니다. 클라우드 공급자, 권장 사항 유형, 상태, 절감액 임계값 및 리소스 태그별 패싯 필터링을 지원하며, 페이지 매김과 총 개수 및 예상 일일 총절감액 요약을 제공합니다.
쿼리 예시:
- 클라우드 비용을 가장 많이 절감할 수 있는 권장 사항은 뭐야?
- 하루에 얼마나 절약할 수 있으며, 아직 완료하지 않은 권장 사항은 몇 개야?
- 팀에서 이미 진행 중인 Kubernetes 클러스터 최적화 작업은 뭐야?
코드 실행
Datadog이 관리하는 샌드박스에서 에이전트가 작성한 TypeScript를 실행하며 Datadog API에 직접 액세스하여 여러 신호에 대한 조사 및 임시 데이터 탐색을 한 번에 수행하는 단일 도구입니다.
해당
code-exec 도구 세트는 미리 보기로 제공되고 있습니다. 미리 보기에
가입하거나
Datadog 지원팀에 문의하여 액세스를 요청하세요.
이 도구 세트에서 실행되는 코드는 사용자의 Datadog API에 대해 사용자 본인의 ID로 실행됩니다. 샌드박스는 모든 API 호출에 기존 역할 권한을 적용하므로, 에이전트는 사용자가 Datadog에서 이미 액세스할 수 있는 데이터만 읽거나 수정할 수 있습니다.
execute_code
도구 세트: code-exec
필수 권한: 실행된 코드가 상호작용하는 기본 Datadog 리소스에 접근하기 위해 필요한 제품별 역할 권한(예: Logs Read 로그를 읽기 위해 필요)입니다.
Datadog이 관리하는 샌드박스에서 AI 에이전트가 작성한 TypeScript를 실행합니다. 코드는 로그, 메트릭, 트레이스, 서비스, 변경 이벤트, 인시던트, 모니터, 대시보드 및 기타 Datadog API를 조회할 수 있는 헬퍼가 포함된 dd.* 네임스페이스를 제공받으며, 구조화된 결과를 에이전트에 반환합니다. 이를 통해 다중 신호 조사 및 임시 데이터 탐색 시 필요한 왕복 호출 횟수를 줄일 수 있습니다.
- 지난 2시간 동안
checkout-api 서비스의 오류 로그, 지연 시간 메트릭 및 최근 배포 내역을 함께 조회하고 오류 급증과 일치하는 배포를 알려줘. - 지난 하루 동안
payments 서비스의 오류 스팬 수, 모니터 경보 및 구성 변경 사항을 비교하고 동일한 시점에 발생한 사항을 파악해 줘. auth-service에 대해 로그의 주요 오류 패턴을 지난 1시간의 CPU 및 메모리 메트릭과 상호 연결하여 오류가 리소스 압박과 관련이 있는지 확인해 줘.
Dashboards
대시보드 검색, 생성, 업데이트 및 삭제를 위한 도구이며 위젯 스키마 참조 및 검증도 포함합니다.
get_datadog_dashboard
도구 세트: core, 대시보드
필수 권한: Dashboards Read 및 User Access Read
Datadog 대시보드를 ID 기준으로 검색하여 제목, 설명, 태그, 위젯을 반환합니다. 우선 search_datadog_dashboards를 사용해 대시보드 ID를 찾으세요.
- 대시보드
ps7-mn3-kwf의 전체 세부 정보를 가져와. - 인프라 개요 대시보드의 위젯과 레이아웃을 보여줘.
- 이 대시보드에서 구성된 템플릿 변수를 검색해 줘.
upsert_datadog_dashboard
도구 세트: core, 대시보드
필수 권한: Dashboards Read 및 Dashboards Write
Datadog 대시보드를 생성하거나 업데이트합니다. 기존 대시보드를 업데이트하려면 해당 대시보드 ID를 제공하세요. 새로 생성하려면 ID를 생략합니다. 위젯을 빌드하기 전에 위젯 스키마를 위해 get_widget_reference를 호출합니다.
- 모든 호스트 전반의 CPU 및 메모리 사용량을 표시하는 대시보드를 생성해 줘.
- 대시보드
abc-123-def에 오류율에 대한 시계열 위젯을 추가해 줘. - 서비스 개요 대시보드의 제목과 설명을 업데이트해 줘.
delete_datadog_dashboard
도구 세트: 대시보드
필수 권한: Dashboards Read 및 Dashboards Write
ID를 기준으로 Datadog 대시보드를 영구적으로 삭제합니다. 이 액션은 실행 취소할 수 없습니다. 우선 search_datadog_dashboards를 사용해 대시보드 ID를 찾으세요.
- 대시보드
ps7-mn3-kwf를 삭제해 줘. - 오래된 스테이징 환경 대시보드를 제거해 줘.
도구 세트: 대시보드
필수 권한: Dashboards Read 또는 Dashboards Write 또는 Notebooks Read
대시보드 위젯 유형에 대한 스키마 및 빌드 지침을 반환합니다. 위젯 정의는 JSON 객체입니다. 이 도구는 스키마를 나타내는 TypeScript 유형 정의를 반환하며 그와 함께 쿼리 패턴, 수식 구문, 일반적인 위험 등을 다루는 빌드 지침도 함께 반환합니다. upsert_datadog_dashboard를 사용하여 위젯을 생성하기 전에 이것을 호출하세요.
- 시계열 위젯의 스키마를 가져와.
- 상위 목록과 쿼리 표 위젯을 빌드하는 방법을 보여줘.
- 산점도 위젯의 스키마는 뭐야?
도구 세트: 대시보드
필수 권한: Dashboards Read 또는 Dashboards Write 또는 Notebooks Read
대시보드 스키마를 기준으로 위젯 정의를 검증합니다. 위젯 JSON을 upsert_datadog_dashboard에 전달하기 전에 이것을 사용해 검사하세요.
- 대시보드를 생성하기 전에 시계열 위젯 정의를 검증해 줘.
- 이 쿼리 표 위젯 JSON이 올바른지 검사해 줘.
도구 세트: 대시보드
필수 권한: Dashboards Read 또는 Dashboards Write 또는 Notebooks Read
위젯 구성, 스키마, 쿼리 구문, 필드 사용, 디버깅 또는 위험과 관련해 Datadog 위젯 전문가에게 질문합니다. 스키마 조회, 필드 설명, 기존 위젯 정의 디버깅 또는 특정 위젯 유형의 작동 방식을 이해하고자 하는 등 맞춤화된 질문에 가장 효과적입니다.
- toplist에는 어느 response_format을 사용해야 해?
- 산점도 위젯의 스키마는 뭐야?
- 이 위젯이 정수가 아닌 분수 값을 표시하는 이유를 디버그하게 도와줘.
- 시계열이 막대와 선 차트를 둘 다 표시하게 구성하려면 어떻게 해야 해?
Data Observability
데이터 카탈로그 검색, 계보 분석, 데이터 품질 모니터링, 데이터 웨어하우스 및 Spark 작업에 대한 비용·성능 권장 사항을 비롯한 Data Observability 도구입니다.
search_data_entities
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
이름, 전체 텍스트 검색 또는 필터(플랫폼, 스키마, 데이터베이스, 계정)를 통해 데이터 카탈로그에서 데이터 엔티티를 검색합니다.
- Snowflake에서 이름이 ‘orders’인 표를 찾아줘.
stg_로 시작하는 모든 dbt 모델을 나열해 줘.- 내 BigQuery 프로젝트에 어떤 스키마가 존재해?
get_data_catalog_schema
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
카탈로그에 데이터가 있는 모든 플랫폼에 대한 엔티티 유형 스키마(엔티티 유형, 포함 계층 구조, 필터링 가능한 속성 및 기본 메트릭)를 반환합니다.
- Data Observability에 연결된 플랫폼은 뭐야?
- Databricks에 존재하는 엔티티 유형은 뭐야?
- 표 엔티티에 사용할 수 있는 메트릭은 뭐야?
get_data_entity_details
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
ID별로 하나 이상의 데이터 엔티티에 대한 전체 세부 정보 및 속성(소유자, 태그, 사용자 지정 속성, 플랫폼, 스키마, 데이터베이스, 계정)을 가져옵니다.
- 이 표 엔티티의 전체 속성을 가져와.
- 이 데이터세트의 소유자는 누구야?
get_data_entity_hierarchy
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
하나 이상의 엔티티에 대한 포함 계층 구조(상위 및 하위 항목)를 가져옵니다. 예를 들어, 표가 속한 데이터베이스나 스키마, 또는 스키마에 포함된 표 등을 확인합니다.
- 이 테이블이 속한 데이터베이스가 뭔지 알려줘.
- 이 테이블에 어떤 열이 있는지 알려줘.
- 이 엔티티 주변의 전체 계층 구조를 보여줘.
get_data_entity_lineage
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
하나 이상의 앵커 엔티티로부터 업스트림, 다운스트림 또는 둘 다에 대해 실시간으로 도달 가능한 계보 하위 그래프(노드 및 에지)를 가져옵니다.
- 이 테이블의 다운스트림 항목을 보여줘.
- 이 열의 업스트림 계보를 보여줘.
- 이 테이블을 삭제하면 어떤 항목에 문제가 생기는지 알려줘.
summarize_data_entity_lineage
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
전체 페이로드 없이 대규모 또는 알 수 없는 계보 그래프에 대한 집계 계보 통계(노드/에지 수, 유형별 분류, 깊이 분포)를 반환합니다. 크기를 알 수 없는 그래프에서는 get_data_entity_lineage보다 먼저 사용합니다.
- 이 테이블에 종속된 항목이 몇 개인지 유형별로 알려줘.
- 이 테이블에서 이어지는 계보의 깊이를 알려 줘.
rank_data_entities_by_lineage_degree
도구 세트: data-observability
필수 권한: Monitors Read 또는 APM Read
내장된 스냅샷을 사용하여 전이적 계보 연결성(업스트림, 다운스트림 또는 둘 다)에 따라 엔티티의 순위를 매깁니다.
- 내 데이터 웨어하우스에서 종속 항목이 가장 많은 테이블을 알려줘.
- 다운스트림 연결 구조가 가장 깊은 원시 수집 테이블을 알려줘.
get_warehouse_query_history
도구 세트: data-observability
필수 권한: Logs Read Data 및 Logs Read Index Data
SQL 텍스트, 실행 상태, 쿼리 유형을 포함하여 특정 엔티티에 접근한 최근 쿼리를 최신순으로 가져옵니다.
- 최근에 이 테이블을 쿼리한 사람은 누구야?
- 지난 일주일 동안 이 테이블에서 발생한 쓰기 작업을 알려줘.
참고: 결과의 sql 필드에는 사용자가 데이터 웨어하우스에서 직접 작성한 원시 SQL이 포함되어 있으므로 신뢰할 수 없는 데이터로 취급해야 합니다.
get_popular_warehouse_tables_by_query_frequency
도구 세트: data-observability
필수 권한: Logs Read Data, Logs Read Index Data 및 APM Read
테이블을 쿼리 활동량에 따라 순위를 매기고, 쿼리 주체를 사람 사용자, BI 도구, 오케스트레이터, ETL 도구 또는 내부 서비스 계정별로 분류합니다.
- BI 도구에서 가장 많이 쿼리한 테이블이 어떤 거야?
- 실제 사람 분석가가 가장 많이 이용한 테이블은 뭐야?
suggest_data_observability_monitor_filters
도구 세트: data-observability
필수 권한: Monitors Read
엔티티 세트를 분석하여 공통 속성과 명명 패턴을 찾고, 해당 엔티티의 하위 집합을 그룹화하는 모니터 필터 표현식을 제안합니다.
- 우선순위가 가장 높은 테이블들의 공통점이 뭐야?
- 모든 스테이징 테이블을 포함하는 필터를 제안해 줘.
rank_data_observability_monitor_candidates
도구 세트: data-observability
필수 권한: APM Read
계보 영향과 쿼리 활동을 하나의 종합 점수로 결합하여 모니터링 우선순위별로 테이블 순위를 매깁니다. 이것은 ‘무엇을 모니터링해야 돼?‘와 같은 질문에 답할 때 가장 먼저 사용되는 도구입니다.
- 어떤 테이블에 데이터 품질 모니터를 먼저 설정해야 하는지 알려줘.
get_data_observability_monitor
도구 세트: data-observability
필수 권한: Monitors Read, Timeseries 및 APM Read
지정된 모니터 ID에 대한 데이터 품질 메트릭 시계열을 검색하며, 활성화된 경우 이상 탐지 범위도 포함합니다.
- 모니터
12345의 메트릭 기록을 보여줘. - 이 최신성 모니터의 이상 징후 범위를 보여줘.
get_data_observability_monitor_coverage
도구 세트: data-observability
필수 권한: Monitors Read
조직의 모든 데이터 품질 모니터를 가져오고 각 모니터의 필터를 적용 대상 엔티티로 확인합니다. 모니터링이 전혀 없는 테이블을 확인하려면 이 기능을 사용하세요.
- 데이터 품질 모니터가 설정되지 않은 테이블을 알려줘.
get_data_observability_monitor_group_statuses
도구 세트: data-observability
필수 권한: APM Read
데이터 품질 모니터 그룹의 현재 경고 및 주의 상태를 조회합니다.
- 현재 데이터 품질 검사를 통과하지 못한 테이블을 알려줘.
도구 세트: data-observability
필수 권한: get 작업 요청 시 APM Read 또는 Monitors Read 사용, update 작업 요청시 Data Observability Catalog Write 사용
데이터 엔티티에 사용자 정의 태그를 가져오거나 설정합니다.
- 이 테이블에 어떤 태그가 있어?
- 이 테이블에
owner:data-platform-team 태그를 지정해 줘.
get_entity_descriptions/update_entity_description
도구 세트: data-observability
필수 권한: get 작업 요청 시 APM Read 또는 Monitors Read 사용, update 작업 요청시 Data Observability Catalog Write 사용
데이터 엔티티에 대한 사용자 정의 설명을 가져오거나 설정합니다.
- 이 테이블의 설명을 보여줘.
- 이 테이블의 용도를 설명하는 내용을 설정해 줘.
get_spark_job_health
도구 세트: data-observability
필수 권한: APM Read
단일 Spark 또는 Databricks 작업 실행에 대한 상세 상태 메트릭(기간, 실행자 CPU 시간, 셔플, 스필, 성능이 가장 저조한 스테이지)을 검색합니다.
- 이 Spark 작업이 느리게 실행된 이유를 알려줘.
- 이 작업의 최근 실행에서 성능이 가장 저조한 단계를 보여줘.
get_spark_sql_plan
도구 세트: data-observability
필수 권한: APM Read
조인 전략, 셔플 정보 및 노드별 메트릭을 포함하여 스테이지에 대한 Spark SQL 물리적 실행 계획을 검색합니다.
- 이 Spark 스테이지의 실행 계획을 보여줘.
list_data_observability_recommendations
도구 세트: data-observability
필수 권한: APM Read
데이터 작업 및 쿼리(Spark, Databricks, Snowflake, BigQuery)에 대한 비용 및 성능 최적화 권장 사항과 예상 비용 절감액 및 시간 절감 효과를 나열합니다. 커서 기반 페이지 매김을 사용하여 간단한 요약을 반환합니다.
- 내 Databricks 작업에 적용할 수 있는 비용 절감 권장 사항을 알려줘.
- 내 Spark 작업의 데이터 편향을 줄이기 위한 권장 사항이 있는지 알려줘.
get_data_observability_recommendation
도구 세트: data-observability
필수 권한: APM Read
문제, 증거 및 제안된 변경 사항을 설명하는 구조화된 본문을 포함하여 ID별로 특정 Data Observability 권장 사항의 전체 세부 정보를 검색합니다.
Database Monitoring
Database Monitoring과의 상호작용을 위한 도구입니다.
find_datadog_database_instances
도구 세트: dbm
필수 권한: Database Monitoring Read
DBM 조사를 위해 데이터베이스 인스턴스를 검색하고 순위를 매깁니다. database_instance 파라미터가 필요한 기타 DBM 도구보다 이것을 먼저 호출하세요. APM 트레이스 또는 스팬 ID, 태그 또는 둘 모두를 수락하여 일치하는 인스턴스를 찾은 다음 해당 인스턴스를 평가하고 순위를 매깁니다.
- 한 시간 전에 트레이스
abc123와 상호 연결된 데이터베이스 인스턴스를 찾아 줘. cluster_name:payments-prod와 일치하는 PostgreSQL 인스턴스는 뭐야?- 상태 기준으로 서비스
checkout-api의 데이터베이스 인스턴스 순위를 매겨줘.
get_datadog_database_calling_services
도구 세트: dbm
필수 권한: Database Monitoring Read
데이터베이스 쿼리를 호출하는 업스트림 APM 서비스 및 리소스를 식별합니다. APM-데이터베이스 경계 전반의 근본 원인 분석을 위해 데이터베이스 활동을 애플리케이션 트레이스와 상호 연결합니다.
db-prod-1에서 가장 느린 쿼리를 호출하는 서비스는 뭐야?- 쿼리 서명
abc123def의 기본 호출자를 찾아 줘. - 결제 데이터베이스의 로드의 원인인 APM 리소스를 보여줘.
get_datadog_database_explain_plans
도구 세트: dbm
필수 권한: Database Monitoring Read
시간 프레임 내 쿼리 서명의 PostgreSQL 실행 계획을 검색합니다. 연산자 트리, 인덱스 사용량, 예상 비용을 비용 기준으로 정렬한 간소화된 계획 구조를 반환합니다.
db-prod-1의 쿼리 서명 abc123def에 대한 설명 계획을 가져와.- 이 느린 쿼리의 가장 비싼 실행 계획을 보여줘.
- 지난 하루 동안 쿼리 서명
xyz789에는 어떤 계획 변형이 발생했어?
get_datadog_database_health_signals
도구 세트: dbm
필수 권한: Database Monitoring Read
상태 검사를 실행하여 CPU 포화도, 재시작, 쿼리 지연 시간, 차단과 같은 잠재적인 PostgreSQL 이슈를 드러냅니다. 회귀 시간 프레임을 기준 기간과 비교합니다.
- 지난 한 시간과 그 이전 한 시간의
db-prod-1 상태 검사를 실행해 줘. - 인시던트 시간 프레임을 전후한 데이터베이스 상태를 검사해 줘.
- 결제 데이터베이스의 회귀를 설명하는 신호는 뭐야?
도구 세트: dbm
필수 권한: Database Monitoring Read
특정 PostgreSQL 쿼리의 성능을 분석합니다. 처리량, 평균 지연 시간, 실행 시간, 실행당 행, 캐시 히트율, I/O 통계, 연결 활동, 대기 이벤트 및 트랜잭션 소요 시간을 반환하며 전체 통계와 타임 버킷 분석을 포함합니다.
- 지난 한 시간 동안의 쿼리 서명
abc123def 성능을 분석해 줘. - 이 쿼리가 프로덕션 PostgreSQL 인스턴스에서 속도가 느린 이유는 뭐야?
- 쿼리 서명
xyz789의 대기 이벤트 및 캐시 히트율을 표시해 줘.
get_datadog_database_query_statement
도구 세트: dbm
필수 권한: Database Monitoring Read
주어진 쿼리 서명에 대한 SQL 문 텍스트를 검색합니다. 이것을 사용해 서명 해시를 다시 구체적인 SQL로 매핑하여 조사 및 보고에 활용하세요.
- 쿼리 서명
abc123def의 SQL을 가져와. - 이 쿼리 해시 뒤의 문을
db-prod-1에 보여줘. - 서명
xyz789는 어느 쿼리에 해당해?
get_datadog_database_recommendations
도구 세트: dbm
필수 권한: Database Monitoring Read
데이터베이스, 쿼리, 표, 호스트 또는 인덱스의 실시간 데이터베이스 권장 사항을 검색합니다. 일치하는 권장 사항을 반환하며 여기에 상태, 심각도 및 정규화된 범위 블록을 포함하여 영향을 받는 인스턴스를 강조 표시하고, 쿼리 서명, 표, 인덱스, 서비스, 계획, 인프라 식별자를 함께 표시합니다.
db-prod-1의 오픈 데이터베이스 권장 사항을 표시해 줘.- 결제 데이터베이스에서 누락된 인덱스 권장 사항을 목록으로 나열해 줘.
- 쿼리 서명
abc123def의 심각도가 높은 권장 사항을 가져와.
get_datadog_database_schemas
도구 세트: dbm
필수 권한: Database Monitoring Read
하나 이상의 데이터베이스 객체에 대한 스키마 정의(열, 인덱스, 외래 키, 파티션)를 가져옵니다. 선택적 스키마, 데이터베이스 및 인스턴스 한정자가 있는 표 이름을 수락합니다.
orders 표의 스키마를 보여줘.db-prod-1의 public.users에 대한 열과 인덱스를 가져와.payments 표의 외래 키를 가져와.
optimize_datadog_database_query
도구 세트: dbm
필수 권한: Database Monitoring Read
결정론적 규칙을 사용하여 최적화 기회를 위해 PostgreSQL 쿼리를 분석합니다. 쿼리 재작성, 안티 패턴 감지(SELECT *, ORDER BY 없는 OFFSET, LIMIT 없는 ORDER BY), 누락된 인덱스 제안, 트랜잭션 중 유휴 영향 분석을 반환합니다. SQL 텍스트 또는 쿼리 서명을 수락합니다.
- 결제 데이터베이스에서 쿼리 서명
abc123def를 최적화해 줘. - 이 SQL에 누락된 인덱스 및 안티 패턴이 있는지 검사해 줘.
db-prod-1에서 가장 느린 쿼리에 대한 재작성을 제안해 줘.
search_datadog_database_plans
도구 세트: dbm
필수 권한: Database Monitoring Read
Database Monitoring 쿼리 실행 계획을 검색합니다. 여기에는 데이터베이스 엔진이 어떻게 쿼리를 실행하는지 표시되며, 인덱스 사용량, 조인 전략, 비용 추산이 포함됩니다. 이것을 사용해 쿼리 성능을 분석하고 최적화 기회를 알아보세요.
- 지난 한 시간 동안의
host:db-prod-1 느린 쿼리의 실행 계획을 보여줘. - 프로덕션 데이터베이스에서
@db.plan.type:explain_analyze가 있는 쿼리 계획을 찾아줘. - 기간이 1초보다 큰
@db.user:app_user가 있는 실행 계획을 가져와.
search_datadog_database_samples
도구 세트: dbm
필수 권한: Database Monitoring Read
성능 메트릭을 포함하며 개별 쿼리 실행을 나타내는 Database Monitoring 쿼리 샘플을 검색합니다. 이것을 사용해 데이터베이스 활동 패턴을 분석하고 느린 쿼리를 식별하며, 데이터베이스 성능 이슈를 조사하세요.
db:mydb에서 (지속 시간이 1초보다 큰) @duration:>1000000000이 있는 쿼리 샘플을 보여줘.host:db-prod-1에서 @db.user:app_user로 필터링된 느린 쿼리를 찾아 줘.@db.query_signature:abc123def의 최근 쿼리 샘플을 가져와서 성능 패턴을 분석해 줘.
DDSQL
DDSQL을 사용하여 Datadog 데이터를 쿼리하기 위한 도구로, DDSQL은 인프라 리소스, 로그, 메트릭, RUM, 스팬 및 기타 Datadog 데이터 소스를 지원하는 SQL 방언입니다.
ddsql_get_spec
도구 세트: ddsql
지원되는 SQL 함수, SQL 키워드 및 표준 PostgreSQL과 DDSQL의 차이를 포함한 간결한 DDSQL 기능 사양을 가져옵니다. 지원되는 구문을 이해하려면 쿼리를 작성하기 전에 이 도구를 호출하세요.
- DDSQL에서 지원되는 SQL 함수는 뭐야?
- DDSQL 쿼리 구문 규칙과 PostgreSQL과의 차이점을 보여줘.
- DDSQL에서 사용할 수 있는 집계 함수는 뭐야?
ddsql_schema_search_tables
도구 세트: ddsql
DDSQL 데이터 세트를 검색하여 표(퍼블릭 데이터 소스, 참조 테이블) 및 사용 가능한 메트릭을 반환합니다.
- DDSQL에서 쿼리할 수 있는 표는 뭐야?
- Kubernetes와 관련된 DDSQL 표를 검색해 줘.
- DDSQL을 사용한 쿼리에 사용할 수 있는 메트릭을 보여줘.
ddsql_schema_get_table_columns
도구 세트: ddsql
스키마 메타데이터에서 DDSQL 표의 정적 SQL 열을 가져옵니다.
aws.ec2_instance 표에서 사용할 수 있는 열은 뭐야?k8s.pods 표의 스키마를 보여줘.
ddsql_schema_search_unstructured_fields
도구 세트: ddsql
로그, RUM, 스팬과 같은 비구조적 DDSQL 소스의 필드를 검색하고 순위를 매깁니다(빈도 기준으로 정렬). 이 도구는 검색 가능한 소스에서 ddsql_schema_get_table_columns로 폴백하기 전에 스키마를 검색하는 데 사용하세요.
- DDSQL 로그에서 사용할 수 있는 필드는 뭐야?
- 내 RUM 데이터에서
service 관련 필드를 찾아 줘. - 내 스팬 데이터에서 가장 일반적인 필드를 보여줘.
ddsql_run_query
도구 세트: ddsql
DDSQL 쿼리를 실행하고 결과를 반환합니다. SQL 구문을 사용한 인프라 리소스, 로그, 메트릭, RUM, 스팬 및 기타 Datadog 데이터 소스 쿼리를 지원합니다. 구문 세부 정보는 DDSQL 참조를 참조하세요.
- 각 AWS 리전에서 실행 중인 EC2 인스턴스는 몇 개야?
- 지난 한 시간 동안의 오류 로그 수가 가장 많은 서비스를 상위 10개까지 보여줘.
- 지난 24시간 동안 호스트별로 그룹화한 평균 CPU 사용량을 쿼리해 줘.
ddsql_create_link
도구 세트: ddsql
주어진 쿼리가 미리 채워진 DDSQL Editor에 대한 Datadog UI 링크를 생성합니다.
- 이 쿼리에 대한 DDSQL Editor 링크를 생성해 줘.
- 내 인프라 쿼리를 사용해서 DDSQL Editor에 대한 공유 가능한 링크를 생성해 줘.
Error Tracking
Datadog Error Tracking과의 상호작용을 위한 도구입니다.
search_datadog_error_tracking_issues
도구 세트: error-tracking
필수 권한: Error Tracking Read
데이터 소스 전체에서(RUM, 로그, 트레이스) Error Tracking 이슈를 검색합니다.
- 지난 24시간 동안 체크아웃 서비스의 모든 Error Tracking 이슈를 보여줘.
- 지난 한 주 동안 내 애플리케이션에서 가장 일반적인 오류는 뭐야?
service:api를 사용해 프로덕션 환경에서 Error Tracking 이슈를 찾아 줘.
get_datadog_error_tracking_issue
도구 세트: error-tracking
필수 권한: Cases Read 및 Error Tracking Read
Datadog에서 특정 Error Tracking 이슈에 관한 상세한 정보를 검색합니다.
- Error Tracking 이슈
550e8400-e29b-41d4-a716-446655440000 해결을 도와줘. - Error Tracking 이슈
a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f의 영향은 뭐야? - Error Tracking 이슈
7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f를 재현할 테스트 케이스를 생성해 줘.
analyze_datadog_error_tracking_errors
도구 세트: error-tracking
필수 권한: Error Tracking Read 및 Timeseries
SQL 쿼리를 사용하여 Datadog Error Tracking 오류를 분석하고 개수 계산, 집계 및 수치 분석을 수행합니다. 이슈(오류 그룹)가 아닌 개별 오류 샘플을 대상으로 동작합니다.
- 지난 한 시간 동안 서비스별 오류 수를 집계해 줘.
- 지난주 체크아웃 서비스의 주요 오류 유형을 보여 줘.
- 버전별 오류를 분석하여 어떤 배포에서 이슈가 발생했는지 파악해 줘.
update_datadog_error_tracking_issue
도구 세트: error-tracking
필수 권한: Cases Read, Cases Write, Error Tracking Read 및 Error Tracking Write
Datadog Error Tracking 이슈의 상태 또는 담당자를 업데이트합니다.
- Error Tracking 이슈
550e8400-e29b-41d4-a716-446655440000을 해결됨으로 표시해 줘. - Error Tracking 이슈
a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f를 나에게 할당해 줘. - Error Tracking 이슈
7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f의 상태를 무시됨으로 설정해 줘.
도구 세트: error-tracking
필수 권한: Cases Read, Cases Write, Error Tracking Read 및 Error Tracking Write
Datadog Error Tracking 이슈에 대한 댓글을 추가, 업데이트 또는 삭제합니다.
- Error Tracking 이슈
550e8400-e29b-41d4-a716-446655440000에 ‘지금 조사 중’이라는 댓글을 추가해 줘. - 방금 추가한 댓글을 ‘버전 2.3.1에서 수정됨’으로 업데이트해 줘.
- 방금 해당 이슈에 추가한 댓글을 삭제해 줘.
실험
실험 생성 및 종료, 진단 실행, 메트릭 변동 조사를 포함하여 실험을 관리하고 분석하기 위한 도구입니다.
해당
experiments 도구 세트는 기본적으로 활성화되어 있지 않습니다. 도구 세트 활성화에 대한 지침은
Datadog MCP 서버 설정을 참조하세요.
list_experiments
도구 세트: experiments
필수 권한: Product Analytics Experiments Read
조직의 실험 목록을 표시하며, 이름 검색, 제한, 페이지 매김을 위한 오프셋을 선택적으로 사용할 수 있습니다.
- 실행 중인 모든 실험을 보여줘.
- 이름에 ‘checkout’이 포함된 실험을 찾아줘.
get_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Read
상태, 연결된 기능 플래그, 대상 유형, 기본 메트릭, 할당 날짜 및 결정을 포함하여 ID별로 단일 실험을 가져옵니다.
- 실험
abc123의 세부 정보를 보여줘. - 실험
abc123의 현재 상태와 연결된 플래그를 보여줘.
create_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Write
이름, 가설, 대상 유형 및 기본 메트릭을 사용하여 새 실험을 생성합니다.
- 새로운 설계가 전환율을 높이는지 테스트할 수 있도록 ‘새 결제 흐름’이라는 실험을 만들어 줘.
link_feature_flag_to_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Write
기능 플래그를 실험에 연결합니다.
- 기능 플래그
new-checkout-flow를 실험 abc123에 연결해 줘.
start_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Write
실험을 시작합니다. 활성 할당이 있는 연결된 플래그, 대상 유형 및 기본 메트릭이 필요합니다.
conclude_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Write
실행 중인 실험을 종료하고 승리한 변형을 최종 확정합니다.
- 실험
abc123을 종료하고, 처리 변형을 최종 승자로 확정해 줘.
cancel_experiment
도구 세트: experiments
필수 권한: Product Analytics Experiments Write
필수 사유를 입력하여 실행 중인 실험을 취소합니다.
- SRM 이슈가 감지되었으므로 실험
abc123을 취소해 줘.
get_experiment_diagnostics
도구 세트: experiments
필수 권한: Product Analytics Experiments Read
결과를 해석하기 전에 샘플 비율 불일치(SRM) 상태, 총 실험 대상 수, 변형별 노출 수 및 비율, 신뢰할 수 없는 메트릭 및 데이터가 없는 메트릭을 포함한 메트릭별 상태에 관한 요약을 반환합니다. get_experiment_results 전에 이 항목을 호출하세요. srm.has_warning이 true인 경우 변형 수준 비교를 신뢰성 있게 해석할 수 없습니다.
- 실험
abc123의 결과를 확인하기 전에 진단을 실행해 줘. - 실험
abc123에 샘플 비율 불일치가 있는지 확인해 줘.
get_experiment_results
도구 세트: experiments
필수 권한: Product Analytics Experiments Read
변형별, 메트릭별로 계산된 결과를 반환합니다. verdict 필드(better, worse, inconclusive 또는 unreliable)의 판정을 따르세요. 원시 p값이나 신뢰 구간을 사용하여 통계적 유의성을 다시 계산하지 마세요.
- 실험
abc123의 결과를 보여줘. - 실험
abc123의 기본 메트릭에 대한 결과를 알려줘.
explore_experiment_results
도구 세트: experiments
필수 권한: Product Analytics Experiments Read, Product Analytics Metrics Read
할당 속성(기기 유형, 국가, 플랜 등급 등) 또는 시간에 따라 결과를 세분화합니다. 자세한 분석을 위해 get_experiment_results 이후에 사용하세요.
- 실험
abc123의 결과를 기기 유형별로 분석해 줘. - 지난 2주 동안 실험
abc123의 상승 추세가 어떻게 변화했는지 보여줘.
list_experiment_segmentation_properties
도구 세트: experiments
필수 권한: Product Analytics Experiments Read, Product Analytics Metrics Read
실험을 분할할 수 있는 할당 속성을 나열합니다. 유효한 속성 ID를 얻으려면 explore_experiment_results 전에 이 함수를 호출하세요. 임의로 추측하지 마세요.
- 실험
abc123의 결과를 세분화하는 데 사용할 수 있는 속성을 보여 줘.
get_experiment_segmentation_property_values
도구 세트: experiments
필수 권한: Product Analytics Experiments Read, Product Analytics Metrics Read
세분화 속성에 대한 구체적인 값을 반환합니다(예: 기기 유형의 경우 ["mobile", "desktop", "tablet"]). 잘못된 필터 문자열을 방지하려면 explore_experiment_results에서 필터링하기 전에 이 기능을 사용하세요.
- 실험
abc123에서 기기 유형 속성에 사용할 수 있는 값을 알려줘.
get_metric_definition
도구 세트: experiments
필수 권한: Product Analytics Metrics Read
실험 메트릭의 정의를 반환합니다. 여기에는 기본 이벤트 쿼리, 데이터 소스, 메트릭 변동 원인을 조사하기 위해 권장되는 Datadog MCP 도구가 포함됩니다. datadog 소스 메트릭의 경우, 응답에는 원시 이벤트 데이터를 쿼리하는 데 필요한 구조화된 파라미터가 포함된 recommended_tool_call 필드가 포함됩니다. Datadog 인프라 또는 APM 메트릭용이 아닙니다. 이 메트릭에는 get_datadog_metric을 사용하세요.
- 실험
abc123의 기본 메트릭에 사용된 이벤트 쿼리를 알려줘. - 이 메트릭이 변동된 이유를 조사하려면 어떤 MCP 도구를 사용해야 하는지 알려줘.
diagnose_experiment_run_failure
도구 세트: experiments
필수 권한: Product Analytics Experiments Read
실험에 대한 최신(또는 특정) 분석 파이프라인 실행이 실패한 이유를 진단합니다. 근본 원인 작업, 분류된 실패 설명 및 실행 가능한 다음 단계를 반환합니다. 결과 품질 및 SRM 이슈에는 대신 get_experiment_diagnostics를 사용하세요.
- 실험
abc123의 최신 분석 실행이 실패한 이유가 뭐야? - 실험
abc123의 파이프라인 실패를 진단해 줘.
Feature Flags
플래그 및 플래그 환경 생성, 나열, 업데이트 등 Feature Flags 관리를 위한 도구입니다.
list_datadog_feature_flags
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Read
페이지 지정을 지원하는 Feature Flags를 목록으로 나열합니다.
- 내 조직의 모든 기능 플래그를 보여줘.
- 체크아웃 서비스의 Feature Flags를 목록으로 나열해 줘.
get_datadog_feature_flag
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Read
특정 기능 플래그에 관한 세부 정보를 검색합니다.
dark-mode-enabled 기능 플래그의 세부 정보를 보여줘.- 플래그
new-checkout-flow의 현재 설정은 뭐야?
create_datadog_feature_flag
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Write
새 기능 플래그를 생성합니다.
- 점진적 롤아웃을 위해
enable-new-dashboard라는 기능 플래그를 생성해 줘. - 베타 기능을 위한 새 부울 기능 플래그를 설정해 줘.
list_datadog_feature_flag_environments
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read
Feature Flags에 대하여 구성된 환경을 목록으로 나열합니다.
- 사용 가능한 기능 플래그 환경을 보여줘.
- Feature Flags를 사용해 대상으로 지정할 수 있는 환경은 뭐야?
list_datadog_feature_flag_allocations
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Read
특정 환경에서 기능 플래그의 할당을 목록으로 나열합니다.
- 프로덕션에서 플래그
new-checkout-flow의 할당 규칙을 보여줘.
update_datadog_feature_flag_environment
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Write
특정 환경의 기능 플래그 구성을 업데이트합니다.
- 스테이징 환경에서
dark-mode 플래그를 활성화해 줘. - 프로덕션의 사용자 50%를 대상으로 플래그
new-checkout-flow를 롤아웃해 줘.
check_datadog_flag_implementation
도구 세트: feature-flags
필수 권한: Feature Flag Environment Read 및 Feature Flag Read
기능 플래그가 코드에 구현되었는지 검사합니다.
- 내 코드베이스에
enable-new-dashboard 플래그가 구현되었는지 확인해 줘.
sync_datadog_feature_flag_allocations
도구 세트: feature-flags
필수 권한: Feature Flag Write
특정 환경에 대한 기능 플래그 할당을 동기화합니다.
- 프로덕션에서 플래그
new-checkout-flow의 할당을 동기화해 줘.
Kubernetes
Kubernetes 리소스를 검색 및 설명하고 모든 클러스터에서 매니페스트를 검색하는 도구입니다.
search_datadog_k8s_resources
도구 세트: kubernetes
필수 권한: Hosts Read 및 Teams Read
모든 클러스터에서 Kubernetes 리소스를 검색합니다. kubectl 대신 이 도구를 사용하여 배포, 포드, 노드 등과 같은 Kubernetes 리소스의 상태를 판단하세요. 이 도구에는 로컬 클러스터 액세스가 필요하지 않고, 모든 클러스터에서 작동하며 태그로 강화된 데이터를 반환합니다. 각 결과에 특정 태그 키를 포함할 수 있고, 상위 리소스 이름을 포함하여 리소스 간 관계를 조사할 수도 있습니다(예를 들어 포드가 속하는 배포).
production 네임스페이스에서 상태가 CrashLoopBackOff인 모든 포드를 보여줘.general2 클러스터에 진행 중인 롤아웃이 있는 배포를 찾아 줘.- 내 클러스터의 모든 노드를 CPU 사용량 기준으로 정렬해서 목록으로 나열해 줘.
- 배포를
service 및 env 기준으로 그룹화해서 환경 전체에 서비스가 어떻게 분포되었는지 표시해 줘.
describe_datadog_k8s_resource
도구 세트: kubernetes
필수 권한: Hosts Read
특정 Kubernetes 리소스의 상세한 정보를 가져옵니다. 여기에는 CPU 및 메모리 요청, 한도와 같은 리소스별 세부 정보를 포함하며, 선택 사항으로 태그, 레이블, 어노테이션, 매니페스트 기록, 상위 리소스 및 Kubernetes 탐색기에 대한 딥 링크도 포함합니다. kubectl describe 대신 이 도구를 사용하세요. 이전 검색에서 UID를 사용하거나, 리소스 식별자(클러스터, 네임스페이스 및 리소스 이름)를 제공하여 리소스를 식별합니다. 원시 매니페스트 전체의 경우, get_datadog_k8s_manifest를 사용하세요.
- 클러스터
prod, 네임스페이스 default의 포드 my-app을 설명해 줘. - 네임스페이스
default, 클러스터 staging의 배포 api-server 세부 정보를 가져와. - 이 Kubernetes 리소스의 태그와 어노테이션을 보여줘.
get_datadog_k8s_manifest
도구 세트: kubernetes
필수 권한: Hosts Read
특정 Kubernetes 리소스의 YAML 매니페스트를 검색합니다. kubectl get -o yaml 대신 이 도구를 사용하세요. kubectl JSONPath 표현식을 사용한 특정 서브트리 추출을 지원하며 status 및 managedFields를 생략하는 간결한 모드를 지원하여 응답 크기를 줄입니다.
- 클러스터
prod, 네임스페이스 default의 포드 my-app에 대한 매니페스트를 가져와 줘. - 네임스페이스
default, 클러스터 staging의 배포 api-server에 대한 컨테이너 포트를 보여줘. - 포드
my-app의 매니페스트에서 컨테이너 이미지를 가져와.
네트워크
Cloud Network Monitoring 분석 및 Network Device Monitoring 도구입니다.
analyze_cloud_network_monitoring
도구 세트: networks
필수 권한: Network Connections Read
Cloud Network Monitoring 데이터를 사용하여 네트워크 수준 이슈를 조사하고, 네트워크 흐름 데이터를 분석하여 재전송 비율 상승과 같은 이상을 감지합니다.
- 내 웹 서버와 데이터베이스 클러스터 간의 네트워크 트래픽을 분석해 줘.
service:api와 service:payments 사이에 재전송 이슈가 있어?- 프로덕션 환경에서 네트워크 흐름 데이터에 이상이 있는지 조사해 줘.
search_ndm_devices
도구 세트: networks
필수 권한: NDM Read
Datadog Network Device Monitoring이 모니터링하는 네트워크 장치(라우터, 스위치, 방화벽)를 검색합니다.
us-east-1 데이터센터의 모든 네트워크 장치를 보여줘.- 오류를 보고하는 방화벽을 찾아 줘.
- 모든 모니터링되는 스위치와 그 상태를 목록으로 나열해 줘.
get_ndm_device
도구 세트: networks
필수 권한: NDM Read
특정 네트워크 장치에 관한 상세한 정보를 검색합니다(장치 ID 기준).
- 네트워크 장치
device:abc123의 세부 정보를 가져와. - 이 라우터의 구성과 상태를 보여줘.
search_ndm_interfaces
도구 세트: networks
필수 권한: NDM Read
특정 장치의 모든 네트워크 인터페이스를 검색합니다.
- 장치
device:abc123의 모든 인터페이스를 보여줘. - 내 코어 라우터의 인터페이스 상태를 목록으로 나열해 줘.
온보딩
가이드가 있는 Datadog 설정 및 구성을 위한 에이전틱 온보딩 도구입니다.
browser_onboarding
도구 세트: onboarding
필수 권한: RUM Apps Read
Browser RUM을 Datadog에 온보딩하는 과정을 안내합니다.
- 웹 애플리케이션에 대해 Browser RUM 모니터링을 설정하게 도와줘.
devices_onboarding
도구 세트: onboarding
필수 권한: RUM Apps Read
장치를 Datadog 모니터링에 온보딩하는 과정을 안내합니다.
- Datadog에서 장치 모니터링을 설정하게 도와줘.
kubernetes_onboarding
도구 세트: onboarding
필수 권한: 없음
Kubernetes 클러스터를 Datadog에 온보딩하는 과정을 안내합니다.
- Kubernetes 클러스터에 대해 Datadog 모니터링을 설정하게 도와줘.
llm_observability_onboarding
도구 세트: onboarding
Datadog에서 Agent Observability를 온보딩하는 과정을 안내합니다.
- AI 애플리케이션에 대해 Agent Observability를 설정하게 도와줘.
test_optimization_onboarding
도구 세트: onboarding
필수 권한: 없음
Datadog에서 Test Optimization을 온보딩하는 과정을 안내합니다.
- CI 파이프라인에 대한 Test Optimization 설정을 도와줘.
serverless_onboarding
도구 세트: onboarding
필수 권한: 없음
서버리스 애플리케이션을 Datadog에 온보딩하는 과정을 안내합니다. 여기에는 AWS Lambda 함수 및 GCP Cloud Run과 Cloud Run 함수(Gen2)가 포함됩니다.
- Datadog으로 AWS Lambda 함수를 모니터링하게 도와줘.
- Datadog으로 GCP Cloud Run 서비스를 모니터링하게 도와줘.
- Datadog으로 GCP Cloud Run 함수를 모니터링하게 도와줘.
source_map_uploads
도구 세트: onboarding
RUM 오류 매핑을 위해 소스 맵을 업로드하는 과정을 안내합니다.
- 소스 맵을 업로드해 RUM 오류에 원본 소스 코드가 표시되게 도와줘.
Product Analytics
조직 어휘 조회, 의미론적 검색, 집계, 여정, 경로 및 보존율을 포함하여 Product Analytics 데이터를 쿼리하기 위한 도구입니다.
해당
product-analytics 도구 세트는 기본적으로 활성화되어 있지 않습니다. 도구 세트 활성화에 대한 지침은
Datadog MCP 서버 설정을 참조하세요.
search_product_analytics_events
도구 세트: product-analytics
필수 권한: RUM Apps Read
시맨틱 검색을 사용하여 자연어 설명과 일치하는 Product Analytics 보기 및 액션을 찾습니다. 조직에서 선별하고 레이블을 지정한 작업도 검색 대상에 포함됩니다.
- 장바구니에 상품을 추가하는 보기와 작업을 찾아 줘.
- 결제를 완료할 때 발생하는 이벤트를 알려줘.
search_product_analytics_org_entities
도구 세트: product-analytics
필수 권한: RUM Apps Read
조직별 Product Analytics 엔티티를 이름이나 키워드(Feature Flags, 컨텍스트 속성 키, 저장된 차트 및 세그먼트)로 조회합니다.
- ‘파워 유저’에 대한 세그먼트를 찾아줘.
- Product Analytics 데이터를 필터링하는 데 사용할 수 있는 Feature Flags를 알려줘.
참고: 이 도구에서 반환된 세그먼트 필터 표현식을 수동으로 구성하지 말고 그대로 사용하세요.
get_product_analytics_saved_chart
도구 세트: product-analytics
필수 권한: RUM Apps Read 및 Product Analytics Saved Widgets Read
저장된 Product Analytics 차트의 전체 정의를 ID별로 검색하며, 쿼리 파라미터, 필터 및 시간 간격을 포함합니다. 먼저 search_product_analytics_org_entities를 사용하여 차트 ID를 찾으세요.
- 저장된 차트
abc-123-def를 로드하고 쿼리 파라미터를 보여줘. - 저장된 ‘주간 보존율’ 차트의 기간을 업데이트하여 다시 만들어줘.
aggregate_product_analytics_events
도구 세트: product-analytics
필수 권한: RUM Apps Read
Product Analytics 이벤트 데이터를 단일 값 또는 시계열로 집계합니다. 선택적으로 그룹화할 수 있으며 개수, 고유 값 수, 평균, 합계, 최솟값, 최댓값 및 백분위수를 계산할 수 있습니다.
- 오늘 세션이 몇 개였는지 알려줘.
- 지난 30일 동안의 일일 활성 사용자 수를 보여줘.
run_product_analytics_journey
도구 세트: product-analytics
필수 권한: RUM Apps Read
사용자, 세션 또는 계정 수준에서 추적되는 다단계 사용자 여정에 걸쳐 퍼널, 시계열, 스칼라, 목록 및 이탈 쿼리를 실행합니다.
- 제품을 본 후 결제를 완료한 비율을 알려줘.
- 장바구니 담기에서 결제 단계 사이에 이탈한 사용자를 보여줘.
run_product_analytics_pathway
도구 세트: product-analytics
필수 권한: RUM Apps Read
소스 뷰에서 시작하거나 타겟 뷰로 이어지는 사용자의 뷰 간 이동 방식을 보여주는 Sankey(경로) 분석을 실행합니다.
- 홈페이지에 접속한 후에 사용자가 가장 많이 이동하는 경로는 뭐야?
- 결제 페이지로 이어지는 경로를 보여줘.
run_product_analytics_retention
도구 세트: product-analytics
필수 권한: RUM Apps Read
Product Analytics 데이터를 코호트 그리드, 보존율 곡선, 시계열 또는 스칼라 값으로 보존율 쿼리를 실행하며, 사용자 또는 계정 수준에서 추적합니다.
- 지난 분기에 가입한 사용자의 주간 보존율 그리드를 보여줘.
- 1월에 가입한 사용자의 7일 차 보존율은 얼마야?
프로파일링
서비스, 런타임 및 트레이스 전반에 걸쳐 Continuous Profiler 데이터를 검색, 탐색 및 분석하기 위한 읽기 전용 도구입니다.
get_profiling_profile_types
도구 세트: profiling
필수 권한: Continuous Profiler Read
주어진 쿼리 컨텍스트(쿼리 문자열 및 시간 범위) 또는 트레이스/스팬 컨텍스트에 대해 사용 가능한 프로파일 유형 및 패밀리를 반환합니다. 먼저 이 도구를 사용하여 어떤 데이터를 쿼리할 수 있는지 확인합니다.
- 지난 한 시간 동안
service:checkout-api에 대해 사용 가능한 프로파일 유형을 보여줘. - 트레이스
7d5d747be160e280504c099d984bcfe0에 대해 사용 가능한 프로파일 패밀리는 뭐야? - 프로덕션 환경에서 사용 가능한 프로파일 유형을 나열해 줘.
get_profiling_services
도구 세트: profiling
필수 권한: Continuous Profiler Read
범위 내의 프로파일링된 서비스 및 해당 프로파일링 패밀리를 나열합니다. 결과는 정렬되지 않으며 중요도나 활동 수준을 의미하지 않습니다.
- 프로덕션 환경에서 프로파일링이 활성화된 모든 서비스를 나열해 줘.
- JVM 프로파일링 데이터가 있는 서비스를 보여줘.
- 결제 팀 환경에서 프로파일링되는 서비스는 뭐야?
get_profiling_runtime_ids
도구 세트: profiling
필수 권한: Continuous Profiler Read
범위 내의 개별 프로파일링된 런타임 ID(프로세스 또는 컨테이너)를 반환합니다. 기본값은 CPU 사용량 기준 상위 1개이며, limit 파라미터로 개수를 제어할 수 있습니다.
service:checkout-api에 대해 CPU 사용량 기준 상위 10개 런타임 ID를 보여줘.- 내 Go 서비스에서 CPU 사용량이 가장 높은 런타임을 가져와.
- 지난 한 시간 동안 결제 서비스의 프로파일링된 런타임 ID를 나열해 줘.
get_profiling_service_insights
도구 세트: profiling
필수 권한: Continuous Profiler Read
상위 수준 요약, 컨텍스트 신호(영향받는 메서드, 패키지, 프로세스) 및 권장 후속 조치를 포함한 사전 계산된 서비스 인사이트를 반환합니다.
service:checkout-api에 대한 프로파일링 인사이트를 보여줘.- 결제 서비스에서 표시된 성능 이슈는 뭐야?
- 내 Java 서비스에 대한 프로파일링 권장 사항을 보여줘.
explore_profiling_flame_graph
도구 세트: profiling
필수 권한: Continuous Profiler Read
지정된 프로파일 유형에 대해 값 기여도 기준 상위 N개의 스택 트레이스를 반환합니다. 프레임, 엔드포인트 또는 속성 정규식으로 필터링할 수 있습니다. 단일 서비스만 지원합니다. service:family 또는 traceContext를 수락합니다.
- 지난 한 시간 동안
service:checkout-api의 CPU 플레임 그래프를 보여줘. - 결제 서비스의 주요 메모리 할당 병목 지점을 찾아줘.
- 트레이스
7d5d747be160e280504c099d984bcfe0의 플레임 그래프를 탐색해 줘.
explore_profiling_call_graph
도구 세트: profiling
필수 권한: Continuous Profiler Read
지정된 프로파일 유형에 대한 주요 함수의 호출 그래프(호출자-피호출자 관계)를 반환합니다. 기본적으로 상위 20개 노드, 5% 임계값 및 노드당 5개 간선을 사용합니다. 단일 서비스만 지원합니다.
service:checkout-api의 CPU 사용량이 높은 함수에 대한 호출 그래프를 보여줘.- 내 Go 서비스에서 가장 느린 경로로 호출되는 함수는 뭐야?
- 결제 서비스의 메모리 할당 호출 그래프를 가져와.
explore_profiling_timeline
도구 세트: profiling
필수 권한: Continuous Profiler Read
CPU 및 I/O 활동과 함께 레인 그룹 타임라인(스레드, 가비지 컬렉션 등)을 반환합니다. 스팬 내 지연 시간 병목 현상을 식별하기 위해 임계 경로 모드(Go 전용, traceContext 필요)를 지원합니다.
- 지난 15분 동안
service:checkout-api의 스레드 타임라인을 보여줘. - 내 Go 서비스의 트레이스
abc123에 대한 임계 경로를 찾아줘. - 지연 시간 급증 시점의 가비지 컬렉션 및 CPU 활동을 탐색해 줘.
get_profiling_timeseries
도구 세트: profiling
필수 권한: Continuous Profiler Read
시계열(rate 메트릭) 형태로 집계된 프로파일링 데이터를 반환합니다. 추세 분석, 서비스 간 비교 및 회귀 탐지에 적합합니다. 프레임 필드, 컨텍스트 및 태그 기준 그룹화를 지원합니다.
- 지난 24시간 동안
service:checkout-api의 CPU 프로파일 시계열을 보여줘. - 버전별로 그룹화하여 내 Java 서비스들의 메모리 할당률을 비교해 줘.
- 배포 기준으로 그룹화하여 지난주 프로파일 회귀를 탐지해 줘.
get_profiling_tag_names
도구 세트: profiling
필수 권한: Continuous Profiler Read
프로파일링 데이터 필터링에 사용할 수 있는 태그 이름(service, host, env, version, family, runtime-id, kube_* 등)을 검색합니다. 관련도 순으로 최대 50개 결과를 반환합니다.
- 프로덕션 환경의 프로파일링 데이터 필터링에 사용할 수 있는 태그 이름은 뭐야?
service:checkout-api에 대한 프로파일링 태그 이름을 나열해 줘.
get_profiling_tag_values
도구 세트: profiling
필수 권한: Continuous Profiler Read
특정 프로파일링 태그(예: service 태그)의 값을 반환합니다. 빈도순으로 정렬된 최대 50개 결과를 반환합니다.
- 지난 한 시간 동안 결제 서비스에 대해 프로파일링 데이터가 있는 버전은 뭐야?
service:checkout-api에 대해 프로파일링 데이터가 가장 많은 데이터센터 2개는 어디야?
get_profiling_fields
도구 세트: profiling
필수 권한: Continuous Profiler Read
get_profiling_timeseries의 그룹화 및 필터 파라미터에서 사용할 수 있는 프레임 및 컨텍스트 패싯 필드(@stack.function, @labels.trace_endpoint 등)를 검색합니다. sampleType 범위 내에서 동작합니다.
- CPU 프로파일에 대해 그룹화에 사용할 수 있는 프레임 필드는 뭐야?
- 메모리 할당 프로파일에 사용할 수 있는 패싯 필드를 보여줘.
service:checkout-api에 대해 시계열 필터링에 사용할 수 있는 컨텍스트 필드를 나열해 줘.
get_profiling_field_values
도구 세트: profiling
필수 권한: Continuous Profiler Read
get_profiling_fields을 통해 검색된 특정 프레임 또는 컨텍스트 필드의 값을 반환합니다. 결과는 빈도순으로 정렬됩니다.
- CPU 프로파일에서
@stack.function의 상위 값을 보여줘. @labels.trace_endpoint의 상위 엔드포인트 값을 가져와.- 메모리 할당 프로파일의 package 필드 값을 나열해 줘.
참조 테이블
참조 테이블을 관리하기 위한 도구로, 테이블 목록 나열, 행 읽기, 행 업서트, 클라우드 스토리지 파일에서 동기화된 테이블 생성 또는 직접 채울 수 있는 빈 테이블 생성 기능이 포함됩니다.
list_reference_tables
도구 세트: reference-tables
조직의 참조 테이블를 목록으로 나열 및 검색하며, 이름 기준으로 필터링 및 정렬(선택 사항)이 있습니다.
- 내 조직의 모든 참조 테이블을 목록으로 나열해 줘.
- 이름에
customer가 있는 참조 테이블을 찾아 줘. - 참조 테이블을 마지막 업데이트 시간 기준으로 정렬해서 보여줘.
list_reference_table_rows
도구 세트: reference-tables
선택적 필터링 및 페이지 매김 기능을 사용하여 참조 테이블의 모든 행을 나열합니다. 우선 list_reference_tables을 사용해 테이블 ID 및 스키마를 찾습니다.
- 참조 테이블의 모든 행을 나열해 줘.
ip_allowlist - 표의 처음 50개 행을 보여줘.
customer_tiers
get_reference_table_rows
도구 세트: reference-tables
참조 테이블에서 기본 키 값을 기준으로 특정 행을 검색합니다. 우선 list_reference_tables을 사용해 테이블 ID 및 스키마를 찾습니다.
- 사용자 참조 테이블에서 기본 키
user001 및 user002가 있는 행을 가져와. - 계정 표에서 계정 ID가
acct-123인 항목을 조회해 줘.
append_reference_table_rows
도구 세트: reference-tables
기존 참조 테이블에 새 행을 추가합니다. 이 작업은 행만 추가하며 기존 데이터를 수정하거나 삭제하지 않습니다. 각 행에는 기본 키 필드를 비롯한 표 스키마의 필수 필드를 모두 포함해야 합니다. 행이 이미 존재할 수 있는 경우, 대신 upsert_reference_table_rows를 사용하세요.
- 사용자 표에 이름이
Carol이고 나이가 28인 사용자 user003에 대한 새 행을 추가해 줘. - 이 다섯 개의 새 계정 항목을 계정 참조 테이블에 추가해 줘.
upsert_reference_table_rows
도구 세트: reference-tables
참조 테이블에 새 행을 삽입하거나 기존 행을 업데이트합니다. 기본 키가 동일한 행이 이미 존재하는 경우 해당 값이 덮어쓰여집니다. 행이 이미 존재할 수 있는 경우 append_reference_table_rows 대신 이 항목을 사용하세요.
- 표에서 계정
acct-123의 계층을 업데이트합니다.customer_tiers - 참조 테이블에 이 10개의 서비스 항목을 추가하거나 업데이트합니다.
service_catalog
create_reference_table
도구 세트: reference-tables
새 참조 테이블을 생성합니다. 두 가지 모드를 지원합니다. LOCAL_FILE은 append_reference_table_rows 또는 upsert_reference_table_rows로 채울 수 있는 빈 테이블을 생성합니다. 클라우드 기반 모드(S3, GCS, AZURE)는 Amazon S3, Google Cloud Storage 또는 Azure Blob Storage의 CSV 파일에서 동기화합니다. INT32 및 STRING 필드 유형만 지원됩니다.
- 서비스 이름, 소유 팀 및 계층 필드가 포함된
service_catalog이라는 빈 참조 테이블을 생성합니다. - 내 S3 버킷
my-data-bucket의 파일 allowlist.csv에서 ip_allowlist라는 참조 테이블을 생성해 줘. - 자동 동기화를 활성화한 상태로
customer_tiers라는 새 GCS 기반 참조 테이블을 설정해 줘.
원격 작업
Datadog Agent가 설치된 호스트에서 읽기 전용 진단을 실행하기 위한 도구입니다. 명령은 제한된 셸 인터프리터를 사용하는 Private Action Runner(PAR)를 통해 호스트에 전달됩니다. 모든 명령은 안전한 Go 내장 함수로 실행되며, 쓰기 권한, 외부 바이너리 실행 및 네트워크 송신이 없습니다. 허용된 명령 목록은 Datadog 백엔드에서 Agent 버전별로 제어됩니다.
datadog_remote_action_restricted_shell_run_command
도구 세트: remote-actions
필수 권한: Connections Resolve 및 Private Action Runner Contribute
지정된 호스트에서 읽기 전용 셸 명령을 실행합니다. 지원되는 명령에는 cat, ls, head, tail, find, grep, sed, cut, sort, uniq, wc, ping, ss, ip가 포함됩니다. 파이프, 루프, 조건문, 변수 할당 및 글로빙을 지원합니다.
- 호스트
prod-web-01의 Datadog Agent 로그 마지막 100줄을 보여줘. - 지난 한 시간 동안 호스트
db-replica-3의 /var/log/app/에서 모든 ERROR 항목을 찾아줘. - 호스트
prod-worker-07의 /etc/datadog-agent/datadog.yaml 내용을 가져와.
RUM
RUM을 위한 도구로, 애플리케이션 확인, 성능 요약, View에 대한 집계 인사이트 제공, 메트릭 탐색, 애플리케이션 구성 검사, 보존 필터 관리 및 사용자 지정 RUM 메트릭 관리를 지원합니다.
search_rum_applications
도구 세트: rum
필수 권한: RUM Apps Read
RUM 애플리케이션을 나열하고 이후 RUM 도구 호출에 사용할 application_id를 확인합니다.
- ‘checkout-web’이라는 이름의 RUM 애플리케이션을 찾아 애플리케이션 ID를 반환해 줘.
- 내 모든 RUM 애플리케이션을 나열해 줘.
get_rum_summary
도구 세트: rum
필수 권한: RUM Apps Read 및 Timeseries
RUM 애플리케이션의 주요 메트릭 요약과 이전 기간 대비 변화를 반환합니다.
- 지난 24시간 동안 ‘checkout-web’ RUM 애플리케이션의 성능을 요약해 줘.
- 내 주요 RUM 애플리케이션의 Core Web Vitals는 전주 대비 어떻게 변했지?
get_rum_insight
도구 세트: rum
필수 권한: RUM Apps Read
RUM View에 대한 집계 인사이트(워터폴, 긴 작업, 핵심 지표 분포 및 태그 분석)를 반환합니다.
- ‘shop’ 애플리케이션의
/checkout 보기에 대해 지난 1시간 동안의 집계 리소스 워터폴을 보여줘. - 홈페이지의 INP 분포를 장치 유형별로 분석해 줘.
search_rum_metrics
도구 세트: rum
필수 권한: RUM Apps Read
기본 제공 메트릭과 사용자 지정 메트릭을 포함하여 애플리케이션의 RUM 메트릭을 탐색합니다.
- ‘checkout-web’ 애플리케이션에 정의된 사용자 지정 RUM 메트릭을 나열해 줘.
- 주요 애플리케이션에서 페이지 로드 시간과 관련된 사용 가능한 RUM 메트릭을 보여줘.
upsert_rum_metric
도구 세트: rum
필수 권한: RUM Apps Read 및 RUM Generate Metrics
사용자 지정 RUM 메트릭을 생성하거나 업데이트합니다. 기존 메트릭을 업데이트하기 전에 변경할 수 없는 필드를 확인합니다. 이 작업은 멱등성을 가집니다.
- 국가별로 그룹화된 뷰 이벤트의 p95 LCP를 추적하는 분포 메트릭
rum.view.lcp_by_country를 생성해 줘. - Synthetic 테스트 트래픽을 제외하도록
rum.error.checkout_errors의 필터를 업데이트해 줘.
delete_rum_metric
도구 세트: rum
필수 권한: RUM Apps Read 및 RUM Generate Metrics
ID를 사용하여 사용자 지정 RUM 메트릭을 영구적으로 삭제합니다. 이 작업은 멱등성을 가집니다.
- 사용자 지정 RUM 메트릭
rum.view.my_custom_metric을 삭제해 줘. - 내 조직에서 RUM 메트릭
rum.view.legacy_page_views를 제거해 줘.
search_rum_retention_filters
도구 세트: rum
필수 권한: RUM Retention Filters Read
RUM 애플리케이션에 구성된 보존 필터를 나열합니다. 읽기 전용이며 RUM without Limits 고객에게 제공됩니다.
- ‘checkout-web’ 애플리케이션에 구성된 보존 필터를 나열해 줘.
- 내 주요 RUM 애플리케이션에 어떤 보존 필터가 설정되어 있지?
append_new_rum_retention_filter
도구 세트: rum
필수 권한: RUM Retention Filters Write 또는 Product Analytics Apps Write
평가 순서의 끝에 추가되는 RUM 보존 필터를 생성합니다. 보존 필터는 어떤 RUM 이벤트가 인덱싱되고 보존될지 제어하며, 이는 청구에 영향을 미칩니다. 적용하기 전에 변경 사항을 확인하세요.
- 오류 이벤트의 100%를 보존하는 ‘checkout-web’에 보존 필터를 생성해 줘.
@view.url_path:/checkout와 일치하는 모든 세션을 유지하는 보존 필터를 내 기본 RUM 앱에 추가해 줘.
update_rum_retention_filter
도구 세트: rum
필수 권한: RUM Retention Filters Write 또는 Product Analytics Apps Write
이름, 이벤트 유형, 쿼리, 샘플링 비율 또는 활성화 상태와 같은 기존 RUM 보존 필터의 속성을 제자리에서 업데이트합니다. 적용하기 전에 변경 사항을 확인하세요.
- ‘checkout errors’ 보존 필터의 샘플링 비율을 100%로 높여줘.
- ’long tasks’ 보존 필터를 내 기본 RUM 앱에서 비활성화해 줘.
reorder_rum_retention_filters
도구 세트: rum
필수 권한: RUM Retention Filters Write 또는 Product Analytics Apps Write
RUM 애플리케이션의 보존 필터에 대한 전체 평가 순서를 설정합니다. 필터는 위에서 아래로 평가되며 각 이벤트는 첫 번째 일치 항목에서 중지되므로, 순서에 따라 적용되는 샘플링 비율이 결정됩니다. 적용하기 전에 새 순서를 확인하세요.
- ‘checkout-web’에서 ‘checkout errors’ 보존 필터를 catch-all 필터 위로 옮겨줘.
- 특정 보존 필터가 광범위한 보존 필터보다 먼저 평가되도록 보존 필터의 순서를 다시 지정해 줘.
delete_rum_retention_filter
도구 세트: rum
필수 권한: RUM Retention Filters Write 또는 Product Analytics Apps Write
ID를 사용하여 RUM 보존 필터를 영구적으로 삭제합니다. 삭제하기 전에 확인하세요. 이 작업은 멱등성을 가집니다.
- ‘checkout-web’에서 ’legacy sessions’ 보존 필터를 삭제합니다.
- 내 기본 RUM 앱에서 ID가
abc-123-def인 보존 필터를 제거합니다.
보안
코드 보안 스캔, 보안 신호 분석·검색·분류, IoC Explorer 지표 조사, 탐지 규칙 및 억제 규칙 관리, 보안 발견 사항 분석을 위한 도구입니다.
datadog_secrets_scan
도구 세트: security
코드에 하드코딩된 시크릿 및 자격 증명이 있는지 스캔하여 AWS 키, API 키, 비밀번호, 토큰, 개인 키 및 데이터베이스 자격 증명을 감지합니다.
- 내 코드에 하드코딩된 시크릿이 있는지 스캔해 줘.
- 이 파일에 커밋된 API 키 또는 비밀번호가 있는지 검사해 줘.
get_datadog_security_signals_schema
도구 세트: security
필수 권한: Security Signals Read
보안 신호에 사용할 수 있는 필드와 해당 유형을 반환합니다. 신호 유형은 Log Detection, Application Security, Workload Security와 같은 @workflow.rule.type 값에 매핑됩니다.
- 보안 신호를 필터링하는 데 사용할 수 있는 필드는 뭐야?
- Cloud SIEM 신호에 사용할 수 있는 필드를 보여줘.
- 신호 규칙 유형 필드에 사용할 수 있는 enum 값은 뭐야?
search_datadog_security_signals
도구 세트: security
필수 권한: Security Signals Read
Datadog Security Monitoring에서 Cloud SIEM 신호, App & API Protection 신호, Workload Protection 신호 등 보안 신호를 검색하고 가져옵니다.
- 지난 24시간 동안의 보안 신호를 보여줘.
- 내 프로덕션 환경과 관련된 심각도가 높은 보안 신호를 찾아 줘.
- 의심스러운 로그인 시도로 트리거된 Cloud SIEM 신호를 나열해 줘.
analyze_datadog_security_signals
도구 세트: security
필수 권한: Security Signals Read 및 Timeseries
집계, 그룹화 및 추세 분석을 위해 SQL 쿼리를 사용하여 보안 신호를 분석합니다. 이것을 계수, top-N 및 시간의 흐름에 따른 분석에 사용하세요. 특정 신호를 목록으로 나열하거나 검색하려면 search_datadog_security_signals 또는 get_datadog_security_signal을 사용합니다.
- 지난 7일 동안의 신호 수를 기준으로 상위 10개의 SIEM 규칙을 보여줘.
- 심각도가 높음, 중요함인 보안 신호를 세어 심각도 기준으로 그룹화해 줘.
- 어제 서비스별로 발생한 App & API Protection 신호는 몇 개였어?
get_datadog_security_signal
도구 세트: security
필수 권한: Security Signals Read
ID별로 보안 신호 하나의 전체 세부 정보를 검색합니다. 여기에는 속성, 규칙 정보, 분류 상태, 태그 및 케이스 상호 연결이 포함됩니다.
- 보안 신호
AwAAAZ27F1BUjY4rPQAAABhBWjI3RjFCVWpZNHJBQUFBSGFNQVZBQUFBR1Bu의 전체 세부 정보를 가져와. - 이 신호의 규칙, 분류 상태 및 연결된 케이스를 보여줘.
update_datadog_security_signals_triage
도구 세트: security
필수 권한: Security Signals Write
하나 이상의 보안 신호(최대 500개)의 분류 상태 또는 담당자를 일괄 업데이트합니다. 업데이트할 신호 ID 목록 또는 일치하는 모든 신호를 대상으로 하는 필터 쿼리를 수락합니다.
- 지난 24시간 동안 ‘무차별 대입 로그인’ 규칙에서 생성된 모든 신호를 보관 처리해 줘.
service:checkout에 대한 모든 열린 신호를 검토 중 상태로 변경하고 나에게 할당해 줘.- 신호
AwAAAZ27F1BUjY4rPQAAABhBWjI3RjFCVWpZNHJBQUFBSGFNQVZBQUFBR1Bu을 ‘테스트’ 사유로 보관 처리해 줘.
search_datadog_security_ioc_indicators
도구 세트: security
필수 권한: Security Signals Read
위협 인텔리전스 피드와 일치하는 IoC Explorer 지표(IP, 도메인, URL, 파일 해시)를 나열합니다. 전체 세부 정보를 얻으려면 get_datadog_security_ioc_indicator와 페어링하시고, 검토됨으로 표시하려면 update_datadog_security_ioc_indicator_triage와 페어링하세요.
- 가장 높은 점수의 악성 IP 지표를 보여줘.
residential_proxy 카테고리에 속하며 점수가 중간 이상인 IoC 지표를 나열해 줘.- 아직 검토되지 않은 위협 지표를 보여줘.
get_datadog_security_ioc_indicator
도구 세트: security
필수 권한: Security Signals Read
값(점수, 범주, AS 정보, GeoIP, 로그 소스, 신호 수)을 기준으로 IoC Explorer 지표 하나의 전체 세부 정보를 검색하세요.
- 위협 지표
192.0.2.1에 대한 세부 정보를 가져와. - 에 대해
malicious.example.com알려진 모든 정보를 보여줘.
update_datadog_security_ioc_indicator_triage
도구 세트: security
필수 권한: Security Signals Write
IoC Explorer 지표의 분류 상태를 설정합니다.
- 지표
192.0.2.1을 검토됨으로 표시해 줘. evil-domain.example.com을 검토되지 않음으로 다시 설정해 줘.
get_datadog_security_ioc_schema
도구 세트: security
필수 권한: Security Signals Read
IoC Explorer에 대한 필터링 가능한 필드와 해당 값을 찾으세요. 사용 가능한 필드를 나열하려면 filter를 생략하고, 해당 필드의 [{value, count}]를 가져오려면 filter를 지정합니다. query를 사용하여 지표의 하위 집합에 대해 개수를 제한합니다.
- IoC 지표 필터에 사용할 수 있는 필드가 뭔지 알려줘.
- 사용 가능한 지표 유형과 각 유형의 개수를 보여줘.
- 높은 점수의 지표로 범위가 지정된
categories 필터의 값을 가져와.
get_datadog_security_detection_rules_schema
도구 세트: security
필수 권한: Security Monitoring Rules Read
탐지 규칙을 위한 작성 참조 정보와 스키마를 반환합니다. 지원되는 규칙 유형, 탐지 방법, 쿼리 구문, 태그 규칙 및 유효한 검색 패싯을 포함합니다. 탐지 규칙을 작성하거나 조회하기 전에 사용하세요. 현재 지원되는 규칙 유형은 로그 탐지, API 보안 및 AppSec입니다.
- 임계값 기반 탐지 규칙 생성 시 사용할 수 있는 필드와 옵션은 뭐야?
- 시퀀스 탐지 규칙의 스키마를 보여줘.
- 탐지 규칙 API에서 사용하는 태그 규칙과 쿼리 구문은 뭐야?
get_datadog_security_detection_rules
도구 세트: security
필수 권한: Security Monitoring Rules Read
보안 탐지 규칙을 조회합니다. 이때 두 가지 모드가 지원됩니다. rule_id를 제공하여 ID별로 단일 규칙의 전체 정의를 가져오거나, rule_id를 생략하여 규칙을 나열합니다(선택적으로 query로 필터링하고 max_tokens로 토큰을 제한할 수 있음). 두 가지 조회 방식은 동시에 사용할 수 없습니다.
- 활성화된 모든 Cloud SIEM 탐지 규칙을 나열해 줘.
source:cloudtrail 태그가 지정된 탐지 규칙을 보여줘.- 탐지 규칙
abc-123-def의 전체 정의를 가져와. - 이 탐지 규칙은 어떤 임계값과 그룹화 필드를 사용해?
create_datadog_security_detection_rule
도구 세트: security
필수 권한: Security Monitoring Rules Write
새 탐지 규칙을 생성하세요. get_datadog_security_detection_rules_schema를 먼저 호출하여 페이로드 문법을 가져오고, 그 후 전체 규칙 페이로드를 제공하세요. 성공 시 서버가 할당한 ID를 포함한 전체 규칙을 반환합니다.
- 5분 동안 동일한 IP에서 10회 이상의 로그인 실패가 발생할 때 실행되는 임계값 탐지 규칙을 생성해 줘.
- IAM 권한 상승에 대해 경보를 보내는 CloudTrail용 새 로그 탐지 규칙을 작성해 줘.
- 오류율이 분당 100회를 초과할 때 신호를 생성하는
source:nginx 탐지 규칙을 생성해 줘.
update_datadog_security_detection_rule
도구 세트: security
필수 권한: Security Monitoring Rules Write
기존 사용자 지정 탐지 규칙을 완전히 교체하여 업데이트합니다. get_datadog_security_detection_rules를 먼저 호출하여 현재 규칙 본문을 가져오고, 필요한 필드를 수정한 후 전체 업데이트된 객체를 제출합니다. Datadog에서 제공하는 기본 규칙은 업데이트할 수 없습니다.
- 탐지 규칙
abc-123-def를 활성화해 줘. - 무차별 대입 탐지 규칙을 비활성화해 줘.
- 내 무차별 대입 탐지 규칙의 임계값을 로그인 실패 10회에서 20회로 변경해 줘.
- 탐지 규칙
abc-123-def에 심각도가 ‘critical’일 때 실행되는 새 케이스를 추가해 줘. - 이 규칙의 그룹화 필드를
@usr.ip에서 @network.client.ip로 변경해 줘.
delete_datadog_security_detection_rules
도구 세트: security
필수 권한: Security Monitoring Rules Write
ID를 사용하여 하나 이상의 사용자 지정 탐지 규칙을 삭제하세요. 단, 사용자 지정(기본값이 아닌) 규칙만 삭제할 수 있습니다. 기본 규칙은 403을 반환합니다. 각 규칙은 개별적으로 승인되며, 실패 시 일괄 작업을 중단하지 않고 failed_rules에 오류가 표시됩니다.
- 탐지 규칙
abc-123-def를 삭제해 줘. - 이전에 생성한 테스트 탐지 규칙 세 개를 제거해 줘.
get_datadog_security_suppressions
도구 세트: security
필수 권한: Security Monitoring Suppressions Read
보안 모니터링 억제 규칙을 조회합니다. 전체 억제 규칙 목록 조회, 특정 ID 조회, 특정 탐지 규칙에 영향을 주는 억제 규칙 조회의 세 가지 모드를 지원합니다. 억제 규칙은 일치하는 조건에 대해 탐지 규칙이 신호를 생성하지 않도록 합니다.
- 현재 활성화된 모든 억제 규칙을 나열해 줘.
- 탐지 규칙
abc-123-def에 적용되는 억제 규칙을 보여줘. - 억제 규칙
sup-456-xyz의 전체 세부 정보를 가져와.
create_datadog_security_suppression
도구 세트: security
필수 권한: Security Monitoring Suppressions Write
특정 조건에 대해 탐지 규칙이 신호를 생성하지 못하도록 하는 새 억제 규칙을 생성합니다. suppression_query 또는 data_exclusion_query 중 하나 이상을 제공해야 합니다.
- IP
10.0.0.1에 대해 무차별 대입 규칙의 신호를 억제해 줘. - 이상 탐지 규칙에서
staging 환경을 무시하는 억제 규칙을 생성해 줘. @usr.email가 테스트 계정과 일치하는 경우 규칙 abc-123-def의 신호를 억제해 줘.
update_datadog_security_suppression
도구 세트: security
필수 권한: Security Monitoring Suppressions Write
기존 억제 규칙을 업데이트합니다. 제공된 필드만 변경합니다. version을 제공하면 동시 수정으로 인한 덮어쓰기를 방지하기 위한 낙관적 동시성 제어를 사용할 수 있습니다.
- 무차별 대입 규칙용 억제 규칙에
10.0.0.2도 제외 대상으로 추가해 줘. - 억제 규칙
sup-456-xyz의 만료일을 다음 분기로 변경해 줘. - 이상 탐지 규칙용 억제 규칙을 삭제하지 않고 비활성화해 줘.
delete_datadog_security_suppression
도구 세트: security
필수 권한: Security Monitoring Suppressions Write
억제 규칙을 삭제합니다.
- 억제 규칙
sup-456-xyz를 삭제해 줘. - 무차별 대입 탐지 규칙을 무음 처리하고 있던 억제 규칙을 제거해 줘.
get_datadog_security_findings_schema
도구 세트: security
필수 권한: Security Monitoring Findings Read
보안 발견 사항에 대한 스키마(사용 가능한 필드 및 각 필드의 유형)를 반환합니다. 쿼리 가능한 필드를 확인하기 위해 analyze_datadog_security_findings을 사용하기 전에 먼저 호출해야 합니다. 발견 사항 유형에 따른 필터링과 응답 크기 조절을 지원합니다.
- 보안 발견 사항에 사용할 수 있는 필드는 뭐야?
- 라이브러리 취약점 발견 사항의 스키마를 보여줘.
- 설명까지 포함된 전체 구성 오류 발견 사항 스키마를 가져와.
analyze_datadog_security_findings
도구 세트: security
필수 권한: Security Monitoring Findings Read 및 Timeseries
SQL 쿼리를 사용하여 보안 발견 사항을 분석하는 기본 도구입니다. 유연한 SQL 집계, 필터링, 그룹화를 사용해 지난 24시간 동안의 실시간 데이터를 쿼리합니다. 먼저 get_datadog_security_findings_schema을 호출하여 사용 가능한 필드를 확인한 후 이 도구를 사용하여 쿼리합니다.
- 가장 중요한 발견 사항이 있는 상위 10개 규칙을 보여줘.
- 열린 발견 사항을 심각도와 발견 사항 유형별로 집계해 줘.
- 익스플로잇이 존재하는 라이브러리 취약점을 리소스별로 그룹화하여 찾아줘.
search_datadog_security_findings
도구 세트: security
필수 권한: Security Monitoring Findings Read
전체 보안 발견 사항 세부 정보를 가져오는 폴백 도구입니다. 대부분의 분석 작업에는 analyze_datadog_security_findings 사용을 권장합니다. 이 도구는 완전한 탐지 객체가 필요하거나 SQL 쿼리로는 충분하지 않을 때에만 사용하세요.
- 내 AWS 환경에서 중요한 발견에 대한 전체 세부 정보를 가져와.
- 특정 규칙에 대한 완전한 탐지 객체를 조회해 줘.
- 열린 ID 위험 발견 사항을 전체 메타데이터와 함께 나열해 줘.
get_datadog_security_findings_ticket_suggestions
도구 세트: security
필수 권한: Security Monitoring Findings Read, Cases Read
보안 발견 사항 티켓 발행을 위한 프로젝트 추천 결과를 반환합니다. 사용 가능한 Case Management, Jira, Linear 및 ServiceNow 프로젝트와 최근 30일 사용 데이터를 보여줍니다. 사용할 프로젝트를 확인하기 위해 create_datadog_security_findings_ticket 전에 호출합니다.
- 보안 발견 사항 티켓을 생성할 때 사용할 수 있는 Jira 프로젝트는 뭐야?
- 사용 가능한 ServiceNow 프로젝트를 보여줘.
- 어느 Linear 프로젝트에 발견 사항을 제출할 수 있어?
- 보안 발견 사항에 가장 많이 사용되는 Case Management 프로젝트는 뭐야?
create_datadog_security_findings_ticket
도구 세트: security
필수 권한: Security Monitoring Findings Write, Cases Read, Cases Write
보안 발견 사항에 대해 Case Management 케이스, Jira 이슈, Linear 이슈 또는 ServiceNow 티켓을 생성합니다. 특정 발견 사항 ID와 프로젝트 ID가 필요합니다. 사용 가능한 프로젝트를 확인하려면 먼저 get_datadog_security_findings_ticket_suggestions를 사용하세요.
- 프로젝트 SECURITY에 대해 이러한 중요한 발견 사항용 Jira 티켓을 생성해 줘.
- 이 규칙의 발견 사항에 대해 Case Management 케이스를 생성해 줘.
- 이 심각도가 높은 발견 사항에 대해 Linear 이슈를 생성해 줘.
- 이 라이브러리 취약점에 대해 ServiceNow 티켓을 생성해 줘.
detach_datadog_security_findings_ticket
도구 세트: security
필수 권한: Security Monitoring Findings Write, Cases Write
보안 발견 사항과 연결된 케이스 또는 티켓의 연결을 해제합니다. Jira 및 ServiceNow 티켓은 Case Management를 통해 연결되므로, 케이스 연결을 해제하면 하위 티켓 연결도 함께 해제됩니다.
- 이 발견 사항들을 연결된 Jira 티켓에서 분리해 줘.
- 이 발견 사항들의 케이스 연결을 제거해 줘.
mute_datadog_security_findings
도구 세트: security
필수 권한: Security Monitoring Findings Write
보안 발견 사항을 음소거하거나 음소거를 해제하여 경고 및 대시보드에서 제외합니다. 음소거 사유(PENDING_FIX, FALSE_POSITIVE, ACCEPTED_RISK 또는 OTHER)가 필요하며, 선택적으로 설명과 만료일을 지정할 수 있습니다.
- 이 발견 사항들을 오탐으로 음소거해 줘.
- 이 구성 오류를 허용된 위험으로 음소거하고 90일 후 만료되도록 설정해 줘.
- 이전에 수정 보류 중으로 표시된 발견 사항의 음소거를 해제해 줘.
assign_datadog_security_findings
도구 세트: security
필수 권한: Security Monitoring Findings Write
보안 발견 사항을 사용자에게 할당하거나 할당을 해제합니다. 할당은 연결된 모든 케이스에도 적용됩니다. 담당자 ID를 생략하면 할당이 해제됩니다.
- 이 중요한 발견 사항들을 보안 팀 리더에게 할당해 줘.
- 더 이상 관련이 없는 발견 사항의 할당을 해제해 줘.
- 이 규칙의 모든 발견 사항을 나에게 할당해 줘.
list_datadog_security_findings_automation_rules
도구 세트: security
필수 권한: Security Pipelines Read
지정된 유형(mute, due_date, ticket_creation 또는 severity_modifier)의 보안 발견 사항 자동화 규칙을 나열합니다.
- 모든 보안 발견 사항 억제 자동화 규칙을 나열해 줘.
- 티켓 생성 규칙을 보여줘.
- 현재 설정되어 있는 마감 기한 자동화 규칙을 알려줘.
create_datadog_security_findings_automation_rule
도구 세트: security
필수 권한: Security Pipelines Write 및 Security Monitoring Findings Read
보안 발견 사항 자동화 규칙을 생성합니다. 다음 rule_type 중 하나를 선택하세요. mute(발견 사항 억제), due_date(수정 마감 기한 설정), severity_modifier(발견 사항 심각도 조정) 또는 ticket_creation(Jira 또는 Case Management 티켓 자동 생성)
- 스테이징 환경에서 오탐지된 잘못된 구성 발견 사항을 자동으로 억제하는 규칙을 생성하세요.
- 심각도가 높은 라이브러리 취약점에 대해 30일 수정 마감 기한을 설정하세요.
- SECURITY 프로젝트의 심각한 발견 사항에 대해 Jira 티켓을 자동으로 생성하세요.
update_datadog_security_findings_automation_rule
도구 세트: security
필수 권한: Security Pipelines Write
기존 자동화 규칙을 업데이트하세요. 부분 업데이트를 지원하므로 제공된 필드만 변경됩니다. 규칙을 활성화하거나 비활성화하고, 이름을 변경하며, 필터를 조정하거나 작업 파라미터를 변경하는 데 사용하세요.
- 스테이징 환경의 발견 사항을 억제하는 자동화 규칙을 활성화해 줘.
- 심각한 발견 사항에 대한 기한 규칙을 30일 대신 14일로 변경해 줘.
- 티켓 생성 규칙을 업데이트하여 다른 Jira 프로젝트를 대상으로 지정해 줘.
delete_datadog_security_findings_automation_rule
도구 세트: security
필수 권한: Security Pipelines Write
ID를 사용하여 보안 발견 사항 자동화 규칙을 영구적으로 삭제합니다.
- 심각도 수정 규칙
abc-123-def를 삭제해 줘. - 더 이상 필요하지 않은 음소거 규칙을 제거해 줘.
reorder_datadog_security_findings_automation_rules
도구 세트: security
필수 권한: Security Pipelines Write
목록에서 자동화 규칙을 위나 아래로 옮깁니다. 규칙은 순서대로 적용되므로 규칙의 위치가 우선순위를 결정합니다.
- 음소거 규칙
abc-123-def를 목록 맨 위로 옮겨줘. - 이 기한 규칙의 우선순위를 두 단계 낮추세요.
get_datadog_security_trace_passlist
도구 세트: security
필수 권한: Application Security Management Protect Read
조직의 모든 웹 애플리케이션 방화벽(WAF) 제외 필터(허용 목록) 항목을 반환하여 기존 억제를 검토할 수 있습니다.
- 모든 App & API Protection 허용 목록 항목을 나열해 줘.
- 활성 WAF 제외 필터를 보여줘.
- 새 허용 목록 억제를 추가하기 전에 기존 항목을 확인해 줘.
upsert_datadog_security_trace_passlist
도구 세트: security
필수 권한: Application Security Management Protect Write
특정 서비스나 엔드포인트에서 노이즈가 많은 규칙을 억제하기 위해 WAF 제외 필터(허용 목록) 항목을 생성하거나 업데이트합니다.
- 서비스 ‘checkout-service’의 엔드포인트 ‘/api/pay’에 대해 규칙 ‘sqli-detection’을 무시하도록 WAF 허용 목록 항목을 추가해 줘.
- 서비스 ‘auth-api’에 대해 규칙 ‘xss-rule’을 억제하도록 제외 필터를 업데이트해 줘.
- ‘/v1/users’에서 규칙 ID ’lfi-attack’과 일치하는 AppSec 허용 목록 항목을 생성해 줘.
delete_datadog_security_trace_passlist
도구 세트: security
필수 권한: Application Security Management Protect Write
기존 WAF 제외 필터(허용 목록) 항목을 삭제합니다.
- WAF 제외 필터 ‘passlist-abc-123’을 삭제해 줘.
- ‘/api/pay’에서 규칙 ‘sqli-detection’과 일치하는 허용 목록 항목을 제거해 줘.
get_datadog_security_aap_denylist
도구 세트: security
필수 권한: Application Security Management Protect Read
차단된 IP, 사용자 및 사용자 에이전트(차단 목록 항목)를 선택적으로 필터링하여 나열합니다.
- AppSec 차단 목록의 모든 차단된 엔티티를 나열해 줘.
- 어제 차단된 IP 주소를 보여줘.
- IP ‘198.51.100.42’가 보안 차단 목록에 있는지 확인해 줘.
upsert_datadog_security_aap_denylist
도구 세트: security
필수 권한: Application Security Management Protect Write
만료 기한이 있는 IP, 사용자 또는 사용자 에이전트에 대한 차단 목록 항목을 추가하거나 업데이트합니다.
- IP ‘198.51.100.42’를 24시간 동안 차단 목록에 추가해 줘.
- 사용자 ‘attacker_user_99’를 차단된 엔티티 목록에 추가해 줘.
- 사용자 에이전트 ‘MaliciousScanner/1.0’에 대한 차단 목록 항목을 생성하고 만료 시간을 다음 주로 설정해 줘.
unblock_datadog_security_aap_denylist
도구 세트: security
필수 권한: Application Security Management Protect Write
차단 목록에 있는 엔티티의 만료 기한을 과거로 설정하여 차단을 해제합니다.
- 거부 목록에서 IP ‘198.51.100.42’의 차단을 해제해 줘.
- 거부된 엔티티 목록에서 사용자 ‘attacker_user_99’를 제거해 줘.
get_datadog_security_aap_custom_rules
도구 세트: security
필수 권한: Application Security Management Protect Read
ID를 사용하여 하나의 App & API Protection(AAP) 사용자 지정 WAF 규칙을 검색하거나 사용자 지정 규칙을 나열합니다. 카테고리, 상태, 서비스 및 환경별 필터링을 지원합니다.
- 프로덕션 환경의 ‘checkout-service’ 서비스에 적용되는 사용자 지정 웹 애플리케이션 방화벽(WAF) 규칙을 나열해 줘.
- AAP 사용자 지정 규칙 ‘rule-xyz-123’을 가져와.
upsert_datadog_security_aap_custom_rule
도구 세트: security
필수 권한: Application Security Management Protect Write
공격 시도 또는 비즈니스 로직 카테고리에서 AAP 사용자 지정 WAF 규칙을 생성하거나 업데이트합니다. 새 규칙은 트래픽을 차단할 수 없습니다. 모니터링 모드에서 규칙을 생성한 다음 일치 항목을 확인한 후 차단 모드로 업데이트하세요.
- ‘/admin’ 경로에 대한 요청을 모니터링하는 사용자 지정 웹 애플리케이션 방화벽(WAF) 규칙을 생성해 줘.
- AAP 사용자 지정 규칙 ‘rule-xyz-123’을 업데이트하여 일치하는 트래픽을 차단해 줘.
- 사용자 지정 규칙 ‘rule-xyz-123’을 삭제하지 않고 비활성화해 줘.
delete_datadog_security_aap_custom_rule
도구 세트: security
필수 권한: Application Security Management Protect Write
ID를 사용하여 AAP 사용자 지정 WAF 규칙을 영구적으로 삭제합니다.
- 사용자 지정 웹 애플리케이션 방화벽(WAF) 규칙 ‘rule-xyz-123’을 삭제해 줘.
- ‘/admin’에 대한 요청을 모니터링하는 AAP 사용자 지정 규칙을 제거해 줘.
get_datadog_security_aap_blocking_config
도구 세트: security
필수 권한: Application Security Management Protect Read
조직 전체의 AAP 차단 및 거부 목록 적용 설정을 검색합니다.
- 조직에 대해 AAP 차단이 활성화되어 있는지 알려줘.
- AAP 거부 목록이 적용되는지 알려줘.
- AAP 차단 구성을 보여줘.
Session Replay
Session Replay 기록을 검색하고 세션 활동을 요약하기 위한 도구입니다.
search_replays
도구 세트: Session Replay
필수 권한: RUM Apps Read
Session Replay 기록을 검색하고 일치하는 세션을 반환합니다. 사용자 식별자, 기기, 오류 수 또는 모든 RUM 패싯별 필터링을 지원하며, 특정 순서의 뷰나 작업을 수행한 세션에 대한 여정 검색을 지원합니다.
- 지난 24시간 동안 오류가 2개 이상 발생한 세션의 Session Replay를 찾아줘.
- 결제 여정을 따랐지만 완료하지 않은 사용자의 Session Replay를 보여줘.
get_replay_summary
도구 세트: Session Replay
필수 권한: RUM Apps Read 및 RUM Session Replay Read
AI 기반의 시간순 Session Replay 재생 기록을 생성합니다. 사용자가 특정 Session Replay 동안 수행한 작업(방문한 페이지, 수행한 작업, 주요 순간)을 챕터별로 정리하여 보여줍니다. 일반적으로 관심 있는 세션을 자세히 살펴보기 위해 search_replays 이후에 호출됩니다.
abc-123-def 세션에서 발생한 내용을 요약해 줘.- 결제 오류를 보고한 사용자의 Session Replay 진행 과정을 순서대로 정리해 줘.
소프트웨어 배포
소프트웨어 제공(CI Visibility, Test Optimization, Code Coverage 및 DORA Metrics)과의 상호 작용을 위한 도구입니다.
search_datadog_ci_pipeline_events
도구 세트: software-delivery
필수 권한: CI Visibility Read
필터를 사용해 CI 이벤트를 검색하고 그에 관한 세부 정보를 반환합니다.
- 내 커밋
58b1488에 대한 모든 파이프라인을 보여줘. - 브랜치
my-branch에서 발생한 최신 파이프라인 실패를 보여줘. - 내 브랜치
my-branch에서 항상 실패하는 작업 integration-test에 대한 수정 방안을 제안해 줘.
aggregate_datadog_ci_pipeline_events
도구 세트: software-delivery
필수 권한: CI Visibility Read
CI 파이프라인 이벤트를 집계하여 통계, 메트릭 및 그룹화된 분석을 생성합니다.
- 지난 7일 동안 평균 작업 실행 시간은 얼마나 돼?
- 지난 2주 동안 실패한 파이프라인은 몇 개였지?
- 파이프라인 이름별로 그룹화한 파이프라인 실행 시간의 95백분위수를 보여줘.
get_datadog_flaky_tests
도구 세트: software-delivery
필수 권한: Test Optimization Read
Datadog Test Optimization에 불안정한 테스트가 있는지 검색하고 분류 세부 정보(실패율, 카테고리, 소유자, 기록, CI 영향)를 반환합니다(페이지 지정, 정렬 포함).
- 소유자가
@team-abc인 체크아웃 서비스의 활성 불안정한 테스트를 실패율 순으로 정렬하여 보여줘. - 리포지토리
github.com/org/repo의 브랜치 main에 있는 불안정한 테스트를 최신순으로 보여줘. - 우선적으로 수정할 수 있도록 실패율이 높은(50% 이상)
timeout 범주의 불안정한 테스트를 나열해 줘.
update_datadog_flaky_test_states
도구 세트: software-delivery
필수 권한: Test Optimization Write
하나 이상의 불안정한 테스트 상태를 quarantined(실패 억제), disabled(테스트 건너뛰기), fixed(해결됨으로 표시) 또는 active(복원)으로 설정합니다. 이 작업은 쓰기 작업이며 명시적인 사용자 승인이 필요합니다. 모든 상태 변경은 되돌릴 수 있습니다.
checkout-service 리포지토리에서 활성인 모든 불안정한 테스트를 격리해 줘.- 불안정한 테스트
AuthServiceTest::testLogin을 수정됨으로 표시해 줘. - 실패율이 50%를 초과하는
@team-payments 소유의 불안정한 테스트를 비활성화해 줘.
aggregate_datadog_test_events
도구 세트: software-delivery
필수 권한: Test Optimization Read
Datadog Test Optimization 이벤트를 집계하여 안정성 및 성능 추세를 집계 함수, 선택적 메트릭, 그룹화 기준 패싯, 구성 가능한 테스트 수준으로 수량화합니다.
- 지난주 실패한 테스트 수를 브랜치별로 집계해 줘.
- 가장 느린 테스트를 식별할 수 있도록 각 테스트 모음의 95백분위 실행 시간을 보여줘.
- 통과 및 실패한 모든 테스트 수를 코드 소유자별로 집계해 줘.
search_datadog_test_events
도구 세트: software-delivery
필수 권한: Test Optimization Read
필터를 사용해 Test Optimization 테스트 이벤트를 검색하고 그에 관한 세부 정보를 반환합니다.
- 지난 24시간 동안 브랜치
main에서 실패한 테스트를 보여줘. - 커밋
abc123의 테스트 실행 결과를 가져와 어떤 테스트가 통과하고 실패했는지 확인해 줘. - 체크아웃 서비스의 모든 불안정한 테스트 실행을 보여줘.
@team-name 소유의 실패 중인 테스트를 찾아줘.
get_datadog_code_coverage_branch_summary
도구 세트: software-delivery
필수 권한: Code Coverage read
리포지토리 브랜치의 집계된 코드 커버리지 요약 메트릭을 가져옵니다. 여기에는 총 커버리지, 패치 커버리지 및 서비스/코드 소유자 분석이 포함됩니다.
github.com/my-org/my-repo의 main 브랜치 코드 커버리지는 뭐야?github.com/my-org/my-repo의 release/1.x 브랜치에 대한 커버리지 요약을 보여줘.
get_datadog_code_coverage_commit_summary
도구 세트: software-delivery
필수 권한: Code Coverage read
리포지토리 커밋의 집계된 코드 커버리지 요약 메트릭을 가져옵니다. 여기에는 총 커버리지, 패치 커버리지 및 서비스/코드 소유자 분석이 포함됩니다.
github.com/my-org/my-repo의 커밋 abc123abc123abc123abc123abc123abc123abcd에 대한 코드 커버리지를 보여줘.- 내 브랜치 최신 커밋의 패치 커버리지는 뭐야?
get_datadog_code_coverage_pr_summary
도구 세트: software-delivery
필수 권한: Code Coverage read
풀 리퀘스트의 집계된 코드 커버리지 요약 메트릭을 가져옵니다. 여기에는 총 커버리지, 패치 커버리지 및 서비스/코드 소유자 분석이 포함됩니다.
github.com/my-org/my-repo의 PR #123에 대한 코드 커버리지를 보여줘.github.com/my-org/my-repo의 풀 리퀘스트 #456에 대한 패치 커버리지를 알려줘.
get_datadog_code_coverage_files
도구 세트: software-delivery
필수 권한: Code Coverage read
리포지토리 커밋, 브랜치 또는 풀 리퀘스트에 대한 파일별 Code Coverage 라인 데이터를 가져옵니다. 각 파일에 대해 실행 가능한 라인, 커버된 라인 및 추가된 라인을 반환합니다. commit_sha, branch 또는 pr_number 중 정확히 하나를 반드시 제공해야 합니다. 결과를 필터링하려면 service, codeowner 또는 flag 중 최대 하나만 제공할 수 있습니다.
github.com/my-org/my-repo의 PR #123에 대한 파일별 코드 커버리지를 보여줘.github.com/my-org/my-repo에서 커밋 abc123abc123abc123abc123abc123abc123abcd의 변경된 파일 코드 커버리지를 가져와.github.com/my-org/my-repo의 main브랜치 커버리지를 코드 소유자 @my-org/my-team 기준으로 필터링해서 보여줘.
get_datadog_test_optimization_settings
도구 세트: software-delivery
필수 권한: Test Optimization Read
서비스에 대해 활성화된 Test Optimization 기능을 검색합니다. 여기에는 테스트 영향 분석(ITR), 조기 플레이크 감지(EFD), 자동 테스트 재시도(ATR), 실패한 테스트 재생, Code Coverage 수집 및 PR 댓글이 포함됩니다.
auth-service에 어떤 Test Optimization 기능이 활성화되어 있지?- 내 체크아웃 서비스의 Test Optimization 설정을 보여줘.
get_datadog_flaky_tests_management_policies
도구 세트: software-delivery
필수 권한: Test Optimization Read
리포지토리에 구성된 불안정한 테스트 관리 정책을 조회합니다. 여기에는 자동 격리 기간, 브랜치 규칙, 실패율 임계값, 비활성화 정책 및 재시도 설정이 포함됩니다.
github.com/my-org/my-repo의 불안정한 테스트 관리 정책을 보여줘.- 체크아웃 서비스 리포지토리에 구성된 자동 격리 규칙은 뭐야?
search_dora_deployments
도구 세트: software-delivery
필수 권한: DORA Metrics Read
DORA 배포 이벤트를 필터 조건으로 검색하거나, ID를 기준으로 단일 배포의 전체 세부 정보를 조회합니다.
- 지난 7일 동안
checkout 서비스의 배포 내역을 보여줘. - DORA 배포
abc123의 세부 정보를 가져와. - 이번 달 프로덕션 환경에서 실패한 배포를 찾아줘.
aggregate_dora_deployments
도구 세트: software-delivery
필수 권한: Timeseries
서비스, 팀 또는 리포지토리에 대한 DORA Metrics(배포 빈도, 변경 리드 타임, 변경 실패율, 복구 시간)를 단일 값 또는 시계열 형태로 반환합니다. 특정 기간의 소프트웨어 배포 성과에 대한 질문에 사용합니다.
- 지난 30일 동안
checkout 서비스의 배포 빈도와 변경 실패율은 뭐야? - 지난 분기 동안
payments 서비스의 변경 리드 타임 추세를 보여줘. auth-service 팀의 4가지 DORA Metrics를 모두 보여줘.
Synthetics
Datadog Synthetic 테스트와의 상호작용을 위한 도구입니다.
get_synthetics_tests
도구 세트: synthetics
필수 권한: Synthetics Read
Datadog Synthetic HTTP API 테스트를 검색합니다.
- 엔드포인트
/v1/my/tested/endpoint의 Synthetic 테스트가 실패하는 이유를 파악할 수 있도록 도와줘. - 장애가 발생했어. 도메인
api.mycompany.com에서 실패 중인 모든 Synthetic 테스트를 찾아줘. - 내 웹사이트
api.mycompany.com에 대한 Synthetic 테스트가 지난 1시간 동안 정상적으로 동작했어?
edit_synthetics_tests
도구 세트: synthetics
필수 권한: Synthetics Global Variable Read, Synthetics Read 및 Synthetics Write
Datadog Synthetic HTTP API 테스트를 편집합니다.
- 내 엔드포인트
/v1/my/tested/endpoint에 정의된 Synthetic 테스트의 어설션을 개선해 줘. - 테스트
aaa-bbb-ccc을 일시 중지하고 실행 위치를 유럽 지역으로만 설정해 줘. - 테스트
aaa-bbb-ccc에 내 팀 태그를 추가해 줘.
synthetics_test_wizard
도구 세트: synthetics
필수 권한: Synthetics Global Variable Read, Synthetics Read 및 Synthetics Write
Datadog Synthetics HTTP API 테스트를 미리 보고 생성합니다.
- 이 코드 파일에 정의된 모든 엔드포인트에 대해 Synthetic 테스트를 생성해 줘.
/path/to/endpoint에 대한 Synthetic 테스트를 생성해 줘.- 내 도메인
mycompany.com의 가용성을 확인하는 Synthetic 테스트를 생성해 줘.
대시보드 및 노트북 위젯의 시각화, 검증 및 유형 변환을 위한 도구입니다.
도구 세트: widgets
필수 권한: Dashboards Read 또는 Timeseries 또는 Monitors Read 또는 APM Read 또는 RUM Apps Read
Datadog 메트릭, 트레이스, 로그 및 기타 데이터를 대화형 차트로 조회하고 시각화합니다. 세 가지 모드(대시보드 조회, 직접 정의, URL 확인)를 지원합니다.
service:api의 지난 한 시간 CPU 사용량 시계열을 보여줘.- 대시보드
abc-123-def의 위젯 2228368921512806에 대한 위젯 데이터를 가져와. - 이 Datadog 공유 링크의 데이터를 시각화해 줘.
도구 세트: widgets
필수 권한: Dashboards Read 또는 Dashboards Write 또는 Notebooks Read 또는 Notebooks Write
Datadog 대시보드 전반의 위젯을 검색하고, 위젯 ID, 제목 및 기본 쿼리 정보를 조회합니다.
system.cpu.user 메트릭을 조회하는 모든 시계열 위젯을 찾아줘.- 모든 대시보드에서 오류율과 관련된 위젯을 검색해 줘.
도구 세트: widgets
필수 권한: Dashboards Read 또는 Dashboards Write 또는 Notebooks Read 또는 Notebooks Write
쿼리를 유지한 채 위젯 정의를 다른 시각화 유형으로 변환합니다. 수식 기반 요청을 사용하는 위젯 유형(timeseries, query_value, top list, query_table, treemap, sunburst, distribution, heatmap, geomap 및 list_stream)을 지원합니다.
- 이 시계열 위젯을 상위 목록으로 변환해 줘.
- 이 쿼리 표 위젯을 트리맵 시각화로 바꿔줘.
validate_notebook_cell
도구 세트: widgets
필수 권한: Timeseries
analysis_sql 셀에 대한 SQL 정확성을 포함해 노트북 셀 위젯 정의를 검증합니다. analysis_sql 셀을 검증할 때는 해당 SQL 식을 스키마와 대조할 수 있도록 상위 데이터 소스 위젯도 함께 포함해야 합니다.
- 저장하기 전에 이 노트북 셀 정의들을 검증해 줘.
- analysis SQL 셀이 상위 위젯의 유효한 컬럼을 참조하는지 확인해 줘.
validate_notebook_cells
도구 세트: widgets
필수 권한: Timeseries
여러 노트북 셀 위젯 정의를 한 번에 검증하며, analysis_sql 셀의 SQL 검증도 포함됩니다.
- 게시 전에 이 노트북의 모든 셀을 검증해 줘.
- 이 세 개의 분석 셀에 SQL 오류가 있는지 확인해 줘.
도구 세트: widgets
필수 권한: Dashboards Read 또는 Timeseries 또는 Monitors Read 또는 APM Read 또는 RUM Apps Read
위젯 정의가 지난 한 시간 동안 실제 데이터를 반환하는지 검증합니다. 대시보드에 위젯을 추가한 후 쿼리가 실제 데이터를 반환하는지 확인할 때 사용합니다. 각 위젯별로 데이터 존재 여부와, 데이터가 없을 경우 그 이유를 반환합니다.
- 이 위젯 정의들이 데이터를 반환하는지 검사해 줘.
- 대시보드에 추가된 위젯들이 실제 메트릭을 표시하는지 검증해 줘.
visualize_tabular_data
도구 세트: widgets
필수 권한: 특정 권한이 필요하지 않습니다.
표 형식 데이터를 대화형 시각화(선버스트, 트리맵 또는 상위 목록)로 렌더링합니다. 쿼리 결과를 집계한 후 계층 구조나 순위를 시각화하는 데 사용합니다.
- 이 그룹화된 메트릭 데이터를 선버스트 차트로 시각화해 줘.
- 이 집계 데이터를 트리맵 세분화로 표시해 줘.
워크플로
에이전트 사용을 위한 워크플로 나열, 조사, 실행 및 구성을 포함한 Workflow Automation 도구입니다.
list_datadog_workflows
도구 세트: workflows
필수 권한: Workflows Read
Workflow Automation 워크플로를 목록으로 나열하고 검색합니다. 이름, 태그, 소유자, 핸들 및 트리거 유형(monitor, schedule, api, incident 등)으로 필터링할 수 있습니다. 결과는 name 또는 updatedAt와 같은 필드를 기준으로 정렬할 수 있습니다.
team:platform 태그가 지정된 게시된 워크플로를 모두 보여줘.- 에이전트 트리거가 구성된 워크플로를 나열해 줘.
- Alice Smith가 소유한 인시던트 대응 관련 워크플로를 모두 찾아줘.
get_datadog_workflow
도구 세트: workflows
필수 권한: Workflows Read
특정 워크플로와 관련된 상세한 정보를 검색합니다(트리거, 단계, 연결 및 입력 스키마 포함).
- 워크플로
00000000-0000-0000-0000-000000000000의 전체 세부 정보를 가져와. - 배포 롤백 워크플로의 입력 파라미터와 단계를 보여줘.
- 이 워크플로에는 어떤 트리거가 구성되어 있지?
execute_datadog_workflow
도구 세트: workflows
필수 권한: Workflows Run
에이전트 트리거가 있고 게시된 워크플로를 실행하며, 해당 워크플로의 입력 스키마와 일치하는 선택적 입력 파라미터를 사용합니다.
- 서비스
checkout-api, 심각도 high에 대해 인시던트 에스컬레이션 워크플로를 실행해 줘. - 결제 서비스에 대한 배포 롤백 워크플로를 실행해 줘.
- 이 조사 컨텍스트를 사용하여 온콜 알림 워크플로를 실행해 줘.
참고: 워크플로는 게시되어 있어야 하며 에이전트 트리거가 구성되어 있어야 합니다. 필요한 경우 update_datadog_workflow_with_agent_trigger를 사용하여 추가할 수 있습니다.
get_datadog_workflow_instance
도구 세트: workflows
필수 권한: Workflows Read
워크플로 실행 인스턴스의 상태 및 세부 정보를 검색합니다(단계 결과 및 출력 포함).
- 내가 실행한 워크플로의 상태는 어떻지?
- 인시던트 에스컬레이션 워크플로가 성공적으로 완료되었어?
- 워크플로 인스턴스
00000000-0000-0000-0000-000000000000의 상세 출력 결과를 보여줘.
update_datadog_workflow_with_agent_trigger
도구 세트: workflows
필수 권한: Workflows Write
워크플로에 에이전트 트리거를 추가하고 게시하여 워크플로를 AI 에이전트가 실행할 수 있게 합니다.
- 여기에서 실행할 수 있도록 배포 롤백 워크플로에 에이전트 트리거를 추가해 줘.
- 인시던트 대응 워크플로가 에이전트에 의해 실행될 수 있도록 구성해 줘.