You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: content/docs/enterprise/metrics.md
+18-6
Original file line number
Diff line number
Diff line change
@@ -4,24 +4,30 @@ sidebar_label: Metrics
4
4
description: Use Prometheus as a metrics data store.
5
5
---
6
6
7
-
Pomerium Enterprise uses Prometheus as a metrics collection back-end. You can configure Pomerium and the Console to talk to an existing Prometheus server, or configure the embedded Prometheus backend.
7
+
Pomerium Enterprise uses Prometheus as a metrics collection back-end. You can configure Pomerium and the Console to talk to an existing Prometheus server, or configure the embedded Prometheus backend. This guide assumes you're running both Pomerium and Pomerium Enterprise on localhost `127.0.0.1`.
8
8
9
9
:::tip
10
10
For production deployments, we suggest using a dedicated Prometheus instance.
11
11
:::
12
12
13
13
## Prepare Pomerium
14
14
15
-
1. In the Pomerium `config.yaml`, define the [`metrics_address`](/docs/reference/metrics-address) key to a network interface and/or port. For example:
15
+
1. In the Pomerium `pomerium-config.yaml`, define the [`metrics_address`](/docs/reference/metrics-address) key to a network interface and/or port. For example:
16
16
17
-
```yaml title="config.yaml"
18
-
metrics_address: 192.0.2.31:9999
17
+
```yaml title="pomerium-config.yaml"
18
+
metrics_address: 127.0.0.1:9091
19
19
```
20
20
21
21
The example above has Pomerium providing metrics at port `9999` on an IP address reachable by the Pomerium Console service.
22
22
23
23
If you're running Pomerium Enterprise in a distributed environment where the IP address is not known at the time of deployment, you can use the resolvable FQDN of the Pomerium host (`pomerium0.internal.mycompany.com`, for example), or override this key with the environment variable `METRICS_ADDRESS`. We do not recommend exposing this endpoint to public traffic as it can contain potentially sensitive information.
24
24
25
+
1. In the Pomerium Enterprise `pomerium-enterprise-config.yaml`, define the `metrics_addr` key to a network interface and/or port. For example:
26
+
27
+
```yaml title="config.yaml"
28
+
metrics_addr: 127.0.0.1:9092
29
+
```
30
+
25
31
## External Prometheus
26
32
27
33
1. Add the listener to your Prometheus configuration, usually via `prometheus.yml`:
@@ -31,7 +37,12 @@ For production deployments, we suggest using a dedicated Prometheus instance.
31
37
scrape_interval: 30s
32
38
scrape_timeout: 5s
33
39
static_configs:
34
-
- targets: ['192.0.2.10:9999']
40
+
- targets: ['127.0.0.1:9901']
41
+
- job_name: 'Pomerium Enterprise'
42
+
scrape_interval: 30s
43
+
scrape_timeout: 5s
44
+
static_configs:
45
+
- targets: ['127.0.0.1:9902']
35
46
36
47
```
37
48
@@ -47,9 +58,10 @@ For production deployments, we suggest using a dedicated Prometheus instance.
47
58
prometheus_url: http://192.168.122.50:9090
48
59
```
49
60
50
-
1. Restart the Pomerium and Pomerium Enterprise services. You should now see route traffic data in the Enterprise Console:
61
+
2. Restart the Pomerium and Pomerium Enterprise services. You should now see route traffic and External Data Source monitoring data in the Enterprise Console:
51
62
52
63

64
+

0 commit comments