Memory Sidecar v3.5.1: 에이전트 불가지론적 메모리를 위한 운영 강화

Memory Sidecar는 분산된 에이전트 상호작용 뒤에서 항상 보이지 않는 일꾼 역할을 해왔습니다. 단일 AI 프레임워크에 결합되지 않고 에이전트 불가지론적 (Agent-agnostic) 메모리 지속성을 제공합니다. v3.5.1에서는 기능의 속도(feature velocity)에서 운영적 성숙도(operational maturity)로 초점이 이동합니다. hermes-memory-installer를 통해 제공되는 이번 릴리스는 대규모 프로덕션 환경에서 메모리 사이드카를 실행하는 팀들을 위해 특별히 설계되었습니다. 만약 당신이 메모리 레이어를 '애완동물(pet)'처럼 관리해 왔다면, 이제는 '가축(cattle)'처럼 관리해야 할 때입니다.

v3.5.1에서 변경된 사항

이번 업데이트는 새로운 기능의 추가가 아닙니다. 새로운 메모리 백엔드도, 화려한 압축 알고리즘도, API를 깨뜨리는 변경 사항도 없습니다. 대신, v3.5.1은 프로토타입과 서비스를 구분 짓는 세 가지 기둥인 리소스 거버넌스 (Resource governance), 결함 격리 (Fault isolation), 그리고 관찰 가능성 (Observability)의 고질적인 격차를 해소합니다.

더욱 엄격한 리소스 거버넌스 (Tighter Resource Governance)

메모리 사이드카는 대규모 벡터 임베딩 (Vector embeddings)이나 리플레이 버퍼 (Replay buffers)를 처리할 때 리소스를 많이 사용하는 것으로 악명이 높습니다. 이전 버전들은 제한 사항을 강제하기 위해 호스트 OS에 의존했으며, 이는 연쇄적인 OOM (Out of Memory) 킬로 이어졌습니다. v3.5.1에서는 hermes-memory-installer가 이제 cgroup v2 메모리 및 CPU 제한을 사이드카 프로세스에 직접 연결하는 systemd drop-in 유닛을 생성합니다. 설치 설정에서 상한선을 정의하면, 설치 프로그램은 단일 사이드카가 호스트나 인접한 컨테이너를 고갈시키지 않도록 보장합니다.

프로세스 수준의 격리 (Process-Level Isolation)

각 메모리 사이드카 인스턴스는 별도의 마운트(mount), PID, 네트워크 네임스페이스(namespace)를 포함하는 경량 네임스페이스인 자체 MemoryZone 내부에서 실행됩니다. 이를 통해 잘못된 메모리 작업이 파일 핸들을 유출하거나 동일한 노드에 있는 다른 사이드카를 방해하는 것을 방지합니다. 설치 프로그램은 네임스페이스 스캐폴딩(scaffolding)을 투명하게 설정합니다. 사이드카 자체는 할당된 리소스와 데이터 디렉토리만을 볼 수 있습니다.

회복 탄력성이 있는 I/O 경로 (Resilient I/O Paths)

이전 버전에서는 전송 중 실패한 메모리 쓰기(Memory writes)가 조용히 누락되었습니다. v3.5.1에서는 구성 가능한 내구성을 가진 내부 쓰기 전용 로그 (Write-Ahead Log, WAL)를 도입합니다. 백엔드 저장소 (PostgreSQL, S3 또는 로컬 디스크)를 사용할 수 없게 되면, WAL이 대기 중인 변이(mutations)를 버퍼링하고 연결이 복구되면 이를 다시 재생(replay)합니다. 설치 프로그램은 배포 중에 --wal-mode (memory, disk 또는 sync)를 노출합니다.

비대해지지 않는 관측성 (Observability Without Bloat)

구조화된 JSON 로깅이 이제 기본값이며, 모든 메모리 읽기/쓰기 작업에 대해 선택적으로 OpenTelemetry 트레이스 전파 (trace propagation)를 지원합니다. 사이드카는 9610 포트의 /metrics에 있는 전용 엔드포인트로 메트릭 (memory_sidecar_*)을 내보냅니다. 설치 프로그램은 내장된 서비스 검색 (service discovery)을 사용할 때 사이드카 Prometheus 스크랩 대상 (scrape target)을 자동으로 구성할 수 있습니다.

간단한 코드 예시: 리소스 제한 구성하기

무거운 대화형 에이전트를 위한 사이드카 인스턴스를 배포한다고 가정해 보겠습니다. hermes-memory-installer는 YAML 프로필을 읽습니다:

# memory-sidecar-profile.yaml
instance:
  name: "chat-agent-mem"
...

설치 프로그램을 실행합니다:

hermes-memory-installer apply --profile memory-sidecar-profile.yaml

설치 프로그램은 프로필을 검증하고, 지정된 메모리 및 CPU 제한이 포함된 systemd 서비스 파일을 생성하며, 자체 MemoryZone 내에서 사이드카를 시작하고, 만약 metrics: true인 경우 /metrics 엔드포인트를 노출합니다. 사이드카가 memory_max를 초과하려는 모든 시도는 즉각적인 cgroup OOM kill을 유발하며, systemd 유닛은 구성 가능한 백오프 (backoff)와 함께 이를 재시작합니다.

이것이 운영 환경에서 중요한 이유

에이전트 불가지론적 메모리 (Agent-agnostic memory)는 시스템이 계속 가동되고 예측 가능할 때만 작동합니다. v3.5.1은 가장 흔한 세 가지 실패 모드인 제약 없는 리소스 소비, 인스턴스 간 오염, 그리고 일시적인 스토리지 중단 중 발생하는 조용한 데이터 손실을 제거합니다. 이제 hermes-memory-installer는 배포 도구이자 거버넌스 계층 (governance layer)으로서 작동하며, 단 하나의 사이드카를 실행하든 천 개를 실행하든 동일한 강화 패턴 (hardening patterns)을 적용합니다.

이전 릴리스에서 마이그레이션하는 경우, 설치 프로그램이 인플레이스 (in-place) 업그레이드를 처리합니다. 즉, 기존의 systemd 유닛을 감지하고, 리소스 경계 (resource boundaries)를 업데이트하며, 우아한 재시작 (graceful restart)을 수행합니다. 데이터 마이그레이션 스크립트나 수동 정리 작업은 필요하지 않습니다.

핵심 요약 (The Bottom Line)

v3.5.1은 의도적으로 지루한 릴리스이며, 그것이 바로 이 버전의 강점입니다. 이 버전은 장기적인 운영을 위해 Memory Sidecar를 더욱 견고하게 만듭니다. 안정성 문제로 인해 에이전트-메모리 레이어 (agent-memory layer)의 프로덕션 도입을 미뤄왔다면, 바로 지금이 적기입니다. hermes-memory-installer가 상용구 (boilerplate) 작업을 처리할 것입니다. 여러분은 실제로 기억할 수 있는 에이전트를 구축하는 데에만 집중하면 됩니다.

hermes-memory-installer CLI를 통해 업그레이드하세요. 전체 변경 로그 (changelog)는 docs.hermes-memory.dev에서 확인할 수 있습니다.