본문으로 건너뛰기

gRPC (개발자 관점)

gRPC는 바이너리 RPC입니다. 이 도구는 .proto 파일 준비를 요구하지 않습니다 — 서버가 Server Reflection을 켜두기만 하면, 클라이언트가 서비스와 메서드를 자동 탐색하고 필드를 확인해 그 자리에서 호출할 수 있습니다.

핵심 흐름​

UI에서의 사용법 (3단계)​

샘플 서비스 qrtest.v1.EchoService(grpc://127.0.0.1:18089, 평문 h2c)를 사용한 예:

  1. gRPC 요청을 연결합니다(url은 host:port를 저장). Reflection이 자동 실행되어 메서드 트리가 나옵니다:
    • /qrtest.v1.EchoService/Echo — 단일 응답(unary)
    • /qrtest.v1.EchoService/EchoStream — 서버 스트리밍
    • /qrtest.v1.EchoService/Collect — 클라이언트 스트리밍
    • /qrtest.v1.EchoService/Chat — 양방향 스트리밍
  2. Echo 메서드의 스키마를 확인합니다:
    • 입력 EchoRequest { message: string, count: int32 }
    • 출력 EchoResponse { message: string, seq: int64, metadataJson: string }
  3. {"message":"hello-grpc","count":3}로 Echo를 호출합니다:
    • Unary: {message:"hello-grpc", seq, metadataJson} 응답 1건, 상태 OK
    • 같은 입력으로 서버 스트리밍 EchoStream: stream#1/#2/#3 3프레임

메타데이터 (gRPC 헤더)​

인증 / 트레이싱 헤더는 소문자 키의 메타데이터로 전달됩니다. grpc-*, content-type 등 예약 헤더는 걸러집니다.

TLS / mTLS​

Pre-URL에 grpcs://를 쓰고, 설정에서 클라이언트 인증서를 임포트합니다.

주의 사항 (중요)​

  • non-OK 상태는 정상적인 비즈니스 결과이며, 연결 실패가 아닙니다: 타임아웃과 비즈니스 오류는 상태 코드와 (비어 있을 수 있는) 응답으로 돌아옵니다 — 트랜스포트 오류로 취급하지 마세요. HTTP 4xx만이 실제 오류를 나타냅니다.
  • 이 도구가 지원하는 것은 unary와 서버 스트리밍뿐입니다. 클라이언트 스트리밍 / 양방향 스트리밍은 아직 호출할 수 없습니다(앱 내 완전한 스트리밍은 UI가 기준입니다).
  • 복합 타입: map 필드는 중첩된 mapEntry로 나타납니다. 간접 참조되는 타입도 함께 로드됩니다.

관련: 환경의 Pre-URL과 TLS 설정은 concepts.