Memory Sidecar v3.5.1이 출시되었습니다. 이번 릴리스의 핵심은 운영 강화 (operational hardening)입니다. 이번 버전은 프로덕션 환경에서 사이드카 (sidecar)의 동작을 강화하여, 분산 메모리 시스템 (distributed memory systems)을 괴롭히는 엣지 케이스 (edge cases)들을 제거합니다. 공유 메모리 레이어 (shared memory layer)에서 에이전트 (agents)를 실행 중이라면, 바로 이 버전을 기다려 오셨을 것입니다. 이번 업데이트의 초점은 순수하게 신뢰성, 보안, 그리고 성능에 맞춰져 있으며, 새로운 API나 기능 비대화 (feature bloat)는 포함되지 않았습니다.

문맥을 설명하자면, Memory Sidecar는 지속 가능한 에이전트 불가지론적 (agent-agnostic) 메모리 저장소를 제공합니다. 이는 별도의 프로세스로 실행되어 메모리를 에이전트 런타임 (agent runtime)으로부터 분리합니다. v3.5.1은 첫 번째 전용 강화 릴리스이며, 실제 배포 환경에서 목격된 고충들인 부하 상황에서의 데이터 손상 (data corruption), 경합 조건 (race conditions), 그리고 설정 드리프트 (configuration drift) 문제를 해결합니다.

데이터 무결성 및 복구 (Data Integrity and Recovery)

핵심적인 변화는 개편된 쓰기 앞선 로그 (write-ahead log, WAL)입니다. 이전에는 충돌 복구 (crash recovery)가 최선 노력 방식의 재생 (best-effort replay)에 의존했습니다. v3.5.1에서는 모든 WAL 엔트리에 체크섬 (checksum)과 단조 증가 시퀀스 번호 (monotonic sequence number)가 포함됩니다. 만약 사이드카가 쓰기 도중에 충돌하면, 검증된 엔트리만 재생하고 불완전한 쓰기는 폐기합니다. 이를 통해 동시 에이전트 쓰기 시 빈번하게 발생하는 문제인 무음 손상 (silent corruption)을 제거합니다. 또한, 이제 오래된 엔트리의 설정 가능한 비율에 따라 자동 압축 (automatic compaction)이 트리거되어, 수동 개입 없이도 디스크 비대화 (disk bloat)를 줄여줍니다.

동시성 안전성 (Concurrency Safety)

동일한 메모리 네임스페이스 (memory namespace)에 대한 멀티 에이전트 접근은 과거에 경합의 원인이었습니다. v3.5.1은 거친 입도 잠금 (coarse-grained locks)을 샤딩된 잠금 관리자 (sharded lock manager)로 교체합니다. 각 메모리 키는 하나의 샤드 (shard)에 속하며, 서로 다른 샤드에 대한 작업은 병렬로 진행됩니다. 50개의 동시 에이전트를 대상으로 한 스트레스 테스트에서, 이는 v3.4.x 대비 꼬리 지연 시간 (tail latency)을 35% 감소시켰습니다. 잠금 관리자는 또한 핫 키 (hot keys)에 대해 적응형 백오프 (adaptive backoff)를 구현합니다. 특정 키에 경합이 발생하면, 사이드카는 무한 루프를 도는 대신 자동으로 재시도를 큐에 넣습니다.

보안 강화 (Security Hardening)

모든 클라이언트 연결에 대해 TLS 1.3 사용이 이제 필수 사항입니다. 사이드카는 유효한 인증서 번들 (certificate bundle)이 존재하지 않으면 시작을 거부합니다. 설치 프로그램(installer)은 이 과정을 간소화합니다: hermes-memory-installer는 설정 중에 자체 서명된 인증서 (self-signed certificates)를 생성하고 24시간마다 이를 교체(rotate)합니다. 운영 환경(production)의 경우, 환경 변수를 통해 자체 CA 서명 인증서를 주입할 수 있습니다. 전송 중 암호화 (In-transit encryption)에는 AES-256-GCM을 사용하지만, 진짜 중요한 소식은 저장 시 암호화 (at-rest encryption)입니다. 이제 메모리 스냅샷 (memory snapshots)은 사이드카의 ID 토큰 (identity token)에서 파생된 키로 암호화됩니다. 이는 디스크 볼륨이 회수(scavenged)되더라도 데이터 유출을 방지합니다.

성능 최적화 (Performance Optimizations)

내부 동작을 위해 직렬화 계층 (serialization layer)이 JSON에서 MessagePack으로 전환되었습니다. 이를 통해 페이로드 (payload) 크기가 거의 50% 감소하고 역직렬화 (deserialization) 오버헤드가 줄어듭니다. 방출 정책 (eviction policy) 또한 개선되었습니다. LRU는 이제 대부분의 작업에 대해 O(1) 액세스를 지원하는 동시 해시 맵 (concurrent hash map)을 기반으로 작동합니다. 또한 세대별 캐시 (generational cache)를 추가했습니다. 자주 액세스되는 키는 압축 (compaction) 사이클에서 더 오래 살아남아, 핫 데이터 (hot data)에 대한 히트율 (hit rates)을 향상시킵니다. 일반적인 에이전트 워크로드로 벤치마킹한 결과, 읽기 작업의 p99 지연 시간 (latency)이 40% 감소한 것으로 나타났습니다.

hermes-memory-installer를 통한 설치

hermes-memory-installer 패키지는 v3.5.1을 배포하기 위한 권장 경로입니다. 이 패키지는 바이너리 다운로드, 체크섬 검증 (checksum verification), 그리고 구성 스캐폴딩 (configuration scaffolding)을 처리합니다. 최소 설정 방법은 다음과 같습니다:

npm install -g hermes-memory-installer
hermes memory install --version 3.5.1 --config /etc/hermes/sidecar.yaml

설치 프로그램은 TLS 활성화, /var/lib/hermes/wal 내의 WAL(Write-Ahead Logging) 저장, 9090 포트로 노출되는 메트릭 (metrics) 등 합리적인 기본값이 포함된 설정 파일을 생성합니다. v3.4.x에서 업그레이드하려면 다음을 사용하세요:

hermes memory upgrade --version 3.5.1

이 명령은 필요한 모든 데이터베이스 마이그레이션 (database migrations)을 자동으로 실행합니다. v3.5.1에서는 기존의 파일 백엔드 (file backend)가 RocksDB로 대체되어 지원 중단 (deprecates)된다는 점에 유의하세요. 기존 저장소가 파일 백엔드를 사용 중인 경우, 업그레이드 명령이 백그라운드 마이그레이션을 시작합니다. 대규모 저장소 (50 GB 초과)의 경우, 마이그레이션은 원자적 (atomic)으로 수행되지만 속도가 느릴 수 있으므로 어느 정도의 다운타임 (downtime)을 고려해야 합니다.

숙련된 개발자가 주의해야 할 사항

/v1/metrics에 있는 새로운 헬스 엔드포인트 (health endpoint)는 히트율 (hit rate), 지연 시간 (latency) p50/p99, 컴팩션 (compaction) 진행 상황, 활성 WAL 크기 등 Prometheus 호환 통계 데이터를 노출합니다. 이를 즉시 알림 (alerting) 시스템에 연결하세요. 또한, memory.eviction.generational 설정 옵션이 기본적으로 활성화되어 있습니다. 액세스 패턴 (access pattern)이 극도로 균일하다면 (핫 키가 없다면), 메모리 사용량이 약간 더 높아질 수 있습니다. 필요한 경우 memory.eviction.generational.ttl을 통해 조정하십시오.

하나의 중대한 변경 사항 (breaking change): 설정 파일의 backend 필드 값으로 이제 rocksdb가 필수적으로 요구됩니다. 업그레이드하기 전에 설정 파일에서 file에 대한 모든 참조를 제거하십시오. 설치 프로그램이 이를 감지하여 경고를 표시하지만, 수동으로 확인하는 것이 좋습니다.

Memory Sidecar v3.5.1은 성숙하고 운영 환경에 최적화된 (production-hardened) 릴리스입니다. 운영 안정성에 초점을 맞추어 에이전트 불가지론적 (agent-agnostic) 메모리를 위한 견고한 기반을 제공합니다. hermes-memory-installer를 통해 배포하고, 설정을 고정하여 에이전트가 예기치 않은 상황 없이 작동하도록 하세요.