# Prometheus Metrics Exporter Release Notes

This page consolidates all Finout Prometheus Metrics Exporter release notes from **version 2.0** onward. Use this page to understand the changes made between exporter versions, how upgrades affect cost calculation, and what actions (if any) are required during onboarding or upgrading.

### Release Notes

<details>

<summary>Version 2.0.3 – Release date: April 5, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter v2.0.3 improves the reliability of the startup health check across all supported Prometheus-compatible backends.

Previously, probing a dedicated readiness endpoint caused false negative failures during onboarding in environments where the endpoint was unavailable - even when metrics could be queried successfully. The health check now runs a lightweight query directly against the metrics endpoint instead.\
\
**Upgrade impact**&#x20;

* Reduces false negative connectivity failures during onboarding.
* `METRICS_READINESS_PATH` is deprecated and no longer has any effect - safe to remove from your configuration.

**Required action:** Update the exporter image in your CronJob YAML to **version 2.0.3**:

```
finout/finout-metrics-exporter:2.0.3
```

</details>

<details>

<summary>Version 2.0.2 – Release date: February 9, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter **v2.0.2** fixes [**CVE-2025-15467**](https://nvd.nist.gov/vuln/detail/CVE-2025-15467)**.**

In addition, this release fixes an issue with the **INITIAL\_BACKFILL\_DATE** environment variable. Previously, configuring this variable could cause the CronJob to fail if more than three days had passed since the initial deployment.

**Required action:** Update the exporter image in your CronJob YAML to version **2.0.2** to mitigate this risk and resolve the bug. Use the following image:&#x20;

```
finout/finout-metrics-exporter:2.0.2
```

</details>

<details>

<summary>Version 2.0.1 – Release date: January 18, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter **v2.0.1** includes a bug fix for the connectivity check logic when using a customized `PATH_PREFIX`.

Previously, when the `PATH_PREFIX` environment variable was set, the exporter incorrectly appended it to the readiness check URL. This caused **false negative readiness failures**, even when the backend endpoint was valid and reachable.\
\
**Upgrade impact:** Resolves false negative host readiness errors when a custom `PATH_PREFIX` is configured.

**Required action:** Update the exporter image in your CronJob YAML to **version 2.0.1**.

```
finout/finout-metrics-exporter:2.0.1
```

</details>

<details>

<summary>Version 2.0.0 - Release date: January 14, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter v2.0.0 introduces major improvements to Kubernetes cost accuracy, backfill control, performance, and platform compatibility.

If you are upgrading to version 2.0.0, you must update your existing Kubernetes **CronJob** deployment to use the new exporter image.\
\
**Upgrade impact:** Cost calculation changes due to consideration of initContainers metrics.

**Required action:** Update the exporter image in your CronJob YAML to the new version:

```
finout/finout-metrics-exporter:2.0.0
```

No other configuration changes are required unless explicitly noted below.

{% hint style="info" %}
**Note**: Starting **June 30, 2026**, all versions 1.x and earlier will reach **End of Life**. These versions do not include the major improvements introduced in v2.0.0 and will no longer receive updates, maintenance, or support. You are encouraged to upgrade to v2.0.0 or later versions to ensure continued stability and compatibility.
{% endhint %}

#### What’s New

1. [InitContainer Resource Metrics](https://docs.finout.io/integrations/kubernetes-prometheus/sidecar-initcontainers-support) - Finout now supports collecting and attributing resource usage from **initContainers**, including both short-lived setup containers and persistent sidecar initContainers.
   * **What changed** – Exporter v2.0.0 now includes CPU and memory requests from all initContainers, ensuring full visibility into their cost impact.
   * **Why it matters** – Provides more accurate Kubernetes cost allocation by capturing all container resource usage and reducing unattributed (idle) costs.
   * **Required Configuration** – No configuration required. These improvements are included by default in the exporter image. Updated cost data appears in Finout within 48 hours after integration.<br>

2. **Configurable Initial Backfill Start Date** – The exporter now provides a clear and explicit way to control the **initial backfill start date** during CronJob onboarding.
   * **What changed** – In addition to the existing `BACKFILL_DAYS` configuration, customers can now set an explicit initial backfill start date using `INITIAL_BACKFILL_DATE`. This is the **preferred configuration** for new deployments, as it is more explicit and predictable than relative backfill days.
   * **Why it matters** – Setting a fixed start date makes it easier to understand exactly which data will be fetched during the initial backfill and avoids ambiguity around relative timeframes.
   * **Required Configuration** – Optional. Use `INITIAL_BACKFILL_DATE` in `YYYY-MM-DD` format to define the initial backfill start date.
     * Initial backfills using `INITIAL_BACKFILL_DATE` are limited to a **maximum of 3 days**.
     * If no configuration is provided, the exporter defaults to backfilling the **last 3 days** from deployment time.
     * If **both** `INITIAL_BACKFILL_DATE` and `BACKFILL_DAYS` are set, the cronjob run will fail. <br>

3. **Memory Handling Improvements** – The exporter was refactored to manage in-process memory more efficiently, improving performance and stability for large-scale environments.

   * **What changed** – Instead of loading all query data into memory before writing, the exporter now **processes and writes data in smaller batches**. This prevents excessive memory usage during large Prometheus queries.
   * **Why it matters** – Reduces the risk of exporter crashes in large Kubernetes environments, ensuring smoother operation and higher reliability when handling extensive datasets.
   * **Required Configuration** - Optional. The exporter uses a default query batch size of **5**. This can be reduced to lower memory consumption by setting the `QUERIES_BATCH_SIZE` environment variable (minimum value: **1**, which results in the lowest memory usage).

4. **Improved Readiness Validation for Centralized Prometheus Monitoring Tools Integrations** - The exporter readiness check now supports more readiness endpoint variants, including `/ready`, and can be customized via a new environment variable.<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong>: These validations are <strong>informative only</strong> - they help surface issues early but do not block the job from continuing or prevent scraping.</p></div>

   * **What changed** - Previously, readiness validation supported only `/-/ready`, with no fallback to `/ready` and no way to customize the readiness path, therefore:&#x20;
     * Added support for the `/ready` readiness suffix.
     * Added a new optional environment variable: \
       `METRICS_READINESS_PATH`, allowing custom readiness endpoint suffixes.
   * **Why it matters** - Improves compatibility with different centralized tools and surfaces readiness issues more clearly - without impacting metric collection.
   * **Required Configuration** - Optional. Set `METRICS_READINESS_PATH` in the CronJob YAML only if your backend readiness endpoint differs from the supported defaults.<br>

5. **ARM Architecture Support** – Finout's Exporter image is now released as a **multi-architecture build**, supporting both `linux/amd64` and `linux/arm64` platforms (previously only `amd64`).
   * **What changed** – The exporter image now automatically detects and runs on the correct architecture; there’s no need to specify the `--platform` flag manually. This works seamlessly on both **x86\_64** and **ARM64** systems.
   * **Why it matters** – Expands compatibility to **ARM-based environments**, ensuring seamless deployment across diverse infrastructure.
   * **Required Configuration** – No configuration required if you’re using the default image tags. If your deployment scripts explicitly define `--platform=linux/amd64`, you can safely remove or update that line for broader compatibility.<br>

6. **Logging Enhancements** – Finout’s exporter now provides clearer, more structured logs to improve visibility and streamline troubleshooting for the R\&D and Support teams.
   * **What changed** – The exporter now provides clearer logs with human-readable timeframes, making it easier to follow CronJob execution and metric processing progress.
   * **Why it matters** – Enhances internal monitoring and debugging efficiency, enabling faster issue resolution and more proactive detection of data pipeline or integration problems.
   * **Required Configuration** - No configuration required. These improvements are included by default in the exporter image.

#### Benefits for Customers

* **More accurate Kubernetes costs when using SideCar initContainers**\
  [InitContainers](https://docs.finout.io/kubernetes-integrations/kubernetes/prometheus/sidecar-initcontainers-support) are now included in cost allocation and work seamlessly with both old and new Kubernetes ratio algorithms.
* **Greater control over historical data**\
  Improved backfill capabilities enable customers to more effectively control the historical backfill start date used during initial setup.
* **Fewer failures in large environments**\
  Memory handling improvements make the exporter more stable and reliable at scale.
* **Wider platform support**\
  The exporter now runs seamlessly on ARM-based systems.

#### FAQs

**Do I need to create a new cost center in order to use v2.0.0?**

* No, you need to **update the image of your existing CronJobs**, using their YAML.

**When does the upgrade take effect, immediately or in the next run?**

* The **next scheduled CronJob run** picks up the new version.
* By default, scheduled runs occur **every 30 minutes**, depending on the CronJob's configuration in its YAML file.
* No reprocessing cycle is required.

</details>

### Security Patches

<details>

<summary>Version 2.0.2 – Release date: February 9, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter **v2.0.2** fixes [**CVE-2025-15467**](https://nvd.nist.gov/vuln/detail/CVE-2025-15467)**.**

In addition, this release fixes an issue with the **INITIAL\_BACKFILL\_DATE** environment variable. Previously, configuring this variable could cause the CronJob to fail if more than three days had passed since the initial deployment.

**Required action:** Update the exporter image in your CronJob YAML to version **2.0.2** to mitigate this risk and resolve the bug. Use the following image:&#x20;

```
finout/finout-metrics-exporter:2.0.2
```

</details>

<details>

<summary>Version 1.34.3 – Release date: February 9, 2026</summary>

#### **Overview**

Prometheus Metrics Exporter **v1.34.3** fixes [**CVE-2025-15467**](https://nvd.nist.gov/vuln/detail/CVE-2025-15467)**.**

**Required action:** Update the exporter image in your CronJob YAML to version **1.34.3** to mitigate this risk. Use the following image:&#x20;

```
finout/finout-metrics-exporter:1.34.3
```

</details>