Skip to main content

Prometheus Scrape plugin

The Prometheus Scrape plugin collects data from Prometheus endpoints. The Prometheus Scrape plugin must be installed on a host to begin collecting metrics.

When to use the Prometheus Scrape plugin

Moogsoft Cloud offers three convenient mechanisms for integration with Prometheus.

  • Use the Moogsoft Prometheus Scrape plugin with a Moogsoft Collector, when you:

    • Want to gather and send Prometheus Scrape data to the Moogsoft Events API for intelligent monitoring.

    • Don’t want to make direct outbound calls from your environment.

    • Can install a collector on a host in your environment and it will act as a proxy.

  • Moogsoft offers two other Prometheus integrations, Prometheus Alertmanager and Prometheus Remote Write:

    • Use the Prometheus Alertmanager integration to ingest notifications from Prometheus and send them to Moogsoft with automatic mapping.

    • Use the Prometheus Remote Write integration to ingest metrics from any external system that supports the Prometheus remote write protocol.

    • Use either integration when you can configure your Prometheus instance to authenticate against a Moogsoft endpoint to send data to Moogsoft. These integrations do not require a Moogsoft Collector and you can use authentication.

Install Prometheus

To have the Moogsoft Prometheus plugin scrape data from a Prometheus endpoint and send data to Moogsoft Cloud, install Prometheus on the systems that you want to monitor.

Install a Moogsoft Collector

To use the Prometheus Scrape plugin, in your Moogsoft UI:

Navigate to the Integrations > Ingestion Services > Collector tab and install a Moogsoft Collector on your host. Read Installing a Linux or Mac collector or Installing a Windows collector, for detailed information about installing a collector.

  1. You can install a collector on the same host that is running Prometheus.

  2. You can install a collector on a different host and scrape data from Prometheus.

After installing a collector go to Ingestion Services > Collectors and click on a specific collector, then select the Prometheus Scrape plugin.

Note

Do not go directly to the Plugins tab, to configure the plugin, as the plugin needs to be associated with a specific collector to work properly.

You can set up the collector plugin when you download a new collector, or any time thereafter when configuring an existing collector.

Configure the Prometheus Scrape plugin

When you click on your Collector > Prometheus Scrape Plugin, a pop-up panel provides links to install a collector or configure the Prometheus Scrape plugin.

Parameter configuration:

  1. From the Prometheus Scrape Plugin > Configuration tab, define the following Prometheus Scrape Plugin parameters::

    • Endpoints — Specify the endpoints for the configuration. The default endpoint is set to http://localhost:9100/metrics. You can use either a URL or IP address such as, such as http://somehost:someport/metrics or http://ipaddress:someport/metrics. You can also have multiple endpoints on a single machine for different types of data (one for system metrics, one for SQL, and so forth).

      Note

      Test your endpoints before specifying them, if one does not work it can prevent the plugin from collecting data from the other endpoints.

    • Scrape Interval (sec) — Set the frequency with which Moogsoft monitors and ingests metrics; the default is every 15 seconds.

  2. Toggle on the Enable option on when you are ready to start plugin data ingestion.

Validate the Prometheus Scrape plugin integration

To validate the integration, you can try some of the following options:

  • Test that your endpoints are working. You may want to specify one at a time and test each one. If one endpoint is not working in a series, it can stop the others from working.

  • Test that the Prometheus Scrape Plugin Collector can listen on the specified endpoint and port number. For an easy test, install Prometheus on the same host as the plugin and use the default localhost provided in the plugin Parameter Configuration panel.

  • Check Ingestion Services > Collectors > Collector Logs to help troubleshoot your installation and configuration.

  • To check if Prometheus Scrape succeeded in transmitting data to the plugin:

    • In Moogsoft, click Metrics and look for the endpoint to see if the Prometheus Scrape data is flowing into the plugin.

    • Check the Prometheus Metrics panel and specify one metric in the Moogsoft Metrics filter to check on a particular metric.

Discover more

In this section: