여러분의 Solana 앱을 더 빠르게: gRPC 데이터양, 수신 처리, 실행 환경 살펴보기

개발 중인 Solana 앱은 더 빠르게 동작할 가능성이 있습니다. 수신하는 데이터양, 그 뒤의 처리 흐름, CPU와 네트워크 같은 실행 자원이 함께 성능에 영향을 줍니다. 이 조합을 살펴보면 기존 소프트웨어의 성능을 더 끌어낼 여지를 찾아볼 수 있습니다.
Solana에서 HFT 개발을 시작하고 Geyser gRPC에 연결했으며 로그에서도 데이터를 확인할 수 있습니다. 그런데 판단 속도는 기대에 미치지 못합니다. 수신부터 판단까지 생기는 대기 시간은 개선할 지점을 찾는 단서가 됩니다. 먼저 현재 코드에서 관측할 수 있는 위치를 찾아보세요.
ERPC도 고객과의 상담과 피드백을 통해 데이터 전달, 수신 설정, 애플리케이션의 처리 흐름을 함께 살펴볼 기회를 얻고 있습니다. 여기서 얻은 관점은 전달 서비스와 문서 개선에 반영됩니다. 이 글에서는 빠르고 많은 데이터가 흐르는 스트림을 처음 다루는 개발자가 자신의 환경에서 개선할 여지를 찾을 수 있도록 원리와 조사 방법을 소개합니다.
현재 코드에서 작은 확인 하나부터 시작하기
전문 용어와 진단 명령은 필요해질 때 찾아보면 됩니다. 프로젝트 코드를 읽을 수 있는 AI 에이전트가 있다면 먼저 아래의 짧은 요청문을 전달해 보세요. 앱의 실행 위치와 언제 느리다고 느끼는지를 덧붙이면 됩니다. 아직 정하지 않은 요구사항이나 얻을 수 없는 측정값은 그대로 두고 시작할 수 있습니다.
text
제 Solana 앱의 응답 속도를 더 높일 여지가 있는지 알아보고 싶습니다.
먼저 현재 코드를 읽고 데이터를 받는 지점과 그 데이터를 사용하는 판단이 완료되는 지점을 찾아주세요. 구독 조건을 유지하면서 그 구간의 이벤트 수와 경과 시간을 측정할 수 있는 최소한의 변경안을 제시해주세요.
이번에는 측정 위치, 변경안, 이를 통해 알 수 있는 것과 아직 측정하지 못하는 것을 보여주는 데까지 진행해주세요. 호스트에 접근할 수 없다면 앱 안에서 관측할 수 있는 범위부터 시작해주세요. 비밀 정보를 표시하거나 운영 환경을 변경하거나 유료 자원을 생성하지 마세요.제 Solana 앱의 응답 속도를 더 높일 여지가 있는지 알아보고 싶습니다.
먼저 현재 코드를 읽고 데이터를 받는 지점과 그 데이터를 사용하는 판단이 완료되는 지점을 찾아주세요. 구독 조건을 유지하면서 그 구간의 이벤트 수와 경과 시간을 측정할 수 있는 최소한의 변경안을 제시해주세요.
이번에는 측정 위치, 변경안, 이를 통해 알 수 있는 것과 아직 측정하지 못하는 것을 보여주는 데까지 진행해주세요. 호스트에 접근할 수 없다면 앱 안에서 관측할 수 있는 범위부터 시작해주세요. 비밀 정보를 표시하거나 운영 환경을 변경하거나 유료 자원을 생성하지 마세요.첫 조사에서 얻고 싶은 결과는 내 코드의 어디서 무엇을 측정하면 되는지 아는 것입니다. 관측할 수 있는 구간과 미측정 구간을 나누면 다음 조사 대상을 고르기 쉬워집니다. 더 자세히 원인을 좁힐 때 사용할 상세 프롬프트도 글 뒤쪽에 준비했습니다.
예를 들어 에이전트는 이렇게 답할 수 있습니다. “수신은
stream.ts의 onData에서, 판단 완료는 strategy.ts의 onDecisionComplete에서 이루어집니다. 수신한 이벤트 수, 완료된 판단 수와 이 구간의 경과 시간을 집계하는 변경을 제안합니다. 이 측정안에서 콜백 이전 구간은 측정 범위에 포함되지 않습니다.” 가상의 TypeScript 파일명과 함수명을 사용한 응답 예시입니다. 사용하는 프로그래밍 언어에 관계없이 실제 코드의 위치, 추가할 기록, 이번 측정으로 알 수 없는 범위, 이 세 가지가 서로 맞는지 확인해 보세요. 수신과 판단이 일대일 관계가 아니라면 대응 관계와 집계 단위도 에이전트에게 제안해 달라고 요청하세요.Web 개발 경험에 스트림을 보는 관점 더하기
관리형 서비스를 이용하면 개별 서버 구성 요소를 자세히 의식하지 않고도 여러 Web 기능을 만들 수 있습니다. 그 경험은 Solana 스트림을 다룰 때도 토대가 됩니다. 여기에 데이터가 계속 얼마나 들어오는지, 앱은 얼마나 빠르게 처리하는지를 보는 관점을 더해봅니다.
SDK로 Solana에 연결하는 일도 비슷하게 간단해 보입니다. 하지만 광범위한 트랜잭션이나 계정 업데이트를 구독하면 작업량이 달라집니다. 필요한 대역폭, CPU, 메모리는 구독 범위, 메시지 크기, 압축, 애플리케이션 처리 내용, 당시 트래픽에 따라 달라집니다. “Solana는 초당 몇 MB”라는 하나의 고정값은 없습니다.
들어오는 작업과 처리 능력 사이의 관계를 설계하고 측정하는 대상으로 삼는 것이 출발점입니다.
데이터가 흘러도 대기열은 계속 쌓일 수 있습니다
먼저 크기가 같은 네모로 동일한 1초 동안 들어오는 데이터양을 비교해 보세요. 네모 하나는 메시지 1,000개이며, 메시지당 1 kB로 가정하면 총 1 MB입니다. 적게 받는 예에서는 초당 2 MB, 많이 받는 예에서는 초당 12 MB가 들어오며 두 예에서 수신 앱의 처리 능력은 같습니다. 이는 메시지 페이로드의 양을 10진 단위로 나타낸 설명용 모델로, 압축과 프로토콜 헤더는 포함하지 않습니다.

설명을 위한 모델을 생각해 보겠습니다. 초당 12,000개의 이벤트가 도착하고, 컴퓨터는 초당 10,000개를 처리합니다. 이벤트마다 필요한 작업량은 같고, 처음 대기열은 비어 있으며, 도착 순서대로 처리하고 아무 이벤트도 버리지 않는다고 가정합니다.
매초 2,000개의 미처리 이벤트가 추가됩니다. 10초 뒤에는 20,000개의 이벤트가 기다립니다. 이 시점에 새로 대기열에 들어온 이벤트는 처리가 시작되기까지 약 2초를 기다립니다. 로그는 계속 움직이지만 대기열도 계속 길어집니다.
이 수치는 설명을 위한 가정이며 Solana나 ERPC의 실측 결과가 아닙니다. 모델은 유입량과 처리 능력이 일정하다고 가정합니다. 실제 트래픽은 순간적으로 몰리고 이벤트별 처리 비용도 달라지므로, 평균 처리 능력이 충분해도 대기가 발생할 수 있습니다.
gRPC 흐름 제어는 수신 측이 받아들일 수 있는 양에 맞춰 전송을 조절합니다. 처리가 뒤처지면 애플리케이션 대기열을 넘어 통신 라이브러리나 송신 측까지 대기가 이어질 수 있습니다. 연결이 살아 있거나 전송 API에 쓰기가 성공했다고 해서 도착한 데이터가 얼마나 최신인지는 알 수 없습니다.[1]
데이터가 네트워크를 지나기 전에 필요한 것 선택하기
판단에 특정 프로그램이나 계정 정보만 필요하다면, 먼저 필요한 데이터를 정의하고 서버 측 구독 필터를 적용하세요. Yellowstone gRPC는 트랜잭션과 계정 필터를 지원합니다. 구체적인 조건 조합과 이용 가능한 범위는 사용하는 API, SDK, 서비스의 명세에서 확인해야 합니다.[2]
무엇을 걸러야 할지 모르겠다면, 앱이 판단에 사용하는 값과 그 값을 제공하는 알림 필드를 코드에서 정리해 보세요. 그 대응 관계를 바탕으로 구독 조건 후보를 만들고, 이미 알고 있는 필수 이벤트가 포함되는지 검증합니다. 이벤트 수가 줄었는지와 필요한 데이터가 유지되는지를 함께 확인하면 다음 비교를 진행할 근거가 생깁니다.
모든 데이터를 받은 뒤 클라이언트에서 불필요한 부분을 버리더라도, 그때까지의 전송, 복호화, 디코딩 작업은 이미 발생했습니다. 송신 측에서 범위를 좁히면 이 작업량부터 줄일 수 있습니다. 앞의 예에서 입력을 필요한 초당 2,000개로 줄이면, 동일한 초당 10,000개의 처리 능력에 여유가 생깁니다.

교통에 비유하면 도로 길이는 전파 거리, 차선 수는 대역폭, 요금소의 처리 능력은 수신 처리 능력, 늘어선 차량은 대기 중인 작업입니다. 같은 요금소에 필요한 차량만 보내는 경우와 주변의 모든 차량을 몰아넣는 경우에는 줄이 쌓이는 방식이 달라집니다. 도로를 짧게 만드는 것과 차량 수를 줄이는 것은 서로 다른 개선입니다.
통신에도 물리적 하한이 있습니다. 100 MB를 1 Gbps로 전송하는 데는 이론상 최소 0.8초가 걸리며, 10 Gbps라면 0.08초가 걸립니다. 십진 단위로 계산한 하한이며, 거리, 프로토콜 오버헤드, 재전송, 대기 중인 작업은 포함하지 않습니다. 스트림의 모든 개별 이벤트가 일률적으로 0.8초 지연된다는 뜻도 아닙니다.
한 번의 계산이 네트워크 통신보다 빠르더라도, 불필요한 데이터를 전송하는 비용이 사라지지는 않습니다. 전파 시간, 단위 시간에 링크를 통과할 수 있는 양, 도착 후 완료할 수 있는 작업량을 각각 고려해야 합니다.
전체 인덱스, 감사, 연구처럼 모든 데이터가 필요한 애플리케이션도 있습니다. 이런 경우에는 해당 작업량에 맞는 수신, 처리, 저장 능력이 필요합니다. 모든 개별 알림을 받는 것과 전체 블록, 즉 블록 단위로 집계·재구성된 데이터를 기다리는 것 역시 다릅니다. 판단에 불필요한 데이터나 집계 완료가 전제 조건으로 들어가 있지는 않은지 확인하세요.[2]
수신 처리와 실행 환경 살펴보기
Rust는 처리 비용을 줄이는 데 도움이 됩니다. 그 속도를 활용하려면 들어오는 데이터양, 회선의 실효 대역폭, 데이터베이스 쓰기를 기다리는 시간, 잠금과 직렬 처리 구간도 함께 살펴봅니다. 비동기 런타임에서는 CPU를 오래 사용하는 작업과 스레드를 막는 작업을 적절한 실행 위치에 배치하는 것도 앱 개선에 도움이 됩니다.[3]
수신 루프는 짧게 유지하고 비용이 큰 작업은 분리하세요. 대기열의 상한과 가득 찼을 때의 동작도 정해야 합니다. 무제한 대기열은 커지는 지연을 늘어나는 메모리 사용량 속에 숨길 수 있습니다. 상한이 있는 대기열도 지속적인 처리 능력 부족 자체를 해결하지는 못합니다. 필요한 순서와 완전성을 유지하면서 구독 범위 축소, 처리 효율 개선, 분할, 병렬화, 자원 증설을 선택해야 합니다.
먼저 수신부터 판단 완료까지 측정하고, 대기가 나타나는 위치부터 자세히 조사합니다. 다음 표는 각 영역을 처음 살펴보는 방법입니다. 상세 지표 이름과 명령은 뒤의 진단 프롬프트에도 정리했으므로 관련된 항목부터 활용할 수 있습니다.
| 자원 | 먼저 확인할 것 |
|---|---|
| CPU | 작업이 한 코어에 집중되어 있나요? 전체와 코어별 사용률, 실행 환경의 CPU 제한을 확인합니다 |
| 메모리 | 처리 대기 이벤트나 메모리 사용량이 계속 늘어나나요? 대기 중인 데이터양과 가장 오래된 이벤트의 대기 시간을 함께 봅니다 |
| 디스크·데이터베이스 | 수신 처리가 저장 완료를 기다리고 있나요? 데이터베이스 쓰기와 저장 대기 시간을 확인합니다. 데이터를 저장하지 않는 앱이라면 다른 영역부터 살펴볼 수 있습니다 |
| 네트워크 | 회선과 설정이 들어오는 데이터양에 맞나요? 실제 전송량, 왕복 시간, 재전송을 확인합니다 |
통신을 더 자세히 조사할 때는 라이브러리 설정도 단서가 됩니다. HTTP/2에는 스트림과 연결 각각에 flow-control window가 있으며, 상대가 추가로 보낼 수 있는 데이터양을 조절합니다. 이 허용량이 대역폭과 왕복 시간의 곱인 대역폭 지연 곱에 비해 작으면 회선에 여유가 있어도 처리량이 한계에 도달할 수 있습니다. 해당하는 상황에서는 라이브러리와 중간 장치를 살펴보고, 설정의 적용 범위와 메모리 비용을 확인하며 조정합니다.[4]
수신량과 함께 최신성과 대기 시간도 측정하세요
먼저 애플리케이션 내부의 적체를 확인하려면 현재 구독을 유지한 채 같은 관측 기간 동안 수신 이벤트 수, 처리 완료 이벤트 수, 대기 이벤트 수, 가장 오래된 이벤트의 대기 시간을 기록하세요. 어디서 측정해야 할지 모르겠다면 아래 프롬프트로 에이전트에게 코드를 조사하게 할 수 있습니다. 명시적인 대기열이 없다면 수신부터 판단 완료까지의 시간을 측정하고, 무거운 처리를 뺀 진단용 구성과 비교하는 것부터 시작하세요.
다음은 언어나 SDK에 의존하지 않는 의사 코드로, 측정 위치를 보여줍니다. 실제 코드에 계측을 추가할 때는 현재의 처리 순서와 동시 처리 방식을 유지합니다.
text
데이터를 수신했을 때:
수신 이벤트 수를 1 증가시킨다
해당 이벤트와 연결된 수신 시각을 단조 시계로 기록한다
기존 처리 흐름으로 전달한다
같은 이벤트를 사용하는 판단이 완료되었을 때:
완료 이벤트 수를 1 증가시킨다
수신부터 경과한 시간을 계산하고 집계한다데이터를 수신했을 때:
수신 이벤트 수를 1 증가시킨다
해당 이벤트와 연결된 수신 시각을 단조 시계로 기록한다
기존 처리 흐름으로 전달한다
같은 이벤트를 사용하는 판단이 완료되었을 때:
완료 이벤트 수를 1 증가시킨다
수신부터 경과한 시간을 계산하고 집계한다수신과 판단이 일대일로 대응하지 않는다면 먼저 그 관계와 집계 단위를 정합니다. 일정한 시간 간격으로 관측 결과를 요약하면 이벤트마다 로그를 추가하지 않고도 결과를 비교할 수 있습니다.
추가로 원인을 구분할 때는 수신 바이트 수, 대기열 바이트 수, 처리 시간 p50/p95/p99, 오류와 재연결도 기록하세요. p99는 측정한 처리 시간의 99%가 그 값 이하에 해당하는 경계값입니다. 각 지표의 측정 위치도 명시해야 합니다. NIC 트래픽, Protobuf 크기, 디코딩한 객체의 크기는 서로 다른 양입니다.
같은 호스트 안의 경과 시간에는 단조 시계를 사용하고, 수신, 대기열 삽입, 꺼내기, 처리 완료를 구분하세요. SDK 콜백 실행 시점에 이미 디코딩이 끝났다면 콜백 이전 구간은 측정되지 않은 것입니다. 송신 측 타임스탬프와 비교할 때는 시계 동기화와 타임스탬프 생성 위치를 확인하세요. 그 차이를 그대로 순수한 네트워크 지연이라고 부르면 안 됩니다.
구독을 바꾸지 않고 업무 처리를 뺐을 때 대기가 줄어든다면, 해당 처리를 추가한 영향을 조사할 단서가 됩니다. 다만 콜백 이후의 처리가 빠르다는 사실만으로 도착한 데이터가 최신이라고 증명할 수는 없습니다.
동일한 구독 조건과 commitment(사용하는 데이터의 확인 단계)를 사용하는 참조 스트림과 이벤트 식별자를 비교할 수도 있습니다. 참조 스트림 자체에 적체가 쌓이고 있지 않은지도 확인하세요. slot 차이만으로 데이터 누락을 입증하거나 고정된 초 단위 시간으로 환산할 수는 없습니다. 일치하는 이벤트가 없는 slot도 있고, slot 자체가 건너뛰어질 수도 있기 때문입니다.[5]
mtr은 경로의 지연과 응답 양상을 조사하는 데 도움이 됩니다. 중간 hop에서만 나타나는 손실은 라우터가 자신의 응답을 제한하기 때문일 수도 있습니다. 목적지까지 이어지는 양상을 TCP 재전송, 실효 전송률, 다른 경로와 함께 비교해야 합니다. mtr만으로 대역폭 부족이나 데이터센터 장애를 확정할 수는 없습니다.[6]
AI 에이전트에 전달할 진단 프롬프트
프로젝트의 코드를 읽을 수 있는 에이전트에 다음 내용을 전달하세요. 먼저 실행 위치와 어떤 상황에서 무엇이 느리게 느껴지는지 설명하면 됩니다. 연결, 구독, 수신 이후 처리는 에이전트가 우선 코드에서 조사할 수 있습니다. API 키나 인증 정보를 대화에 붙여 넣을 필요는 없습니다.
필요한 이벤트나 허용 지연을 아직 정하지 못했다면 미정이라고 알려도 됩니다. 어떤 정보를 보고 무엇을 판단하려는지 자신의 말로 설명하세요. 얻을 수 없는 측정값은 미측정으로 남겨 두고, 지금 확인할 수 있는 부분부터 시작하세요.
text
제 Solana Geyser gRPC 클라이언트의 응답 속도를 더 높일 여지가 있는지 조사해주세요. 지연, 적체, 연결 끊김이 있다면 원인을 구분하고 개선을 도와주세요. 연결 성공이나 이벤트가 보이는 로그만으로 최신 데이터를 처리하고 있다고 판단하지 마세요. 원인이 클라이언트 또는 제공자 중 어느 쪽인지도 미리 단정하지 마세요.
1. 목표를 확인하세요. 필요한 이벤트, 허용 가능한 데이터 최신성, 순서와 손실에 관한 요구사항, 구독 필터, commitment, 엔드포인트 리전, 실제 언어/SDK/gRPC 라이브러리 버전, 실행 환경을 정리하세요. 접근 가능한 코드, 설정, lockfile부터 확인하고 부족한 정보만 질문하세요. 미정인 요구사항은 미정으로 명시하고, 먼저 현재 상태를 조사하세요. 비밀 정보를 표시하지 말고 공유 로그에서는 민감한 내용을 가리세요.
2. 수신부터 완료까지 측정하세요. 먼저 수신, 처리 완료, 대기 시간을 우선하며 측정 가능한 부분부터 시작하세요. 이벤트/초, 바이트/초, 완료 이벤트/초, 대기열 개수/바이트/가장 오래된 이벤트의 대기 시간, p50/p95/p99, 오류, 연결 끊김, 재연결, 드롭을 기록하세요. 명시적인 대기열이 없다면 그 사실과 관측할 수 있는 처리 구간을 밝히세요. 관측 위치와 측정하지 못한 구간을 명시하세요. NIC 트래픽, 전송선상의 바이트, Protobuf 크기, 디코딩한 객체를 구분하세요. 호스트 내부 경과 시간에는 단조 시계를 사용하고, 외부 시각은 동기화와 타임스탬프 생성 위치를 확인하세요. slot 차이를 바로 데이터 손실이나 고정된 시간으로 환산하지 마세요.
3. CPU, 메모리, 디스크, 네트워크 제약을 분리하세요. 코어/스레드별 CPU, steal과 CPU 제한, RSS/GC/swap/PSI, I/O 대기, NIC 바이트/드롭/오류, TCP 재전송과 RTT를 확인하세요. Linux 도구로는 mpstat, pidstat, vmstat, iostat, sar, ss -ti, /proc/pressure/ 등을 사용할 수 있습니다. 도구나 권한이 없으면 그 사실을 알리고 필요한 최소 명령을 제시하세요. 호스트에 접근할 수 없다면 관리 콘솔이나 애플리케이션 내부 계측에서 얻을 수 있는 정보를 찾고, 얻을 수 없는 항목은 미측정으로 표시하세요. 결과를 만들어 내지 마세요.
4. HTTP/2의 스트림·연결 윈도, TCP 수신 버퍼, 프록시, VPN, sidecar를 확인하세요. 설치된 SDK 버전의 공식 문서를 확인하고 대역폭 지연 곱을 고려하세요. 수신 루프와 주변의 JSON 변환, 이벤트마다 남기는 로그, 동기식 데이터베이스/외부 API 호출, 블로킹 작업, 잠금, 무제한 작업 생성과 무제한 대기열을 점검하세요. Rust나 비동기 코드 자체를 해결책으로 간주하지 마세요.
5. mtr 또는 동등한 도구를 사용할 수 있다면 실제 엔드포인트 호스트를 대상으로 유한한 횟수의 측정을 하세요. 지원되는 시스템에서는 다음을 고려할 수 있습니다: mtr --tcp --port <PORT> --report --report-cycles 30 <HOST>. 일반적인 TLS 포트를 가정하지 말고 실제 포트를 사용하세요. 중간 hop의 손실만으로 장애라고 단정하지 말고 목적지의 동작, 재전송, 다른 경로와 비교하세요. mtr을 대역폭 측정의 대용으로 사용하지 마세요.
6. 현재 구독 조건에서 기준값을 기록하고 한 번에 하나의 변수만 바꾸세요. 최소 수신 경로와 업무 처리를 포함한 파이프라인을 비교할 때는 같은 구독을 유지하세요. 필터 변경은 별도의 비교로 다루세요. 구독을 좁히기 전에 판단에 쓰는 입력값과 알림의 대응 관계를 확인하고, 후보 필터가 이미 알고 있는 필수 이벤트를 포함하는지 검증하세요. 필요한 순서와 완전성을 유지하는 상한 있는 대기열과 병렬 처리를 설계하고, 넘쳤을 때의 동작을 명시하세요. 필요한 데이터를 임의로 버리지 마세요. 오류 상세와 재시도 시점을 저장하고, 정해진 중지 기간에는 재연결하지 마세요.
7. 관측 사실, 원인 후보, 검증하지 않은 가설, 검토 가능한 변경 사항, 변경 전후의 측정값을 나누어 보고하세요. 필요한 CPU, RAM, 대역폭, 저장 성능, 배치 위치를 구독과 실측을 바탕으로 산정하고 피크에 대비한 여유를 포함하세요. 모든 Solana 환경에 적용되는 고정 하드웨어 요구사항을 만들어 내지 마세요. 필요하면 동일한 구독, SDK, commitment로 다른 머신/데이터센터를 비교하는 계획을 제안하세요.
ERPC를 사용하고 있다면 현재 gRPC FAQ를 읽고 정확한 오류 코드에 해당하는 지침을 따르세요:
https://erpc.global/en/faq/grpc/general/
ERPC User MCP나 CLI가 연결되어 있다면 실제 이용 가능한 작업과 권한을 확인하세요. 계정 접근 권한이 있다고 해서 호스트를 진단할 수 있는 것은 아닙니다. 유료 VPS 생성, 계약 변경, 운영 환경 업데이트나 재시작 전에는 비용, 목적, 테스트 시간을 제시하고 내 승인을 받으세요. 먼저 진단과 검토 가능한 개선안을 완성하세요.제 Solana Geyser gRPC 클라이언트의 응답 속도를 더 높일 여지가 있는지 조사해주세요. 지연, 적체, 연결 끊김이 있다면 원인을 구분하고 개선을 도와주세요. 연결 성공이나 이벤트가 보이는 로그만으로 최신 데이터를 처리하고 있다고 판단하지 마세요. 원인이 클라이언트 또는 제공자 중 어느 쪽인지도 미리 단정하지 마세요.
1. 목표를 확인하세요. 필요한 이벤트, 허용 가능한 데이터 최신성, 순서와 손실에 관한 요구사항, 구독 필터, commitment, 엔드포인트 리전, 실제 언어/SDK/gRPC 라이브러리 버전, 실행 환경을 정리하세요. 접근 가능한 코드, 설정, lockfile부터 확인하고 부족한 정보만 질문하세요. 미정인 요구사항은 미정으로 명시하고, 먼저 현재 상태를 조사하세요. 비밀 정보를 표시하지 말고 공유 로그에서는 민감한 내용을 가리세요.
2. 수신부터 완료까지 측정하세요. 먼저 수신, 처리 완료, 대기 시간을 우선하며 측정 가능한 부분부터 시작하세요. 이벤트/초, 바이트/초, 완료 이벤트/초, 대기열 개수/바이트/가장 오래된 이벤트의 대기 시간, p50/p95/p99, 오류, 연결 끊김, 재연결, 드롭을 기록하세요. 명시적인 대기열이 없다면 그 사실과 관측할 수 있는 처리 구간을 밝히세요. 관측 위치와 측정하지 못한 구간을 명시하세요. NIC 트래픽, 전송선상의 바이트, Protobuf 크기, 디코딩한 객체를 구분하세요. 호스트 내부 경과 시간에는 단조 시계를 사용하고, 외부 시각은 동기화와 타임스탬프 생성 위치를 확인하세요. slot 차이를 바로 데이터 손실이나 고정된 시간으로 환산하지 마세요.
3. CPU, 메모리, 디스크, 네트워크 제약을 분리하세요. 코어/스레드별 CPU, steal과 CPU 제한, RSS/GC/swap/PSI, I/O 대기, NIC 바이트/드롭/오류, TCP 재전송과 RTT를 확인하세요. Linux 도구로는 mpstat, pidstat, vmstat, iostat, sar, ss -ti, /proc/pressure/ 등을 사용할 수 있습니다. 도구나 권한이 없으면 그 사실을 알리고 필요한 최소 명령을 제시하세요. 호스트에 접근할 수 없다면 관리 콘솔이나 애플리케이션 내부 계측에서 얻을 수 있는 정보를 찾고, 얻을 수 없는 항목은 미측정으로 표시하세요. 결과를 만들어 내지 마세요.
4. HTTP/2의 스트림·연결 윈도, TCP 수신 버퍼, 프록시, VPN, sidecar를 확인하세요. 설치된 SDK 버전의 공식 문서를 확인하고 대역폭 지연 곱을 고려하세요. 수신 루프와 주변의 JSON 변환, 이벤트마다 남기는 로그, 동기식 데이터베이스/외부 API 호출, 블로킹 작업, 잠금, 무제한 작업 생성과 무제한 대기열을 점검하세요. Rust나 비동기 코드 자체를 해결책으로 간주하지 마세요.
5. mtr 또는 동등한 도구를 사용할 수 있다면 실제 엔드포인트 호스트를 대상으로 유한한 횟수의 측정을 하세요. 지원되는 시스템에서는 다음을 고려할 수 있습니다: mtr --tcp --port <PORT> --report --report-cycles 30 <HOST>. 일반적인 TLS 포트를 가정하지 말고 실제 포트를 사용하세요. 중간 hop의 손실만으로 장애라고 단정하지 말고 목적지의 동작, 재전송, 다른 경로와 비교하세요. mtr을 대역폭 측정의 대용으로 사용하지 마세요.
6. 현재 구독 조건에서 기준값을 기록하고 한 번에 하나의 변수만 바꾸세요. 최소 수신 경로와 업무 처리를 포함한 파이프라인을 비교할 때는 같은 구독을 유지하세요. 필터 변경은 별도의 비교로 다루세요. 구독을 좁히기 전에 판단에 쓰는 입력값과 알림의 대응 관계를 확인하고, 후보 필터가 이미 알고 있는 필수 이벤트를 포함하는지 검증하세요. 필요한 순서와 완전성을 유지하는 상한 있는 대기열과 병렬 처리를 설계하고, 넘쳤을 때의 동작을 명시하세요. 필요한 데이터를 임의로 버리지 마세요. 오류 상세와 재시도 시점을 저장하고, 정해진 중지 기간에는 재연결하지 마세요.
7. 관측 사실, 원인 후보, 검증하지 않은 가설, 검토 가능한 변경 사항, 변경 전후의 측정값을 나누어 보고하세요. 필요한 CPU, RAM, 대역폭, 저장 성능, 배치 위치를 구독과 실측을 바탕으로 산정하고 피크에 대비한 여유를 포함하세요. 모든 Solana 환경에 적용되는 고정 하드웨어 요구사항을 만들어 내지 마세요. 필요하면 동일한 구독, SDK, commitment로 다른 머신/데이터센터를 비교하는 계획을 제안하세요.
ERPC를 사용하고 있다면 현재 gRPC FAQ를 읽고 정확한 오류 코드에 해당하는 지침을 따르세요:
https://erpc.global/en/faq/grpc/general/
ERPC User MCP나 CLI가 연결되어 있다면 실제 이용 가능한 작업과 권한을 확인하세요. 계정 접근 권한이 있다고 해서 호스트를 진단할 수 있는 것은 아닙니다. 유료 VPS 생성, 계약 변경, 운영 환경 업데이트나 재시작 전에는 비용, 목적, 테스트 시간을 제시하고 내 승인을 받으세요. 먼저 진단과 검토 가능한 개선안을 완성하세요.비교 가능한 환경에서 같은 코드를 실행하세요
측정 결과를 통해 CPU나 메모리 자원, 네트워크 경로를 개선할 여지를 찾을 수도 있습니다. 더 강력한 CPU, 더 많은 메모리, 작업 분할, 데이터 소스에 가까운 위치 등이 선택지가 됩니다. 이런 선택을 앱이 다루는 데이터양과 관측 결과에 연결하면 시도할 이유와 확인할 효과가 더 명확해집니다.
ERPC VPS는 Solana 인프라 가까이에서 스트림 클라이언트를 실행할 수 있는 선택지입니다. 시간당 과금을 이용해 같은 코드와 구독으로 현재 환경과 비교할 수 있습니다. 현재 요금, 리전, 재고는 Dashboard에서 확인하세요. ERPC에서도 필요한 자원은 구독과 애플리케이션 처리에 따라 달라집니다.[7]
수신 처리량뿐 아니라 대기열 증가, 처리 완료 시점의 최신성, p99, 오류를 비교하세요. 측정 기간과 체인 부하도 기록하세요. 동시 비교나 반복 측정은 시간에 따른 트래픽 변화를 환경 차이로 오해하지 않도록 도와줍니다.
지원을 요청할 때는 민감한 정보를 가린 구독 설정, SDK 버전, 리전, 타임스탬프, 오류 메시지 전체, 지금까지 얻은 측정 결과를 공유해 주세요. 아직 얻지 못한 값은 미측정이라고 알려도 괜찮습니다.
관측할 수 있는 것이 하나 늘어날 때마다 다음에 시도할 변경을 고르기 쉬워집니다. 필요한 데이터를 유지하면서 개선 효과를 하나씩 확인해 나가세요. 저희도 여러분의 개발을 지원하는 정보와 인프라를 계속 다듬겠습니다.
참고 자료와 관련 링크
- [1] gRPC Flow Control: https://grpc.io/docs/guides/flow-control/
- [2] Yellowstone gRPC 구독 명세: https://github.com/rpcpool/yellowstone-grpc/blob/master/README.md
- [3] Tokio: CPU-bound tasks and blocking code: https://docs.rs/tokio/latest/tokio/index.html#cpu-bound-tasks-and-blocking-code
- [4] HTTP/2 흐름 제어: https://www.rfc-editor.org/rfc/rfc9113.html#section-5.2
- [5] Solana 용어: https://solana.com/docs/references/terminology
- [6] mtr 공식 문서: https://github.com/traviscross/mtr
- [7] ERPC VPS: https://erpc.global/ko/vps/
- Linux PSI: https://docs.kernel.org/accounting/psi.html
- Node.js 측정 API: https://nodejs.org/api/perf_hooks.html
- ERPC gRPC FAQ: https://erpc.global/ko/faq/grpc/general/
- ERPC Web Dashboard: https://dashboard.erpc.global/ko/
- Validators DAO 공식 Discord: https://discord.gg/C7ZQSrCkYR









