Bits Live Debugger

Bits 코드(Code)를 사용해 대화형 인터페이스로 Live Debugger 세션을 만들고 관리하는 방법을 알아봐요. 영어 질문(자연어)으로 실행 중인 서비스를 조사하고, 로그포인트를 배치하고, 변수 스냅샷을 검색하며, 근본 원인과 코드 수정을 제안받아요.

출처: 문서

본문

{% callout %}

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

{% alert level="danger" %} 이 제품은 사용자가 선택한 Datadog 사이트에서는 지원되지 않아요. ({% placeholder "user-datadog-site-name" /%}). {% /alert %}

{% /callout %}

{% callout %}

다음 Datadog 사이트 사용자에게 중요한 안내: app.datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, app.datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com

{% callout %}

프리뷰 참여하기!

Bits Live Debugger는 프리뷰(Preview) 상태예요. 대기자 명단에 참여하려면 액세스를 요청하세요.

액세스 요청 (Request Access) {% /callout %}

{% /callout %}

개요 (Overview)

Bits Live Debugger는 Live Debugger에 대화형 인터페이스를 도입해 자연어로 실행 중인 서비스를 조사할 수 있게 해 줘요. 조사하고 싶은 내용을 설명하면 Bits가 로그포인트를 배치하고 변수 스냅샷을 검색하며 결과를 해석해요. Bits가 근본 원인을 파악하면 코드 수정을 제안할 수도 있어요.

모든 디버깅 활동은 Live Debugger를 통해 실행돼요. 그래서 동일한 권한, 속도 제한, 자동 만료 동작, 민감 데이터 스크러빙이 적용돼요.

Bits Live Debugger 기능은 Live Debugger 페이지에서만 접근할 수 있어요.

{% alert level="info" %} Bits Live Debugger는 기본 에이전트로 Bits 코드를 사용해요. Bits Live Debugger 프리뷰 단계에서는 Live Debugger를 통해 세션을 시작할 때 Bits 코드 AI 크레딧이 청구되지 않아요. {% /alert %}

사전 요구 사항 (Prerequisites)

Bits Live Debugger를 사용하기 전에:

• 대상 서비스에 Live Debugger가 활성화되어 있어야 해요. 자세한 내용은 Live Debugger 활성화를 참고하세요.
• 계정에 Live Debugger를 사용하는 데 필요한 권한, 즉 대상 환경에 대한 읽기, 쓰기, 변수 캡처 권한이 있어야 해요.
• 조직에서 Bits 코드를 사용할 수 있어야 해요.
• 대상 서비스에 대해 소스 코드 통합이 설정되어 있어야 해요.

사용 가능한 작업 (Available actions)

Bits는 디버깅 세션 동안 다음 Live Debugger 작업을 수행할 수 있어요:

Bits가 만든 로그포인트는 수동으로 만든 로그포인트와 동일한 규칙을 따라요. 이들은 읽기 전용이고 차단하지 않으며 설정된 시간 제한(10분~2일, 기본 60분) 후 자동으로 만료돼요. Bits는 애플리케이션 상태를 수정하거나 제어 흐름을 바꿀 수 없어요.

디버깅 세션 시작하기 (Start a debugging session)

1. Datadog에서 Live Debugger로 이동해요.

2. Bits Live Debugger 채팅창에서 조사하고 싶은 문제를 설명해요. 프롬프트를 제출하기 전에 대상 서비스와 환경을 선택해요.

그러면 Bits가 자동으로 조사를 진행해요:

• 연결된 소스 코드 저장소의 관련 코드 경로를 분석하고 가설을 세우기 위해 후속 질문을 할 수도 있어요.
• 관련 코드 위치에 최대 5개의 로그포인트를 구성하고 활성화해 필요한 특정 데이터를 캡처해요.
• 활성 로그포인트의 로그와 변수 스냅샷을 검색·분석해 가설을 검증하고 응답을 구성해요.

1. Bits의 응답을 검토하고, 필요에 따라 로그포인트, 캡처된 데이터, 제안된 코드 수정의 세부 내용을 탐색해요. 필요하다면 채팅에 답변해 조사를 계속해요.

2. 언제든지 로그포인트를 비활성화하려면 Bits에 요청하거나 개별 로그포인트 또는 세션의 Disable 버튼을 클릭해요.

참고: Bits는 필요한 데이터를 검색하는 즉시 자신이 만든 로그포인트를 보통 비활성화해요. 로그포인트는 설정된 시간 제한 후에도 자동으로 만료돼요.

동작 및 제한 사항 (Behavior and limitations)

다중 버전 환경: 대상 환경에 여러 코드 버전이 배포된 경우, 버전마다 대상 파일이 다를 수 있어요. 이 경우 Bits는 로그포인트를 배치하기 전에 대상 버전을 확인하도록 요청해요. 이렇게 하면 로그포인트가 잘못된 줄 번호에 배치되는 것을 방지할 수 있어요.

언어 지원: 일부 기능은 언어에 따라 달라져요. 예를 들어 조건식은 모든 런타임에서 지원되지 않아요. 요청한 기능이 대상 서비스의 언어에서 지원되지 않으면 Bits가 알려줘요.

민감 데이터: 수동으로 만든 로그포인트에 적용되는 민감 데이터 스크러빙 동작이 Bits가 만든 로그포인트에도 적용돼요. 프로덕션 환경에서는 숫자나 불리언이 아닌 캡처 값이 기본적으로 삭제(redact)돼요.

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 아티클이에요:

• Bits 코드
• Live Debugger
• 민감 데이터 스크러빙
• Datadog Live Debugger로 재배포 없이 운영 코드 디버깅하기