파라미터 그룹 생성 및 관리
파라미터 그룹을 사용해 엔진 버전별 MemStore Redis OSS 파라미터를 조회하고, 연결된 클러스터에 적용할 설정을 관리하는 방법을 설명합니다.
카카오클라우드 MemStore에서 제공하는 파라미터 목록과 기본 개념은 Redis OSS와 호환됩니다. 파라미터를 변경하면 MemStore 서비스 운영에 영향을 미칠 수 있으므로 변경 전에 각 파라미터의 용도와 설정값을 충분히 검토하시기 바랍니다. 자세한 내용은 Redis OSS 공식 문서를 참고하세요.
파라미터 그룹 생성, 수정 등 관련 이벤트는 Alert Center > 이벤트 알림에서 받아볼 수 있습니다. 설정 가능한 이벤트 내역은 Cloud Trail, 이벤트 알림 설정 방법은 Alert Center > 알림 정책 생성 및 관리를 참고하세요.
파라미터 그룹 목록 보기
카카오클라우드 MemStore에서 제공하는 기본/커스텀 파라미터 그룹 목록을 확인할 수 있습니다.
-
카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 확인할 파라미터 그룹 분류에 따라 커스텀 그룹 또는 기본 그룹 탭을 선택합니다.
-
선택한 탭에서 파라미터 그룹 목록을 확인합니다.
항목 설명 이름 파라미터 그룹 이름 클러스터 모드 클러스터 모드 사용 여부 패밀리 파라미터 그룹과 호환되는 MemStore Redis OSS 엔진 패밀리 연결된 클러스터 수 해당 그룹에 연결된 클러스터 수
- 연결된 클러스터의 파라미터 반영 상태에 이상이 있을 경우, 경고 아이콘 노출설명 파라미터 그룹 설명 [⋮] 버튼 커스텀 그룹만 제공
- 수정: 파라미터 수정
- 복사: 해당 그룹과 동일한 파라미터로 새로운 파라미터 그룹 생성
- 초기값으로 재설정: 해당 그룹의 파라미터를 생성 시점의 초기값으로 재설정
- 롤백: 해당 그룹의 파라미터를 직전 값으로 되돌림, 수정한 내역이 없거나 이미 롤백한 경우 롤백 불가
- 삭제: 해당 그룹 삭제
파라미터 그룹 상세 보기
MemStore 파라미터 그룹의 상세 정보는 탭별로 구분해 확인할 수 있습니다.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 확인할 파라미터 그룹 분류에 따라 커스텀 그룹 또는 기본 그룹 탭을 선택합니다.
- 선택한 탭에서 상세 정보를 조회할 파라미터 그룹을 선택합니다.
파라미터 그룹 상세 화면의 탭은 다음과 같이 구성됩니다.
- 파라미터: 파라미터의 이름, 값, 유형, 데이터 형식, 수정 여부를 확인할 수 있습니다. 파라미터 수정 시 유의 사항은 파라미터 그룹 수정을 참고해 주세요.
- 연결된 클러스터: 파라미터 그룹이 연결된 클러스터와 파라미터 반영 상태를 확인할 수 있습니다. 파라미터 반영 상태가
Error-Sync,Suspended이면 [재시도] 버튼으로 연결된 클러스터에 파라미터 반영을 다시 요청할 수 있습니다. 파라미터 반영 상태의 의미는 파라미터 반영 상태를 참고해 주세요. - 최근 이벤트: 최근 7일간 발생한 파라미터 그룹의 주요 이벤트를 확인할 수 있습니다. 이벤트 발생 시간, 이벤트 이름, 처리 결과, 관련 클러스터 정보를 확인할 수 있습니다.
최근 이벤트 탭에서 확인할 수 있는 이벤트는 다음과 같습니다.
| 파라미터 그룹 유형 | 이벤트 이름 | 설명 |
|---|---|---|
| 그룹 공통 | Apply Parameter Group | 파라미터 그룹 적용 요청이 들어왔을 때 발생 |
| Apply Parameter Group Failed | 클러스터에 파라미터 그룹 적용 작업이 완료되었으나 실패했을 때 발생 | |
| Apply Parameter Group Complete | 모든 클러스터에 파라미터 그룹 적용 작업을 완료했을 때 발생 | |
| Apply Parameter Group To Cluster | 클러스터에 파라미터 그룹 적용 작업을 시작했을 때 발생 | |
| Apply Parameter Group To Cluster Failed | 클러스터에 파라미터 그룹 적용이 실패했을 때 발생 | |
| Apply Parameter Group To Cluster Complete | 특정 클러스터에 파라미터 그룹 적용을 완료했을 때 발생 | |
| 커스텀 | Create Parameter Group | 파라미터 그룹 생성 요청이 들어왔을 때 발생 |
| Update Parameter Group | 파라미터 그룹 수정 요청이 들어왔을 때 발생 | |
| Update Parameters | 파라미터 값 수정 요청이 들어왔을 때 발생 | |
| Reset Parameters | 파라미터 초기화 요청이 들어왔을 때 발생 | |
| Rollback Parameters | 파라미터 이전 값으로 롤백 요청이 들어왔을 때 발생 |
파라미터 그룹 생성
커스텀 파라미터 그룹을 생성할 수 있습니다. 파라미터 값은 파라미터 그룹을 만든 후 수정할 수 있습니다.
-
카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
-
커스텀 그룹 탭에서 아이콘 > 파라미터 그룹 생성을 선택합니다.
-
파라미터 그룹 생성 페이지에서 필요한 내용을 입력한 후 [생성] 버튼을 클릭합니다.
항목 구분 설명 기본 설정 파라미터 그룹 이름 파라미터 그룹의 이름
- 동일 프로젝트 내에서 중복된 이름은 사용할 수 없음설명(선택) 파라미터 그룹에 대한 부가 설명을 최대 100자까지 입력 가능 파라미터 그룹 설정 패밀리 파라미터 그룹의 MemStore Redis OSS 엔진 패밀리 클러스터 모드 클러스터 모드 사용 여부 기본 파라미터 그룹 해당 엔진 버전에서 제공하는 기본 파라미터 그룹 파라미터 해당 파라미터 그룹의 초기 파라미터 값
파라미터 그룹 수정
커스텀 파라미터 그룹은 생성 후 설명과 수정하려는 파라미터 값을 변경할 수 있습니다. 수정 여부가 가능인 파라미터만 수정할 수 있으며, 값이 수정된 파라미터는 가능(수정됨)으로 변경됩니다.
Dynamic유형인 파라미터 중 일부는 글로벌로 적용되므로 세션 갱신이 필요합니다.- 연결된 클러스터의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터를 수정할 수 없습니다. - 파라미터 그룹 수정 페이지에서는 수정 가능한 파라미터 목록 내에서 목록을 이동해도 선택한 체크 박스가 유지됩니다.
- 일부 파라미터는 수정 시 MemStore 서비스 운영에 영향을 미칠 수 있습니다. 자세한 내용은 수정 시 주의해야 할 파라미터를 확인해 주세요.
- 파라미터 수정 후 문제가 발생할 수 있으므로, 설정을 백업하려면 파라미터 그룹
복사를 권장합니다. 필요에 따라재시도,롤백,초기화를 사용할 수 있습니다.
-
카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
-
수정할 파라미터 그룹을 확인한 뒤 [⋮] 버튼 > 수정을 선택합니다.
-
파라미터 그룹 수정 페이지에서 필요한 내용을 수정합니다.
항목 구분 설명 기본 정보 파라미터 그룹 이름 파라미터 그룹의 이름 설명(선택) 파라미터 그룹에 대한 부가 설명을 최대 100자까지 입력 가능 수정 가능한 파라미터 파라미터 그룹 내에서 수정 가능한 파라미터 목록
- 수정된 파라미터는 수정 여부가가능(수정됨)으로 변경 -
필요한 값으로 파라미터 그룹을 수정한 뒤 [확인] 버튼을 클릭합니다.
-
클러스터에 연결된 파라미터 그룹이 복수 개인 경우, 파라미터 적용 방식을 선택할 수 있습니다.
일괄반영: 수정된 파라미터를 모든 클러스터에 일괄 반영합니다.순차반영: 수정된 파라미터를 클러스터에 연속해서 반영합니다.
수정 시 주의해야 할 파라미터
일부 파라미터는 클라이언트 연결, Replica 동기화, 백로그 버퍼, 노드 상태에 영향을 줄 수 있습니다. 변경 전 클러스터 구성, Replica 개수, 워크로드를 확인하세요.
repl-backlog는 Primary, Replica 노드의 레플리케이션이 네트워크 단절로 끊어졌을 때 부분 동기화를 위해 Replica 노드에 전송할 데이터를 임시 보관하는 버퍼입니다.
- 네트워크 단절이 발생하면 Primary 노드는 동기화할 데이터를 backlog에 저장하고, Replica가 다시 연결되었을 때 해당 데이터로 부분 동기화(psync)를 시도합니다.
- Primary 노드는 마지막 Replica 노드와 연결이 해제된 후 일정 시간(
repl-backlog-ttl) 동안만 백로그 데이터를 유지하고, 이후 백로그 버퍼를 해제합니다. - 백로그 버퍼 해제 이후 Replica 노드가 다시 연결되면 데이터 동기화를 위해 full sync를 수행합니다.
- 연관 파라미터:
repl-backlog-size,repl-backlog-ttl
클라이언트 출력 버퍼 파라미터
| 파라미터 | 용도 | 수정 시 유의 사항 |
|---|---|---|
client-output-buffer-limit-normal-hard-limit | 클라이언트 출력 버퍼 메모리 사용량 상한 값 - 입력 범위: 0~- 0 설정 시 상한 없음 | 설정값 도달 시 클라이언트 연결 해제 가능 너무 낮은 값 설정 시 MemStore 서비스 프로비저닝 실패 가능 워크로드를 고려한 충분한 수치 또는 기본값( 0) 설정 권장 |
client-output-buffer-limit-normal-soft-limit | 클라이언트 출력 버퍼 메모리 사용량 임계값 - 입력 범위: 0~- 0 설정 시 임계값 없음 | 임계 시간 동안 설정값 초과 시 클라이언트 연결 해제 가능 너무 낮은 값 설정 시 MemStore 서비스 프로비저닝 실패 가능 워크로드를 고려한 충분한 수치 또는 기본값( 0) 설정 권장 |
client-output-buffer-limit-normal-soft-seconds | 클라이언트 출력 버퍼가 임계값에 도달했을 때 제한 전까지 허용되는 시간 - 입력 범위: 0~2147483647- 0 설정 시 시간 제한 없음 | client-output-buffer-limit-normal-soft-limit 초과 상태가 설정 시간보다 길면 클라이언트 연결 해제 가능너무 낮은 값 설정 시 MemStore 서비스 프로비저닝 실패 가능 워크로드를 고려한 충분한 수치 또는 기본값( 0) 설정 권장 |
Replica 동기화 파라미터
| 파라미터 | 용도 | 수정 시 유의 사항 |
|---|---|---|
min-replicas-max-lag | Primary 노드가 허용하는 Replica 노드의 핑 수신 최대 지연 시간 - 입력 범위: 0~2147483647 | 설정 시간까지 Primary 노드가 핑을 수신하지 못하면 Replica 사용 불가 상태로 간주 서비스 안정성을 고려한 적절한 수치 설정 권장 |
min-replicas-to-write | Primary 노드가 쓰기 요청을 받기 위해 유지해야 하는 최소 Replica 개수 - 입력 범위: 0~2147483647 | 설정값만큼 Replica 노드가 확보되지 않으면 Primary 노드의 쓰기 요청 거부 클러스터의 실제 Replica 개수를 고려한 설정 필요 - 예: Replica 노드가 2개인 클러스터에서 5로 설정 시 NOREPLICAS 오류 발생 가능 |
백로그 버퍼 파라미터
| 파라미터 | 용도 | 수정 시 유의 사항 |
|---|---|---|
repl-backlog-size | Primary 노드가 Replica 노드와 데이터 동기화를 위해 사용하는 백로그 버퍼 크기 - 입력 범위: 16384~ | 복제 지연이 백로그 크기보다 크면 전체 동기화(full sync) 발생 너무 낮은 값 설정 시 전체 동기화 빈도 증가로 성능 또는 가용성 영향 가능 워크로드 요구 사항을 고려한 충분한 수치 설정 권장 |
repl-backlog-ttl | Primary 노드가 Replica 노드와 데이터 동기화를 위해 백로그 버퍼를 보관하는 주기 - 입력 범위: 0~2147483647- 0 설정 시 백로그 버퍼 유지 | 설정 시간 이후 백로그 데이터 해제로 전체 동기화(full sync) 발생 가능 너무 낮은 값 설정 시 전체 동기화 빈도 증가로 성능 또는 가용성 영향 가능 워크로드 요구 사항을 고려한 충분한 수치 설정 권장 |
클라이언트 연결 수 파라미터
| 파라미터 | 용도 | 수정 시 유의 사항 |
|---|---|---|
maxclients | 노드에 연결할 수 있는 최대 클라이언트 개수 - 입력 범위: 100~65000 | 워크로드 요구 사항보다 낮은 값 설정 시 클라이언트 커넥션 실패 가능 노드 Health check 불가로 Failover 발생 가능 노드 유형과 워크로드를 고려한 충분한 수치 설정 권장 |
파라미터 그룹 복사
커스텀 파라미터 그룹은 복사 기능을 제공하며 백업용으로 사용할 수 있습니다. 선택한 파라미터 그룹을 복사해 새로운 파라미터 그룹을 만듭니다.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 복사할 파라미터 그룹을 확인한 뒤 [⋮] 버튼 > 복사를 선택합니다.
- 파라미터 그룹 복사 팝업창에서 입력 정보를 확인한 후 [확인] 버튼을 클릭합니다.
- 커스텀 그룹 탭에서 복사된 파라미터 그룹을 확인합니다.
파라미터 그룹 초기값으로 재설정
커스텀 파라미터 그룹은 변경한 파라미터 값을 초기값으로 재설정할 수 있습니다. 초기값은 파라미터 그룹 생성 시 선택한 기본 파라미터 그룹의 기본값을 의미합니다. 초기값으로 재설정하면 연결된 클러스터 전체에 파라미터 변경이 일괄 적용됩니다.
- 연결된 클러스터의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터를 초기값으로 재설정할 수 없습니다.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 초기값으로 재설정할 파라미터 그룹을 확인한 뒤 [⋮] 버튼 > 파라미터 초기값으로 재설정을 선택합니다.
- 파라미터 초기값으로 재설정 팝업창에서 안내 사항을 확인한 후 [확인] 버튼을 클릭합니다.
클러스터에 연결된 파라미터 그룹이 복수 개인 경우, 파라미터 적용 방식을 선택할 수 있습니다.일괄반영: 수정된 파라미터를 모든 클러스터에 일괄 반영합니다.순차반영: 수정된 파라미터를 클러스터에 연속해서 반영합니다. 대기 중인 클러스터의 파라미터 반영 상태는Pending이 됩니다. - 연결된 클러스터가 있는 경우, 각 클러스터의 파라미터 반영 상태로 재설정이 잘 반영되었는지 확인합니다.
파라미터 그룹 롤백
커스텀 파라미터 그룹은 파라미터 값을 수정한 후 직전 값으로 변경할 수 있는 롤백 기능을 제공합니다. 파라미터 그룹은 직전 변경 이력이 있는 경우에만 롤백할 수 있습니다.
- 연결된 클러스터의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터 그룹을 롤백할 수 없습니다. - 롤백을 수행한 후에는 이미 직전의 수정 이력으로 변경되었기 때문에 더 이전의 수정 이력으로 롤백할 수 없습니다. 롤백 후 다시 파라미터를 수정하면 수정 이력이 생기므로 다시 롤백을 사용할 수 있습니다.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 롤백할 파라미터 그룹을 확인한 뒤 [⋮] 버튼 > 롤백을 선택합니다.
- 파라미터 그룹 롤백 팝업창에서 안내 사항을 확인하고, [확인] 버튼을 클릭합니다.
- 연결된 클러스터가 있는 경우, 각 클러스터의 파라미터 반영 상태로 롤백이 잘 반영되었는지 확인합니다.
파라미터 그룹 삭제
커스텀 파라미터 그룹을 더 이상 사용하지 않는 경우, 파라미터 그룹을 삭제할 수 있습니다.
- 기본 파라미터 그룹은 삭제할 수 없습니다.
- 연결된 클러스터가 있는 경우에는 파라미터 그룹을 삭제할 수 없습니다.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 삭제할 파라미터 그룹을 확인한 뒤 [⋮] 버튼 > 삭제를 선택합니다.
- 파라미터 그룹 삭제 팝업창에서 입력 정보를 작성한 후 [확인] 버튼을 클릭합니다.
- 커스텀 그룹 탭에서 파라미터 그룹이 삭제되었는지 확인합니다.
파라미터 그룹 반영 재시도
연결된 클러스터의 파라미터 반영 상태가 In-Sync가 아닌 Error-Sync, Suspended일 때만 파라미터 반영을 재시도할 수 있습니다.
파라미터 반영 상태에 대한 자세한 설명은 파라미터 반영 상태를 참고하세요.
- 카카오클라우드 콘솔 > Data Store > MemStore 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 선택한 탭에서 상세 정보를 조회할 파라미터 그룹을 선택합니다.
- 연결된 클러스터 탭으로 이동합니다.
- 재시도할 클러스터의 [재시도] 버튼을 클릭합니다.