Data
Plugin
banyandb-bydbql
BanyanDB, as an observability database, aims to ingest, analyze and store Metrics, Tracing and Logging data. It's designed to handle observability data generated by observability platform and APM system, like Apache SkyWalking etc.
Plugin Signal60/100Solid
maintained100
capable37
documented30
adopted54
Install on Claude Code
> /plugin marketplace add apache/skywalking-banyandb> /plugin install banyandb-bydbql@banyandb
Stats
348
Stars
113
Forks
Active
Maintenance
Go
Language
Apache-2.0
License
1h ago
Last commit
5y ago
Created
Repo: apache/skywalking-banyandb
In this plugin
See everything inside What's inside
Skills
4/bydbqlGenerate, validate, and optionally execute read-only BanyanDB BydbQL for STREAM, MEASURE, TRACE, and PROPERTY resources. Use when the user asks to query BanyanDB, translate natural language to BydbQL, inspect BanyanDB schema or data, validate BydbQL, or fetch raw BanyanDB/compilingCompile and build the SkyWalking BanyanDB project. Use when the user asks to compile, build, or generate code for this project./gh-pull-requestCreate a GitHub pull request for SkyWalking BanyanDB. Use when the user asks to create a PR, submit changes, or open a pull request./vendor-updateUpgrade Go/Node.js vendor dependencies and sync tool versions. Use whenever the user says "upgrade dependencies", "update vendors", "vendor update", "run vendor-upgrade", "bump dependencies", "update packages", or asks to run the `vendor-update` Make target. This skill also
MCP
1Badges
5
README
1BanyanDB
BanyanDB, as an observability database, aims to ingest, analyze and store Metrics, Tracing and Logging data. It's designed to handle observability data generated by observability platform and APM system, like Apache SkyWalking etc.
Introduction
BanyanDB, as an observability database, aims to ingest, analyze and store Metrics, Tracing, and Logging data. It's designed to handle observability data generated by Apache SkyWalking. Before BanyanDB emerges, the Databases that SkyWalking adopted are not ideal for the APM data model, especially for saving tracing and logging data. Consequently, There’s room to improve the performance and resource usage based on the nature of SkyWalking data patterns.
The database research community usually uses RUM Conjecture to describe how a database access data. BanyanDB combines several access methods to build a comprehensive APM database to balance read cost, update cost, and memory overhead.
Contact us
- Submit an issue by selecting the BanyanDB component.
- Mail list: dev@skywalking.apache.org. Mail to dev-subscribe@skywalking.apache.org, follow the reply to subscribe the mail list.
- Send
Request to join SkyWalking slackmail to the mail list(dev@skywalking.apache.org), we will invite you in. - For Chinese speaker, send
[CN] Request to join SkyWalking slackmail to the mail list(dev@skywalking.apache.org), we will invite you in. - X (Twitter): @BanyanDB and @ASFSkyWalking
Documentation
Developer tooling
The dump trace-source-catalog subcommand validates the frozen downloaded trace benchmark shard and writes its deterministic
core and secondary-index ledgers. It requires --source-path and a new, outside-source --output-path; see the
trace pipeline merge performance design for the source contract.
The dump trace-generate-fixture subcommand consumes that catalog and the immutable downloaded shard, verifies the default
SkyWalking sampler ratio, and writes the deterministic one-day core and secondary-index fixture through the data-node part
receipt path. It requires --source-path, --catalog-path, a new --output-path, and the built sampler --plugin-path.
The trace benchmark receiver can enable per-merge JSONL recording for the primary, boundary-drain, and cooldown phases. Records classify actual sampler execution, preserve merge depth and input lineage, nest secondary-index work under its core merge, and expose reconciled low-cardinality aggregates plus serial-attribution resource deltas.
Contributing
For developers who want to contribute to this project, see the Contribution Guide.
License
File tree
1755apache/skywalking-banyandbView on GitHub
.agents/
plugins/
marketplace.json
.asf.yaml
.claude-plugin/
marketplace.json
plugin.json
.codex-plugin/
plugin.json
.dlc.json
.dockerignore
.gitattributes
.github/
actions/
build-docker-image/
action.yml
setup-build-env/
action.yml
PULL_REQUEST_TEMPLATE
workflows/
canopy.yml
ci.yml
dead-link-checker.yaml
dependency-review.yml
e2e.yml
flaky-test.yml
prepare.yml
property-repair.yml
publish-docker.yml
quick-start-test.yml
slow-test.yml
test-banyand.yml
test-bydbctl.yml
test-fodc-dashboard-e2e.yml
test-fodc-e2e.yml
test-fodc.yml
test-integration-distributed.yml
test-integration-standalone.yml
test-pkg.yml
test-plugin-sidecar-e2e.yml
test.yml
.gitignore
.golangci-format.yml
.golangci.yml
.licenserc.yaml
.mcp.json
AGENTS.md
api/
.gitignore
buf.gen.yaml
buf.work.yaml
common/
doc.go
id.go
kind_version.go
data/
codec_test.go
codec.go
data.go
frame_counters_test.go
frame_counters.go
measure.go
property.go
snapshot.go
stream_frame_test.go
stream_frame.go
stream.go
trace_frame_test.go
trace_frame.go
trace.go
Makefile
proto/
banyandb/
bydbql/
v1/
query.proto
rpc.proto
cluster/
v1/
node_schema_status.proto
rpc.proto
common/
v1/
common.proto
rpc.proto
trace.proto
database/
v1/
database.proto
rpc.proto
schema.proto
fodc/
v1/
rpc.proto
measure/
v1/
query.proto
rpc.proto
topn.proto
write.proto
model/
v1/
common.proto
query.proto
write.proto
pipeline/
v1/
trace_pipeline.proto
property/
v1/
gossip.proto
property.proto
repair.proto
rpc.proto
schema/
v1/
barrier.proto
internal.proto
stream/
v1/
query.proto
rpc.proto
write.proto
trace/
v1/
query.proto
rpc.proto
write.proto
version.go
buf.lock
buf.yaml
validate/
validate_test.go
validate.go
assets/
banyandb_small.jpg
banyandb.jpeg
banyand/
.gitignore
backup/
backup_test.go
backup.go
lifecycle/
cluster_state.go
current_node.go
lifecycle.go
measure_migration_visitor.go
metrics_test.go
migration_error_test.go
migration_error.go
migration_integration.go
orphan_archive_fatal_test.go
orphan_archive_test.go
orphan_archive.go
progress_mark_test.go
progress.go
report_partial_failure_test.go
retry_test.go
retry.go
roundtrip_measure_orphan_test.go
roundtrip_send_test.go
roundtrip_test.go
row_replay_bufpool_test.go
row_replay_bufpool.go
row_replay_entity_rebuild_test.go
row_replay_entity_rebuild.go
row_replay_measure_pool_test.go
row_replay_measure_pool.go
row_replay_measure.go
row_replay_pipeline.go
row_replay_sender_test.go
row_replay_skip_test.go
row_replay_stream.go
row_replay_test.go
row_replay_trace.go
row_replay.go
segment_boundary_utils_test.go
segment_boundary_utils.go
service.go
skipped_source.go
steps_test.go
steps.go
stream_migration_visitor.go
trace_migration_visitor.go
restore_test.go
restore.go
snapshot/
snapshot.go
timedir_test.go
timedir.go
cmd/
backup/
main.go
dump/
main.go
measure_test.go
measure.go
property_test.go
property.go
sidx.go
stream_test.go
stream.go
trace_catalog.go
trace_fixture.go
trace_test.go
trace.go
lifecycle/
main.go
migration/
analyze.go
copy.go
example/
plan-backup.yaml
plan-live.yaml
runner-pod.yaml
main.go
MIGRATION.md
plan.go
README.md
scripts/
verify-data.sh
verify.go
restore/
main.go
server/
main.go
trace-merge-benchmark/
main.go
doc.go
Dockerfile
dquery/
dquery.go
measure_test.go
measure.go
stream.go
topn.go
trace.go
internal/
benchmark/
controller/
controller_test.go
controller.go
manifest.go
sourcecatalog/
catalog_test.go
catalog.go
checksum.go
model.go
tracebaseline/
capture.go
controlled_helpers_test.go
controlled_run.go
controlled_test.go
controlled.go
driver.go
html_test.go
html.go
model.go
readiness_test.go
readiness.go
server_test.go
server.go
tracefixture/
generate_test.go
generate.go
hash.go
ledger.go
plan_test.go
plan.go
reconcile_test.go
reconcile.go
reference_integration_test.go
sampler_test.go
sampler.go
source.go
dump/
decode.go
dump_test.go
helpers.go
index_resolver.go
iterator.go
measure/
columnar_consistency_test.go
iterator.go
measure_test.go
measure.go
suite_test.go
primary_block.go
scratch.go
stream/
iterator.go
stream_test.go
stream.go
suite_test.go
trace/
iterator.go
suite_test.go
trace_test.go
trace.go
encoding/
tag_encoder_test.go
tag_encoder.go
migration/
classify_test.go
classify.go
executor.go
fsutil_test.go
fsutil.go
migration_measure_test.go
migration_stream_test.go
orchestrator_test.go
orchestrator.go
plan_test.go
plan.go
schemaroot.go
srcroots.go
unionsidx_test.go
unionsidx.go
sidx/
block_reader_test.go
block_reader.go
block_scanner_test.go
block_scanner.go
block_test.go
block_writer.go
block.go
collect_tags_for_filter_test.go
element_test.go
element.go
file_part_sync_test.go
interfaces.go
introducer_test.go
introducer.go
iter_test.go
iter.go
merge_test.go
merge.go
merger_durability_test.go
metadata_test.go
metadata.go
options_test.go
options.go
part_iter_test.go
part_iter.go
part_key_iter_test.go
part_key_iter.go
part_test.go
part_wrapper_test.go
part_wrapper.go
part.go
primary_metadata.go
query_benchmark_test.go
query_result.go
query_test.go
query.go
raw_scan_test.go
raw_scan.go
scan_query.go
sidx_test.go
sidx.go
snapshot_test.go
snapshot.go
sync_test.go
sync.go
tag_filter_op_test.go
tag_filter_op.go
tag_test.go
tag.go
timestamp_test.go
snapshot/
snapshot_test.go
snapshot.go
storage/
cache_test.go
cache.go
disk_monitor_test.go
disk_monitor.go
failed_parts_handler_test.go
failed_parts_handler.go
index_test.go
index.go
inspect_stats_test.go
inspect_stats.go
metrics.go
README.md
rotation_test.go
rotation.go
segment_idle_reclaim_test.go
segment_lifecycle_integration_test.go
segment_test.go
segment.go
shard.go
snapshot_closed_segment_test.go
snapshot_test.go
snapshot.go
storage.go
tsdb_test.go
tsdb.go
version_test.go
version.go
... 1600 moreShowing a partial view of a very large repo.
FAQ
banyandb-bydbql is a Claude Code plugin with 4 hand-picked skills for data work, indexed on Flowy. Install it with the command on its page. It includes bydbql, compiling, gh-pull-request. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is banyandb-bydbql?
- BanyanDB, as an observability database, aims to ingest, analyze and store Metrics, Tracing and Logging data. It's designed to handle observability data generated by observability platform and APM system, like Apache SkyWalking etc.
- How do I install banyandb-bydbql?
- Run these in Claude Code: /plugin marketplace add apache/skywalking-banyandb then /plugin install banyandb-bydbql@banyandb. Then prompt normally.
- Does banyandb-bydbql auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is banyandb-bydbql free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.