grpc client

The grpc client binding adapts grpc request-response streams to http request-response streams.

grpc_server:
  type: grpc
  kind: client
  exit: tcp_server

Configuration (* required)

catalog

object as map of named array

To map defined catalog for schema retrieval based on catalog specific parameters.

catalog:
  my_catalog:
    - subject: http

catalog[].id*

integer

Define specific schema id to refer from catalog.

catalog[].strategy*

enum [ topic ]

To determine the subject based on the specified strategy.

catalog[].subject*

string

Unique identifier for schema categorization in the catalog.

catalog[].version

string | Default: latest

Specific iteration or version of a registered schema in the defined catalog.

exit

string

Default exit binding when no conditional routes are viable.

exit: echo_server

routes

array of object

Conditional grpc specific routes. At least one of routes or the top-level exit is required.

routes:
  - guarded:
      my_guard:
        - echo:messages
    when:
      - method: example.EchoService/*
        metadata:
          custom-text: custom value
          custom-binary:
            base64: Y3VzdG9tIHZhbHVl
    exit: echo_server

routes[].guarded

object as map of named array of string

Roles required by named guard.

routes:
  - guarded:
      my_guard:
        - echo:messages

routes[].when

array of object

List of conditions (any match) to match this route. Read more: When a route matches

routes:
    when:
      - method: example.EchoService/*
        metadata:
          custom-text: custom value
          custom-binary:
            base64: Y3VzdG9tIHZhbHVl

when[].method

string

gRPC service method name, such as example.EchoService/EchoUnary, or service method pattern such as example.EchoService/*.

when[].metadata

object as map of named string or object properties

Metadata header name value pairs (all match).

Each metadata header value can be string or object with base64 property.

metadata.base64

string

Base64 encoded value for binary metadata header.

routes[].exit

string

Routed exit binding when conditional route matches.

routes:
  - when:
    ...
    exit: echo_server

telemetry

object

Defines the desired telemetry for the binding.

telemetry.metrics

array

Telemetry metrics to track

telemetry:
  metrics:
    - stream.*
    - grpc.*

telemetry.attributes

object as map of named string properties

Telemetry attributes to add to the binding metrics.