파라미터 목록

파라미터 변경 주의 사항

카카오클라우드 MemStore에서 제공하는 파라미터 목록과 기본 개념은 Valkey, Redis OSS와 호환됩니다. 파라미터를 변경하면 MemStore 서비스 운영에 영향을 미칠 수 있으므로 변경 전에 각 파라미터의 용도와 설정값을 충분히 검토하시기 바랍니다. 자세한 내용은 Valkey 공식문서, Redis OSS 공식 문서를 참고하세요.

수정 시 주의해야 할 파라미터

일부 파라미터는 클라이언트 연결, Replica 동기화, 백로그 버퍼, 노드 상태에 영향을 줄 수 있습니다. 변경 전 클러스터 구성, Replica 개수, 워크로드를 확인하세요.

repl-backlog 파라미터

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 발생 가능 노드 유형과 워크로드를 고려한 충분한 수치 설정 권장