aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorIvan Kiselev <homelessnessbo@users.noreply.github.com>2018-07-02 12:39:32 +0200
committerBen Kochie <superq@gmail.com>2018-07-02 12:39:32 +0200
commitae90bac5b89fa3b65a4dd24131dbd41842c11083 (patch)
treeb77a81f6bfcdc537acc1e4f746559ab0185317e9 /docs
parent107e5dfecc8c5bf6fd133aa757967e47094117ae (diff)
downloadprometheus_node_collector-ae90bac5b89fa3b65a4dd24131dbd41842c11083.tar.bz2
prometheus_node_collector-ae90bac5b89fa3b65a4dd24131dbd41842c11083.tar.xz
prometheus_node_collector-ae90bac5b89fa3b65a4dd24131dbd41842c11083.zip
Add example of translating new metrics to old format in case of migration to 1.16 version (#982)
Add additional example of how to save old metrics Signed-off-by: Ivan Kiselev <ivan@messagebird.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/V0_16_UPGRADE_GUIDE.md5
-rw-r--r--docs/example-16-compatibility-rules-new-to-old.yml190
2 files changed, 193 insertions, 2 deletions
diff --git a/docs/V0_16_UPGRADE_GUIDE.md b/docs/V0_16_UPGRADE_GUIDE.md
index d987683..0a8bf24 100644
--- a/docs/V0_16_UPGRADE_GUIDE.md
+++ b/docs/V0_16_UPGRADE_GUIDE.md
@@ -10,11 +10,12 @@ Grafana users can add multiple queries in order to display both the old and new
10 10
11## Use recording rules 11## Use recording rules
12 12
13We have provides a [sample recording rule set] to create duplicate metrics. This has a minor disadvantage that it creates a lot of extra data, and re-aligns the timestamps of the data. 13We have provided a [sample recording rule set that translates old metrics to new ones] and the [one that translates new metrics format to old one] to create duplicate metrics (it translates "old" metrics format to new one). This has a minor disadvantage that it creates a lot of extra data, and re-aligns the timestamps of the data.
14 14
15## Run both old and new versions simultaneously. 15## Run both old and new versions simultaneously.
16 16
17It's possible to run both the old and new exporter on different ports, and include an additional scrape job in Prometheus. It's recommended to enable only the collectors that have name changes that you care about. 17It's possible to run both the old and new exporter on different ports, and include an additional scrape job in Prometheus. It's recommended to enable only the collectors that have name changes that you care about.
18 18
19[naming best practices]: https://prometheus.io/docs/practices/naming/ 19[naming best practices]: https://prometheus.io/docs/practices/naming/
20[sample recording rule set]: example-16-compatibility-rules.yml 20[sample recording rule set that translates old metrics to new ones]: example-16-compatibility-rules.yml
21[one that translates new metrics format to old one]: example-16-compatibility-rules-new-to-old.yml
diff --git a/docs/example-16-compatibility-rules-new-to-old.yml b/docs/example-16-compatibility-rules-new-to-old.yml
new file mode 100644
index 0000000..a6bd60d
--- /dev/null
+++ b/docs/example-16-compatibility-rules-new-to-old.yml
@@ -0,0 +1,190 @@
1- name: node_exporter-16-bcache
2 rules:
3 - expr: node_bcache_cache_read_races
4 record: node_bcache_cache_read_races_total
5- name: node_exporter-16-buddyinfo
6 rules:
7 - expr: node_buddyinfo_blocks
8 record: node_buddyinfo_count
9- name: node_exporter-16-stat
10 rules:
11 - expr: node_boot_time_seconds
12 record: node_boot_time
13 - expr: node_context_switches_total
14 record: node_context_switches
15 - expr: node_forks_total
16 record: node_forks
17 - expr: node_intr_total
18 record: node_intr
19- name: node_exporter-16-cpu
20 rules:
21 - expr: label_replace(node_cpu_seconds_total, "cpu", "$1", "cpu", "cpu(.+)")
22 record: node_cpu
23- name: node_exporter-16-diskstats
24 rules:
25 - expr: node_disk_read_bytes_total
26 record: node_disk_bytes_read
27 - expr: node_disk_written_bytes_total
28 record: node_disk_bytes_written
29 - expr: node_disk_io_time_seconds_total
30 record: node_disk_io_time_ms
31 - expr: node_disk_io_time_weighted_seconds_total
32 record: node_disk_io_time_weighted
33 - expr: node_disk_reads_completed_total
34 record: node_disk_reads_completed
35 - expr: node_disk_reads_merged_total
36 record: node_disk_reads_merged
37 - expr: node_disk_read_time_seconds_total
38 record: node_disk_read_time_ms
39 - expr: node_disk_writes_completed_total
40 record: node_disk_writes_completed
41 - expr: node_disk_writes_merged_total
42 record: node_disk_writes_merged
43 - expr: node_disk_write_time_seconds_total
44 record: node_disk_write_time_ms
45- name: node_exporter-16-filesystem
46 rules:
47 - expr: node_filesystem_free_bytes
48 record: node_filesystem_free
49 - expr: node_filesystem_avail_bytes
50 record: node_filesystem_avail
51 - expr: node_filesystem_size_bytes
52 record: node_filesystem_size
53- name: node_exporter-16-infiniband
54 rules:
55 - expr: node_infiniband_port_data_received_bytes_total
56 record: node_infiniband_port_data_received_bytes
57 - expr: node_infiniband_port_data_transmitted_bytes_total
58 record: node_infiniband_port_data_transmitted_bytes
59- name: node_exporter-16-interrupts
60 rules:
61 - expr: node_interrupts_total
62 record: node_interrupts
63- name: node_exporter-16-memory
64 rules:
65 - expr: node_memory_Active_bytes
66 record: node_memory_Active
67 - expr: node_memory_Active_anon_bytes
68 record: node_memory_Active_anon
69 - expr: node_memory_Active_file_bytes
70 record: node_memory_Active_file
71 - expr: node_memory_AnonHugePages_bytes
72 record: node_memory_AnonHugePages
73 - expr: node_memory_AnonPages_bytes
74 record: node_memory_AnonPages
75 - expr: node_memory_Bounce_bytes
76 record: node_memory_Bounce
77 - expr: node_memory_Buffers_bytes
78 record: node_memory_Buffers
79 - expr: node_memory_Cached_bytes
80 record: node_memory_Cached
81 - expr: node_memory_CommitLimit_bytes
82 record: node_memory_CommitLimit
83 - expr: node_memory_Committed_AS_bytes
84 record: node_memory_Committed_AS
85 - expr: node_memory_DirectMap2M_bytes
86 record: node_memory_DirectMap2M
87 - expr: node_memory_DirectMap4k_bytes
88 record: node_memory_DirectMap4k
89 - expr: node_memory_Dirty_bytes
90 record: node_memory_Dirty
91 - expr: node_memory_HardwareCorrupted_bytes
92 record: node_memory_HardwareCorrupted
93 - expr: node_memory_Hugepagesize_bytes
94 record: node_memory_Hugepagesize
95 - expr: node_memory_Inactive_bytes
96 record: node_memory_Inactive
97 - expr: node_memory_Inactive_anon_bytes
98 record: node_memory_Inactive_anon
99 - expr: node_memory_Inactive_file_bytes
100 record: node_memory_Inactive_file
101 - expr: node_memory_KernelStack_bytes
102 record: node_memory_KernelStack
103 - expr: node_memory_Mapped_bytes
104 record: node_memory_Mapped
105 - expr: node_memory_MemAvailable_bytes
106 record: node_memory_MemAvailable
107 - expr: node_memory_MemFree_bytes
108 record: node_memory_MemFree
109 - expr: node_memory_MemTotal_bytes
110 record: node_memory_MemTotal
111 - expr: node_memory_Mlocked_bytes
112 record: node_memory_Mlocked
113 - expr: node_memory_NFS_Unstable_bytes
114 record: node_memory_NFS_Unstable
115 - expr: node_memory_PageTables_bytes
116 record: node_memory_PageTables
117 - expr: node_memory_Shmem_bytes
118 record: node_memory_Shmem
119 - expr: node_memory_Slab_bytes
120 record: node_memory_Slab
121 - expr: node_memory_SReclaimable_bytes
122 record: node_memory_SReclaimable
123 - expr: node_memory_SUnreclaim_bytes
124 record: node_memory_SUnreclaim
125 - expr: node_memory_SwapCached_bytes
126 record: node_memory_SwapCached
127 - expr: node_memory_SwapFree_bytes
128 record: node_memory_SwapFree
129 - expr: node_memory_SwapTotal_bytes
130 record: node_memory_SwapTotal
131 - expr: node_memory_Unevictable_bytes
132 record: node_memory_Unevictable
133 - expr: node_memory_VmallocChunk_bytes
134 record: node_memory_VmallocChunk
135 - expr: node_memory_VmallocTotal_bytes
136 record: node_memory_VmallocTotal
137 - expr: node_memory_VmallocUsed_bytes
138 record: node_memory_VmallocUsed
139 - expr: node_memory_Writeback_bytes
140 record: node_memory_Writeback
141 - expr: node_memory_WritebackTmp_bytes
142 record: node_memory_WritebackTmp
143- name: node_exporter-16-network
144 rules:
145 - expr: node_network_receive_bytes_total
146 record: node_network_receive_bytes
147 - expr: node_network_receive_compressed_total
148 record: node_network_receive_compressed
149 - expr: node_network_receive_drop_total
150 record: node_network_receive_drop
151 - expr: node_network_receive_errs_total
152 record: node_network_receive_errs
153 - expr: node_network_receive_fifo_total
154 record: node_network_receive_fifo
155 - expr: node_network_receive_frame_total
156 record: node_network_receive_frame
157 - expr: node_network_receive_multicast_total
158 record: node_network_receive_multicast
159 - expr: node_network_receive_packets_total
160 record: node_network_receive_packets
161 - expr: node_network_transmit_bytes_total
162 record: node_network_transmit_bytes
163 - expr: node_network_transmit_compressed_total
164 record: node_network_transmit_compressed
165 - expr: node_network_transmit_drop_total
166 record: node_network_transmit_drop
167 - expr: node_network_transmit_errs_total
168 record: node_network_transmit_errs
169 - expr: node_network_transmit_fifo_total
170 record: node_network_transmit_fifo
171 - expr: node_network_transmit_frame_total
172 record: node_network_transmit_frame
173 - expr: node_network_transmit_multicast_total
174 record: node_network_transmit_multicast
175 - expr: node_network_transmit_packets_total
176 record: node_network_transmit_packets
177- name: node_exporter-16-nfs
178 rules:
179 - expr: node_nfs_connections_total
180 record: node_nfs_net_connections
181 - expr: node_nfs_packets_total
182 record: node_nfs_net_reads
183 - expr: label_replace(label_replace(node_nfs_requests_total, "proto", "$1", "version", "(.+)"), "method", "$1", "procedure", "(.+)")
184 record: node_nfs_procedures
185 - expr: node_nfs_rpc_authentication_refreshes_total
186 record: node_nfs_rpc_authentication_refreshes
187 - expr: node_nfs_rpcs_total
188 record: node_nfs_rpc_operations
189 - expr: node_nfs_rpc_retransmissions_total
190 record: node_nfs_rpc_retransmissions
© 2015 Mike Crute