diff --git a/admin/prometheus.md b/admin/prometheus.md new file mode 100644 index 000000000..5af44108b --- /dev/null +++ b/admin/prometheus.md @@ -0,0 +1,33 @@ +--- +title: Prometheus integration +description: Learn how to configure Prometheus with Coder. +--- + +The Prometheus integration enables you to query and visualize Coder's platform +metrics. + +## Requirements + +- A Coder deployment on Kubernetes +- [Prometheus Operator](https://github.com/prometheus-operator/prometheus-operator) +installed on your cluster + +## Configuration + +Coder sends Prometheus-formatted metrics to port `2112` on the `coderd` +container. Use the below PodMonitor resource to connect the Prometheus Operator +to this endpoint: + +```yaml +apiVersion: monitoring.coreos.com/v1 +kind: PodMonitor +metadata: + name: master-monitor + namespace: coder +spec: + selector: + matchLabels: + app.kubernetes.io/component: coderd + podMetricsEndpoints: + - port: prom-coderd +``` diff --git a/manifest.json b/manifest.json index ad99fe472..a59ad71f3 100644 --- a/manifest.json +++ b/manifest.json @@ -371,6 +371,9 @@ { "path": "./admin/git.md" }, + { + "path": "./admin/prometheus.md" + }, { "path": "./admin/licensing.md" },