summaryrefslogtreecommitdiffstats
path: root/collectors/xenstat.plugin/metadata.yaml
blob: e5527dbb17fdbac87504141b450c9f9b9d4b4099 (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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
plugin_name: xenstat.plugin
modules:
  - meta:
      plugin_name: xenstat.plugin
      module_name: xenstat.plugin
      monitored_instance:
        name: Xen XCP-ng
        link: "https://xenproject.org/"
        categories:
          - data-collection.containers-and-vms
        icon_filename: "xen.png"
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      keywords: []
      most_popular: false
    overview:
      data_collection:
        metrics_description: "This collector monitors XenServer and XCP-ng host and domains statistics."
        method_description: ""
      supported_platforms:
        include: []
        exclude: []
      multi_instance: true
      additional_permissions:
        description: "The plugin needs setuid."
      default_behavior:
        auto_detection:
          description: "This plugin requires the `xen-dom0-libs-devel` and `yajl-devel` libraries to be installed."
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list:
          - title: Libraries
            description: |
              1. Install `xen-dom0-libs-devel` and `yajl-devel` using the package manager of your system.
              
                Note: On Cent-OS systems you will need `centos-release-xen` repository and the required package for xen is `xen-devel`
              
              2. Re-install Netdata from source. The installer will detect that the required libraries are now available and will also build xenstat.plugin.
      configuration:
        file:
          name: "netdata.conf"
          section_name: "[plugin:xenstat]"
          description: "The netdata main configuration file."
        options:
          description: ""
          folding:
            title: "Config options"
            enabled: true
          list:
            - name: update every
              description: Data collection frequency.
              default_value: 1
              required: false
        examples:
          folding:
            enabled: true
            title: ""
          list: []
    troubleshooting:
      problems:
        list: []
    alerts: []
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: global
          description: "These metrics refer to the entire monitored application."
          labels: []
          metrics:
            - name: xenstat.mem
              description: Memory Usage
              unit: "MiB"
              chart_type: stacked
              dimensions:
                - name: free
                - name: used
            - name: xenstat.domains
              description: Number of Domains
              unit: "domains"
              chart_type: line
              dimensions:
                - name: domains
            - name: xenstat.cpus
              description: Number of CPUs
              unit: "cpus"
              chart_type: line
              dimensions:
                - name: cpus
            - name: xenstat.cpu_freq
              description: CPU Frequency
              unit: "MHz"
              chart_type: line
              dimensions:
                - name: frequency
        - name: xendomain
          description: "Metrics related to Xen domains. Each domain provides its own set of the following metrics."
          labels: []
          metrics:
            - name: xendomain.states
              description: Domain States
              unit: "boolean"
              chart_type: line
              dimensions:
                - name: running
                - name: blocked
                - name: paused
                - name: shutdown
                - name: crashed
                - name: dying
            - name: xendomain.cpu
              description: CPU Usage (100% = 1 core)
              unit: "percentage"
              chart_type: line
              dimensions:
                - name: used
            - name: xendomain.mem
              description: Memory Reservation
              unit: "MiB"
              chart_type: line
              dimensions:
                - name: maximum
                - name: current
            - name: xendomain.vcpu
              description: CPU Usage per VCPU
              unit: "percentage"
              chart_type: line
              dimensions:
                - name: a dimension per vcpu
        - name: xendomain vbd
          description: "Metrics related to Xen domain Virtual Block Device. Each VBD provides its own set of the following metrics."
          labels: []
          metrics:
            - name: xendomain.oo_req_vbd
              description: VBD{%u} Out Of Requests
              unit: "requests/s"
              chart_type: line
              dimensions:
                - name: requests
            - name: xendomain.requests_vbd
              description: VBD{%u} Requests
              unit: "requests/s"
              chart_type: line
              dimensions:
                - name: read
                - name: write
            - name: xendomain.sectors_vbd
              description: VBD{%u} Read/Written Sectors
              unit: "sectors/s"
              chart_type: line
              dimensions:
                - name: read
                - name: write
        - name: xendomain network
          description: "Metrics related to Xen domain network interfaces. Each network interface provides its own set of the following metrics."
          labels: []
          metrics:
            - name: xendomain.bytes_network
              description: Network{%u} Received/Sent Bytes
              unit: "kilobits/s"
              chart_type: line
              dimensions:
                - name: received
                - name: sent
            - name: xendomain.packets_network
              description: Network{%u} Received/Sent Packets
              unit: "packets/s"
              chart_type: line
              dimensions:
                - name: received
                - name: sent
            - name: xendomain.errors_network
              description: Network{%u} Receive/Transmit Errors
              unit: "errors/s"
              chart_type: line
              dimensions:
                - name: received
                - name: sent
            - name: xendomain.drops_network
              description: Network{%u} Receive/Transmit Drops
              unit: "drops/s"
              chart_type: line
              dimensions:
                - name: received
                - name: sent