@@ -16,40 +16,61 @@ ha_iot_class: "Local Polling"
16
16
17
17
The ` netdata ` sensor platform allows you to display information collected by [ Netdata] ( http://my-netdata.io/ ) .
18
18
19
+ ## {% linkable_title Configuration %}
20
+
21
+
22
+
19
23
To add this platform to your installation, add the following to your ` configuration.yaml ` file:
20
24
21
25
``` yaml
22
26
# Example configuration.yaml entry
23
27
sensor :
24
28
- platform : netdata
29
+ resources :
30
+ system.load :
31
+ element : load15
32
+ system.cpu :
33
+ element : system
25
34
` ` `
26
35
27
- Configuration variables:
28
-
29
- - **host** (*Optional*): The IP address or hostname of your Netdata instance. Defaults to ` localhost`.
30
- - **port** (*Optional*): The port that the Netdata instance is running on. Defaults to `19999`.
31
- - **name** (*Optional*): Name of the sensor. Defaults to "Netdata".
32
- - **resources** (*Optional*) array: List of details to monitor. Defaults is `memory_free`.
33
- - ' memory_free ' : Free memory
34
- - ' memory_used ' : Used memory
35
- - ' memory_cached ' : Cached memory
36
- - ' memory_buffers ' : Buffered memory
37
- - ' swap_free ' : Free swap
38
- - ' swap_used ' : Used swap
39
- - ' processes_running ' : Processes Running
40
- - ' processes_blocked ' : Processes Blocked
41
- - ' system_load ' : System Load 15 min
42
- - ' system_io_in ' : System I/O In
43
- - ' system_io_out ' : System I/O Out
44
- - ' ipv4_in ' : Amount of inbound IPv4 packets per second
45
- - ' ipv4_out ' : Amount of outbound IPv4 packets per second
46
- - ' disk_free ' : Free disk space
47
- - ' cpu_iowait ' : CPU spent spent waiting for IO operations
48
- - ' cpu_user ' : CPU time spent executing user tasks
49
- - ' cpu_system ' : CPU time spent executing system tasks
50
- - ' cpu_softirq ' : CPU time spent servicing soft interrupts
51
- - ' cpu_guest ' : CPU time spent on guest tasks (such as VMs)
52
- - ' uptime ' : Time (in seconds) since last boot
53
- - ' packets_received ' : Amount of packets received
54
- - ' packets_sent ' : Amount of packets sent
55
- - ' connections ' : Total active connections
36
+ {% configuration %}
37
+ host:
38
+ description: The IP address or hostname of your Netdata instance.
39
+ required: false
40
+ type: string
41
+ default: localhost
42
+ port:
43
+ description: The port that the Netdata instance is running on.
44
+ required: false
45
+ type: int
46
+ default: 19999
47
+ name:
48
+ description: Name of the monitored Netdata instance.
49
+ required: false
50
+ type: number
51
+ default: Netdata
52
+ resources:
53
+ description: List of details to monitor.
54
+ required: true
55
+ type: map
56
+ keys:
57
+ data_group:
58
+ description: "Name of the data group to monitor, e.g., ` system.cpu`."
59
+ required : true
60
+ keys :
61
+ element :
62
+ description : The element of the group to monitor.
63
+ required : true
64
+ type : string
65
+ name :
66
+ description : Name to use for the sensor in the frontend.
67
+ required : false
68
+ type : string
69
+ default : element name
70
+ icon :
71
+ description : Icon to use for the sensor.
72
+ required : false
73
+ type : string
74
+ default : " mdi:desktop-classic"
75
+ {% endconfiguration %}
76
+
0 commit comments