웹 UI 설치

문서 버전을 선택합니다.

이 페이지에서는 자체 관리형 데이터베이스 클러스터의 상태와 구성을 모니터링할 수 있도록 AlloyDB Omni 웹 사용자 인터페이스를 설치하는 방법을 보여줍니다. 웹 UI는 다음 기능을 제공합니다.

기능 설명 컨테이너 (독립형) Kubernetes RPM (Linux) RPM 조정자
클러스터 선택 대상 클러스터에 액세스하기 위한 연결 사용자 인증 정보를 설정, 등록, 저장할 수 있는 연결 화면 지원됨 지원됨 지원됨 지원됨
클러스터 개요 모든 활성 클러스터 인스턴스와 원격 분석 그래프를 표시하는 관찰 대시보드 지원됨 지원됨 지원됨 지원됨
데이터베이스 클러스터의 카탈로그 테이블과 데이터베이스 크기를 표시하는 개요 페이지 지원됨 지원됨 지원됨 지원됨
열 기반 엔진 분석 쿼리의 구성 설정 및 스캔 실행 통계입니다. 지원됨 지원됨 지원됨 지원됨
데이터베이스 플래그 활성 플래그와 기본 설정에서 벗어난 구성을 표시하는 관찰 보드 지원됨 지원됨 지원됨 지원됨
쿼리 통계 구조적 히스토그램과 느린 쿼리 목록을 표시하는 원격 분석 및 쿼리 성능 대시보드 지원됨 지원됨 지원됨 지원됨
시스템 통계 CPU 사용량, 메모리 사용량, 디스크 I/O를 표시하는 원격 분석 차트 지원되지 않음 (독립형 컨테이너만 해당) 지원됨 지원됨 지원됨

시작하기 전에

웹 UI를 설치하기 전에 다음을 수행해야 합니다.

  1. 웹 UI를 사용할 수 있도록 배포 이미지를 가져오고 AlloyDB Omni를 다운로드하여 설치합니다. RPM을 사용하여 AlloyDB Omni 설치

  2. 데이터베이스 사용자를 구성합니다.

    웹 UI는 데이터베이스에 액세스하기 위한 pg_monitor 역할이 있는 제한된 사용자 계정을 사용합니다. psql 세션에서 다음 명령어를 실행하여 각 클러스터에서 이 사용자를 구성합니다.

    CREATE ROLE alloydbui WITH LOGIN PASSWORD 'PASSWORD';
GRANT pg_monitor TO alloydbui WITH INHERIT TRUE;

  3. AlloyDB Omni 모니터링 에이전트를 구성합니다.

    RPM을 사용하여 AlloyDB Omni를 실행하면 alloydbomni_monitor 모니터링 에이전트를 동일한 저장소에서 별도의 RPM 패키지로 사용할 수 있습니다. 자세한 내용은 AlloyDB Omni 모니터링 설치 및 시작, AlloyDB Omni 모니터링 구성, AlloyDB Omni 모니터링 확인을 참조하세요.

    설치에서 커스텀 데이터 디렉터리(PG_DATA_DIR)를 사용하는 경우 /etc/systemd/system/alloydbomni_monitor.service.d/override.conf를 구성하고 모니터 서비스를 다시 시작합니다.

    sudo mkdir -p /etc/systemd/system/alloydbomni_monitor.service.d
sudo tee /etc/systemd/system/alloydbomni_monitor.service.d/override.conf <<'EOF'
[Service]
Environment="PG_DATA_DIR=PG_DATA_DIR"
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni_monitor

    PG_DATA_DIR를 데이터베이스 데이터 디렉터리의 경로로 바꿉니다(예: /var/lib/postgresql/18/data 또는 /data).

    모니터링 에이전트가 활성 상태이고 측정항목을 내보내고 있는지 확인하려면 sudo systemctl status alloydbomni_monitor 및 curl http://localhost:9187/metrics를 실행합니다.

    sudo mkdir -p /etc/systemd/system/alloydbomni18.service.d
sudo tee /etc/systemd/system/alloydbomni18.service.d/override.conf <<'EOF'
[Service]
CPUQuota=100%
MemoryMax=100%
IOAccounting=yes
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

  4. Prometheus를 구성합니다.

    CPU 사용량을 포함하여 개요 및 시스템 통계 페이지에서 차트 데이터를 보려면 Prometheus를 설치하고 구성합니다. 모니터링 도구 선택 및 설치의 설치 및 구성 안내를 따릅니다.

추가 단계(선택 사항)

추가 웹 UI 기능을 사용 설정하려면 다음 안내를 따르세요.

  • 쿼리 통계 설정

    쿼리 통계 기능을 사용하려면 pg_stat_statements 확장 프로그램을 사용 설정합니다. psql 세션에서 다음 명령어를 실행하여 라이브러리를 구성합니다.

    ALTER SYSTEM SET shared_preload_libraries=google_columnar_engine,google_job_scheduler,google_storage,google_db_advisor,pg_stat_statements;
ALTER SYSTEM SET pg_stat_statements.max = 10000;
ALTER SYSTEM SET pg_stat_statements.track_utility = on;
ALTER SYSTEM SET track_io_timing = on;

    그런 다음 각 데이터베이스에서 개별적으로 다음 명령어를 실행하여 확장 프로그램을 만듭니다.

    CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

    변경사항을 적용하려면 데이터베이스를 다시 시작합니다. 열 기반 엔진을 사용 설정하려면 해당 설정이 완료될 때까지 기다렸다가 다시 시작하세요.

  • 열 기반 엔진 설정

    웹 UI에서 열 기반 엔진 데이터에 액세스하려면 열 기반 엔진 개요에 설명된 대로 엔진을 구성합니다.

  • AlloyDB AI 설정

    웹 UI에서 AlloyDB AI 기능을 사용하려면 다음 권한을 부여합니다.

    • 벡터 색인을 채우려면 alloydbui 사용자에게 pg_stat_ann_indexes에 대한 SELECT 권한을 부여합니다.
    • 벡터 열을 표시하려면 alloydbui 사용자에게 테이블에 대한 SELECT 권한을 부여합니다.
자세한 내용은 AlloyDB AI를 사용하여 생성형 AI 애플리케이션 빌드를 참조하세요.

웹 UI 설치

모든 노드에서 웹 UI를 설치하고 실행할 수 있습니다. 웹 UI에는 전용 노드가 필요하지 않습니다. 전체 설치에는 약 250MB의 디스크 공간이 필요합니다. 배포용 이미지를 가져오고 AlloyDB Omni를 다운로드한 후 웹 UI를 설치하고 실행할 수 있습니다.

RPM을 사용하여 설치

Google은 Linux 패키지 서명 키를 사용하여 AlloyDB Omni RPM 패키지에 서명합니다. GPG 서명 확인으로 YUM 저장소를 구성하고 웹 UI RPM 패키지를 설치하려면 다음 단계를 완료합니다.

  1. 로컬 디렉터리에서 YUM 저장소를 구성합니다.

    sudo tee -a /etc/yum.repos.d/alloydbomni_ui.repo << EOF
[alloydbomni_ui]
name=alloydbomni_ui
baseurl=ALLOYDB_OMNI_COMMON_REPOSITORY_URL
enabled=1
repo_gpgcheck=1
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

    sudo yum makecache

    ALLOYDB_OMNI_COMMON_REPOSITORY_URL을 AlloyDB Omni 공통 저장소의 URL로 바꿉니다.

  2. 웹 UI RPM 패키지를 설치합니다.

    sudo dnf install alloydbomni_ui

웹 UI 시작

웹 UI는 Java 키 저장소를 사용하여 연결 데이터를 암호화하는 데 사용되는 256비트 AES 키를 보호합니다. 웹 UI를 시작할 때 비밀번호가 포함된 환경 변수를 지정합니다.

Linux에서 웹 UI 시작

export ALLOYDB_OMNI_UI_KEYSTORE="PASSWORD"
/opt/alloydbomni/app/alloydb-ui/app/bin/alloydb

웹 UI 열기

웹 UI를 보려면 http://HOST:9080에서 브라우저를 엽니다.

HOST을 웹 UI가 설치된 노드의 호스트 이름 또는 IP 주소로 바꿉니다.

  • 선택적인 ALLOYDB_OMNI_BASE_PATH 환경 변수를 사용하여 커스텀 기본 경로를 구성한 경우(예: 기존 리버스 프록시 뒤에서 호스팅하는 경우) URL에 경로를 추가해야 합니다(http://HOST:9080/BASE_PATH).

  • 선행 슬래시 없이 기본 경로를 구성할 수 있습니다(예: ALLOYDB_OMNI_BASE_PATH=PATH). 다음은 모두 유효한 대안입니다.

    • /test/
    • test/
    • test
    • /test

제한사항

웹 UI에는 다음과 같은 제한사항이 있습니다.

  • 컨테이너화된 모니터링 에이전트를 독립형 컨테이너 배포에 사용할 수 없으므로 AlloyDB Omni 독립형 컨테이너 배포에 연결할 때는 개요 차트와 시스템 인사이트를 사용할 수 없습니다. 차트 이외의 다른 모든 기능과 측정항목은 계속 정상적으로 작동합니다.

  • 특정 테이블의 열 기반 엔진 데이터를 보려면 alloydbui 사용자에게 해당 테이블에 대한 권한이 하나 이상 있어야 합니다(예: SELECT).

  • 벡터 색인 데이터를 보려면 alloydbui 사용자에게 pg_stat_ann_indexes에 대한 SELECT 권한이 필요합니다.

  • 특정 테이블의 벡터 열 데이터를 보려면 alloydbui 사용자에게 해당 테이블에 대한 SELECT 권한이 필요합니다.

권장사항 및 주의사항

웹 UI를 설치하고 구성할 때는 다음 권장사항과 주의사항을 따르세요.

  • 키 저장소 비밀번호 보호: 웹 UI는 256비트 AES 데이터베이스 암호화 키를 보호하기 위해 자바 키 저장소를 생성합니다. ALLOYDB_OMNI_UI_KEYSTORE에 안전한 암호를 사용합니다. 구성 파일을 전송하고 일치하지 않는 키 저장소 비밀번호로 연결하면 복호화 오류가 발생합니다.
  • Prometheus 측정항목 스크래핑: 데이터베이스 노드에 과부하를 주지 않고 통계를 쿼리하도록 표준 범위 (15~30초)에서 대상 인스턴스를 폴링하도록 스크래퍼를 구성합니다.

다음 단계