> ## Documentation Index
> Fetch the complete documentation index at: https://mw-docs.middleware.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prometheus

> Prometheus Integration - Setup & Installation Docs | Middleware

Retrieve metrics from a Prometheus endpoint.

# Prerequisites

Middleware Host Agent (MW Agent) must be installed on your local machine. To install the MW Agent, see our [Installation Guide](https://docs.middleware.io/agent-installation/overview).

# Setup

Follow these steps to set up the Prometheus integration:

1. In the Middleware UI, navigate to the [**Integrations**](https://app.middleware.io/installation#integration/allintegration) page
2. Click on the Prometheus integration and you will see some settings as shown below:

<img src="https://mintcdn.com/middlewareio/cgLzouXcJUXtP_sv/images/integration/prometheus-integration.png?fit=max&auto=format&n=cgLzouXcJUXtP_sv&q=85&s=b5dfb0cc931ad32ac7384ff55bf8684c" width="1852" height="1017" data-path="images/integration/prometheus-integration.png" />

a) First you will need to select the host from which you can access your prometheus endpoint.
b) Add Prometheus Endpoint Name and URL, which we call Job and Target in Prometheus. (You can also add multiple URLs under 1 name)
Once you save these settings. Middleware agent will start collecting metrics from the Prometheus endpoint.

# Create your own dashboard

<p>You can create your custom dashboard based on prometheus endpoint we just scraped.</p>
<p>When adding a new widget to an existing dashboard, you will find a list of available Prometheus metrics under the "service" data source.</p>
<p>These metrics can be visualized using various widget types, such as Timeseries, Bar Chart, Pie Chart, and more.</p>

<Note>Data source "service" contains all the miscellaneous sources. Soon, we will be promoting "prometheus" as a data source.</Note>

<img src="https://mintcdn.com/middlewareio/cgLzouXcJUXtP_sv/images/integration/prometheus-integration-2.png?fit=max&auto=format&n=cgLzouXcJUXtP_sv&q=85&s=d6820d22550d71a57d9c67ba12d9edf1" width="1836" height="937" data-path="images/integration/prometheus-integration-2.png" />

# Troubleshooting

<Accordion title="Missing Integrations Menu">
  If you do not see the Integrations Menu in Middlware, that means your account has not been granted `Installation` permissions. Contact your system administrator to add the `Installation` permission to your user role in Settings.
</Accordion>

# Next Steps

* [How to Create Alerts](https://docs.middleware.io/workflow/alerting/setup-alert)
* [Dashboard Basics & Customization](https://docs.middleware.io/workflow/custom-dashboard/dashboard-builder-overview)
* [Custom Telemetry Ingestion](https://docs.middleware.io/open-telemetry/otel-getting-started)
* [Getting Started With Real User Monitoring (RUM)](https://docs.middleware.io/rum/rum-overview)
* [Data Ingestion APIs](https://docs.middleware.io/data-ingestion-apis/opentelemetry-metrics)
* [Configure OTel Collector Contrib](https://docs.middleware.io/open-telemetry/otel-collector)

<Note> Need assistance or want to learn more about Middleware? Contact us at support\[at]middleware.io. </Note>