diff --git a/doc/ci/environments.md b/doc/ci/environments.md
index 371622d3331..df5c66a4c85 100644
--- a/doc/ci/environments.md
+++ b/doc/ci/environments.md
@@ -603,7 +603,7 @@ exist, you should see something like:
 >
 - For the monitor dashboard to appear, you need to:
   - Have enabled the [Prometheus integration][prom]
-  - Configured Prometheus to collect at least one [supported metric](prometheus_library/metrics.md)
+  - Configured Prometheus to collect at least one [supported metric](../user/project/integrations/prometheus_library/metrics.md)
 - With GitLab 9.2, all deployments to an environment are shown directly on the
   monitoring dashboard
 
diff --git a/doc/user/project/integrations/prometheus.md b/doc/user/project/integrations/prometheus.md
index 6b73452168a..a23635d1999 100644
--- a/doc/user/project/integrations/prometheus.md
+++ b/doc/user/project/integrations/prometheus.md
@@ -34,7 +34,7 @@ Depending on your deployment and where you have located your GitLab server, ther
 Installing and configuring Prometheus to monitor applications is fairly straight forward.
 
 1. [Install Prometheus](https://prometheus.io/docs/introduction/install/)
-1. Set up one of the [supported monitoring targets](metrics.md)
+1. Set up one of the [supported monitoring targets](prometheus_library/metrics.md)
 1. Configure the Prometheus server to [collect their metrics](https://prometheus.io/docs/operating/configuration/#scrape_config)
 
 ### Configuring Omnibus GitLab Prometheus to monitor Kubernetes deployments