{"repo":"mahlonsmith/netdata-timescale-relay","free":true,"listed":false,"github":"https://github.com/mahlonsmith/netdata-timescale-relay","clone":"git clone https://github.com/mahlonsmith/netdata-timescale-relay.git","description":"A Netdata json formatter for storing metrics in Timescale.","language":"Nim","stars":16,"topics":["nim","netdata","timescale","postgresql","json","monitoring"],"license":null,"category":"analytics","readme_excerpt":"Netdata-TSRelay =============== What's this? ------------ This program is designed to accept JSON streams from Netdata clients, and write metrics to a PostgreSQL table - specifically, Timescale backed tables (though that's not technically a requirement.) Installation ------------ You'll need a working Nim build environment and PostgreSQL development headers to compile the binary. Simply run make to build it. Put it wherever you please. Configuration ------------- There are a few assumptions that should be satisfied before running this successfully. Database setup You'll need to create the destination table. Index it based on how you intend to query the data, including JSON functional indexing, etc. See PostgreSQL documentation for details. Strongly encouraged: Promote this table to a Timescale \"hypertable\". See Timescale docs for that, but a quick example to partition automatically at weekly boundaries would look something like this, if you're running v0.9.0 or better: Timescale also has some great examples and advice for efficient JSON indexing and queries. Netdata You'll likely want to pare down what netdata is sending. Here's an example configuration for exporting.conf -- season this to taste (what charts to send and frequency.) Note: This example uses the \"exporting\" module introduced in Netdata v1.23. If your netdata is older than that, you'll be using the deprecated \"backend\" instead in the main netdata.conf file. Running the Relay ----------------- Options [-q --quiet]","default_branch":null,"files":null,"tree":[],"storefront":"/r/mahlonsmith","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/mahlonsmith/netdata-timescale-relay/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}