Protocol Documentation
Table of Contents
banyandb/common/v1/trace.proto
Span
Span is the basic unit of a trace.
| Field | Type | Label | Description |
|---|
| start_time | google.protobuf.Timestamp | | start_time is the start time of the span. |
| end_time | google.protobuf.Timestamp | | end_time is the end time of the span. |
| error | bool | | error indicates whether the span is an error span. |
| tags | Tag | repeated | tags is a list of tags of the span. |
| message | string | | message is the message generated by the span. |
| children | Span | repeated | children is a list of child spans of the span. |
| duration | int64 | | duration is the duration of the span. |
Tag
Tag is the key-value pair of a span.
| Field | Type | Label | Description |
|---|
| key | string | | key is the key of the tag. |
| value | string | | value is the value of the tag. |
Trace
Trace is the top level message of a trace.
| Field | Type | Label | Description |
|---|
| trace_id | string | | trace_id is the unique identifier of the trace. |
| spans | Span | repeated | spans is a list of spans in the trace. |
| error | bool | | error indicates whether the trace is an error trace. |
banyandb/model/v1/common.proto
FieldValue
Float
| Field | Type | Label | Description |
|---|
| value | double | | |
Int
| Field | Type | Label | Description |
|---|
| value | int64 | | |
IntArray
| Field | Type | Label | Description |
|---|
| value | int64 | repeated | |
Str
| Field | Type | Label | Description |
|---|
| value | string | | |
StrArray
| Field | Type | Label | Description |
|---|
| value | string | repeated | |
TagFamilyForWrite
| Field | Type | Label | Description |
|---|
| tags | TagValue | repeated | |
TagValue
AggregationFunction
| Name | Number | Description |
|---|
| AGGREGATION_FUNCTION_UNSPECIFIED | 0 | |
| AGGREGATION_FUNCTION_MEAN | 1 | |
| AGGREGATION_FUNCTION_MAX | 2 | |
| AGGREGATION_FUNCTION_MIN | 3 | |
| AGGREGATION_FUNCTION_COUNT | 4 | |
| AGGREGATION_FUNCTION_SUM | 5 | |
banyandb/model/v1/query.proto
Condition
Condition consists of the query condition with a single binary operator to be imposed For 1:1 BinaryOp, values in condition must be an array with length = 1, while for 1:N BinaryOp, values can be an array with length >= 1.
Condition.MatchOption
Criteria
tag_families are indexed.
LogicalExpression
LogicalExpression supports logical operation
QueryOrder
QueryOrder means a Sort operation to be done for a given index rule. The index_rule_name refers to the name of a index rule bound to the subject.
| Field | Type | Label | Description |
|---|
| index_rule_name | string | | |
| sort | Sort | | |
Tag
Pair is the building block of a record which is equivalent to a key-value pair. In the context of Trace, it could be metadata of a trace such as service_name, service_instance, etc. Besides, other tags are organized in key-value pair in the underlying storage layer. One should notice that the values can be a multi-value.
TagFamily
| Field | Type | Label | Description |
|---|
| name | string | | |
| tags | Tag | repeated | |
TagProjection
TagProjection is used to select the names of keys to be returned.
TagProjection.TagFamily
TimeRange
TimeRange is a range query for uint64, the range here follows left-inclusive and right-exclusive rule, i.e. [begin, end) if both edges exist
Condition.BinaryOp
BinaryOp specifies the operation imposed to the given query condition For EQ, NE, LT, GT, LE and GE, only one operand should be given, i.e. one-to-one relationship. HAVING and NOT_HAVING allow multi-value to be the operand such as array/vector, i.e. one-to-many relationship. For example, "keyA" contains "valueA" and "valueB" MATCH performances a full-text search if the tag is analyzed. The string value applies to the same analyzer as the tag, but string array value does not. Each item in a string array is seen as a token instead of a query expression.
| Name | Number | Description |
|---|
| BINARY_OP_UNSPECIFIED | 0 | |
| BINARY_OP_EQ | 1 | |
| BINARY_OP_NE | 2 | |
| BINARY_OP_LT | 3 | |
| BINARY_OP_GT | 4 | |
| BINARY_OP_LE | 5 | |
| BINARY_OP_GE | 6 | |
| BINARY_OP_HAVING | 7 | |
| BINARY_OP_NOT_HAVING | 8 | |
| BINARY_OP_IN | 9 | |
| BINARY_OP_NOT_IN | 10 | |
| BINARY_OP_MATCH | 11 | |
Condition.MatchOption.Operator
| Name | Number | Description |
|---|
| OPERATOR_UNSPECIFIED | 0 | |
| OPERATOR_AND | 1 | |
| OPERATOR_OR | 2 | |
LogicalExpression.LogicalOp
| Name | Number | Description |
|---|
| LOGICAL_OP_UNSPECIFIED | 0 | |
| LOGICAL_OP_AND | 1 | |
| LOGICAL_OP_OR | 2 | |
Sort
| Name | Number | Description |
|---|
| SORT_UNSPECIFIED | 0 | |
| SORT_DESC | 1 | |
| SORT_ASC | 2 | |
banyandb/model/v1/write.proto
Status
Status is the response status for write
| Name | Number | Description |
|---|
| STATUS_UNSPECIFIED | 0 | |
| STATUS_SUCCEED | 1 | |
| STATUS_INVALID_TIMESTAMP | 2 | |
| STATUS_NOT_FOUND | 3 | |
| STATUS_EXPIRED_SCHEMA | 4 | |
| STATUS_INTERNAL_ERROR | 5 | |
| STATUS_DISK_FULL | 6 | |
| STATUS_VERSION_UNSUPPORTED | 7 | Client version not supported |
| STATUS_VERSION_DEPRECATED | 8 | Client version deprecated but still supported |
| STATUS_METADATA_REQUIRED | 9 | Metadata is required for the first request |
| STATUS_SCHEMA_NOT_APPLIED | 10 | Client's ModRevision is ahead of the server cache; the server waited and timed out. |
banyandb/measure/v1/query.proto
DataPoint
DataPoint is stored in Measures
| Field | Type | Label | Description |
|---|
| timestamp | google.protobuf.Timestamp | | timestamp is in the timeunit of milliseconds. |
| tag_families | banyandb.model.v1.TagFamily | repeated | tag_families contains tags selected in the projection |
| fields | DataPoint.Field | repeated | fields contains fields selected in the projection |
| sid | uint64 | | sid is the series id of the data point |
| version | int64 | | version is the version of the data point in a series sid, timestamp and version are used to identify a data point |
DataPoint.Field
InternalDataPoint
InternalDataPoint wraps DataPoint with shard information for internal use. Used in distributed query to distinguish data from different shards.
| Field | Type | Label | Description |
|---|
| data_point | DataPoint | | The actual data point |
| shard_id | uint32 | | The shard id where this data point comes from |
InternalQueryRequest
InternalQueryRequest is the internal request for distributed query. Wraps QueryRequest for extensibility.
| Field | Type | Label | Description |
|---|
| request | QueryRequest | | The actual query request |
| agg_return_partial | bool | | agg_return_partial when true asks data nodes to return aggregation partials (for reduce at liaison) |
InternalQueryResponse
InternalQueryResponse is the internal response for distributed query. Contains shard information for proper deduplication.
| Field | Type | Label | Description |
|---|
| data_points | InternalDataPoint | repeated | data_points with shard information |
| trace | banyandb.common.v1.Trace | | trace contains the trace information of the query when trace is enabled |
| raw_frame_body | bytes | | raw_frame_body contains the vectorized raw frame body when raw wire mode is enabled |
QueryRequest
QueryRequest is the request contract for query.
| Field | Type | Label | Description |
|---|
| groups | string | repeated | groups indicate where the data points are stored. |
| name | string | | name is the identity of a measure. |
| time_range | banyandb.model.v1.TimeRange | | time_range is a range query with begin/end time of entities in the timeunit of milliseconds. |
| criteria | banyandb.model.v1.Criteria | | tag_families are indexed. |
| tag_projection | banyandb.model.v1.TagProjection | | tag_projection can be used to select tags of the data points in the response |
| field_projection | QueryRequest.FieldProjection | | field_projection can be used to select fields of the data points in the response |
| group_by | QueryRequest.GroupBy | | group_by groups data points based on their field value for a specific tag and use field_name as the projection name |
| agg | QueryRequest.Aggregation | | agg aggregates data points based on a field |
| top | QueryRequest.Top | | top limits the result based on a particular field. If order_by is specified, top sorts the dataset based on order_by's output |
| offset | uint32 | | offset is used to support pagination, together with the following limit. If top is specified, offset processes the dataset based on top's output |
| limit | uint32 | | limit is used to impose a boundary on the number of records being returned. If top is specified, limit processes the dataset based on top's output |
| order_by | banyandb.model.v1.QueryOrder | | order_by is given to specify the sort for a tag. |
| trace | bool | | trace is used to enable trace for the query |
| stages | string | repeated | stages is used to specify the stage of the data points in the lifecycle |
| rewrite_agg_top_n_result | bool | | rewrite_agg_top_n_result will rewrite agg result to raw data |
| group_mod_revisions | QueryRequest.GroupModRevisionsEntry | repeated | group_mod_revisions gates the query per group. Keys match entries in groups; values are the client's known mod_revision for that group. Empty map or value 0 means "don't gate". A group not listed in the map is not gated. |
QueryRequest.Aggregation
QueryRequest.FieldProjection
| Field | Type | Label | Description |
|---|
| names | string | repeated | |
QueryRequest.GroupBy
| Field | Type | Label | Description |
|---|
| tag_projection | banyandb.model.v1.TagProjection | | tag_projection must be a subset of the tag_projection of QueryRequest |
| field_name | string | | field_name must be one of fields indicated by field_projection |
QueryRequest.GroupModRevisionsEntry
QueryRequest.Top
| Field | Type | Label | Description |
|---|
| number | int32 | | number set the how many items should be returned |
| field_name | string | | field_name must be one of files indicated by the field_projection |
| field_value_sort | banyandb.model.v1.Sort | | field_value_sort indicates how to sort fields ASC: bottomN DESC: topN UNSPECIFIED: topN |
QueryResponse
QueryResponse is the response for a query to the Query module.
| Field | Type | Label | Description |
|---|
| data_points | DataPoint | repeated | data_points are the actual data returned |
| trace | banyandb.common.v1.Trace | | trace contains the trace information of the query when trace is enabled |
| group_statuses | QueryResponse.GroupStatusesEntry | repeated | group_statuses reports the per-group gate outcome. Populated even when the query short-circuits because any group failed the gate. |
QueryResponse.GroupStatusesEntry
banyandb/measure/v1/topn.proto
TopNList
TopNList contains a series of topN items
TopNList.Item
TopNRequest
TopNRequest is the request contract for query.
| Field | Type | Label | Description |
|---|
| groups | string | repeated | groups indicate where the data points are stored. |
| name | string | | name is the identity of a measure. |
| time_range | banyandb.model.v1.TimeRange | | time_range is a range query with begin/end time of entities in the timeunit of milliseconds. |
| top_n | int32 | | top_n set the how many items should be returned in each list. |
| agg | banyandb.model.v1.AggregationFunction | | agg aggregates lists grouped by field names in the time_range |
| conditions | banyandb.model.v1.Condition | repeated | criteria select counters. Only equals are acceptable. |
| field_value_sort | banyandb.model.v1.Sort | | field_value_sort indicates how to sort fields |
| trace | bool | | trace is used to enable trace for the query |
| stages | string | repeated | stages is used to specify the stage of the data points in the lifecycle |
TopNResponse
TopNResponse is the response for a query to the Query module.
| Field | Type | Label | Description |
|---|
| lists | TopNList | repeated | lists contain a series topN lists ranked by timestamp if agg_func in query request is specified, lists' size should be one. |
| trace | banyandb.common.v1.Trace | | trace contains the trace information of the query when trace is enabled |
banyandb/common/v1/common.proto
Group
Group is an internal object for Group management
| Field | Type | Label | Description |
|---|
| metadata | Metadata | | metadata define the group's identity |
| catalog | Catalog | | catalog denotes which type of data the group contains |
| resource_opts | ResourceOpts | | resourceOpts indicates the structure of the underlying kv storage |
| updated_at | google.protobuf.Timestamp | | updated_at indicates when resources of the group are updated |
| created_at | google.protobuf.Timestamp | | created_at is the first-appearance timestamp; survives updates unchanged. |
| pipeline | TracePipelineConfig | optional | pipeline carries the optional group-scoped in-merge retention config. Absent or non-CATALOG_TRACE group means no sampler. |
IntervalRule
IntervalRule is a structured duration
LifecycleStage
| Field | Type | Label | Description |
|---|
| name | string | | The stage name (e.g., "warm", "cold"). This should be a non-empty string. |
| shard_num | uint32 | | Number of shards allocated for this stage. Must be greater than zero. |
| segment_interval | IntervalRule | | Defines the interval for data segmentation in this stage. This is a required field and uses the IntervalRule structure. |
| ttl | IntervalRule | | Specifies the time-to-live for data in this stage before moving to the next. This is also a required field using the IntervalRule structure. |
| node_selector | string | | Node selector specifying target nodes for this stage. Optional; if provided, it must be a non-empty string. |
| close | bool | | Indicates whether segments that are no longer live should be closed. |
| replicas | uint32 | | replicas is the number of replicas for this stage. This is an optional field and defaults to 0. A value of 0 means no replicas, while a value of 1 means one primary shard and one replica. Higher values indicate more replicas. |
Metadata
Metadata is for multi-tenant, multi-model use
| Field | Type | Label | Description |
|---|
| group | string | | group contains a set of options, like retention policy, max |
| name | string | | name of the entity |
| id | uint32 | | id is the unique identifier of the entity if id is not set, the system will generate a unique id |
| create_revision | int64 | | readonly. create_revision is the revision of last creation on this key. |
| mod_revision | int64 | | readonly. mod_revision is the revision of last modification on this key. |
Plugin
Plugin is one link in a pipeline's processing chain.
| Field | Type | Label | Description |
|---|
| name | string | | name is the operator-facing identity for this link. |
| sampler | SamplerPlugin | | sampler owns a keep/drop verdict over a vectorized batch of traces. |
ResourceOpts
| Field | Type | Label | Description |
|---|
| shard_num | uint32 | | shard_num is the number of shards |
| segment_interval | IntervalRule | | segment_interval indicates the length of a segment |
| ttl | IntervalRule | | ttl indicates time to live, how long the data will be cached |
| stages | LifecycleStage | repeated | stages defines the ordered lifecycle stages. Data progresses through these stages sequentially. |
| default_stages | string | repeated | default_stages is the name of the default stage |
| replicas | uint32 | | replicas is the number of replicas. This is used to ensure high availability and fault tolerance. This is an optional field and defaults to 0. A value of 0 means no replicas, while a value of 1 means one primary shard and one replica. Higher values indicate more replicas. |
SamplerPlugin
SamplerPlugin configures a user-supplied native Go plugin (.so) that owns a keep/drop verdict over a vectorized batch of traces.
| Field | Type | Label | Description |
|---|
| path | string | | path is the plugin .so filename, resolved within the data node's trusted plugin directory. |
| symbol | string | | symbol is the constructor symbol the engine looks up; defaults to "NewSampler" if empty. |
| abi_version | uint32 | | abi_version is the ABI version the plugin was built against. |
| config | google.protobuf.Struct | | config is the plugin-defined configuration serialized to canonical JSON for the constructor. |
StageRule
StageRule binds the pipeline to one lifecycle stage and declares that stage's retention plugin chain.
| Field | Type | Label | Description |
|---|
| stage | string | | stage is the stage name from the Group's ResourceOpts.stages. |
| plugins | Plugin | repeated | plugins is the ordered retention chain for this stage. |
TracePipelineConfig
TracePipelineConfig is the group-scoped, name-less in-merge retention configuration. Identity comes from the carrying Group; there is one config per group by construction.
| Field | Type | Label | Description |
|---|
| enabled | bool | | enabled activates the pipeline. |
| plugins | Plugin | repeated | plugins is the ordered chain of plugins evaluated by enabled events. |
| merge_grace | google.protobuf.Duration | | merge_grace is the per-trace maturity window for the in-merge filter. Strictly positive if set; engine default 30s if unset. |
| finalize_grace | google.protobuf.Duration | | finalize_grace is the per-segment settling window for the scheduled finalization pass. Strictly positive if set; engine default 5m if unset. |
| stages | StageRule | repeated | stages declares per-stage retention rules. |
| schema_names | string | repeated | schema_names lists explicit schema names to target within the Group. |
| schema_name_regex | string | | schema_name_regex is an RE2 pattern matched against schema names. |
| enabled_events | PipelineEvent | repeated | enabled_events lists the pipeline-wide events to run. |
Catalog
| Name | Number | Description |
|---|
| CATALOG_UNSPECIFIED | 0 | |
| CATALOG_STREAM | 1 | |
| CATALOG_MEASURE | 2 | |
| CATALOG_PROPERTY | 3 | |
| CATALOG_TRACE | 4 | |
IntervalRule.Unit
| Name | Number | Description |
|---|
| UNIT_UNSPECIFIED | 0 | |
| UNIT_HOUR | 1 | |
| UNIT_DAY | 2 | |
PipelineEvent
PipelineEvent identifies a pipeline-wide event that can be independently enabled.
| Name | Number | Description |
|---|
| PIPELINE_EVENT_UNSPECIFIED | 0 | |
| PIPELINE_EVENT_MERGE | 1 | In-merge filter during Hot-phase LSM compaction merges. |
| PIPELINE_EVENT_FINALIZE | 2 | Tail-sampling gate at Hot-phase segment finalization. |
banyandb/property/v1/property.proto
Property
Property stores the user defined data
banyandb/property/v1/rpc.proto
ApplyRequest
ApplyResponse
| Field | Type | Label | Description |
|---|
| created | bool | | created indicates whether the property existed. True: the property is absent. False: the property existed. |
| tags_num | uint32 | | |
DeleteRequest
| Field | Type | Label | Description |
|---|
| group | string | | groups indicate where the data points are stored. |
| name | string | | name is the identity of a property. |
| id | string | | id is the identity of item in the property. |
DeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
InternalDeleteRequest
| Field | Type | Label | Description |
|---|
| ids | bytes | repeated | |
InternalQueryResponse
| Field | Type | Label | Description |
|---|
| sources | bytes | repeated | |
| trace | banyandb.common.v1.Trace | | |
| deletes | int64 | repeated | deletes indicates the property is deleted timestamps, it's mapping to the sources in the same order if the value is 0, it means the property is not deleted |
| sorted_values | bytes | repeated | sorted_values contains pre-extracted sort values from shard searches, mapping to sources in the same order for optimized sorting at liaison layer |
InternalRepairRequest
InternalRepairResponse
InternalUpdateRequest
QueryOrder
| Field | Type | Label | Description |
|---|
| tag_name | string | | tag_name is the name of the tag to be ordered. |
| sort | banyandb.model.v1.Sort | | order_by is given to specify the sort for a tag. |
QueryRequest
QueryRequest is the request contract for query.
| Field | Type | Label | Description |
|---|
| groups | string | repeated | groups indicate where the data points are stored. |
| name | string | | name is created when it receives the first property |
| ids | string | repeated | ids is the identities of properties |
| criteria | banyandb.model.v1.Criteria | | criteria is used to filter properties based on tags |
| tag_projection | string | repeated | tag_projection can be used to select tags of the data points in the response |
| limit | uint32 | | |
| trace | bool | | trace is used to enable trace for the query |
| order_by | QueryOrder | | order_by is given to specify the sort for a tag. |
QueryResponse
QueryResponse is the response for a query to the Query module.
| Field | Type | Label | Description |
|---|
| properties | Property | repeated | properties are the actual data returned |
| trace | banyandb.common.v1.Trace | | trace contains the trace information of the query when trace is enabled |
ApplyRequest.Strategy
| Name | Number | Description |
|---|
| STRATEGY_UNSPECIFIED | 0 | |
| STRATEGY_MERGE | 1 | |
| STRATEGY_REPLACE | 2 | |
PropertyService
banyandb/stream/v1/query.proto
Element
Element represents (stream context) a Span defined in Google Dapper paper or equivalently a Segment in Skywalking. (Log context) a log
| Field | Type | Label | Description |
|---|
| element_id | string | | element_id could be span_id of a Span or segment_id of a Segment in the context of stream |
| timestamp | google.protobuf.Timestamp | | timestamp represents a millisecond 1) either the start time of a Span/Segment, 2) or the timestamp of a log |
| tag_families | banyandb.model.v1.TagFamily | repeated | fields contains all indexed Field. Some typical names, - stream_id - duration - service_name - service_instance_id - end_time_milliseconds |
QueryRequest
QueryRequest is the request contract for query.
| Field | Type | Label | Description |
|---|
| groups | string | repeated | groups indicate where the elements are stored. |
| name | string | | name is the identity of a stream. |
| time_range | banyandb.model.v1.TimeRange | | time_range is a range query with begin/end time of entities in the timeunit of milliseconds. In the context of stream, it represents the range of the startTime for spans/segments, while in the context of Log, it means the range of the timestamp(s) for logs. it is always recommended to specify time range for performance reason |
| offset | uint32 | | offset is used to support pagination, together with the following limit |
| limit | uint32 | | limit is used to impose a boundary on the number of records being returned |
| order_by | banyandb.model.v1.QueryOrder | | order_by is given to specify the sort for a field. So far, only fields in the type of Integer are supported |
| criteria | banyandb.model.v1.Criteria | | tag_families are indexed. |
| projection | banyandb.model.v1.TagProjection | | projection can be used to select the key names of the element in the response |
| trace | bool | | trace is used to enable trace for the query |
| stages | string | repeated | stage is used to specify the stage of the query in the lifecycle |
| group_mod_revisions | QueryRequest.GroupModRevisionsEntry | repeated | group_mod_revisions gates the query per group. Keys match entries in groups; values are the client's known mod_revision for that group. Empty map or value 0 means "don't gate". A group not listed in the map is not gated. |
QueryRequest.GroupModRevisionsEntry
QueryResponse
QueryResponse is the response for a query to the Query module.
| Field | Type | Label | Description |
|---|
| elements | Element | repeated | elements are the actual data returned |
| trace | banyandb.common.v1.Trace | | trace contains the trace information of the query when trace is enabled |
| group_statuses | QueryResponse.GroupStatusesEntry | repeated | group_statuses reports the per-group gate outcome. Populated even when the query short-circuits because any group failed the gate. |
QueryResponse.GroupStatusesEntry
banyandb/trace/v1/query.proto
InternalQueryResponse
InternalQueryResponse is the response of an internal query.
| Field | Type | Label | Description |
|---|
| internal_traces | InternalTrace | repeated | internal_traces is a list of internal traces that match the query. |
| trace_query_result | banyandb.common.v1.Trace | | trace_query_result contains the trace of the query execution if tracing is enabled. |
InternalTrace
InternalTrace is the trace that is used for internal use.
| Field | Type | Label | Description |
|---|
| spans | Span | repeated | spans are the spans that belong to this trace. |
| trace_id | string | | trace_id is the unique identifier of the trace. |
| key | int64 | | key is used for sorting. |
QueryRequest
QueryRequest is the request contract for query.
| Field | Type | Label | Description |
|---|
| groups | string | repeated | groups indicates the physical data location. |
| name | string | | name is the identity of a trace. |
| time_range | banyandb.model.v1.TimeRange | | time_range is a range query with begin/end time of entities in the timeunit of milliseconds. In the context of trace, it represents the range of the startTime for spans/segments, it is always recommended to specify time range for performance reason |
| offset | uint32 | | offset is used to support pagination, together with the following limit |
| limit | uint32 | | limit is used to impose a boundary on the number of spans being returned |
| order_by | banyandb.model.v1.QueryOrder | | order_by is given to specify the sort for a tag. So far, only tags in the type of Integer are supported |
| criteria | banyandb.model.v1.Criteria | | criteria is the filter criteria. |
| tag_projection | string | repeated | projection can be used to select the names of the tags in the response |
| trace | bool | | trace is used to enable trace for the query |
| stages | string | repeated | stage is used to specify the stage of the query in the lifecycle |
| group_mod_revisions | QueryRequest.GroupModRevisionsEntry | repeated | group_mod_revisions gates the query per group. Keys match entries in groups; values are the client's known mod_revision for that group. Empty map or value 0 means "don't gate". A group not listed in the map is not gated. |
QueryRequest.GroupModRevisionsEntry
QueryResponse
QueryResponse is the response of a query.
| Field | Type | Label | Description |
|---|
| traces | Trace | repeated | traces is a list of traces that match the query, with spans grouped by trace ID. |
| trace_query_result | banyandb.common.v1.Trace | | trace_query_result contains the trace of the query execution if tracing is enabled. |
| group_statuses | QueryResponse.GroupStatusesEntry | repeated | group_statuses reports the per-group gate outcome. Populated even when the query short-circuits because any group failed the gate. |
QueryResponse.GroupStatusesEntry
Span
Span is a single operation within a trace.
| Field | Type | Label | Description |
|---|
| tags | banyandb.model.v1.Tag | repeated | tags are the indexed tags of the span. |
| span | bytes | | span is the raw span data. |
| span_id | string | | span_id is the unique identifier of the span. |
Trace
Trace contains all spans that belong to a single trace ID.
| Field | Type | Label | Description |
|---|
| spans | Span | repeated | spans is the list of spans that belong to this trace. |
| trace_id | string | | trace_id is the unique identifier of the trace. |
banyandb/bydbql/v1/query.proto
QueryRequest
QueryRequest is the main request message for BydbQL queries
| Field | Type | Label | Description |
|---|
| query | string | | query is the BydbQL query string |
QueryResponse
QueryResponse contains the result of a BydbQL query
banyandb/bydbql/v1/rpc.proto
BydbQLService
BydbQLService provides query interface for BanyanDB Query Language (BydbQL)
| Method Name | Request Type | Response Type | Description |
|---|
| Query | QueryRequest | QueryResponse | Query executes a generic BydbQL query with explicit FROM clause This endpoint requires the query to specify the resource type and name in the FROM clause (e.g., "FROM STREAM sw", "FROM MEASURE metrics") |
banyandb/schema/v1/barrier.proto
AwaitRevisionAppliedRequest
AwaitRevisionAppliedRequest carries the minimum mod_revision the caller is waiting for and a wall-clock budget for the wait.
AwaitRevisionAppliedResponse
AwaitRevisionAppliedResponse reports whether every node reached the target revision before the timeout, and lists laggards otherwise.
AwaitSchemaAppliedRequest
AwaitSchemaAppliedRequest pairs each key with a per-key minimum revision. keys is capped at 10000 server-side; exceeding the cap returns InvalidArgument. A min_revisions entry of 0 means "just present, any revision".
AwaitSchemaAppliedResponse
AwaitSchemaAppliedResponse reports whether every requested key is present at or above its target revision on every node.
AwaitSchemaDeletedRequest
AwaitSchemaDeletedRequest names the keys that must disappear from every node's cache before the call returns.
AwaitSchemaDeletedResponse
AwaitSchemaDeletedResponse reports whether every node has removed the requested keys.
NodeLaggard
NodeLaggard reports a single cluster member (peer liaison or data node) that has not caught up to the requested schema state. missing_keys is populated by AwaitSchemaApplied responses; still_present_keys by AwaitSchemaDeleted responses. reason is set when the laggard exists for a non-default cause (e.g. "evicted_during_poll" when the cluster transitioned the member from Active to Evictable mid-call); empty otherwise.
SchemaKey
SchemaKey identifies a schema resource by kind and name. Valid kind values: "measure", "stream", "trace", "property", "index_rule", "index_rule_binding", "group", "top_n_aggregation".
SchemaBarrierService
SchemaBarrierService lets clients block until every data node in the cluster has caught up to a target schema state. The standalone implementation lands in Step 1.8; the distributed liaison fan-out lands in Steps 1.15-1.17.
banyandb/cluster/v1/node_schema_status.proto
GetAbsentKeysRequest
GetAbsentKeysRequest names the keys whose absence the caller wants to confirm.
GetAbsentKeysResponse
GetAbsentKeysResponse partitions the requested keys into absent and still-present subsets.
GetKeyRevisionsRequest
GetKeyRevisionsRequest names the keys whose per-key revisions the caller wants to inspect.
GetKeyRevisionsResponse
GetKeyRevisionsResponse lists per-key revisions in the same order the caller supplied keys.
GetMaxRevisionRequest
GetMaxRevisionRequest carries no parameters; the node returns its current max mod_revision.
GetMaxRevisionResponse
GetMaxRevisionResponse holds the node's current max mod_revision.
| Field | Type | Label | Description |
|---|
| max_mod_revision | int64 | | |
KeyRevision
KeyRevision pairs a SchemaKey with the node's local mod_revision and presence flag.
NodeSchemaStatusService
NodeSchemaStatusService is exposed by every data node so the liaison can inspect each node's local schema cache when satisfying a SchemaBarrierService request. The implementation lands in Step 2.1.
banyandb/cluster/v1/rpc.proto
FileInfo
Information about an individual file within a part.
| Field | Type | Label | Description |
|---|
| name | string | | File identifier (e.g., "primary", "timestamps", "tagFamilies:seriesId"). |
| offset | uint32 | | Byte offset within the part where this file starts. |
| size | uint32 | | Size of this file in bytes. |
HealthCheckRequest
| Field | Type | Label | Description |
|---|
| service_name | string | | |
HealthCheckResponse
PartInfo
Information about a part contained within a chunk.
| Field | Type | Label | Description |
|---|
| id | uint64 | | Unique identifier for this part. |
| files | FileInfo | repeated | Information about individual files within this part. |
| compressed_size_bytes | uint64 | | Compressed size in bytes from partMetadata. |
| uncompressed_size_bytes | uint64 | | Uncompressed size in bytes from partMetadata. |
| total_count | uint64 | | Total count from partMetadata. |
| blocks_count | uint64 | | Blocks count from partMetadata. |
| min_timestamp | int64 | | Minimum timestamp from partMetadata. |
| max_timestamp | int64 | | Maximum timestamp from partMetadata. |
| min_key | int64 | | Minimum user-provided key for sidx. |
| max_key | int64 | | Maximum user-provided key for sidx. |
| part_type | string | | Part type. |
PartResult
PartResult contains the result for individual parts.
| Field | Type | Label | Description |
|---|
| success | bool | | Whether this part was processed successfully. |
| error | string | | Error message if processing failed. |
| bytes_processed | uint32 | | Number of bytes processed for this part. |
SendRequest
| Field | Type | Label | Description |
|---|
| topic | string | | |
| message_id | uint64 | | |
| body | bytes | | |
| batch_mod | bool | | |
| version_info | VersionInfo | | version_info contains version information |
| group | string | | group is the business group associated with this message. |
| sender_node | string | | sender_node is the BanyanDB node name of the sender; set only on the first message of a stream. |
| sender_role | string | | sender_role is the role of the sender node; set only on the first message of a stream. |
| sender_tier | string | | sender_tier is the storage tier label of the sender node; set only on the first message of a stream. |
SendResponse
SyncCompletion
SyncCompletion contains completion information for the sync operation.
| Field | Type | Label | Description |
|---|
| total_bytes_sent | uint64 | | Total bytes sent for validation. |
| total_parts_sent | uint32 | | Total number of parts sent. |
| total_chunks | uint32 | | Total number of chunks in this sync. |
SyncMetadata
SyncMetadata contains metadata for the sync operation.
| Field | Type | Label | Description |
|---|
| group | string | | Group name (stream/measure). |
| shard_id | uint32 | | Shard identifier. |
| topic | string | | Sync topic (stream-part-sync or measure-part-sync). |
| timestamp | int64 | | Timestamp when sync started. |
| total_parts | uint32 | | Total number of parts being synced. |
| sender_node | string | | sender_node is the BanyanDB node name of the sender. |
| sender_role | string | | sender_role is the role of the sender node. |
| sender_tier | string | | sender_tier is the storage tier label of the sender node. |
SyncPartRequest
Chunked Sync Service Messages.
| Field | Type | Label | Description |
|---|
| session_id | string | | Unique session identifier for this sync operation. |
| chunk_index | uint32 | | Current chunk index (0-based). |
| chunk_data | bytes | | Actual chunk data. |
| chunk_checksum | string | | CRC32 checksum for this chunk. |
| parts_info | PartInfo | repeated | Information about parts contained in this chunk. |
| metadata | SyncMetadata | | Sent with first chunk (chunk_index = 0). |
| completion | SyncCompletion | | Sent with last chunk to finalize. |
| version_info | VersionInfo | | version_info contains version information |
SyncPartResponse
SyncPartResponse contains the response for a sync part request.
SyncResult
SyncResult contains the result of a sync operation.
| Field | Type | Label | Description |
|---|
| success | bool | | Whether entire sync was successful. |
| total_bytes_received | uint64 | | Total bytes received. |
| duration_ms | int64 | | Time taken for sync in milliseconds. |
| chunks_received | uint32 | | Number of chunks successfully received. |
| parts_received | uint32 | | Number of parts successfully received. |
| parts_results | PartResult | repeated | Results for each part. |
VersionCompatibility
| Field | Type | Label | Description |
|---|
| supported | bool | | supported indicates whether the client version is supported |
| server_api_version | string | | server_api_version is the API version of the server |
| supported_api_versions | string | repeated | supported_api_versions lists API versions supported by the server |
| server_file_format_version | string | | server_file_format_version is the file format version of the server |
| supported_file_format_versions | string | repeated | supported_file_format_versions lists file format versions supported by the server |
| reason | string | | reason provides human-readable explanation of version incompatibility |
VersionInfo
| Field | Type | Label | Description |
|---|
| file_format_version | string | | file_format_version indicates the file format version used |
| compatible_file_format_version | string | repeated | compatible_file_format_version lists backward compatible versions |
| api_version | string | | api_version indicates the API semantic version |
SyncStatus
SyncStatus represents the status of a sync operation.
| Name | Number | Description |
|---|
| SYNC_STATUS_UNSPECIFIED | 0 | Unspecified status. |
| SYNC_STATUS_CHUNK_RECEIVED | 1 | Chunk received and validated successfully. |
| SYNC_STATUS_CHUNK_CHECKSUM_MISMATCH | 2 | Chunk checksum validation failed. |
| SYNC_STATUS_CHUNK_OUT_OF_ORDER | 3 | Chunk received out of expected order. |
| SYNC_STATUS_SESSION_NOT_FOUND | 4 | Session ID not recognized. |
| SYNC_STATUS_SYNC_COMPLETE | 5 | Entire sync operation completed successfully. |
| SYNC_STATUS_VERSION_UNSUPPORTED | 6 | Version not supported for sync operations. |
| SYNC_STATUS_FORMAT_VERSION_MISMATCH | 7 | File format version incompatible. |
| SYNC_STATUS_SERVER_BUSY | 8 | Receiver under memory pressure; sender should back off and retry the whole part. |
ChunkedSyncService
ChunkedSyncService provides streaming sync capabilities for chunked data transfer.
| Method Name | Request Type | Response Type | Description |
|---|
| SyncPart | SyncPartRequest stream | SyncPartResponse stream | SyncPart synchronizes part data using chunked transfer. |
Service
banyandb/common/v1/rpc.proto
APIVersion
APIVersion is the version of the API
| Field | Type | Label | Description |
|---|
| version | string | | version is the version of the API |
| revision | string | | revision is the commit hash of the API |
GetAPIVersionRequest
GetAPIVersionRequest is the request for GetAPIVersion
empty
GetAPIVersionResponse
GetAPIVersionResponse is the response for GetAPIVersion
| Field | Type | Label | Description |
|---|
| version | APIVersion | | version is the version of the API |
Service
Service is the service for the API
banyandb/database/v1/database.proto
Node
Node.LabelsEntry
Shard
Role
| Name | Number | Description |
|---|
| ROLE_UNSPECIFIED | 0 | |
| ROLE_META | 1 | |
| ROLE_DATA | 2 | |
| ROLE_LIAISON | 3 | |
banyandb/database/v1/schema.proto
Entity
| Field | Type | Label | Description |
|---|
| tag_names | string | repeated | |
FieldSpec
FieldSpec is the specification of field
| Field | Type | Label | Description |
|---|
| name | string | | name is the identity of a field |
| field_type | FieldType | | field_type denotes the type of field value |
| encoding_method | EncodingMethod | | encoding_method indicates how to encode data during writing |
| compression_method | CompressionMethod | | compression_method indicates how to compress data during writing |
IndexRule
IndexRule defines how to generate indices based on tags and the index type IndexRule should bind to a subject through an IndexRuleBinding to generate proper indices.
| Field | Type | Label | Description |
|---|
| metadata | banyandb.common.v1.Metadata | | metadata define the rule's identity |
| tags | string | repeated | tags are the combination that refers to an indexed object If the elements in tags are more than 1, the object will generate a multi-tag index Caveat: All tags in a multi-tag MUST have an identical IndexType |
| type | IndexRule.Type | | type is the IndexType of this IndexObject. |
| updated_at | google.protobuf.Timestamp | | updated_at indicates when the IndexRule is updated |
| analyzer | string | | analyzer analyzes tag value to support the full-text searching for TYPE_INVERTED indices. available analyzers are: - "standard" provides grammar based tokenization - "simple" breaks text into tokens at any non-letter character, such as numbers, spaces, hyphens and apostrophes, discards non-letter characters, and changes uppercase to lowercase. - "keyword" is a “noop” analyzer which returns the entire input string as a single token. - "url" breaks test into tokens at any non-letter and non-digit character. |
| no_sort | bool | | no_sort indicates whether the index is not for sorting. |
| created_at | google.protobuf.Timestamp | | created_at is the first-appearance timestamp; survives updates unchanged. |
IndexRuleBinding
IndexRuleBinding is a bridge to connect severalIndexRules to a subject This binding is valid between begin_at_nanoseconds and expire_at_nanoseconds, that provides flexible strategies to control how to generate time series indices.
Measure
Measure intends to store data point
| Field | Type | Label | Description |
|---|
| metadata | banyandb.common.v1.Metadata | | metadata is the identity of a measure |
| tag_families | TagFamilySpec | repeated | tag_families are for filter measures |
| fields | FieldSpec | repeated | fields denote measure values |
| entity | Entity | | entity indicates which tags will be to generate a series and shard a measure |
| interval | string | | interval indicates how frequently to send a data point valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h", "d". |
| updated_at | google.protobuf.Timestamp | | updated_at indicates when the measure is updated |
| index_mode | bool | | index_mode specifies whether the data should be stored exclusively in the index, meaning it will not be stored in the data storage system. |
| sharding_key | ShardingKey | | sharding_key determines the distribution of TopN-related data. |
| created_at | google.protobuf.Timestamp | | created_at is the first-appearance timestamp; survives updates unchanged. |
Property
Property stores the user defined data
ShardingKey
| Field | Type | Label | Description |
|---|
| tag_names | string | repeated | |
Stream
Stream intends to store streaming data, for example, traces or logs
Subject
Subject defines which stream or measure would generate indices
TagFamilySpec
| Field | Type | Label | Description |
|---|
| name | string | | |
| tags | TagSpec | repeated | tags defines accepted tags |
TagSpec
TopNAggregation
TopNAggregation generates offline TopN statistics for a measure's TopN approximation
Trace
Trace defines a tracing-specific storage resource. It is suitable for storing traces and spans. The name of a Trace is a logical namespace within a group, while the group of a Trace corresponds to a physical directory.
| Field | Type | Label | Description |
|---|
| metadata | banyandb.common.v1.Metadata | | metadata is the identity of the trace resource. |
| tags | TraceTagSpec | repeated | tags are the specification of tags. |
| trace_id_tag_name | string | | trace_id_tag_name is the name of the tag that stores the trace ID. |
| timestamp_tag_name | string | | timestamp_tag_name is the name of the tag that stores the timestamp. |
| updated_at | google.protobuf.Timestamp | | updated_at indicates when the trace resource is updated. |
| span_id_tag_name | string | | span_id_tag_name is the name of the tag that stores the span ID. |
| created_at | google.protobuf.Timestamp | | created_at is the first-appearance timestamp; survives updates unchanged. |
TraceTagSpec
TraceTagSpec defines the specification of a tag in a trace.
| Field | Type | Label | Description |
|---|
| name | string | | name is the name of the tag. |
| type | TagType | | type is the type of the tag. |
CompressionMethod
| Name | Number | Description |
|---|
| COMPRESSION_METHOD_UNSPECIFIED | 0 | |
| COMPRESSION_METHOD_ZSTD | 1 | |
EncodingMethod
| Name | Number | Description |
|---|
| ENCODING_METHOD_UNSPECIFIED | 0 | |
| ENCODING_METHOD_GORILLA | 1 | |
FieldType
| Name | Number | Description |
|---|
| FIELD_TYPE_UNSPECIFIED | 0 | |
| FIELD_TYPE_STRING | 1 | |
| FIELD_TYPE_INT | 2 | |
| FIELD_TYPE_DATA_BINARY | 3 | |
| FIELD_TYPE_FLOAT | 4 | |
IndexRule.Type
Type determine the index structure under the hood
| Name | Number | Description |
|---|
| TYPE_UNSPECIFIED | 0 | |
| TYPE_INVERTED | 1 | |
| TYPE_SKIPPING | 2 | |
| TYPE_TREE | 3 | TYPE_TREE is a tree index, which is used for storing hierarchical data. |
TagType
| Name | Number | Description |
|---|
| TAG_TYPE_UNSPECIFIED | 0 | |
| TAG_TYPE_STRING | 1 | |
| TAG_TYPE_INT | 2 | |
| TAG_TYPE_STRING_ARRAY | 3 | |
| TAG_TYPE_INT_ARRAY | 4 | |
| TAG_TYPE_DATA_BINARY | 5 | |
| TAG_TYPE_TIMESTAMP | 6 | |
banyandb/database/v1/rpc.proto
DataInfo
DataInfo contains data storage information for a specific node.
| Field | Type | Label | Description |
|---|
| node | Node | | node is the node that stores this data. |
| segment_info | SegmentInfo | repeated | segment_info contains information about each segment on this node. |
| data_size_bytes | int64 | | data_size_bytes is the total size of data on this node in bytes. |
GetClusterStateRequest
GetClusterStateResponse
| Field | Type | Label | Description |
|---|
| route_tables | GetClusterStateResponse.RouteTablesEntry | repeated | Liaison node: map's key could be "tire1" and "tire2". tire1 route traffic between liaison nodes, tire2 spread data among data nodes Data node: map's key could be "property" for gossip. Lifecycle agent: map's key could be the next stage's name. |
GetClusterStateResponse.RouteTablesEntry
GetCurrentNodeRequest
GetCurrentNodeResponse
| Field | Type | Label | Description |
|---|
| node | Node | | |
GroupDeletionTask
GroupDeletionTask represents the status of a group deletion operation.
| Field | Type | Label | Description |
|---|
| current_phase | GroupDeletionTask.Phase | | current_phase is the current phase of the deletion task. |
| total_counts | GroupDeletionTask.TotalCountsEntry | repeated | total_counts maps resource types to their total count. |
| deleted_counts | GroupDeletionTask.DeletedCountsEntry | repeated | deleted_counts maps resource types to the count of deleted resources. |
| total_data_size_bytes | int64 | | total_data_size_bytes is the total size of data to be deleted in bytes. |
| deleted_data_size_bytes | int64 | | deleted_data_size_bytes is the size of data that has been deleted in bytes. |
| message | string | | message provides additional information about the task status. |
| created_at | google.protobuf.Timestamp | | created_at is the timestamp when the task was created. |
| updated_at | google.protobuf.Timestamp | | updated_at is the timestamp when the task was last updated. |
GroupDeletionTask.DeletedCountsEntry
GroupDeletionTask.TotalCountsEntry
GroupRegistryServiceCreateRequest
GroupRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
GroupRegistryServiceDeleteRequest
GroupRegistryServiceDeleteRequest is the request for deleting a group.
| Field | Type | Label | Description |
|---|
| group | string | | group is the name of the group to delete. |
| dry_run | bool | | dry_run indicates whether to perform a dry run without actually deleting data. When true, returns what would be deleted without making changes. |
| force | bool | | force indicates whether to force delete the group even if it contains data. When false, deletion will fail if the group is not empty. |
| data_only | bool | | data_only indicates whether to delete only data files without removing metadata. When true, metadata are preserved. |
GroupRegistryServiceDeleteResponse
GroupRegistryServiceDeleteResponse is the response for deleting a group.
| Field | Type | Label | Description |
|---|
| schema_info | SchemaInfo | | schema_info contains the schema resources that would be deleted (populated in dry-run mode). |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
GroupRegistryServiceExistRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
GroupRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
GroupRegistryServiceGetRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
GroupRegistryServiceGetResponse
GroupRegistryServiceInspectRequest
GroupRegistryServiceInspectRequest is the request for inspecting a group's detailed information.
| Field | Type | Label | Description |
|---|
| group | string | | group is the name of the group to inspect. |
GroupRegistryServiceInspectResponse
GroupRegistryServiceInspectResponse is the response for inspecting a group.
| Field | Type | Label | Description |
|---|
| group | banyandb.common.v1.Group | | group contains the group metadata. |
| schema_info | SchemaInfo | | schema_info contains information about all schemas in the group. |
| data_info | DataInfo | repeated | data_info contains data storage information for each node. |
| liaison_info | LiaisonInfo | repeated | liaison_info contains information about pending operations in liaison. |
GroupRegistryServiceListRequest
GroupRegistryServiceListResponse
GroupRegistryServiceQueryRequest
GroupRegistryServiceQueryRequest is the request for querying a group deletion task.
| Field | Type | Label | Description |
|---|
| group | string | | group is the name of the group whose deletion task to query. |
GroupRegistryServiceQueryResponse
GroupRegistryServiceQueryResponse is the response for querying a group deletion task.
| Field | Type | Label | Description |
|---|
| task | GroupDeletionTask | | task contains the status of the deletion task. |
GroupRegistryServiceUpdateRequest
GroupRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
IndexRuleBindingRegistryServiceCreateRequest
IndexRuleBindingRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
IndexRuleBindingRegistryServiceDeleteRequest
IndexRuleBindingRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
IndexRuleBindingRegistryServiceExistRequest
IndexRuleBindingRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_index_rule_binding | bool | | |
IndexRuleBindingRegistryServiceGetRequest
IndexRuleBindingRegistryServiceGetResponse
IndexRuleBindingRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
IndexRuleBindingRegistryServiceListResponse
IndexRuleBindingRegistryServiceUpdateRequest
IndexRuleBindingRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
IndexRuleRegistryServiceCreateRequest
IndexRuleRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
IndexRuleRegistryServiceDeleteRequest
IndexRuleRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
IndexRuleRegistryServiceExistRequest
IndexRuleRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_index_rule | bool | | |
IndexRuleRegistryServiceGetRequest
IndexRuleRegistryServiceGetResponse
IndexRuleRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
IndexRuleRegistryServiceListResponse
| Field | Type | Label | Description |
|---|
| index_rule | IndexRule | repeated | |
IndexRuleRegistryServiceUpdateRequest
IndexRuleRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
InvertedIndexInfo
InvertedIndexInfo contains information about the inverted index.
| Field | Type | Label | Description |
|---|
| data_count | int64 | | data_count is the number of entries in the inverted index. |
| data_size_bytes | int64 | | data_size_bytes is the size of the inverted index in bytes. |
LiaisonInfo
LiaisonInfo contains information about pending operations in liaison.
| Field | Type | Label | Description |
|---|
| pending_write_data_count | int64 | | pending_write_data_count is the number of data entries waiting to be written. |
| pending_sync_part_count | int64 | | pending_sync_part_count is the number of parts waiting to be synchronized. |
| pending_sync_data_size_bytes | int64 | | pending_sync_data_size_bytes is the size of data waiting to be synchronized in bytes. |
| pending_handoff_part_count | int64 | | pending_handoff_part_count is the number of parts waiting for handoff. |
| pending_handoff_data_size_bytes | int64 | | pending_handoff_data_size_bytes is the size of data waiting for handoff in bytes. |
MeasureRegistryServiceCreateRequest
| Field | Type | Label | Description |
|---|
| measure | Measure | | |
MeasureRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
MeasureRegistryServiceDeleteRequest
MeasureRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
MeasureRegistryServiceExistRequest
MeasureRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_measure | bool | | |
MeasureRegistryServiceGetRequest
MeasureRegistryServiceGetResponse
| Field | Type | Label | Description |
|---|
| measure | Measure | | |
MeasureRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
MeasureRegistryServiceListResponse
| Field | Type | Label | Description |
|---|
| measure | Measure | repeated | |
MeasureRegistryServiceUpdateRequest
| Field | Type | Label | Description |
|---|
| measure | Measure | | |
MeasureRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
PropertyRegistryServiceCreateRequest
| Field | Type | Label | Description |
|---|
| property | Property | | |
PropertyRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
PropertyRegistryServiceDeleteRequest
PropertyRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
PropertyRegistryServiceExistRequest
PropertyRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_property | bool | | |
PropertyRegistryServiceGetRequest
PropertyRegistryServiceGetResponse
| Field | Type | Label | Description |
|---|
| property | Property | | |
PropertyRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
PropertyRegistryServiceListResponse
| Field | Type | Label | Description |
|---|
| properties | Property | repeated | |
PropertyRegistryServiceUpdateRequest
| Field | Type | Label | Description |
|---|
| property | Property | | |
PropertyRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
RouteTable
RouteTable represents a collection of nodes grouped by their health state. It provides a view of nodes that are registered, actively healthy, and those being evicted.
| Field | Type | Label | Description |
|---|
| registered | Node | repeated | registered contains all nodes that have been discovered and registered in this route. |
| active | string | repeated | active contains node names (Node.Metadata.Name) that are currently healthy and can handle requests. |
| evictable | string | repeated | evictable contains node names (Node.Metadata.Name) that are unhealthy and being retried before eviction. |
SIDXInfo
SIDXInfo contains information about sidx.
| Field | Type | Label | Description |
|---|
| data_count | int64 | | data_count is the number of entries in sidx. |
| data_size_bytes | int64 | | data_size_bytes is the size of sidx in bytes. |
| part_count | int64 | | part_count is the number of parts in sidx. |
SchemaInfo
SchemaInfo contains information about all schema objects in a group.
| Field | Type | Label | Description |
|---|
| streams | string | repeated | streams is the list of stream names in the group. |
| measures | string | repeated | measures is the list of measure names in the group. |
| traces | string | repeated | traces is the list of trace names in the group. |
| properties | string | repeated | properties is the list of property names in the group. |
| index_rules | string | repeated | index_rules is the list of index rule names in the group. |
| index_rule_bindings | string | repeated | index_rule_bindings is the list of index rule binding names in the group. |
| topn_aggregations | string | repeated | topn_aggregations is the list of TopN aggregation names in the group. |
SegmentInfo
SegmentInfo contains information about a specific time segment.
| Field | Type | Label | Description |
|---|
| segment_id | string | | segment_id is the unique identifier of the segment. |
| time_range_start | string | | time_range_start is the start time of the segment. |
| time_range_end | string | | time_range_end is the end time of the segment. |
| shard_info | ShardInfo | repeated | shard_info contains information about each shard in this segment. |
| series_index_info | SeriesIndexInfo | | series_index_info contains information about the series index. |
SeriesIndexInfo
SeriesIndexInfo contains information about the series index.
| Field | Type | Label | Description |
|---|
| data_count | int64 | | data_count is the number of entries in the series index. |
| data_size_bytes | int64 | | data_size_bytes is the size of the series index in bytes. |
ShardInfo
ShardInfo contains information about a specific shard.
| Field | Type | Label | Description |
|---|
| shard_id | uint32 | | shard_id is the unique identifier of the shard. |
| data_count | int64 | | data_count is the number of data entries in this shard. |
| data_size_bytes | int64 | | data_size_bytes is the size of data in this shard in bytes. |
| part_count | int64 | | part_count is the number of parts in this shard. |
| inverted_index_info | InvertedIndexInfo | | inverted_index_info contains information about the inverted index. |
| sidx_info | SIDXInfo | | sidx_info contains information about sidx. |
| file_part_count | int64 | | file_part_count is the number of file parts (excluding in-memory parts) in this shard. |
Snapshot
SnapshotRequest
SnapshotRequest.Group
SnapshotResponse
| Field | Type | Label | Description |
|---|
| snapshots | Snapshot | repeated | |
StreamRegistryServiceCreateRequest
| Field | Type | Label | Description |
|---|
| stream | Stream | | |
StreamRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
StreamRegistryServiceDeleteRequest
StreamRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
StreamRegistryServiceExistRequest
StreamRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_stream | bool | | |
StreamRegistryServiceGetRequest
StreamRegistryServiceGetResponse
| Field | Type | Label | Description |
|---|
| stream | Stream | | |
StreamRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
StreamRegistryServiceListResponse
| Field | Type | Label | Description |
|---|
| stream | Stream | repeated | |
StreamRegistryServiceUpdateRequest
| Field | Type | Label | Description |
|---|
| stream | Stream | | |
StreamRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
TopNAggregationRegistryServiceCreateRequest
TopNAggregationRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
TopNAggregationRegistryServiceDeleteRequest
TopNAggregationRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
TopNAggregationRegistryServiceExistRequest
TopNAggregationRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_top_n_aggregation | bool | | |
TopNAggregationRegistryServiceGetRequest
TopNAggregationRegistryServiceGetResponse
TopNAggregationRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
TopNAggregationRegistryServiceListResponse
TopNAggregationRegistryServiceUpdateRequest
TopNAggregationRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | mod_revision is the etcd revision assigned by the server on successful create/update. |
TraceRegistryServiceCreateRequest
| Field | Type | Label | Description |
|---|
| trace | Trace | | |
TraceRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
TraceRegistryServiceDeleteRequest
TraceRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the etcd revision of the tombstone; zero if the server did not record one. |
TraceRegistryServiceExistRequest
TraceRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_trace | bool | | |
TraceRegistryServiceGetRequest
TraceRegistryServiceGetResponse
| Field | Type | Label | Description |
|---|
| trace | Trace | | |
TraceRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
TraceRegistryServiceListResponse
| Field | Type | Label | Description |
|---|
| trace | Trace | repeated | |
TraceRegistryServiceUpdateRequest
| Field | Type | Label | Description |
|---|
| trace | Trace | | |
TraceRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
GroupDeletionTask.Phase
Phase represents the current phase of the deletion task.
| Name | Number | Description |
|---|
| PHASE_UNSPECIFIED | 0 | |
| PHASE_PENDING | 1 | PHASE_PENDING indicates the task is waiting to start. |
| PHASE_IN_PROGRESS | 2 | PHASE_IN_PROGRESS indicates the task is currently executing. |
| PHASE_COMPLETED | 3 | PHASE_COMPLETED indicates the task has completed successfully. |
| PHASE_FAILED | 4 | PHASE_FAILED indicates the task has failed. |
ClusterStateService
GroupRegistryService
IndexRuleBindingRegistryService
IndexRuleRegistryService
MeasureRegistryService
NodeQueryService
PropertyRegistryService
SnapshotService
StreamRegistryService
TopNAggregationRegistryService
TraceRegistryService
banyandb/fodc/v1/rpc.proto
Call
CrashBreadcrumb
CrashBreadcrumb.FieldsEntry
CrashPanicRecord
CrashPanicRecord.ProcessMetadataEntry
FetchPressureProfile
| Field | Type | Label | Description |
|---|
| request_id | string | | proxy-generated per fetch; echoed back in every PressureProfileChunk to correlate |
| profile_id | string | | |
| type | string | | "heap" |
| filepath | string | | the absolute path the agent reported in PressureProfileInfo.filepath; agent opens it AFTER validating it is within --pressure-profiler-dir |
GroupLifecycleInfo
| Field | Type | Label | Description |
|---|
| name | string | | |
| catalog | string | | |
| resource_opts | banyandb.common.v1.ResourceOpts | | |
| data_info | banyandb.database.v1.DataInfo | repeated | |
| errors | string | repeated | errors lists every failure observed while collecting data_info for this group: top-level CollectDataInfo failures (GetGroup, missing collector, dial failure -- prefixed "top-level: ") and per-node broadcast failures (prefixed "future error: ", "node error: ", "broadcast failed: "). Combined with len(data_info), consumers can tell the following four states apart: - data_info empty && errors empty -> no nodes reported (group inactive) - data_info empty && errors non-empty -> total failure - data_info non-empty && errors empty -> full success - data_info non-empty && errors non-empty -> partial failure |
InspectAllRequest
InspectAllResponse
LifecycleData
LifecycleReport
ListComplete
Agent -> Proxy: sent once after all records for a ListProfiles request have been streamed (including the zero-record case), so the proxy knows the agent is done without waiting out a fixed window.
| Field | Type | Label | Description |
|---|
| request_id | string | | echoes ListProfiles.request_id |
ListProfiles
Proxy -> Agent: stream all capture-event metadata for this request id.
| Field | Type | Label | Description |
|---|
| request_id | string | | proxy-generated per list; echoed back in ListComplete to correlate |
Metric
Metric.LabelsEntry
PressureProfileChunk
One slice of a profile's bytes during download.
| Field | Type | Label | Description |
|---|
| request_id | string | | echoes FetchPressureProfile.request_id -- correlates this chunk stream to its fetch |
| profile_id | string | | |
| type | string | | "heap" |
| data | bytes | | a bounded slice (e.g. <= 1MB) |
| last | bool | | true on the final chunk |
| error | string | | non-empty if the file cannot be served (e.g. evicted / not found) |
PressureProfileInfo
One pprof profile inside a capture event (metadata only, no bytes).
| Field | Type | Label | Description |
|---|
| type | string | | "heap" |
| filename | string | | base name, e.g. "heap.pprof" |
| filepath | string | | absolute path on the agent's disk, e.g. /tmp/pressure-profiles/20260627T101112.000000000Z/heap.pprof |
| format | string | | "pprof" (gzip-compressed protobuf) |
| size_bytes | int64 | | on-disk size |
PressureProfileRecord
Metadata for one capture event (no bytes). pod/role are NOT carried here: the proxy enriches them from the registered AgentIdentity, same as crash.
RegisterAgentRequest
RegisterAgentRequest.LabelsEntry
RegisterAgentResponse
StreamClusterTopologyRequest
StreamClusterTopologyResponse
| Field | Type | Label | Description |
|---|
| request_topology | bool | | Request topology from agent |
StreamCrashDiagnosticsRequest
StreamCrashDiagnosticsResponse
| Field | Type | Label | Description |
|---|
| request_diagnostics | bool | | Request crash diagnostics from agent |
StreamLifecycleRequest
StreamLifecycleResponse
| Field | Type | Label | Description |
|---|
| request_lifecycle | bool | | |
StreamMetricsRequest
StreamMetricsResponse
StreamPressureProfilesRequest
Agent -> Proxy: either a metadata record (answer to list_profiles) or a byte chunk (answer to fetch_profile).
StreamPressureProfilesResponse
Proxy -> Agent: either "stream all your metadata" or "stream one profile's bytes".
Topology
MetricType
MetricType represents the Prometheus metric type.
| Name | Number | Description |
|---|
| METRIC_TYPE_UNSPECIFIED | 0 | |
| METRIC_TYPE_GAUGE | 1 | |
| METRIC_TYPE_COUNTER | 2 | |
| METRIC_TYPE_HISTOGRAM | 3 | |
| METRIC_TYPE_SUMMARY | 4 | |
| METRIC_TYPE_UNTYPED | 5 | |
FODCService
GroupLifecycleService
GroupLifecycleService provides group lifecycle information from liaison nodes. Registered on the internal gRPC server so FODC agent can access it.
banyandb/measure/v1/write.proto
DataPointSpec
DataPointSpec defines the specification of a data point.
| Field | Type | Label | Description |
|---|
| tag_family_spec | TagFamilySpec | repeated | the tag family specification |
| field_names | string | repeated | the field names |
DataPointValue
DataPointValue is the data point for writing. It only contains values.
InternalWriteRequest
TagFamilySpec
TagFamilySpec defines the specification of a tag family.
| Field | Type | Label | Description |
|---|
| name | string | | name of the tag family |
| tag_names | string | repeated | names of tags in the tag family |
WriteRequest
WriteRequest is the request contract for write
| Field | Type | Label | Description |
|---|
| metadata | banyandb.common.v1.Metadata | | the metadata is required only for the first request of gRPC stream. |
| data_point | DataPointValue | | the data_point is required. |
| message_id | uint64 | | the message_id is required. |
| data_point_spec | DataPointSpec | | the data point specification. If this is not set with the indicated metadata, use the schema definition. If this is not set, use the existing spec declaration from previous requests in the current gRPC stream. |
WriteResponse
WriteResponse is the response contract for write
| Field | Type | Label | Description |
|---|
| message_id | uint64 | | the message_id from request. |
| status | string | | status indicates the request processing result |
| metadata | banyandb.common.v1.Metadata | | the metadata from request when request fails |
banyandb/measure/v1/rpc.proto
DeleteExpiredSegmentsRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
| segment_suffixes | string | repeated | |
DeleteExpiredSegmentsResponse
| Field | Type | Label | Description |
|---|
| deleted | int64 | | |
MeasureService
banyandb/pipeline/v1/trace_pipeline.proto
TracePipelineRegistryServiceCreateRequest
TracePipelineRegistryServiceCreateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
TracePipelineRegistryServiceDeleteRequest
TracePipelineRegistryServiceDeleteResponse
| Field | Type | Label | Description |
|---|
| deleted | bool | | |
| delete_time | int64 | | delete_time is the server-assigned tombstone timestamp in unix nanos. |
| mod_revision | int64 | | mod_revision is the revision of the tombstone; zero if the server did not record one. |
TracePipelineRegistryServiceExistRequest
TracePipelineRegistryServiceExistResponse
| Field | Type | Label | Description |
|---|
| has_group | bool | | |
| has_trace_pipeline_config | bool | | |
TracePipelineRegistryServiceGetRequest
TracePipelineRegistryServiceGetResponse
TracePipelineRegistryServiceListRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
TracePipelineRegistryServiceListResponse
TracePipelineRegistryServiceUpdateRequest
TracePipelineRegistryServiceUpdateResponse
| Field | Type | Label | Description |
|---|
| mod_revision | int64 | | |
TracePipelineRegistryService
TracePipelineRegistryService manages TracePipelineConfig resources, mirroring the registry services of every other schema resource. Create/Update run the admission and conflict checks of §2.3/§2.4 of the design.
banyandb/property/v1/gossip.proto
PropagationContext
| Field | Type | Label | Description |
|---|
| nodes | string | repeated | |
| max_propagation_count | int32 | | |
| current_propagation_count | int32 | | |
| origin_node | string | | |
PropagationRequest
PropagationResponse
PropagationTraceContext
GossipService
banyandb/property/v1/repair.proto
DifferTreeSummary
| Field | Type | Label | Description |
|---|
| nodes | TreeLeafNode | repeated | if the nodes is empty, mean the server side don't have more tree leaf nodes to send. |
PropertyMissing
| Field | Type | Label | Description |
|---|
| entity | string | | |
PropertySync
PropertySyncWithFrom
RepairRequest
| Field | Type | Label | Description |
|---|
| tree_root | TreeRoot | | compare stage |
| tree_slots | TreeSlots | | |
| property_missing | PropertyMissing | | repair stage case 1: client missing but server existing |
| property_sync | PropertySync | | case 2: client existing but server missing case 3: SHA value mismatches |
| wait_next_differ | WaitNextDifferData | | wait next differ tree summary for process |
RepairResponse
RootCompare
| Field | Type | Label | Description |
|---|
| tree_found | bool | | |
| root_sha_match | bool | | |
TreeLeafNode
| Field | Type | Label | Description |
|---|
| slot_index | int32 | | slot_index is the index of the slot in the tree. |
| exists | bool | | if the slot is empty, means the server side don't have the slot. |
| entity | string | | if the slot and entity exists, the SHA value of the entity. |
| sha | string | | |
TreeRoot
TreeSlotSHA
TreeSlots
WaitNextDifferData
PropertySyncFromType
| Name | Number | Description |
|---|
| PROPERTY_SYNC_FROM_TYPE_UNSPECIFIED | 0 | |
| PROPERTY_SYNC_FROM_TYPE_MISSING | 1 | client missing but server existing |
| PROPERTY_SYNC_FROM_TYPE_SYNC | 2 | client existing but server missing or SHA value mismatches |
RepairService
banyandb/schema/v1/internal.proto
DeleteSchemaRequest
DeleteSchemaResponse
| Field | Type | Label | Description |
|---|
| found | bool | | |
InsertSchemaRequest
InsertSchemaResponse
ListSchemasRequest
ListSchemasResponse
| Field | Type | Label | Description |
|---|
| properties | banyandb.property.v1.Property | repeated | |
| delete_times | int64 | repeated | delete_times maps to properties in the same order. 0 means not deleted, >0 means deletion timestamp. |
RepairSchemaRequest
RepairSchemaResponse
UpdateSchemaRequest
UpdateSchemaResponse
WatchSchemasRequest
WatchSchemasResponse
SchemaEventType
| Name | Number | Description |
|---|
| SCHEMA_EVENT_TYPE_UNSPECIFIED | 0 | |
| SCHEMA_EVENT_TYPE_INSERT | 1 | |
| SCHEMA_EVENT_TYPE_UPDATE | 2 | |
| SCHEMA_EVENT_TYPE_DELETE | 3 | |
| SCHEMA_EVENT_TYPE_REPLAY_DONE | 4 | |
SchemaManagementService
SchemaUpdateService
banyandb/stream/v1/write.proto
ElementValue
| Field | Type | Label | Description |
|---|
| element_id | string | | element_id could be span_id of a Span or segment_id of a Segment in the context of stream |
| timestamp | google.protobuf.Timestamp | | timestamp is in the timeunit of milliseconds. It represents 1) either the start time of a Span/Segment, 2) or the timestamp of a log |
| tag_families | banyandb.model.v1.TagFamilyForWrite | repeated | the order of tag_families' items match TagFamilySpec |
InternalWriteRequest
| Field | Type | Label | Description |
|---|
| shard_id | uint32 | | |
| entity_values | banyandb.model.v1.TagValue | repeated | |
| request | WriteRequest | | |
| raw_element_id | uint64 | | raw_element_id carries the original storage-internal eID (an already-hashed uint64) forwarded by lifecycle row-replay. When non-zero, the receiver uses it directly and skips the HashStr step on element.element_id, so a logical element migrated through both chunk-sync and row-replay paths keeps the same target-side eID and query-layer dedup stays consistent. SDK and topN write paths leave this unset (0). |
TagFamilySpec
TagFamilySpec defines the specification of a tag family.
| Field | Type | Label | Description |
|---|
| name | string | | name of the tag family |
| tag_names | string | repeated | names of tags in the tag family |
WriteRequest
| Field | Type | Label | Description |
|---|
| metadata | banyandb.common.v1.Metadata | | the metadata is required only for the first request of gRPC stream. |
| element | ElementValue | | the element is required. |
| message_id | uint64 | | the message_id is required. |
| tag_family_spec | TagFamilySpec | repeated | the tag family specification. If this is not set with the indicated metadata, use the schema definition. If this is not set, use the existing spec declaration from previous requests in the current gRPC stream. |
WriteResponse
| Field | Type | Label | Description |
|---|
| message_id | uint64 | | the message_id from request. |
| status | string | | status indicates the request processing result |
| metadata | banyandb.common.v1.Metadata | | the metadata from request when request fails |
banyandb/stream/v1/rpc.proto
DeleteExpiredSegmentsRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
| segment_suffixes | string | repeated | |
DeleteExpiredSegmentsResponse
| Field | Type | Label | Description |
|---|
| deleted | int64 | | |
StreamService
banyandb/trace/v1/write.proto
InternalWriteRequest
TagSpec
| Field | Type | Label | Description |
|---|
| tag_names | string | repeated | |
WriteRequest
WriteResponse
banyandb/trace/v1/rpc.proto
DeleteExpiredSegmentsRequest
| Field | Type | Label | Description |
|---|
| group | string | | |
| segment_suffixes | string | repeated | |
DeleteExpiredSegmentsResponse
| Field | Type | Label | Description |
|---|
| deleted | int64 | | |
TraceService
Scalar Value Types
| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
|---|
| double | | double | double | float | float64 | double | float | Float |
| float | | float | float | float | float32 | float | float | Float |
| int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
| int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
| uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
| uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
| sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
| sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
| fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
| fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
| sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
| sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
| bool | | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass |
| string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
| bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |