FlashArray Pure Storage

Supported OS

Versión de la integración1.3.0

Información general

Este check monitoriza Pure Storage FlashArray a través del Datadog Agent y el exportador OpenMetrics de Pure Storage.

La integración puede proporcionar datos de rendimiento a nivel de matriz, host, volumen y pod, así como información muy clara sobre capacidad y configuración.

Puedes monitorizar múltiples FlashArrays y agregarlos en un único dashboard o agruparlos según el entorno definido por el cliente.

Esta integración requiere lo siguiente:

  • Agent v7.26.x o posterior para utilizar OpenMetrics BaseCheckV2
  • Python 3
  • El exportador OpenMetrics de Pure Storage se instala y ejecuta en un entorno contenedorizado. Consulta el repositorio de GitHub para obtener instrucciones de instalación.
    • En FlashArrays que ejecutan Purity//FA versión 6.7.0 y posteriores, el exportador OpenMetrics se ejecuta de forma nativa en la matriz. Consulta Configuración para obtener más información.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.

Instalación

  1. Descarga e inicia el Datadog Agent.
  2. Instala manualmente la integración Pure FlashArray. Consulta Uso de integraciones comunitarias para obtener más información en función de tu entorno.

Host

Para configurar este check para un Agent que se ejecuta en un host, ejecuta sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==<INTEGRATION_VERSION>.

Nota: <INTEGRATION_VERSION> se puede encontrar dentro del CHANGELOG.md para Datadog Integration Extras.

  • Por ejemplo sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.3.0

Configuración

  1. Crea un usuario local en tu FlashArray con el rol de sólo lectura y genera un token de API para este usuario. Generar una clave API
  2. Añade el siguiente bloque de configuración al archivo purefa.d/conf.yaml, en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para empezar a recopilar tus datos de rendimiento de PureFA. Consulta el ejemplo purefa.d/conf.yaml para conocer todas las opciones de configuración disponibles.

Nota: La creación de tu archivo de configuración requiere el endpoint /array como mínimo absoluto.

(Preferido) Para uso con el exportador nativo OpenMetrics de Pure Storage (Purity//FA v6.7.0 o posteriores)

init_config:
   timeout: 60

instances:

  - openmetrics_endpoint: https://<array_ip_or_fqdn>/metrics/array?namespace=purefa
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
    # If you have not configured your Purity management TLS certifcate, you may skip TLS verification. For other TLS options, please see conf.yaml.example.
    # tls_verify: false
    # tls_ignore_warning: true

  - openmetrics_endpoint: https://<array_ip_or_fqdn>/metrics/volumes?namespace=purefa
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
    # If you have not configured your Purity management TLS certifcate, you may skip TLS verification. For other TLS options, please see conf.yaml.example.
    # tls_verify: false
    # tls_ignore_warning: true

  - openmetrics_endpoint: https://<array_ip_or_fqdn>/metrics/hosts?namespace=purefa
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
    # If you have not configured your Purity management TLS certifcate, you may skip TLS verification. For other TLS options, please see conf.yaml.example.
    # tls_verify: false
    # tls_ignore_warning: true

  - openmetrics_endpoint: https://<array_ip_or_fqdn>/metrics/pods?namespace=purefa
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
    # If you have not configured your Purity management TLS certifcate, you may skip TLS verification. For other TLS options, please see conf.yaml.example.
    # tls_verify: false
    # tls_ignore_warning: true

  - openmetrics_endpoint: https://<array_ip_or_fqdn>/metrics/directories?namespace=purefa
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
    # If you have not configured your Purity management TLS certifcate, you may skip TLS verification. For other TLS options, please see conf.yaml.example.
    # tls_verify: false
    # tls_ignore_warning: true

Para su uso con el exportador externo [OpenMetrics de Pure Storage(https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter) (Purity //FA v<6.7.0)

init_config:
   timeout: 60

instances:

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/array?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/volumes?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/hosts?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/pods?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/directories?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fa_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120
  1. Reinicia el Agent.

Validación

[Ejecuta el subcomando de estado del Agent] (https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) y busca purefa en la sección Checks.

Actualización a nuevas versiones de esta integración

A partir del check del Agent PureFA v1.0.x a v1.1.x

1.1.x admite tanto el exportador OpenMetrics de Pure Storage como el obsoleto exportador Prometheus de Pure Storage.

El dashboard del obsoleto exportador Prometheus de Pure Storage ha sido renombrado como Pure FlashArray - Overview (Legacy Exporter).

En metrics.py encontrarás una lista de métricas compartidas y exclusivas de los distintos exportadores. Es posible que tengas que actualizar tus dashboards o tus alertas para que coincidan con los nuevos nombres de métricas al migrar del exportador Prometheus de Pure Storage al exportador OpenMetrics de Pure Storage. Si tienes alguna pregunta, ponte en contacto con Pure Storage con la información de la pestaña Asistencia.

Al migrar del exportador Prometheus de Pure Storage al exportador OpenMetrics de Pure Storage, los endpoints ya no tendrán /flasharray en el URI del endpoint.

En futuras versiones del check del Agent PureFA, se eliminarán los nombres de métricas del exportador Prometheus Pure Storage.

Solucionar problemas

Las matrices no se muestran en el dashboard

Los dashboards incluidos en esta integración utilizan las etiquetas (tags) env y fa_array_name. Asegúrate de configurarlas para cada instancia. host también debe configurarse para los endpoints /array y /pods en purefa.d/conf.yaml.

- tags:
   - env:<env>
   - fa_array_name:<full_fqdn>
   - host:<full_fqdn>

Aumento del intervalo de recopilación

El check de FlashArray Pure Storage configura min_collection_interval como 120 por defecto y el valor mínimo recomendado es 20. Si es necesario:, puedes aumentar/disminuir min_collection_interval en el archivo purefa.d/conf.yaml:

min_collection_interval: 120

Datos recopilados

Métricas

purefa.alerts.open
(gauge)
Eventos de alerta de FlashArray abiertos.
purefa.alerts.total
(gauge)
(Legacy) Número de eventos de alerta.
purefa.array.performance_average_bytes
(gauge)
Tamaño medio de las operaciones de la matriz FlashArray en bytes.
Se muestra como bytes
purefa.array.performance_avg_block_bytes
(gauge)
(Legacy) Tamaño medio de bloque de FlashArray.
Se muestra como bytes
purefa.array.performance_bandwidth_bytes
(gauge)
Rendimiento de la matriz FlashArray en bytes por segundo.
Se muestra como bytes
purefa.array.performance_iops
(gauge)
(Legacy) IOPS FlashArray.
Se muestra como operación
purefa.array.performance_latency_usec
(gauge)
Latencia de la matriz FlashArray en microsegundos.
Se muestra como microsegundos
purefa.array.performance_qdepth
(gauge)
(Legacy) Profundidad de la cola de FlashArray.
purefa.array.performance_queue_depth_ops
(gauge)
Tamaño de la profundidad de la cola de la matriz FlashArray.
Se muestra como operación
purefa.array.performance_throughput_iops
(gauge)
Rendimiento de la matriz FlashArray en IOPS.
Se muestra como operación
purefa.array.space_bytes
(gauge)
Espacio de la matriz FlashArray en bytes.
Se muestra como bytes
purefa.array.space_capacity_bytes
(gauge)
(Legacy) Capacidad de espacio total de FlashArray.
Se muestra como bytes
purefa.array.space_data_reduction_ratio
(gauge)
Reducción de datos del espacio de la matriz FlashArray.
purefa.array.space_datareduction_ratio
(gauge)
(Legacy) Reducción global de datos de FlashArray.
purefa.array.space_provisioned_bytes
(gauge)
(Legacy) Espacio total aprovisionado de FlashArray.
Se muestra como bytes
purefa.array.space_used_bytes
(gauge)
(Legacy) Espacio total utilizado de FlashArray.
Se muestra como bytes
purefa.array.space_utilization
(gauge)
Uso del espacio de la matriz FlashArray en porcentaje.
Se muestra como porcentaje
purefa.directory.performance_average_bytes
(gauge)
Tamaño medio de las operaciones del directorio FlashArray en bytes.
Se muestra como bytes
purefa.directory.performance_bandwidth_bytes
(gauge)
Rendimiento del directorio FlashArray en bytes por segundo.
Se muestra como bytes
purefa.directory.performance_latency_usec
(gauge)
Latencia del directorio FlashArray en microsegundos.
Se muestra como microsegundos
purefa.directory.performance_throughput_iops
(gauge)
Rendimiento del directorio FlashArray en IOPS.
Se muestra como operación
purefa.directory.space_bytes
(gauge)
Espacio del directorio FlashArray en bytes.
Se muestra como bytes
purefa.directory.space_data_reduction_ratio
(gauge)
Reducción de datos del espacio del directorio FlashArray.
purefa.drive.capacity_bytes
(gauge)
Capacidad de la unidad FlashArray en bytes.
Se muestra como bytes
purefa.hardware.chassis_health
(gauge)
(Legacy) Estado de salud del chasis de hardware de FlashArray.
purefa.hardware.component_health
(gauge)
(Legacy) Estado de salud del componente de hardware de FlashArray.
purefa.hardware.controller_health
(gauge)
(Legacy) Estado de salud del controlador de hardware de FlashArray.
purefa.hardware.power_volts
(gauge)
(Legacy) Tensión de alimentación del hardware de FlashArray.
Se muestra como voltios
purefa.hardware.temperature_celsius
(gauge)
(Legacy) Sensores de temperatura del hardware de FlashArray.
Se muestra como grados celsius
purefa.host.connections_info
(gauge)
Conexiones de volúmenes del host FlashArray.
purefa.host.connectivity_info
(gauge)
Información de conectividad del host FlashArray.
purefa.host.performance_average_bytes
(gauge)
Tamaño medio de las operaciones del host FlashArray en bytes.
Se muestra como bytes
purefa.host.performance_bandwidth_bytes
(gauge)
Ancho de banda del host FlashArray en bytes por segundo.
Se muestra como bytes
purefa.host.performance_iops
(gauge)
(Legacy) IOPS de host FlashArray.
Se muestra como operación
purefa.host.performance_latency_usec
(gauge)
Latencia del host FlashArray en microsegundos.
Se muestra como microsegundos
purefa.host.performance_throughput_iops
(gauge)
Rendimiento del host FlashArray en IOPS.
Se muestra como operación
purefa.host.space_bytes
(gauge)
Espacio del host FlashArray en bytes.
Se muestra como bytes
purefa.host.space_data_reduction_ratio
(gauge)
Reducción de datos del espacio del host FlashArray.
purefa.host.space_datareduction_ratio
(gauge)
(Legacy) Ratio de reducción de datos de los volúmenes del host FlashArray.
purefa.host.space_size_bytes
(gauge)
Tamaño de los volúmenes del host FlashArray.
Se muestra como bytes
purefa.hw.component_status
(gauge)
Estado del componente de hardware de FlashArray.
purefa.hw.component_temperature_celsius
(gauge)
Temperatura del componente de hardware de FlashArray en °C.
Se muestra como grados celsius
purefa.hw.component_voltage_volt
(gauge)
Tensión del componente de hardware de FlashArray.
Se muestra como voltios
purefa.hw.controller_info
(gauge)
Información del controlador FlashArray
purefa.hw.controller_mode_since_timestamp_seconds
(gauge)
Tiempo de actividad del controlador de hardware de FlashArray en segundos
Se muestra como segundos
purefa.info
(gauge)
Información del sistema FlashArray.
purefa.network.interface_performance_bandwidth_bytes
(gauge)
Ancho de banda de la interfaz de red de FlashArray en bytes por segundo
Se muestra como bytes
purefa.network.interface_performance_errors
(gauge)
Errores de la interfaz de red de FlashArray en errores por segundo
Se muestra como error
purefa.network.interface_performance_throughput_pkts
(gauge)
Rendimiento de la interfaz de red de FlashArray en paquetes por segundo.
Se muestra como paquete
purefa.network.interface_speed_bandwidth_bytes
(gauge)
Velocidad de la interfaz de red de FlashArray en bytes por segundo
Se muestra como bytes
purefa.network.port_info
(gauge)
Información del puerto de red de FlashArray
purefa.pod.mediator_status
(gauge)
(Legacy) Estado del mediador de pods de FlashArray.
purefa.pod.performance_average_bytes
(gauge)
Tamaño medio de las operaciones de pods de FlashArray.
Se muestra como bytes
purefa.pod.performance_bandwidth_bytes
(gauge)
Rendimiento de pods de FlashArray en bytes por segundo.
Se muestra como bytes
purefa.pod.performance_iops
(gauge)
(Legacy) IOPS de pods de FlashArray.
Se muestra como operación
purefa.pod.performance_latency_usec
(gauge)
Latencia de pods de FlashArray en microsegundos.
Se muestra como microsegundos
purefa.pod.performance_replication_bandwidth_bytes
(gauge)
Ancho de banda de replicación de pods de FlashArray.
Se muestra como bytes
purefa.pod.performance_throughput_iops
(gauge)
Rendimiento de pods de FlashArray en IOPS.
Se muestra como operación
purefa.pod.replica_links_lag_average_msec
(gauge)
Retraso medio de enlaces de pods de FlashArray en milisegundos.
Se muestra como segundos
purefa.pod.replica_links_lag_average_sec
(gauge)
Retraso medio de enlaces de pods de FlashArray en milisegundos.
Se muestra como segundos
purefa.pod.replica_links_lag_max_msec
(gauge)
Retraso máximo de enlaces de pods de FlashArray en milisegundos.
Se muestra como segundos
purefa.pod.replica_links_lag_max_sec
(gauge)
Retraso máximo de enlaces de pods de FlashArray en milisegundos.
Se muestra como segundos
purefa.pod.replica_links_performance_bandwidth_bytes
(gauge)
Ancho de banda de enlaces de pods de FlashArray.
Se muestra como bytes
purefa.pod.space_bytes
(gauge)
Espacio de pods de FlashArray en bytes.
Se muestra como bytes
purefa.pod.space_data_reduction_ratio
(gauge)
Reducción de datos en el espacio de pods de FlashArray.
purefa.pod.space_datareduction_ratio
(gauge)
(Legacy) Ratio de reducción de datos de pods de FlashArray.
purefa.pod.space_size_bytes
(gauge)
(Legacy) Tamaño de pods de FlashArray.
Se muestra como bytes
purefa.pod.status
(gauge)
(Legacy) Estado de pods de FlashArray.
purefa.volume.performance_average_bytes
(gauge)
Tamaño medio de las operaciones de volúmenes de FlashArray en bytes.
Se muestra como bytes
purefa.volume.performance_bandwidth_bytes
(gauge)
Rendimiento de volúmenes de FlashArray en bytes por segundo.
Se muestra como bytes
purefa.volume.performance_iops
(gauge)
(Legacy) IOPS de volúmenes de FlashArray.
Se muestra como operación
purefa.volume.performance_latency_usec
(gauge)
Latencia de volúmenes de FlashArray en microsegundos.
Se muestra como microsegundos
purefa.volume.performance_throughput_bytes
(gauge)
(Legacy) Rendimiento de volúmenes de FlashArray.
Se muestra como bytes
purefa.volume.performance_throughput_iops
(gauge)
Rendimiento de volúmenes de FlashArray en IOPS.
Se muestra como operación
purefa.volume.space_bytes
(gauge)
Espacio de volúmenes de FlashArray en bytes.
Se muestra como bytes
purefa.volume.space_data_reduction_ratio
(gauge)
Reducción del espacio de datos de volúmenes de FlashArray.
purefa.volume.space_datareduction_ratio
(gauge)
(Legacy) Ratio de reducción de datos de volúmenes de FlashArray.
purefa.volume.space_size_bytes
(gauge)
(Legacy) Tamaño de volúmenes de FlashArray.
Se muestra como bytes

Eventos

La integración PureFA no incluye eventos.

Checks de servicio

purefa.openmetrics.health

Devuelve CRITICAL si el Agent no puede conectarse al endpoint de OpenMetrics o OK en caso contrario.

Estados: ok, crítico

Soporte

Para obtener asistencia o realizar solicitudes de funciones, ponte en contacto con Pure Storage utilizando los siguientes métodos: