gRPC

gRPC

gRPC is a popular, high-performance, open-source RPC framework. It supports

  • Cisco Spaces Firehose API gRPC service definition is provided as a proto file. You can compile this file using the protocol buffer compiler (language specific).

  • gRPC operates over HTTP/2.

  • Events are encoded as Protocol Buffers (protobuf).


Note

The Cisco SpacesFirehose API maintains a rolling window of recent events for the partner. The width of this window is unspecified and is subject to change; providing timestamps within the preceding hour is expected to work.

Multiple receiver and partitions

These guidelines to configure multi-receiver deployments for your application:

  • If your application uses multiple receivers, include the min_partition and max_partition values in the EventsStreamRequest.

  • Your application can have up to 12 receivers.

For example, if you have 4 receivers within your application, you would have the these:

  • Receiver #1 with min_partition = 1 and max_partition = 3

  • Receiver #2 with min_partition = 4 and max_partition = 6

Receiver partition assigments

Configure your receivers with the these partition assignments:

  • Receiver #3 with min_partition = 7 and max_partition = 9

  • Receiver #4 with min_partition = 10 and max_partition = 12