1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
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
|
