Sylvie-Wxr commented on code in PR #496: URL: https://github.com/apache/skywalking-banyandb/pull/496#discussion_r1690837327
########## docs/observability.md: ########## @@ -4,12 +4,33 @@ This document outlines the observability features of BanyanDB, which include met ## Metrics -BanyanDB has built-in support for metrics collection. Currently, there is only one supported metrics provider: `Prometheus`. It is auto enabled at run time through `observability-modes` flag. +BanyanDB has built-in support for metrics collection. Currently, there are two supported metrics provider: `prometheus` and `native`. These can be enabled through `observability-modes` flag. + +### Prometheus + +Prometheus is auto enabled at run time, if no flag is passed or if `promethus` is set in `observability-modes` flag. When the Prometheus metrics provider is enabled, the metrics server listens on port `2121`. This allows Prometheus to scrape metrics data from BanyanDB for monitoring and analysis. The Docker image is tagged as "prometheus" to facilitate cloud-native operations and simplify deployment on Kubernetes. This allows users to directly deploy the Docker image onto their Kubernetes cluster without having to rebuild it with the "prometheus" tag. +### Self-observability + +If the `observability-modes` flag is set to `native`, the self-observability metrics provider will be enabled. The metrics will be displayed in the dashboard of [skywalking-banyandb-webapp](http://localhost:17913/) + +![dashboard](https://skywalking.apache.org/doc-graph/banyandb/v0.7.0/dashboard.png) + +#### Metrics storage + +In self-observability, the metrics data is stored in BanyanDB within the ` _monitoring` internal group. Each metric will be created as a new `measure` within this group. + +#### Write Flow + +![self-observability-write](https://skywalking.apache.org/doc-graph/banyandb/v0.7.0/self-observability-write.png) Review Comment: Added explanation. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: notifications-unsubscr...@skywalking.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org