summaryrefslogtreecommitdiffstats
path: root/src/go/collectors/go.d.plugin/modules/storcli/metadata.yaml
blob: ecf97fb4420eb2a358dafb9b4fda83dbf3f9ba44 (plain)
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
plugin_name: go.d.plugin
modules:
  - meta:
      id: collector-go.d.plugin-storcli
      plugin_name: go.d.plugin
      module_name: storcli
      monitored_instance:
        name: StoreCLI RAID
        link: "https://docs.broadcom.com/doc/12352476"
        icon_filename: "hard-drive.svg"
        categories:
          - data-collection.storage-mount-points-and-filesystems
      keywords:
        - storage
        - raid-controller
        - manage-disks
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      most_popular: false
    overview:
      data_collection:
        metrics_description: |
          Monitors the health of StoreCLI Hardware RAID by tracking the status of RAID adapters, physical drives, and backup batteries in your storage system.
          It relies on the [`storcli`](https://docs.broadcom.com/doc/12352476) CLI tool but avoids directly executing the binary.
          Instead, it utilizes `ndsudo`, a Netdata helper specifically designed to run privileged commands securely within the Netdata environment.
          This approach eliminates the need to use `sudo`, improving security and potentially simplifying permission management.

          Executed commands:
          -  `storcli /cALL show all J nolog`
          -  `storcli /cALL/eALL/sALL show all J nolog`
        method_description: ""
      supported_platforms:
        include: []
        exclude: []
      multi_instance: false
      additional_permissions:
        description: ""
      default_behavior:
        auto_detection:
          description: ""
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list: []
      configuration:
        file:
          name: go.d/storcli.conf
        options:
          description: |
            The following options can be defined globally: update_every.
          folding:
            title: Config options
            enabled: true
          list:
            - name: update_every
              description: Data collection frequency.
              default_value: 10
              required: false
            - name: timeout
              description: storcli binary execution timeout.
              default_value: 2
              required: false
        examples:
          folding:
            title: Config
            enabled: true
          list:
            - name: Custom update_every
              description: Allows you to override the default data collection interval.
              config: |
                jobs:
                  - name: storcli
                    update_every: 5  # Collect StorCLI RAID statistics every 5 seconds
    troubleshooting:
      problems:
        list: []
    alerts: []
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: controller
          description: These metrics refer to the Controller.
          labels:
            - name: controller_number
              description: Controller number (index)
            - name: model
              description: Controller model
          metrics:
            - name: storcli.controller_status
              description: Controller status
              unit: status
              chart_type: line
              dimensions:
                - name: optimal
                - name: degraded
                - name: partially_degraded
                - name: failed
            - name: storcli.controller_bbu_status
              description: Controller BBU status
              unit: status
              chart_type: line
              dimensions:
                - name: healthy
                - name: unhealthy
                - name: na
        - name: physical drive
          description: These metrics refer to the Physical Drive.
          labels:
            - name: controller_number
              description: Controller number (index)
            - name: enclosure_number
              description: Enclosure number (index)
            - name: slot_number
              description: Slot number (index)
            - name: media type
              description: Media type (e.g. HDD)
          metrics:
            - name: storcli.phys_drive_errors
              description: Physical Drive media errors rate
              unit: errors/s
              chart_type: line
              dimensions:
                - name: media
                - name: other
            - name: storcli.phys_drive_predictive_failures
              description: Physical Drive predictive failures rate
              unit: failures/s
              chart_type: line
              dimensions:
                - name: predictive_failures
            - name: storcli.phys_drive_smart_alert_status
              description: Physical Drive SMART alert status
              unit: status
              chart_type: line
              dimensions:
                - name: active
                - name: inactive
            - name: storcli.phys_drive_temperature
              description: Physical Drive temperature
              unit: status
              chart_type: line
              dimensions:
                - name: temperature