Pure Storage FlashArray

Supported OS Windows Mac OS

통합 버전1.2.0

개요

이 점검 는 Datadog 에이전트 퓨어스토리지 개방형메트릭 익스포터를 통해 퓨어스토리지 플래시어레이를 모니터링합니다.

통합에서는 어레이, 호스트, 볼륨 및 포드 레벨의 성능 데이터와 높은 수준의 용량 및 설정 정보를 제공할 수 있습니다.

여러 개의 FlashArray를 모니터링하고 단일 대시보드에 통합하거나 고객이 정의한 환경에 따라 그룹화할 수 있습니다.

이 통합에는 다음이 필요합니다.

  • OpenMetricsBaseCheckV2를 활용하기 위한 에이전트 v7.26.x 이상
  • Python 3
  • Pure Storage OpenMetrics 익스포터는 컨테이너화된 환경에 설치 및 실행됩니다. 설치 지침은 GitHub 리포지토리를 참조하세요.

설정

아래 지침에 따라 호스트에서 실행되는 에이전트의 경우 이 점검을 설치하고 설정하세요.. 컨테이너화된 환경의 경우 자동탐지 통합 템플릿에서 이 지침을 적용하는 방법을 확인할 수 있습니다.

설치

  1. Datadog 에이전트를 다운로드하여 실행합니다.
  2. Pure FlashArray 통합을 직접 설치합니다. 환경에 따른 자세한 내용은 커뮤니티 통합 사용을 참조하세요.

호스트

호스트에서 실행되는 에이전트에 대해 이 점검을 설정하려면 sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==<INTEGRATION_VERSION>을 실행하세요.

참고: <INTEGRATION_VERSION> Datadog 통합 추가 정보는 CHANGELOG.md에서 확인할 수 있습니다.

  • 예: sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.2.0

설정

  1. FlashArray에 읽기 전용 역할로 로컬 사용자를 생성하고 이 사용자에 대한 API 토큰을 생성합니다. API 키 생성
  2. 에이전트의 설정 디렉터리 루트의 conf.d/ 폴더에 있는 purefa.d/conf.yaml 파일에 다음 설정 블록을 추가하여 PureFA 성능 데이터 수집을 시작하세요. 사용 가능한 모든 설정 옵션은 샘플 purefa.d/conf.yaml을 참조하세요.

참고: 설정 파일을 만들 때 /array 엔드포인트는 반드시 필요합니다.

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. Agent를 재시작합니다.

검증

에이전트 상태 하위 명령을 실행하고 점검 섹션에서 purefa를 찾습니다.

이 통합의 새 버전으로 업그레이드하기

PureFA 에이전트 점검 1.0.x~1.1.x

1.1.x는 Pure Storage OpenMetrics 익스포터와 더 이상 사용되지 않는 Pure Storage Prometheus 익스포터를 모두 지원합니다.

더 이상 지원되지 않는 Pure Storage Prometheus 익스포터의 대시보드는 Pure FlashArray - Overview (Legacy Exporter)로 이름이 변경되었습니다.

각기 다른 익스포터에 고유하며 공유되어 있는 메트릭 목록은 메트릭.py에 나와 있습니다. Pure Storage Prometheus익스포터에서 Pure Storage Prometheus 익스포터로 마이그레이션할 때 새로운 메트릭 이름과 일치하도록 대시보드 및/또는 알림을 업데이트해야 할 수 있습니다. 문의 사항이 있으시면 Pure Storage 지원 탭에 정보를 제공해 주세요.

Pure Storage Prometheus 익스포터에서 Pure Storage OpenMetrics 익스포터로 마이그레이션하는 경우, 엔드포인트 URI에 더 이상 /flasharray가 존재하지 않습니다.

향후 버전의 PureFA 에이전트 점검에서는 Pure Storage Prometheus 익스포터에서 메트릭 이름이 제거됩니다.

트러블슈팅

배열은 대시보드에 표시되지 않습니다.

이 통합에 포함된 대시보드는 태그 envfa_array_name을 사용합니다. hostpurefa.d/conf.yaml/array/pods 엔드포인트에 대해서도 설정해야 합니다.

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

수집 간격 늘리기

Pure Storage FlashArray 점검은 기본적으로 min_collection_interval120으로 설정하며, 최소 권장값은 20입니다. 필요한 경우 purefa.d/conf.yaml 파일에서 min_collection_interval를 늘리거나 줄일 수 있습니다.

min_collection_interval: 120

수집한 데이터

메트릭

purefa.alerts.open
(gauge)
FlashArray open alert events.
purefa.alerts.total
(gauge)
(Legacy) Number of alert events.
purefa.array.performance_average_bytes
(gauge)
FlashArray array average operations size in bytes.
Shown as byte
purefa.array.performance_avg_block_bytes
(gauge)
(Legacy) FlashArray avg block size.
Shown as byte
purefa.array.performance_bandwidth_bytes
(gauge)
FlashArray array throughput in bytes per second.
Shown as byte
purefa.array.performance_iops
(gauge)
(Legacy) FlashArray IOPS.
Shown as operation
purefa.array.performance_latency_usec
(gauge)
FlashArray array latency in microseconds.
Shown as microsecond
purefa.array.performance_qdepth
(gauge)
(Legacy) FlashArray queue depth.
purefa.array.performance_queue_depth_ops
(gauge)
FlashArray array queue depth size.
Shown as operation
purefa.array.performance_throughput_iops
(gauge)
FlashArray array throughput in iops.
Shown as operation
purefa.array.space_bytes
(gauge)
FlashArray array space in bytes.
Shown as byte
purefa.array.space_capacity_bytes
(gauge)
(Legacy) FlashArray overall space capacity.
Shown as byte
purefa.array.space_data_reduction_ratio
(gauge)
FlashArray array space data reduction.
purefa.array.space_datareduction_ratio
(gauge)
(Legacy) FlashArray overall data reduction.
purefa.array.space_provisioned_bytes
(gauge)
(Legacy) FlashArray overall provisioned space.
Shown as byte
purefa.array.space_used_bytes
(gauge)
(Legacy) FlashArray overall used space.
Shown as byte
purefa.array.space_utilization
(gauge)
FlashArray array space utilization in percent.
Shown as percent
purefa.directory.performance_average_bytes
(gauge)
FlashArray directory average operations size in bytes.
Shown as byte
purefa.directory.performance_bandwidth_bytes
(gauge)
FlashArray directory throughput in bytes per second.
Shown as byte
purefa.directory.performance_latency_usec
(gauge)
FlashArray directory latency in microseconds.
Shown as microsecond
purefa.directory.performance_throughput_iops
(gauge)
FlashArray directory throughput in iops.
Shown as operation
purefa.directory.space_bytes
(gauge)
FlashArray directory space in bytes.
Shown as byte
purefa.directory.space_data_reduction_ratio
(gauge)
FlashArray directory space data reduction.
purefa.drive.capacity_bytes
(gauge)
FlashArray drive capacity in bytes.
Shown as byte
purefa.hardware.chassis_health
(gauge)
(Legacy) FlashArray hardware chassis health status.
purefa.hardware.component_health
(gauge)
(Legacy) FlashArray hardware component health status.
purefa.hardware.controller_health
(gauge)
(Legacy) FlashArray hardware controller health status.
purefa.hardware.power_volts
(gauge)
(Legacy) FlashArray hardware power supply voltage.
Shown as volt
purefa.hardware.temperature_celsius
(gauge)
(Legacy) FlashArray hardware temperature sensors.
Shown as degree celsius
purefa.host.connections_info
(gauge)
FlashArray host volumes connections.
purefa.host.connectivity_info
(gauge)
FlashArray host connectivity info.
purefa.host.performance_average_bytes
(gauge)
FlashArray host average operations size in bytes.
Shown as byte
purefa.host.performance_bandwidth_bytes
(gauge)
FlashArray host bandwidth in bytes per second.
Shown as byte
purefa.host.performance_iops
(gauge)
(Legacy) FlashArray host IOPS.
Shown as operation
purefa.host.performance_latency_usec
(gauge)
FlashArray host latency in microseconds.
Shown as microsecond
purefa.host.performance_throughput_iops
(gauge)
FlashArray host throughput in iops.
Shown as operation
purefa.host.space_bytes
(gauge)
FlashArray host space in bytes.
Shown as byte
purefa.host.space_data_reduction_ratio
(gauge)
FlashArray host space data reduction.
purefa.host.space_datareduction_ratio
(gauge)
(Legacy) FlashArray host volumes data reduction ratio.
purefa.host.space_size_bytes
(gauge)
FlashArray host volumes size.
Shown as byte
purefa.hw.component_status
(gauge)
FlashArray hardware component status.
purefa.hw.component_temperature_celsius
(gauge)
FlashArray hardware component temperature in C.
Shown as degree celsius
purefa.hw.component_voltage_volt
(gauge)
FlashArray hardware component voltage.
Shown as volt
purefa.info
(gauge)
FlashArray system information.
purefa.network.interface_performance_bandwidth_bytes
(gauge)
FlashArray network interface bandwidth in bytes per second
Shown as byte
purefa.network.interface_performance_errors
(gauge)
FlashArray network interface errors in errors per second
Shown as error
purefa.network.interface_performance_throughput_pkts
(gauge)
FlashArray network interface throughput in packets per second.
Shown as packet
purefa.pod.mediator_status
(gauge)
(Legacy) FlashArray pod mediatorstatus.
purefa.pod.performance_average_bytes
(gauge)
FlashArray pod average operations size.
Shown as byte
purefa.pod.performance_bandwidth_bytes
(gauge)
FlashArray pod throughput in bytes per second.
Shown as byte
purefa.pod.performance_iops
(gauge)
(Legacy) FlashArray pod IOPS.
Shown as operation
purefa.pod.performance_latency_usec
(gauge)
FlashArray pod latency in microseconds.
Shown as microsecond
purefa.pod.performance_replication_bandwidth_bytes
(gauge)
FlashArray pod replication bandwidth.
Shown as byte
purefa.pod.performance_throughput_iops
(gauge)
FlashArray pod throughput in iops.
Shown as operation
purefa.pod.replica_links_lag_average_sec
(gauge)
FlashArray pod links average lag in seconds.
Shown as second
purefa.pod.replica_links_lag_max_sec
(gauge)
FlashArray pod links max lag in seconds.
Shown as second
purefa.pod.replica_links_performance_bandwidth_bytes
(gauge)
FlashArray pod links bandwidth.
Shown as byte
purefa.pod.space_bytes
(gauge)
FlashArray pod space in bytes.
Shown as byte
purefa.pod.space_data_reduction_ratio
(gauge)
FlashArray pod space data reduction.
purefa.pod.space_datareduction_ratio
(gauge)
(Legacy) FlashArray pod data reduction ratio.
purefa.pod.space_size_bytes
(gauge)
(Legacy) FlashArray pod size.
Shown as byte
purefa.pod.status
(gauge)
(Legacy) FlashArray pod status.
purefa.volume.performance_average_bytes
(gauge)
FlashArray volume average operations size in bytes.
Shown as byte
purefa.volume.performance_bandwidth_bytes
(gauge)
FlashArray volume throughput in bytes per second.
Shown as byte
purefa.volume.performance_iops
(gauge)
(Legacy) FlashArray volume IOPS.
Shown as operation
purefa.volume.performance_latency_usec
(gauge)
FlashArray volume latency in microseconds.
Shown as microsecond
purefa.volume.performance_throughput_bytes
(gauge)
(Legacy) FlashArray volume throughput.
Shown as byte
purefa.volume.performance_throughput_iops
(gauge)
FlashArray volume throughput in iops.
Shown as operation
purefa.volume.space_bytes
(gauge)
FlashArray volume space in bytes.
Shown as byte
purefa.volume.space_data_reduction_ratio
(gauge)
FlashArray volume space data reduction.
purefa.volume.space_datareduction_ratio
(gauge)
(Legacy) FlashArray volumes data reduction ratio.
purefa.volume.space_size_bytes
(gauge)
(Legacy) FlashArray volumes size.
Shown as byte

이벤트

PureFA 통합에는 이벤트가 포함되어 있지 않습니다.

서비스 점검

이 통합에서 제공하는 서비스 점검에 대한 목록은 service_checks.json을 참조하세요.

지원

지원 또는 기능 요청이 필요한 경우, 다음 방법을 통해 Pure Storage에 문의하세요.