PostgreSQL 확장의 서버 대시보드에는 PostgreSQL 연결 세부 정보, 라이브 및 기록 성능 메트릭 및 지원되는 관리 도구가 표시됩니다. 편집기를 종료하지 않고도 서버 활동을 모니터링하고, 쿼리를 열고, 스키마 시각화 도우미를 시작하고, Azure 서버 구성에 액세스할 수 있습니다. 대시보드는 Visual Studio Code커서에서 동일한 방식으로 실행됩니다. 대시보드의 AI 단추에서 열리는 AI 채팅 패널만 다릅니다.
Tip
먼저 서버 연결을 설정합니다. 연결 및 ID를 참조하세요. 대시보드에서 사용할 수 있는 Azure 관련 관리 작업은 Azure 서버 관리를 참조하세요.
서버 대시보드 열기
- 연결 트리에서 서버 노드를 마우스 오른쪽 단추로 클릭합니다.
- 대시보드를 선택합니다.
대시보드는 <profileName> - 대시보드라는 이름의 탭에서 열리고 페이지 헤더 <connectionLabel> | 성능 대시보드를 표시합니다.
메모
서버 대시보드는 기본적으로 사용하도록 설정된 미리 보기 기능입니다. 비활성화하려면 VS Code 설정에서 pgsql.enableServerDashboard를 false로 설정하세요.
서버 세부 정보 카드
대시보드의 맨 위에는 현재 연결을 요약하는 세부 정보 카드가 표시됩니다.
| Field | Description |
|---|---|
| 서버 | PostgreSQL 서버의 주소입니다. |
| 버전 | 서버에서 보고한 PostgreSQL 버전입니다. |
| 항구 | 연결에 사용되는 TCP 포트입니다(기본값: 5432). |
| User | 이 연결에 대해 인증된 사용자입니다. |
| 기본 DB | 연결의 대상이 되는 데이터베이스입니다(기본값은 postgres). |
| 시스템 상태 | (Azure만 해당)준비, 중지 또는 시작과 같은 Azure Database for PostgreSQL 유연한 서버의 현재 상태입니다. 상태를 업데이트할 값 옆에 있는 새로 고침 단추를 선택합니다. |
메모
상태 필드는 Azure Database for PostgreSQL 유연한 서버 연결에 대해서만 나타납니다.
도구 모음
대시보드 맨 위에 있는 도구 모음은 일반적인 작업에 빠르게 액세스할 수 있도록 합니다. 일부 단추는 특정 조건이 충족되는 경우에만 표시됩니다.
연결 작업
| 단추 | Description |
|---|---|
| 연결 | 서버 연결이 끊어지면 나타납니다. 연결을 다시 설정하려면 선택합니다. 연결하는 동안 단추가 연결 중...으로 변경되었습니다. |
| 동작>연결 해제 | 서버에서 연결을 끊습니다. 연결된 경우 작업 드롭다운 목록 메뉴에서 사용할 수 있습니다. |
서버 연결이 끊어지면 도구 모음의 데이터베이스 관련 단추가 비활성화되고 도구 설명이 표시됩니다. "데이터베이스 연결이 필요합니다. 데이터베이스에 연결하여 이 기능을 사용하도록 설정합니다."
데이터베이스 작업
| 단추 | Description |
|---|---|
| 새 쿼리 | 이 서버의 데이터베이스에 연결된 새 쿼리 편집기를 엽니다. 데이터베이스 선택기를 사용하면 대상 데이터베이스를 선택할 수 있습니다. |
| Connect AI / Connect Copilot | 이 서버의 스키마 및 데이터로 범위가 지정된 에이전트 모드 세션을 엽니다. 열리는 채팅 패널은 Visual Studio Code에서는 GitHub Copilot Chat이고, Cursor에서는 Cursor의 기본 AI 패널입니다. Copilot 통합을 참조하세요. |
| 스키마 시각화 | 이 서버에서 데이터베이스에 대한 스키마 시각화 도우미를 시작합니다. 데이터베이스 선택기를 사용하면 대상 데이터베이스를 선택할 수 있습니다. 스키마 시각화 도우미를 참조하세요. |
Azure 서버 작업
Azure Database for PostgreSQL 유연한 서버 연결의 경우 작업 드롭다운 목록 메뉴에는 서버 수명 주기 작업이 포함되고 도구 모음에는 추가 포털 단추가 표시됩니다.
| 단추 | Description |
|---|---|
| 작업>시작 | 중지된 Azure 서버를 시작합니다. |
| 작업>중지 | 실행 중인 Azure 서버를 중지합니다. 할당 취소를 중지하면 컴퓨팅 리소스가 할당 취소되고 컴퓨팅 청구가 일시 중지됩니다. |
| 작업>재시작 | Azure 서버를 다시 시작합니다. 다시 시작해야 하는 매개 변수를 변경한 후 사용합니다. |
| Azure Portal | 기본 브라우저의 Azure 포털에서 서버의 관리 블레이드를 엽니다. |
메모
시작, 중지 및 다시 시작 작업에는 서버 리소스에 대한 적절한 Azure RBAC(역할 기반 액세스 제어) 권한이 필요합니다.
서버 설정 메뉴
지원되는 Azure 연결의 경우 도구 모음에 서버 설정 드롭다운 목록 단추가 나타납니다. VS Code 내에서 열리는 Azure 관리 페이지에 대한 탐색을 제공합니다.
| 메뉴 항목 | Description |
|---|---|
| 네트워크 구성 | Azure Database for PostgreSQL 유연한 서버의 경우 방화벽 규칙 및 공용 액세스 설정을 보고 수정합니다. Azure HorizonDB(미리 보기)의 경우 방화벽 규칙 및 Azure 서비스 액세스를 보고 수정합니다. |
| 서버 매개 변수 | PostgreSQL 매개 변수(정적 매개 변수와 동적 둘 다)를 찾아서 업데이트합니다. |
| Backups | 백업 기록을 보고 백업 보존 정책을 구성합니다. |
| 서버 로그 | 문제 해결을 위해 PostgreSQL 서버 로그에 액세스하고 다운로드합니다. |
| 서버 복제 | 백업 지점에서 Azure 서버를 복제합니다. |
Azure Database for PostgreSQL 유연한 서버 연결은 전체 메뉴를 표시할 수 있습니다. Azure HorizonDB(미리 보기) 연결은 연결에 완전한 Azure 리소스 및 풀 ID가 있는 경우 네트워크 구성을 표시할 수 있습니다. 매개 변수, 백업, 서버 로그, 복제 및 수명 주기 작업은 Azure HorizonDB(미리 보기) 연결에 사용할 수 없습니다.
메모
서버 설정 단추는 확장에서 서버에 대한 Azure 메타데이터를 검색하고 하나 이상의 설정 페이지를 사용할 수 있는 경우에만 표시됩니다.
Azure 메타데이터 프롬프트
확장에서 서버가 지원되는 Azure Database for PostgreSQL 리소스인 것으로 보이지만 Azure 메타데이터를 아직 사용할 수 없는 경우, 도구 모음에 Azure 서버 감지 프롬프트가 표시됩니다. 메타데이터 가져오기를 선택하여 메타데이터를 검색합니다. 메타데이터를 페치하면 Azure Database for PostgreSQL 유연한 서버 설정 및 작업, Azure HorizonDB(미리 보기) 네트워크 구성 및 지원되는 Azure Monitor 메트릭과 같이 리소스 ID에 의존하는 Azure 관리 기능을 사용할 수 있습니다.
메타데이터 페치에 실패하면 메타데이터 페치 실패 오류 메시지가 세부 정보와 함께 표시됩니다.
불완전한 메타데이터 배너
Azure 메타데이터를 가져오지만 테넌트 ID가 누락된 경우 대시보드 맨 위에 불완전한 Azure 메타데이터라는 제목의 경고 배너가 표시됩니다. 배너에서 메타데이터 가져오기 를 선택하여 다시 시도합니다. 테넌트 ID는 서버 수명 주기 작업(시작, 중지, 다시 시작)에 필요합니다.
조사 탭
도구 모음 및 세부 정보 카드 아래에 대시보드는 모니터링 데이터를 4개의 조사 탭으로 구성합니다. 서버의 기능은 표시되는 탭을 결정합니다.
| Tab | 표시되는 내용 |
|---|---|
| Overview | 범주별로 그룹화된 메트릭 차트와 각 그룹에 빠르게 액세스할 수 있는 목차 탐색기가 있습니다. |
| 쿼리 | 개별 쿼리 세부 정보로 드릴다운하여 실행 시간, 호출 수 또는 기타 메트릭별로 순위가 매겨진 상위 SQL 문입니다. |
| 대기 | 서버가 대기하는 시간을 보여 주는 순위가 지정된 테이블 및 오버타임 차트를 사용하여 이벤트 분석을 대기합니다. |
| 세션 | 활성 및 유휴 세션, 차단 트리 보기, 잠금 활동 차트 및 세션 수준 세부 정보 패널 |
탭을 선택하여 콘텐츠 영역을 전환합니다. 대시보드는 현재 세션 내의 활성 탭을 기억합니다.
Overview
개요 탭은 기본 방문 보기입니다. 서버 메트릭을 축소 가능한 그룹으로 구성된 대화형 차트로 표시합니다.
메트릭 그룹
메트릭은 다음 그룹으로 구성됩니다. 일부 그룹은 모든 서버에 대해 표시되지 않습니다. 대시보드에는 사용 가능한 데이터가 있는 그룹만 표시됩니다.
| 그룹 | 다루는 내용 |
|---|---|
| 리소스 | CPU 사용률, 메모리 사용량 및 컴퓨팅 수준 메트릭. |
| 연결들 | 활성 연결, 상태별 연결 수 및 연결 풀 메트릭. |
| 디스크 I/O | 처리량, IOPS 및 대기 시간을 읽고 씁니다. |
| 스토리지 | 사용된 디스크 공간, 사용 가능한 스토리지 및 스토리지 비율입니다. |
| 트랜잭션 및 워크로드 | 트랜잭션 속도, 커밋, 롤백 및 처리된 행 |
| 대기 이벤트 | 상위 대기 이벤트 유형 및 해당 빈도 요약입니다. |
| 유지 관리 및 자동 진공 | 자동 진공 활동 및 데드 튜플 개수입니다. |
| 트랜잭션 ID 안전성 | 트랜잭션 ID 수명 및 랩어라운드 지표. |
| 복제 | 복제 지연 및 복제본 상태(복제가 구성된 경우). |
측면의 목차 탐색기를 사용하여 특정 그룹으로 직접 이동합니다. 그룹 머리글을 선택하여 차트를 확장하거나 축소합니다.
메트릭 소스
각 메트릭 차트에는 데이터가 시작되는 위치를 나타내는 원본 배지가 표시됩니다.
| Badge | Source | Availability |
|---|---|---|
| System | 서버의 기본 제공 통계 수집기 | 모든 PostgreSQL 서버 |
| azure | Azure 모니터 | Azure 메타데이터를 사용하여 유연한 서버 연결 Azure Database for PostgreSQL |
두 원본을 모두 사용할 수 있는 경우 개요는 두 원본의 메트릭을 함께 표시하며 각 차트는 원본 배지로 레이블이 지정됩니다.
시간 창 및 표준 시간대
표준 시간대 선택기에서 로컬 또는 UTC 를 선택하여 차트 축 및 도구 설명에서 타임스탬프를 표시하는 방법을 제어합니다.
Azure Monitor 메트릭의 경우 시간 창 선택기를 사용하여 날짜 범위를 선택할 수 있습니다.
- 1시간
- 6시간
- 12시간
- 1일
- 7일
- 30일
차트 상호 작용
- 범례: 각 차트에는 범례가 표시됩니다. 범례 항목을 선택하여 해당 계열을 숨깁니다. 를 다시 선택하여 복원합니다.
- 십자선 동기화: 한 차트를 마우스로 가리키면 동일한 탭의 모든 차트가 동일한 타임스탬프에 십자선을 동기화하므로 차트 간에 메트릭을 상호 연결할 수 있습니다.
- 확대/축소: 차트 확대/축소 컨트롤을 사용하여 관심 있는 시간 범위에 초점을 맞춥니다.
쿼리
쿼리 탭에는 PostgreSQL 통계 수집기의 쿼리 성능 데이터가 표시됩니다. 이를 사용하여 느리거나 자주 호출되는 SQL 문을 식별합니다.
쿼리 통계를 사용하려면 연결된 PostgreSQL 서버에서 확장을 사용하도록 설정해야 합니다 pg_stat_statements .
상위 SQL 테이블
기본 보기는 순위가 지정된 SQL 문 테이블입니다. 각 행은 다음을 보여줍니다.
| Column | Description |
|---|---|
| Query | 정규화된 SQL 텍스트입니다. 행을 선택하여 세부 정보 패널을 엽니다. |
| 쿼리 ID | PostgreSQL 쿼리 식별자입니다. |
| 통화 | 구문이 실행된 총 횟수입니다. |
| 총 시간 | 누적 실행 시간입니다. |
| 평균 시간 | 호출당 평균 실행 시간입니다. |
| 행 | 반환되거나 영향을 받는 총 행입니다. |
| Database | statement가 실행된 데이터베이스입니다. |
| User | 문을 실행한 PostgreSQL 역할입니다. |
테이블 위의 데이터베이스 및 사용자 필터 드롭다운을 사용하여 결과의 범위를 좁힐 수 있습니다.
쿼리 세부 정보 패널
위쪽 SQL 테이블에서 행을 선택하여 오른쪽에 있는 세부 정보 패널을 엽니다. 세부 정보 패널에는 다음이 표시됩니다.
- 구문이 강조 표시된 전체 SQL 텍스트
- 실행 통계(호출, 총 시간, 평균 시간, 최소/최대 시간, 표준 편차)
- 시간이 지남에 따라 구문의 성능을 시각화하는 실행 차트
세부 정보 패널에서 Copilot에게 질문하기(또는 커서에서 AI 요청)을 선택하여 쿼리의 컨텍스트가 미리 로드된 AI 채팅 세션을 엽니다.
대기
대기 탭을 사용하면 서버에서 대기하는 시간을 파악할 수 있습니다. 순위표와 시간 경과에 따른 차트를 결합합니다.
- 순위가 지정된 테이블: 총 대기 시간을 기준으로 정렬된 대기 이벤트 유형을 나열합니다. 각 행에는 대기 이벤트 이름, 범주 및 누적 시간이 표시됩니다.
- 오버타임 차트: 시간에 따라 누적된 대기 이벤트를 시각화하므로 모니터링 기간 동안 대기 패턴이 어떻게 변경되는지 확인할 수 있습니다.
대기 탭의 차트는 십자선 동기화를 사용하므로 한 차트를 마우스로 가리키면 다른 차트의 동일한 시점이 강조 표시됩니다.
Copilot에게 질문하기 선택(또는 커서에서 AI 요청)을 선택하여 현재 대기 이벤트 데이터를 컨텍스트로 사용하여 AI 채팅 세션을 엽니다.
세션
세션 탭에는 활성 데이터베이스 세션이 표시되며 차단 관계를 식별하는 데 도움이 됩니다.
세션 요약 카드
맨 위에 요약 카드는 활성, 유휴 및 차단된 세션과 같은 세션 범주에 대한 개수를 표시합니다.
세션 테이블
세션 테이블에는 다음 열이 있는 개별 세션이 나열됩니다.
| Column | Description |
|---|---|
| Pid | 백 엔드의 프로세스 ID입니다. |
| User | 세션에 대한 PostgreSQL 역할입니다. |
| Database | 연결된 데이터베이스입니다. |
| Application | 클라이언트 애플리케이션 이름입니다. |
| 시스템 상태 | 세션 상태(활성, 유휴 상태, 트랜잭션의 유휴 상태 등). |
| 대기 유형 | 현재 대기 유형(있는 경우)입니다. |
| 대기 이벤트 | 특정 대기 이벤트 이름입니다. |
| Query | 현재 또는 마지막으로 실행된 쿼리 텍스트입니다. |
| Duration | 현재 상태가 유지된 기간입니다. |
| 백 엔드 형식 | 백 엔드 프로세스 유형(클라이언트 백 엔드, 자동 진공 작업자 등). |
테이블 위의 필터 컨트롤을 사용하여 워크로드 유형, 애플리케이션 또는 상태별로 세션 범위를 좁힐 수 있습니다.
세션 테이블 헤더에서 Copilot에게 질문하기(또는 커서로 AI 요청)을 선택하여 세션 데이터를 컨텍스트로 사용하여 AI 채팅 세션을 엽니다. 차단 체인이 있는 경우, 분석은 차단 관계 및 세션 상태에 중점을 둡니다.
블록 트리
세션 간에 차단 관계가 있는 경우 대시보드에는 다른 세션을 차단하는 세션을 시각화하는 차단 트리가 표시됩니다. 트리 노드를 확장하여 차단 세션에서 해당 웨이터로 체인을 추적합니다.
활동 차트 잠금
잠금 활동 차트는 시간 경과에 따른 잠금 획득 및 대기 패턴을 표시하여 경합에 대한 시각적 요약을 제공합니다.
세션 세부 정보 패널
전체 쿼리 텍스트 및 세션 속성을 포함하여 전체 세션 정보를 보여 주는 세부 정보 패널을 열려면 세션 행을 선택합니다.
복제본 토폴로지
읽기 복제본을 사용하는 Azure Database for PostgreSQL 유연한 서버 연결의 경우 대시보드에 복제본 토폴로지 패널이 나타납니다. 주 서버와 해당 복제본에 상태 표시기, 전환 준비 상태 및 토폴로지 경고가 표시됩니다.
대시보드에서 AI 요청
Copilot에게 질문하기 단추(커서에서 AI 요청)는 쿼리 탭 헤더, 대기 탭, 세션 탭 및 개별 메트릭 차트와 같은 여러 대시보드 컨텍스트에 표시됩니다. 이를 선택하면 확장은 컨텍스트로 미리 로드된 관련 대시보드 데이터(메트릭, 쿼리 세부 정보, 대기 이벤트 또는 세션 정보)를 사용하여 에이전트 모드에서 AI 채팅 세션을 엽니다.
메모
Copilot에게 질문하기 / Ask AI 버튼을 사용하려면 활성 AI 도우미가 필요합니다. Visual Studio Code에서는 GitHub Copilot이 설치되어 있고 로그인되어 있어야 하며, Cursor에서는 내장 AI를 사용해야 합니다. 데이터가 로드되는 동안 또는 사용할 수 있는 데이터가 없는 경우 단추를 사용할 수 없습니다.
연결이 끊긴 상태
서버 연결이 끊어지면 대시보드에 데이터베이스 연결이 필요하다는 메시지가 표시됩니다. 연결을 선택하여 연결을 다시 구성하고 대시보드 데이터를 로드합니다.
Azure 메트릭 상태 메시지
Azure Monitor 메트릭을 볼 때 메트릭을 사용할 수 없는 경우 대시보드에 상태 메시지가 표시될 수 있습니다.
- 누락된 Azure 메타데이터: 기록 메트릭에는 Azure 메타데이터가 필요합니다. 메타데이터 가져오기를 선택하여 검색합니다.
- 사용 권한 부족: Azure Monitor 메트릭을 쿼리하는 데 필요한 Azure 권한이 없습니다. 자세한 내용은 필요한 권한 보기를 선택합니다.