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

Supabase Cloud용 데이터베이스 모니터링 설정

원문 보기 위키 갱신

Supabase Cloud용 Database Monitoring은 자체 호스팅 Datadog Agent 없이도 쿼리 성능 메트릭과 쿼리 샘플을 노출해서 Supabase 데이터베이스에 대한 가시성을 제공해요.

{% alert level="info" %} Datadog Agent가 필요한 자체 호스팅 Supabase 배포는 Supabase Self-Hosted 설정을 참고해요. {% /alert %}

출처: 문서

본문

사전 요구 사항

  • Postgres 데이터베이스가 있는 Supabase 프로젝트.
  • Supabase Project ID (Supabase 프로젝트 설정에서 확인).
  • Supabase API 키 (Supabase 프로젝트 설정의 API 아래에서 확인).
  • Management API 접근 권한이 있는 Supabase Personal Access Token.

설정

{% image source="https://docs.dd-static.net/images/database_monitoring/supabase_cloud_integration_tile.192fe16ba3421717677e62b653027220.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/database_monitoring/supabase_cloud_integration_tile.192fe16ba3421717677e62b653027220.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Supabase Cloud integration tile configuration" /%}

  1. Datadog의 Supabase 통합 타일로 이동하세요.
  2. Add Account를 클릭하세요.
  3. Supabase Project ID와 API Key를 입력하세요.
  4. 쿼리 성능 최적화를 위해 Enable Database Monitoring을 선택하세요.
  5. Personal Access Token을 입력하세요.
  6. Save를 클릭하세요.

Datadog가 Supabase 프로젝트에 연결해서 Database Monitoring 텔레메트리 수집을 시작해요. Agent 설치는 필요 없어요.

{% alert level="info" %} 각 Supabase 프로젝트는 별도로 구성해야 해요. 연결된 Supabase 계정에 새 프로젝트를 추가한다고 해서 Database Monitoring이 자동으로 활성화되지는 않아요. {% /alert %}

수집되는 데이터

Database Monitoring을 활성화하면 Datadog는 Supabase Cloud 데이터베이스에서 다음 텔레메트리를 수집해요:

쿼리 성능 메트릭

pg_stat_statements에서 가져오며 5초마다 수집해요:

  • 호출 횟수와 처리된 행 수
  • 총 및 평균 실행 시간
  • 공유 및 로컬 버퍼 hit/read/dirty/write 통계
  • 블록 I/O 읽기 및 쓰기 시간
  • 임시 버퍼 읽기 및 쓰기 횟수

쿼리 샘플

pg_stat_activity에서 가져오며 5초마다 수집해요:

  • 활성 및 유휴 쿼리 스냅샷
  • 난독화된 쿼리 텍스트와 쿼리 시그니처
  • 대기 이벤트 유형과 이벤트 이름
  • 세션 상태와 백엔드 유형
  • 블로킹 PID
  • 애플리케이션, 상태, 사용자, 데이터베이스별로 그룹화된 연결 집계

데이터베이스 인스턴스 메타데이터

5분마다 수집해요:

  • PostgreSQL 버전
  • 인스턴스 식별자와 호스트네임
  • 연결 모드 (직접 또는 풀러)

검증

설정 후 Datadog의 Database Monitoring 페이지로 이동해서 Supabase 데이터베이스 쿼리와 성능 메트릭을 확인하세요.

{% image source="https://docs.dd-static.net/images/database_monitoring/supabase_cloud_product.6ed36569e393589d319ab031a8f8b2d8.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/database_monitoring/supabase_cloud_product.6ed36569e393589d319ab031a8f8b2d8.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Database Monitoring overview for a Supabase Cloud instance" /%}

더 알아보기 (Learn more)

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