Migrating from Promscrape V1 to V2
Promscrape is the lightweight Prometheus server in the Sysdig agent. An
updated version of
promscrape, named Promscrape V2 is available. This configuration is controlled by the
prom_discovery_service parameter in the
dragent.yaml file. To use the latest features, such as Service Discovery and Monitoring Integrations, you need to have this option enabled in your environment.
Compare Promscrape V1 and V2
The main difference between V1 and V2 is how scrape targets are determined.
In v1 targets are found through
process-filtering rules configured in
dragent.default.yaml (if no rules are given in
process-filtering rules are applied to all the
running processes on the host. Matches are made based on process
attributes, such as process name or TCP ports being listened to, as well
as associated contexts from docker or Kubernetes, such as container
labels or Kubernetes annotations.
With Promscrape V2, scrape targets are determined by
fields in a
prometheus.yaml file (or the
file if no
prometheus.yaml exists). Because
promscrape is adapted
from the open-source Prometheus server, the
scrape_config settings are
compatible with the normal Prometheus configuration. For more
information, see Configuration.
Migrate Using Default Configuration
The default configuration for Promscrape v1 triggers the scraping based on standard Kubernetes pod annotations and container labels. The default configuration for v2 currently triggers scraping only based on the standard Kubernetes pod annotations leveraging the Prometheus native Kubernetes service discovery. Use the following configuration:
The port number to scrape
Optional. It will scrape all pod-registered ports if omitted.
The default is
The default is
Users running Kubernetes with Promscrape v1 default rules and triggering scraping based on pod annotations, need not take any action to migrate to v2. The migration happens automatically.
Users operating non-Kubernetes environments might need to continue using v1 for now, depending on how scraping is triggered. As of today
promscrape.v2doesn’t support leveraging container and Docker labels to discover Prometheus metrics endpoints. If your environment is one of these, define static jobs with the
IP:portto be scrapped.
Migrate Using Custom Rules
If you relying on custom
process_filter rules to collect metrics, use
any method using standard Prometheus configuration syntax to scrape the
endpoints. We recommend one of the following:
- Adopt the standard approach of adding the standard Prometheus annotations to their pods. For more information, see Migrate Using Default Configuration.
- Write a Prometheus
scrape_configby using Kubernetes pods service discovery and use the appropriate pod metadata to trigger their scrapes.
See the below example for converting your
process_filter rules to
Appchecks are not compatble with Promscrape v2. See Configure Monitoring Integrations for supported integrations.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.