Metrics: Add section about Prometheus

docs/integrate/metrics.md

@@ -1,10 +1,69 @@
 (metrics)=
-# Processing monitoring metrics with CrateDB
+# Monitoring and Metrics with CrateDB
 
 Storing metrics data for the long term is a common need in systems monitoring
 scenarios. CrateDB offers corresponding integration adapters.
 
 
+(prometheus)=
+## Prometheus
+
+```{div}
+:style: "float: right"
+[![](https://github.com/crate/crate-clients-tools/assets/453543/8ddb109f-b45f-46b0-8103-30ba491f7142){w=180px}](https://prometheus.io/)
+```
+
+[Prometheus] is an open-source systems monitoring and alerting toolkit
+for collecting metrics data from applications and infrastructures.
+
+Prometheus collects and stores its metrics as time series data, i.e.
+metrics information is stored with the timestamp at which it was recorded,
+alongside optional key-value pairs called labels.
+
+### Features
+
+Prometheus's main features are:
+
+- a multi-dimensional data model with time series data identified by metric name and key/value pairs
+- PromQL, a flexible query language to leverage this dimensionality
+- no reliance on distributed storage; single server nodes are autonomous
+- time series collection happens via a pull model over HTTP
+- pushing time series is supported via an intermediary gateway
+- targets are discovered via service discovery or static configuration
+- multiple modes of graphing and dashboarding support
+
+
+### Remote Endpoints and Storage
+
+The [Prometheus remote endpoints and storage] subsystem, based on its
+[remote write] and [remote read] features, allows to transparently
+send and receive metric samples. It is primarily intended for long term
+storage.
+
+This is where CrateDB comes into place. Using the [CrateDB Prometheus
+Adapter], one can easily store the collected metrics data in CrateDB and
+take advantage of its high ingestion and query speed and friendly UI to
+massively scale-out Prometheus.
+
+
+### Resources
+
+- [CrateDB Prometheus Adapter]
+- [Getting Started With Prometheus and CrateDB for Long-Term Storage]
+- [Storing long-term metrics with Prometheus in CrateDB]
+- [Webinar: Using Prometheus and Grafana with CrateDB Cloud]
+
+![](https://github.com/crate/crate-clients-tools/assets/453543/26b47686-889a-4137-a87f-d6a6b38d56d2){h=200px}
+
+```{seealso}
+[CrateDB and Prometheus]
+```
+
+```{div}
+:style: "clear: both"
+```
+
+
 (telegraf)=
 ## Telegraf
 
@@ -49,6 +108,15 @@ a very minimal memory footprint.
 ```
 
 
+[CrateDB and Prometheus]: https://cratedb.com/integrations/cratedb-and-prometheus
 [CrateDB and Telegraf]: https://crate.io/integrations/cratedb-and-telegraf
+[CrateDB Prometheus Adapter]: https://github.com/crate/cratedb-prometheus-adapter
+[Getting Started With Prometheus and CrateDB for Long-Term Storage]: https://cratedb.com/blog/getting-started-prometheus-cratedb-long-term-storage
+[Prometheus]: https://prometheus.io/
+[Prometheus remote endpoints and storage]: https://prometheus.io/docs/operating/integrations/#remote-endpoints-and-storage
+[remote read]: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#remote_read
+[remote write]: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#remote_write
+[Storing long-term metrics with Prometheus in CrateDB]: https://community.cratedb.com/t/storing-long-term-metrics-with-prometheus-in-cratedb/1012
 [Telegraf]: https://www.influxdata.com/time-series-platform/telegraf/
 [Use CrateDB With Telegraf, an Agent for Collecting & Reporting Metrics]: https://crate.io/blog/use-cratedb-with-telegraf-an-agent-for-collecting-reporting-metrics
+[Webinar: Using Prometheus and Grafana with CrateDB Cloud]: https://cratedb.com/resources/webinars/lp-wb-prometheus-grafana