plugin_name: python.d.plugin
modules:
  - meta:
      plugin_name: python.d.plugin
      module_name: adaptec_raid
      monitored_instance:
        name: AdaptecRAID
        link: "https://www.microchip.com/en-us/products/storage"
        categories:
          - data-collection.storage-mount-points-and-filesystems
        icon_filename: "adaptec.svg"
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      keywords:
        - storage
        - raid-controller
        - manage-disks
      most_popular: false
    overview:
      data_collection:
        metrics_description: |
          This collector monitors Adaptec RAID hardware storage controller metrics about both physical and logical drives.
        method_description: |
          It uses the arcconf command line utility (from adaptec) to monitor your raid controller.
          
          Executed commands:
            - `sudo -n arcconf GETCONFIG 1 LD`
            - `sudo -n arcconf GETCONFIG 1 PD`
      supported_platforms:
        include: []
        exclude: []
      multi_instance: false
      additional_permissions:
        description: "The module uses arcconf, which can only be executed by root. It uses sudo and assumes that it is configured such that the netdata user can execute arcconf as root without a password."
      default_behavior:
        auto_detection:
          description: "After all the permissions are satisfied, netdata should be to execute commands via the arcconf command line utility"
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list:
          - title: Grant permissions for netdata, to run arcconf as sudoer
            description: |
              The module uses arcconf, which can only be executed by root. It uses sudo and assumes that it is configured such that the netdata user can execute arcconf as root without a password.
              
              Add to your /etc/sudoers file:
              which arcconf shows the full path to the binary.
              
              ```bash
              netdata ALL=(root)       NOPASSWD: /path/to/arcconf
              ```
          - title: Reset Netdata's systemd unit CapabilityBoundingSet (Linux distributions with systemd)
            description: |
              The default CapabilityBoundingSet doesn't allow using sudo, and is quite strict in general. Resetting is not optimal, but a next-best solution given the inability to execute arcconf using sudo.
              
              As root user, do the following:
              
              ```bash
              mkdir /etc/systemd/system/netdata.service.d
              echo -e '[Service]\nCapabilityBoundingSet=~' | tee /etc/systemd/system/netdata.service.d/unset-capability-bounding-set.conf
              systemctl daemon-reload
              systemctl restart netdata.service
              ```
      configuration:
        file:
          name: "python.d/adaptec_raid.conf"
        options:
          description: |
            There are 2 sections:
            
            * Global variables
            * One or more JOBS that can define multiple different instances to monitor.
            
            The following options can be defined globally: priority, penalty, autodetection_retry, update_every, but can also be defined per JOB to override the global values.
            
            Additionally, the following collapsed table contains all the options that can be configured inside a JOB definition.
            
            Every configuration JOB starts with a `job_name` value which will appear in the dashboard, unless a `name` parameter is specified.
          folding:
            title: "Config options"
            enabled: true
          list:
            - name: update_every
              description: Sets the default data collection frequency.
              default_value: 5
              required: false
            - name: priority
              description: Controls the order of charts at the netdata dashboard.
              default_value: 60000
              required: false
            - name: autodetection_retry
              description: Sets the job re-check interval in seconds.
              default_value: 0
              required: false
            - name: penalty
              description: Indicates whether to apply penalty to update_every in case of failures.
              default_value: yes
              required: false
        examples:
          folding:
            enabled: true
            title: "Config"
          list:
            - name: Basic
              folding:
                enabled: false
              description: A basic example configuration per job
              config: |
                job_name:
                    name: my_job_name           
                    update_every: 1         # the JOB's data collection frequency
                    priority: 60000         # the JOB's order on the dashboard
                    penalty: yes            # the JOB's penalty
                    autodetection_retry: 0  # the JOB's re-check interval in seconds
    troubleshooting:
      problems:
        list: []
    alerts:
      - name: adaptec_raid_ld_status
        link: https://github.com/netdata/netdata/blob/master/health/health.d/adaptec_raid.conf
        metric: adaptec_raid.ld_status
        info: logical device status is failed or degraded
      - name: adaptec_raid_pd_state
        link: https://github.com/netdata/netdata/blob/master/health/health.d/adaptec_raid.conf
        metric: adaptec_raid.pd_state
        info: physical device state is not online
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: global
          description: "These metrics refer to the entire monitored application."
          labels: []
          metrics:
            - name: adaptec_raid.ld_status
              description: "Status of logical devices (1: Failed or Degraded)"
              unit: "bool"
              chart_type: line
              dimensions:
                - name: a dimension per logical device
            - name: adaptec_raid.pd_state
              description: "State of physical devices (1: not Online)"
              unit: "bool"
              chart_type: line
              dimensions:
                - name: a dimension per physical device
            - name: adaptec_raid.smart_warnings
              description: S.M.A.R.T warnings
              unit: "count"
              chart_type: line
              dimensions:
                - name: a dimension per physical device
            - name: adaptec_raid.temperature
              description: Temperature
              unit: "celsius"
              chart_type: line
              dimensions:
                - name: a dimension per physical device