--- title: "DB Cluster 상세 보기" slug: "db-clouddbserverless-dbclusterdetail" tags: ["Cloud DB Serveless"] updated: 2026-09-17T09:07:41Z published: 2026-09-17T09:07:41Z canonical: "guide.ncloud-docs.com/db-clouddbserverless-dbclusterdetail" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # DB Cluster 상세 보기 VPC 환경에서 이용 가능합니다. DB Cluster를 운영하다 보면 생성 당시 설정했던 DB 관련 옵션을 변경해야 하는 상황이 발생할 수 있습니다. Cloud DB Serverless에서는 이미 생성한 DB 클러스터일지라도 간편하게 몇 번의 클릭으로 관련 설정을 변경할 수 있도록 지원하고 있습니다. 참고 - DB 관리 기능은 기본적으로 DB 클러스터 상태가 **운영중**인 경우에 사용 가능합니다. - DB 관리 기능은 DB 클러스터와 DB 인스턴스에 따라 사용 가능한 메뉴가 상이합니다. 생성하여 운영 중인 DB Cluster를 관리하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 **Menu** > **All Services** > **Database** > **Cloud DB Serverless** 메뉴를 차례대로 클릭해 주십시오. 2. **DB Cluster** 메뉴를 클릭해 주십시오. 3. DB Cluster 목록에서 관리할 Cluster를 클릭한 다음 **[DB 관리]** 버튼을 클릭해 주십시오. 4. **DB Cluster 상세 보기** 메뉴에서 필요한 관리 탭을 클릭해 주십시오. ## Database 관리 선택한 DB 클러스터에 데이터베이스를 추가하거나 생성한 데이터베이스를 삭제할 수 있습니다. 데이터베이스는 최대 1,000개까지 추가 및 조회 할 수 있으며, 추가 및 삭제 작업은 한번에 10개까지 가능합니다. DB 추가 및 생성 작업을 수행하려면 **[Database 추가]** 버튼을 클릭하여 데이터베이스를 추가하거나 생성된 DB 행의 **[삭제]** 버튼을 클릭하여 데이터베이스를 삭제해 주십시오. 주의 데이터베이스를 삭제하면 선택한 데이터베이스의 모든 데이터가 삭제됩니다. ## DB Config 관리 DB 클러스터가 운영중 상태에서 다양한 설정을 변경할 수 있습니다. 변경한 설정값은 DB 클러스터 전체에 적용되며, 일부 Config 변수는 변경 시 DB 클러스터가 재시작된 후 적용됩니다. 변경하는 방법은 다음과 같습니다. 1. **DB Config 관리** 탭에서 필요한 정보를 확인하거나 입력해 주십시오. - Config Name: 설정 변수 이름 - Config Value: 변수값 2. **[추가]** 버튼을 클릭해 주십시오. - 추가한 설정 변수 수정 시: **[수정]** 버튼 클릭 - 추가한 설정 변수 삭제 시(기본값으로 설정 시): **[삭제]** 버튼 클릭 3. **[저장]** 버튼을 클릭해 주십시오. 4. DB 클러스터 목록에서 Config를 변경한 Status를 확인해 주십시오. - 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태 - 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태 주의 - 설정한 Config값이 적합하지 않은 경우 DB 클러스터가 정상적으로 동작하지 않을 수 있습니다. 설정 전 Config 변수의 동작을 충분히 숙지한 후 적용해 주십시오. 만약 잘못된 설정으로 DB 클러스터 동작에 문제가 발생한 경우 고객 센터로 문의해 주십시오. - DB Config 관리를 통해 로그(binary, error, slow, general log)가 수집되도록 설정하는 경우 해당 DB 클러스터의 데이터 스토리지 영역에 저장하고, 사용량 만큼 비용이 발생합니다. ### Config 변수 목록 Config 변수에 대한 설명은 다음과 같습니다. 참고 - Config 변수 설정에 대한 자세한 설명은 [MySQL 공식 문서(영문)](https://dev.mysql.com/doc/refman/8.0/en/server-configuration.html)를 참조해 주십시오. - 일부 Config 변수는 Cloud DB Serverless 내부적으로 관리되어 직접 수정이 불가합니다. ## DB User 관리 DB 클러스터를 생성할 때 접속할 계정의 아이디와 비밀번호를 기본으로 생성합니다. 하지만 DB 클러스터를 운영하다 보면 사용자를 추가해야 하거나, 기존 사용자 계정 비밀번호를 재설정해야 하는 상황이 발생할 수 있습니다. 또는 사용자 계정을 삭제해야 할 수도 있습니다. Cloud DB Serverless에서는 DB 클러스터를 사용하는 사용자 계정의 추가, 수정, 삭제를 간편하게 할 수 있는 DB User 관리 기능을 제공합니다. DB User 관리 기능으로 사용자 계정을 변경한 결과는 DB Service 전체에 적용됩니다. 사용자 계정은 최대 1,000개까지 추가할 수 있습니다. 사용자 계정을 추가, 삭제하거나 기존 관리자 계정의 비밀번호를 변경하는 방법은 다음과 같습니다. 1. **DB User 관리** 탭에서 사용자 계정에 필요한 작업을 진행해 주십시오. - 사용자 계정 추가: USER_ID, DB 권한, 암호에 정보를 입력한 후 **[DB User 추가]** 버튼 클릭 - 모든 DB 권한은 system DB의 execute 권한을 포함 - CRUD 권한은 READ 권한을 포함하며, DDL 권한은 READ, CRUD 권한을 포함 - 프로시저 조회는 권한과 상관 없이 모든 계정에서 수행 가능([MySQL 공식 문서(영문)](https://dev.mysql.com/doc/refman/5.7/en/show.html) 참조) - 사용자 계정 삭제: 삭제할 사용자 계정 행에서 **[삭제]** 버튼 클릭 - 사용자 계정 비밀번호 수정: 수정할 사용자 계정 행에서 **[수정]** 버튼 클릭하여 수정 후 **[저장]** 버튼 클릭 2. **[저장]** 버튼을 클릭해 주십시오. 3. DB 클러스터 화면의 목록에서 User를 설정한 DB 클러스터의 상태를 확인해 주십시오. - 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태 - 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태 주의 - 사용자 계정을 삭제할 경우, 삭제된 계정을 사용하고 있던 애플리케이션은 접근이 불가능해 집니다. - 콘솔에서 허용하지 않는 문자로 DB User를 생성할 경우, 콘솔에서 수정, 삭제가 불가능합니다. DB 클러스터에 직접 접속 후 변경해 주십시오. ## Audit 설정 관리 DB 클러스터에서 발생하는 접속 및 쿼리 수행 내역을 감사(Audit) 목적으로 로그 파일에 기록할 수 있습니다. Audit 설정 관리에서 Audit Log 사용 여부, 기록할 이벤트 범위, 로그 형식을 설정할 수 있으며, 변경한 설정은 DB 클러스터 전체에 적용됩니다. 변경하는 방법은 다음과 같습니다. 1. **Audit 설정 관리** 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오. - Audit Log 사용: Audit Log의 활성화 여부 선택 (기본값: 비활성화) - Audit Policy: Audit Log에 기록할 이벤트 정의 (기본값: ALL) - LOGINS: DB에 접속하는 DB 계정의 접속 및 접속 해제만 기록 - QUERIES: DB에서 발생하는 DDL 문을 포함한 쿼리 기록 - ALL: LOGINS + QUERIES - Log Format: Audit Log 파일에 기록되는 형식 (JSON, XML 중 선택, 기본값: JSON) 2. **[저장]** 버튼을 클릭해 주십시오. 3. 재시작 안내 팝업이 표시되는 경우 내용을 확인한 후 **[확인]** 버튼을 클릭해 주십시오. 4. DB Cluster 화면의 DB 클러스터 목록에서 Audit을 설정한 대상의 Status를 확인해 주십시오. - 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태 - 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태 - **설정 변경 시 재시작 여부** | 변경 내용 | 재시작 | 설명 | | --- | --- | --- | | Audit Log 활성화 | 필요 | DB 클러스터의 모든 DB 인스턴스가 재시작된 후 적용 | | Log Format 변경 | 필요 | 활성화 상태에서 Log Format을 변경하는 경우 재시작된 후 적용 | | Audit Policy 변경 | 불필요 | 활성화 상태에서 Audit Policy만 변경하는 경우 즉시 적용 | | Audit Log 비활성화 | 불필요 | 즉시 적용되며, 이미 기록된 Audit Log 파일은 삭제되지 않고 유지 | - **Audit Log 필드 목록** Audit Log에 기록되는 정보는 동일하나 Log Format(JSON/XML)에 따라 필드 이름과 구조가 다릅니다. - JSON: 레코드 배열로 기록되며, 각 레코드는 공통 필드와 이벤트 종류별 데이터 객체로 구성됩니다. - XML: `<AUDIT_RECORD>` 요소의 하위 요소로 기록되며, 모든 항목이 대문자 요소 이름을 사용합니다. - 필드 대응표 | 항목 | JSON | XML | | --- | --- | --- | | 이벤트 발생 시간(UTC+0) | timestamp | TIMESTAMP | | 레코드 ID | id | RECORD_ID - XML은 `<번호>_<시각>` 형식 | | 이벤트 종류 | class + event | NAME | | 수행된 작업 유형 | query_data.sql_command | COMMAND_CLASS | | Client connection ID | connection_id | CONNECTION_ID | | 접속 계정 | account.user | USER | | 인증에 사용된 계정 | account.user에 포함 | PRIV_USER | | 접속 호스트 | account.host | HOST | | Client IP 주소 | login.ip | IP | | 외부 인증 사용자 | login.os | OS_LOGIN | | Proxy 사용자 | login.proxy | PROXY_USER | | 접속 시 default DB | connection_data.db | DB | | 접근한 테이블 | table_access_data.table | TABLE | | 상태 결과 값(0: 성공) | connection_data.status general_data.status command_data.status query_data.status | STATUS | | 커넥션 종류 | connection_data.connection_type | CONNECTION_TYPE | | 수행된 SQL 문 | query_data.query parse_data.query | SQLTEXT | | 재작성된 SQL 문 | parse_data.rewritten_query | REWRITTEN_QUERY | | 파싱 플래그 | parse_data.flags | FLAGS | | 수행된 커맨드 종류 | command_data.command | COMMAND_CLASS | | 조회한 변수 이름/값 | global_variable_data.name global_variable_data.value | VARIABLE_NAME VARIABLE_VALUE | | Client 정보 | connection_attributes | CONNECTION_ATTRIBUTES - XML은 ATTRIBUTE의 NAME/VALUE 쌍으로 반복 | | 서버 ID | server_id | SERVER_ID | Client 정보(connection_attributes)에는 `_pid`, `_platform`, `_os`, `_client_name`, `_client_version`, `program_name`, `os_user` 등이 기록되며, 접속에 사용한 커넥터에 따라 항목이 달라질 수 있습니다. ``` * 이벤트 종류 대응표 ``` | 설명 | JSON (class/event) | XML (NAME) | | --- | --- | --- | | 접속 | connection/connect | Connect | | 접속 해제 | connection/disconnect | Disconnect | | 쿼리 시작 | query/query_start | Query Start | | 쿼리 종료 | query/query_status_end | Query Status End | | 커맨드 시작 | command/command_start | Command Start | | 커맨드 종료 | command/command_end | Command End | | 쿼리 재작성 | parse/query_rewritten | Query Rewritten | | Prepared statement | parse/prepared_statement | Prepared Statement | | 테이블 조회 | table_access/read | TableRead | | 테이블 입력 | table_access/insert | TableInsert | | 변수 조회 | global_variable/variable_get | Variable Get | | 일반 상태 | general/status | Status | | 일반 결과 | general/result | Result | | 오류 | general/error | Error | ``` * 레코드 예시 ``` JSON ``` { "timestamp": "2026-07-31 17:23:37", "id": 62, "class": "connection", "event": "connect", "connection_id": 10, "account": { "user": "app_user", "host": "" }, "login": { "user": "app_user", "os": "", "ip": "127.0.0.1", "proxy": "" }, "connection_data": { "connection_type": "tcp/ip", "status": 0, "db": "fmtdb" } } ``` XML ``` Connect 5_2026-07-31T17:23:37 2026-07-31T17:23:37 Connection 10 localhost 127.0.0.1 app_user app_user fmtdb 0 TCP/IP ``` > 로그인에 실패한 경우 접속 이벤트(JSON `connection/connect`, XML `Connect`)의 상태 결과 값에 오류 번호가 기록됩니다. 예를 들어 비밀번호가 틀린 경우 `1045`가 기록됩니다. 주의 - Audit Log 활성화 또는 Log Format 변경 시 DB 클러스터의 모든 DB 인스턴스가 재시작됩니다. 재시작 중에는 DB 접속이 끊길 수 있으며, Primary가 재시작되는 동안에는 쓰기(Write) 작업을 수행할 수 없습니다. 단, Failover는 발생하지 않습니다. - Audit Policy를 ALL 또는 QUERIES로 설정하는 경우 수행되는 모든 쿼리가 기록되어 로그 발생량이 크게 증가할 수 있습니다. - Audit Log는 DB 클러스터의 데이터 스토리지 및 Cloud Log Analytics 서비스를 이용하므로 용량에 대한 추가 비용이 발생합니다. 참고 - Log Format을 변경하면 기록되는 정보는 동일하나 필드 이름과 구조가 달라집니다. Audit Log를 수집해 분석하는 시스템을 연동한 경우 Log Format 변경 시 파싱 규칙도 함께 변경해 주십시오. - Audit Log가 비활성화 상태인 경우 Audit Policy와 Log Format은 선택할 수 없습니다. - Audit Log의 로테이션 및 보관 설정은 **DB Log 설정 관리** 탭에서 다른 로그와 동일한 방식으로 변경할 수 있습니다. - 수집된 Audit Log는 다른 DB 로그와 동일한 방식으로 파일로 저장됩니다. 로그 파일 목록은 **[DB 관리]** > **DB Instance 상세 보기** > **DB Instance Logs**에서, 로그 내용은 **Monitoring** > **DB Logs**에서 조회할 수 있습니다. - 사용 중인 Audit Log 파일은 `mysql-audit.log`로 저장되며, 로테이션된 파일은 `mysql-audit.<로테이션 시각>.log` 형식으로 저장됩니다. - DB 클러스터 운영 및 이중화를 위해 네이버 클라우드 플랫폼에서 사용하는 관리 계정의 활동은 Audit Log 기록 대상에서 제외됩니다. ## DB Log 설정 관리 생성한 DB 클러스터의 로그 로테이션 및 보관 설정을 변경할 수 있습니다. 변경 시 DB 클러스터 전체에 적용됩니다. 변경하는 방법은 다음과 같습니다. 1. **DB Log 설정 관리** 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오. - Log: 로그 이름 확인 (Error Log, Slow Query Log, General Log, Audit Log 중 선택) - Log Rotate: 로그 로테이션이 매일 또는 사이즈별로 수행되도록 설정 - 사이즈로 선택 시 10~100MB 중 선택 - Log file: 저장할 로그 파일의 개수 (3~7개 중 선택) 2. **[저장]** 버튼을 클릭해 주십시오. 3. DB Cluster 화면의 DB 클러스터 목록에서 Log를 설정한 대상의 Status를 확인해 주십시오. - 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태 - 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태 참고 - General Query Log는 **DB 관리** > **DB Cluster 상세 보기** > **DB Config 관리**에서 `general_log`를 활성화해야 적재됩니다. - Audit Log는 **DB 관리** > **DB Cluster 상세 보기** > **Audit 설정 관리**에서 활성화한 경우에만 로테이션 및 보관 설정을 변경할 수 있습니다. - Log Rotate 타입 변경 시 이전 로그는 자동 삭제가 불가합니다. 불필요한 로그는 **[DB 관리]** > **DB Instance 상세 보기** > **DB Instance Logs** > **[Log 삭제]** 기능을 통해 삭제 바랍니다. ## Backup 설정 관리 선택한 DB 클러스터의 백업 파일 보관 기간 및 백업 수행 시간 설정을 변경할 수 있습니다. 변경하는 방법은 다음과 같습니다. 1. **Backup 설정 관리** 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오. - Backup 설정: Cloud DB Serverless의 백업 설정의 사용 여부 선택 (현재 옵션 변경 불가) - Backup 파일 보존 기간: 1~30까지 입력 가능 - Backup 시간: 백업을 진행하는 시간 설정이며 선택한 시간으로부터 15분 이내에 백업 수행 - 자동: 하루마다 자동으로 백업 시작 - 사용자 정의: 하루마다 사용자가 설정한 시간+15분 사이에 백업 시작 2. **[저장]** 버튼을 클릭해 주십시오.