Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions purefa/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# CHANGELOG - PureFA

## 1.3.1/ 2026-07-11

***Added***:

* Changed branding from Pure Storage to Everpure.

## 1.3.0/ 2025-07-10

***Added***:
Expand Down
32 changes: 17 additions & 15 deletions purefa/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Overview

This check monitors the [Pure Storage FlashArray][3] through the [Datadog Agent][2] and the [Pure Storage OpenMetrics exporter][1].
This check monitors the [Everpure FlashArray][3] through the [Datadog Agent][2].

The integration can provide performance data at the array, host, volume and pod level, as well as high-level capacity and configuration information.

Expand All @@ -12,8 +12,9 @@ You can monitor multiple FlashArrays and aggregate these into a single dashboard

- Agent v7.26.x+ to utilize OpenMetricsBaseCheckV2
- Python 3
- The Pure Storage OpenMetrics exporter is installed and running in a containerized environment. Refer to the [GitHub repo][1] for installation instructions.
- On FlashArrays running Purity//FA version 6.7.0 and higher the OpenMetrics exporter natively runs on the array, see Configuration for details
- FlashArray running Purity//FA version 6.7.0+
- For FlashArrays running Purity//FA version <6.7.0 the Pure Storage OpenMetrics exporter required to be installed and running in a containerized environment. Refer to the [GitHub repo][1] for installation instructions.


## Setup

Expand All @@ -22,15 +23,15 @@ Follow the instructions below to install and configure this check for an Agent r
### Installation

1. [Download and launch the Datadog Agent][9].
2. Manually install the Pure FlashArray integration. See [Use Community Integrations][10] for more details based on your environment.
2. Manually install the Everpure FlashArray integration. See [Use Community Integrations][10] for more details based on your environment.


#### Host

To configure this check for an Agent running on a host, run `sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==<INTEGRATION_VERSION>`.

Note: `<INTEGRATION_VERSION>` can be found within the [CHANGELOG.md][13] for Datadog Integration Extras.
* e.g. `sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.3.0`
* e.g. `sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.3.1`

### Configuration

Expand All @@ -40,7 +41,7 @@ Note: `<INTEGRATION_VERSION>` can be found within the [CHANGELOG.md][13] for Da

> **Note**: The `/array` endpoint is required as an absolute minimum when creating your configuration file.

#### (Preferred) For use with the native Pure Storage OpenMetrics Exporter (Purity//FA 6.7.0+)
#### (Preferred) For use with the native Everpure OpenMetrics Exporter (Purity//FA 6.7.0+)
```yaml
init_config:
timeout: 60
Expand Down Expand Up @@ -169,15 +170,17 @@ instances:

#### From PureFA Agent Check 1.0.x to 1.1.x

1.1.x supports both the [Pure Storage OpenMetrics exporter][1] and the deprecated [Pure Storage Prometheus exporter][14].
1.1.x supports the native Everpure FlashArray exporter, the [Pure Storage OpenMetrics exporter][1], and the deprecated [Pure Storage Prometheus exporter][14].

- Note: The native Everpure FlashArray exporter and the [Pure Storage OpenMetrics exporter][1] use the same metric names and metric conventions.

The dashboard for the deprecated [Pure Storage Prometheus exporter][14] has been renamed to `Pure FlashArray - Overview (Legacy Exporter)`.

A listing of metrics that are both shared and unique to the different exporters are listed in [metrics.py][15]. You may need to update your dashboards and/or your alerts to match the new metric names when migrating from the [Pure Storage Prometheus exporter][14] to the [Pure Storage OpenMetrics exporter][1]. Please contact Pure Storage with the information in the Support tab if you have any questions.
A listing of metrics that are both shared and unique to the different exporters are listed in [metrics.py][15]. You may need to update your dashboards and/or your alerts to match the new metric names when migrating from the [Pure Storage Prometheus exporter][14] to the [Pure Storage OpenMetrics exporter][1]. Please contact Everpure with the information in the Support tab if you have any questions.

When migrating from [Pure Storage Prometheus exporter][14] to the [Pure Storage OpenMetrics exporter][1], the endpoints no longer have `/flasharray` in the endpoint URI.

In future versions of the PureFA Agent Check, the metric names from the Pure Storage Prometheus exporter will be removed.
In future versions of the PureFA Agent Check, the metric names from the Everpure Prometheus exporter will be removed.

### Troubleshooting

Expand All @@ -194,7 +197,7 @@ The dashboards included in this integration use the tags `env`, and `fa_array_na

#### Increasing collection interval

The Pure Storage FlashArray check sets `min_collection_interval` to `120` by default, and the minimum recommended value is `20`. You may increase/decrease `min_collection_interval` in the `purefa.d/conf.yaml` file if necessary:
The Everpure FlashArray check sets `min_collection_interval` to `120` by default, and the minimum recommended value is `20`. You may increase/decrease `min_collection_interval` in the `purefa.d/conf.yaml` file if necessary:

```yaml
min_collection_interval: 120
Expand All @@ -217,20 +220,19 @@ See [service_checks.json][12] for a list of service checks provided by this inte

## Support

For support or feature requests, contact Pure Storage through the following methods:
* Email: pure-observability@purestorage.com
* Slack: [Pure Storage Code// Observability Channel][11].
For support or feature requests, contact Everpure through the following methods:
* Email: pure-observability@everpuredata.com


[1]: https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter
[2]: /account/settings/agent/latest
[3]: https://www.purestorage.com/products.html
[3]: https://www.everpuredata.com/products.html
[4]: https://github.com/datadog/integrations-extras/blob/master/purefa/datadog_checks/purefa/data/conf.yaml.example
[5]: https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent
[6]: https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information
[7]: https://github.com/DataDog/integrations-extras/blob/master/purefa/metadata.csv
[9]: /account/settings/agent/latest
[10]: https://docs.datadoghq.com/agent/guide/community-integrations-installation-with-docker-agent
[11]: https://code-purestorage.slack.com/messages/C0357KLR1EU
[12]: https://github.com/DataDog/integrations-extras/blob/master/purefa/assets/service_checks.json
[13]: https://github.com/DataDog/integrations-extras/blob/master/purefa/CHANGELOG.md
[14]: https://github.com/PureStorage-OpenConnect/pure-exporter
Expand Down
31 changes: 31 additions & 0 deletions purefa/assets/Everpure-vector-logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 0 additions & 15 deletions purefa/assets/Pure-storage-vector-logo.svg

This file was deleted.

4 changes: 2 additions & 2 deletions purefa/assets/configuration/spec.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ files:
- template: instances/openmetrics
options:
overrides:
openmetrics_endpoint.value.example: http://localhost:9490/metrics/flasharray/array?endpoint=array01
openmetrics_endpoint.value.example: https://<arrayIP-or-FQDN>/metrics/array?namespace=purefa
openmetrics_endpoint.display_priority: 1
hostname_label.value.example: host
hostname_label.display_priority: 1
Expand All @@ -22,7 +22,7 @@ files:
min_collection_interval.value.example: 120
min_collection_interval.enabled: true
cache_shared_labels.value.example: false
share_labels.value.enabled: true
share_labels.enabled: true
share_labels.value.example:
purefa_info:
labels:
Expand Down
Loading
Loading