Pure Storage FlashArray

Supported OS Windows Mac OS

통합 버전1.2.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

개요

이 점검 는 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.hw.controller_info
(gauge)
FlashArray controller info
purefa.hw.controller_mode_since_timestamp_seconds
(gauge)
FlashArray hardware controller uptime in seconds
Shown as second
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.network.interface_speed_bandwidth_bytes
(gauge)
FlashArray network interface speed in bytes per second
Shown as byte
purefa.network.port_info
(gauge)
FlashArray network port info
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_msec
(gauge)
FlashArray pod links average lag in milliseconds.
Shown as second
purefa.pod.replica_links_lag_average_sec
(gauge)
FlashArray pod links average lag in milliseconds.
Shown as second
purefa.pod.replica_links_lag_max_msec
(gauge)
FlashArray pod links max lag in milliseconds.
Shown as second
purefa.pod.replica_links_lag_max_sec
(gauge)
FlashArray pod links max lag in milliseconds.
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에 문의하세요.