{ "api_version": "1", "kind": "dse_post", "self": "https://update.dsesecurity.com/api/v1/posts/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "item": { "id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "slug": "choose-the-prometheus-relabeling-stage-from-the-intended-effect", "url": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "alternate_urls": { "markdown": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect.md", "json": "https://update.dsesecurity.com/api/v1/posts/choose-the-prometheus-relabeling-stage-from-the-intended-effect/" }, "title": "Do not expect metric relabeling to remove Prometheus up", "summary": "Prometheus excludes automatically generated series such as up from metric relabeling.", "format": { "slug": "guide", "name": "Guide" }, "priority": { "slug": "info", "name": "Information" }, "featured": false, "image": { "theme": "network-infrastructure", "label": "Networks & infrastructure", "alt": "Resilient network core with engineered blue and gold data paths.", "card_url": "https://update.dsesecurity.com/assets/editorial/network-infrastructure-card.webp?v=1.8.20", "hero_url": "https://update.dsesecurity.com/assets/editorial/network-infrastructure-hero.webp?v=1.8.20", "social_url": "https://update.dsesecurity.com/assets/editorial/network-infrastructure-social-v2.jpg?v=1.8.20", "width": 2400, "height": 1350 }, "topics": [ { "slug": "it", "name": "IT", "url": "https://update.dsesecurity.com/topic/it/" }, { "slug": "networks-infrastructure", "name": "Networks & Infrastructure", "url": "https://update.dsesecurity.com/topic/networks-infrastructure/" } ], "author": { "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/#editorial-team", "type": "Organization" }, "publisher": { "name": "Detection Systems & Engineering", "url": "https://dsesecurity.com/" }, "published_at": "2026-10-20T18:15:35+00:00", "modified_at": "2026-10-20T18:34:33+00:00", "reviewed_on": "2026-10-20", "reading_minutes": 2, "word_count": 257, "potentially_affected": "Review native Prometheus metric filtering separately from target selection, including the automatically generated up exception.", "dse_recommendation": "DSE recommends treating scrape-health series and filtered application samples as separate expected outputs of a collection change.", "primary_source": { "name": "Prometheus documentation — Configuration", "url": "https://prometheus.io/docs/prometheus/latest/configuration/configuration/", "published_on": null, "authority": "prometheus.io" }, "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/", "usage_info": "https://update.dsesecurity.com/usage/", "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.", "content_html": "

Prometheus excludes automatically generated series such as up from metric relabeling.

\n

Source facts

\n

Prometheus target relabeling rewrites the target label set before scraping and applies steps in configuration order. Metric relabeling operates on samples immediately before ingestion. Metric relabeling does not apply to automatically generated series such as up. The same-looking rule syntax therefore has a different boundary depending on where it is configured.

\n

Source: Prometheus documentation — Configuration.

\n

Applicability

\n

Review native Prometheus metric filtering separately from target selection, including the automatically generated up exception.

\n

DSE recommendation

\n

DSE recommends treating scrape-health series and filtered application samples as separate expected outputs of a collection change. Write an explicit decision for up: retain it as the scrape signal, or change target selection when the intended outcome is to stop scraping that target. Do not present an ingestion filter as proof that the network request stopped. Review rule order when one target transformation supplies another’s input. Keep a small expected-series list with the job so a responder can distinguish an intentional application-metric exclusion from an unavailable exporter.

\n

Verification

\n

In a nonproduction scrape job, compare discovered targets, scrape activity, up, and a disposable application metric before and after the rule. Confirm the chosen stage produces the intended effect without losing unrelated samples. Review the resulting labels for unique series identity. Retain the target state, observed scrape and queries for up and the application metric together. Ask the monitoring owner to approve the result specifically against the expected-series list rather than a single empty dashboard panel.

\n

Official reference

\n

Prometheus documentation — Configuration. Reviewed October 20, 2026.

", "content_text": "Prometheus excludes automatically generated series such as up from metric relabeling.\nSource facts\nPrometheus target relabeling rewrites the target label set before scraping and applies steps in configuration order. Metric relabeling operates on samples immediately before ingestion. Metric relabeling does not apply to automatically generated series such as up. The same-looking rule syntax therefore has a different boundary depending on where it is configured.\nSource: Prometheus documentation — Configuration.\nApplicability\nReview native Prometheus metric filtering separately from target selection, including the automatically generated up exception.\nDSE recommendation\nDSE recommends treating scrape-health series and filtered application samples as separate expected outputs of a collection change. Write an explicit decision for up: retain it as the scrape signal, or change target selection when the intended outcome is to stop scraping that target. Do not present an ingestion filter as proof that the network request stopped. Review rule order when one target transformation supplies another’s input. Keep a small expected-series list with the job so a responder can distinguish an intentional application-metric exclusion from an unavailable exporter.\nVerification\nIn a nonproduction scrape job, compare discovered targets, scrape activity, up, and a disposable application metric before and after the rule. Confirm the chosen stage produces the intended effect without losing unrelated samples. Review the resulting labels for unique series identity. Retain the target state, observed scrape and queries for up and the application metric together. Ask the monitoring owner to approve the result specifically against the expected-series list rather than a single empty dashboard panel.\nOfficial reference\nPrometheus documentation — Configuration. Reviewed October 20, 2026.", "content_markdown": "Prometheus excludes automatically generated series such as up from metric relabeling.\n\n## Source facts\n\nPrometheus target relabeling rewrites the target label set before scraping and applies steps in configuration order. Metric relabeling operates on samples immediately before ingestion. Metric relabeling does not apply to automatically generated series such as up. The same-looking rule syntax therefore has a different boundary depending on where it is configured.\n\nSource: [Prometheus documentation — Configuration](https://prometheus.io/docs/prometheus/latest/configuration/configuration/).\n\n## Applicability\n\nReview native Prometheus metric filtering separately from target selection, including the automatically generated up exception.\n\n## DSE recommendation\n\nDSE recommends treating scrape-health series and filtered application samples as separate expected outputs of a collection change. Write an explicit decision for up: retain it as the scrape signal, or change target selection when the intended outcome is to stop scraping that target. Do not present an ingestion filter as proof that the network request stopped. Review rule order when one target transformation supplies another’s input. Keep a small expected-series list with the job so a responder can distinguish an intentional application-metric exclusion from an unavailable exporter.\n\n## Verification\n\nIn a nonproduction scrape job, compare discovered targets, scrape activity, up, and a disposable application metric before and after the rule. Confirm the chosen stage produces the intended effect without losing unrelated samples. Review the resulting labels for unique series identity. Retain the target state, observed scrape and queries for up and the application metric together. Ask the monitoring owner to approve the result specifically against the expected-series list rather than a single empty dashboard panel.\n\n## Official reference\n\n[Prometheus documentation — Configuration](https://prometheus.io/docs/prometheus/latest/configuration/configuration/). Reviewed October 20, 2026." }, "json_ld": { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://dsesecurity.com/#organization", "name": "Detection Systems & Engineering", "alternateName": "DSE Security", "url": "https://dsesecurity.com/", "logo": { "@type": "ImageObject", "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20" } }, { "@type": "Organization", "@id": "https://update.dsesecurity.com/#editorial-team", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/", "parentOrganization": { "@id": "https://dsesecurity.com/#organization" } }, { "@type": "WebSite", "@id": "https://update.dsesecurity.com/#website", "name": "DSE Updates", "alternateName": "DSE Security Knowledge Hub", "url": "https://update.dsesecurity.com/", "inLanguage": "en-US", "publisher": { "@id": "https://dsesecurity.com/#organization" }, "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@type": "WebPage", "@id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "url": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "isPartOf": { "@id": "https://update.dsesecurity.com/#website" }, "lastReviewed": "2026-10-20" }, { "@type": "BreadcrumbList", "@id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/#breadcrumbs", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "DSE Updates", "item": "https://update.dsesecurity.com/" }, { "@type": "ListItem", "position": 2, "name": "IT", "item": "https://update.dsesecurity.com/topic/it/" }, { "@type": "ListItem", "position": 3, "name": "Do not expect metric relabeling to remove Prometheus up", "item": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/" } ] }, { "@type": [ "Article", "TechArticle" ], "@id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/#article", "identifier": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "url": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/", "headline": "Do not expect metric relabeling to remove Prometheus up", "description": "Prometheus excludes automatically generated series such as up from metric relabeling.", "abstract": "Prometheus excludes automatically generated series such as up from metric relabeling.", "articleBody": "Prometheus excludes automatically generated series such as up from metric relabeling.\nSource facts\nPrometheus target relabeling rewrites the target label set before scraping and applies steps in configuration order. Metric relabeling operates on samples immediately before ingestion. Metric relabeling does not apply to automatically generated series such as up. The same-looking rule syntax therefore has a different boundary depending on where it is configured.\nSource: Prometheus documentation — Configuration.\nApplicability\nReview native Prometheus metric filtering separately from target selection, including the automatically generated up exception.\nDSE recommendation\nDSE recommends treating scrape-health series and filtered application samples as separate expected outputs of a collection change. Write an explicit decision for up: retain it as the scrape signal, or change target selection when the intended outcome is to stop scraping that target. Do not present an ingestion filter as proof that the network request stopped. Review rule order when one target transformation supplies another’s input. Keep a small expected-series list with the job so a responder can distinguish an intentional application-metric exclusion from an unavailable exporter.\nVerification\nIn a nonproduction scrape job, compare discovered targets, scrape activity, up, and a disposable application metric before and after the rule. Confirm the chosen stage produces the intended effect without losing unrelated samples. Review the resulting labels for unique series identity. Retain the target state, observed scrape and queries for up and the application metric together. Ask the monitoring owner to approve the result specifically against the expected-series list rather than a single empty dashboard panel.\nOfficial reference\nPrometheus documentation — Configuration. Reviewed October 20, 2026.", "datePublished": "2026-10-20T18:15:35+00:00", "dateModified": "2026-10-20T18:34:33+00:00", "mainEntityOfPage": { "@id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/" }, "inLanguage": "en-US", "isAccessibleForFree": true, "author": { "@type": "Organization", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/#editorial-team" }, "publisher": { "@id": "https://dsesecurity.com/#organization" }, "image": { "@type": "ImageObject", "@id": "https://update.dsesecurity.com/updates/choose-the-prometheus-relabeling-stage-from-the-intended-effect/#primaryimage", "url": "https://update.dsesecurity.com/assets/editorial/network-infrastructure-social-v2.jpg?v=1.8.20", "contentUrl": "https://update.dsesecurity.com/assets/editorial/network-infrastructure-social-v2.jpg?v=1.8.20", "width": 1200, "height": 630, "caption": "Do not expect metric relabeling to remove Prometheus up" }, "articleSection": [ "IT", "Networks & Infrastructure" ], "keywords": [ "IT", "Networks & Infrastructure", "Guide", "Information priority" ], "genre": "Guide", "about": [ { "@type": "Thing", "name": "IT", "url": "https://update.dsesecurity.com/topic/it/" }, { "@type": "Thing", "name": "Networks & Infrastructure", "url": "https://update.dsesecurity.com/topic/networks-infrastructure/" } ], "wordCount": 257, "timeRequired": "PT2M", "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/", "usageInfo": "https://update.dsesecurity.com/usage/", "copyrightHolder": { "@id": "https://dsesecurity.com/#organization" }, "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.", "citation": { "@type": "CreativeWork", "name": "Prometheus documentation — Configuration", "url": "https://prometheus.io/docs/prometheus/latest/configuration/configuration/" } } ] } }