From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id 62C221FF15C for ; Wed, 7 Aug 2024 14:38:03 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 9F3946B12; Wed, 7 Aug 2024 14:38:12 +0200 (CEST) From: Gabriel Goller To: pbs-devel@lists.proxmox.com Date: Wed, 7 Aug 2024 14:37:36 +0200 Message-Id: <20240807123736.276522-1-g.goller@proxmox.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.049 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment RCVD_IN_VALIDITY_CERTIFIED_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. RCVD_IN_VALIDITY_RPBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. RCVD_IN_VALIDITY_SAFE_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [influxdata.com] Subject: [pbs-devel] [PATCH proxmox-backup v3] docs: add external metrics server page X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox Backup Server development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pbs-devel-bounces@lists.proxmox.com Sender: "pbs-devel" Add External Metrics page to PBS's documentation. Most of it is copied from the PVE documentation, minus the Graphite part. Signed-off-by: Gabriel Goller --- v3, thanks @Lukas: - forgot to save the file :( v2, thanks @Lukas: - some phrasing and rst nits - s/Proxmox Backup/Proxmox Backup Server docs/external_metric_server.rst | 57 +++++++++++++++++++++++++++++++++ docs/sysadmin.rst | 2 ++ 2 files changed, 59 insertions(+) create mode 100644 docs/external_metric_server.rst diff --git a/docs/external_metric_server.rst b/docs/external_metric_server.rst new file mode 100644 index 000000000000..097a8cc3a1c0 --- /dev/null +++ b/docs/external_metric_server.rst @@ -0,0 +1,57 @@ +.. _external_metric_server: + +External Metric Server +---------------------- + +Proxmox Backup Server periodically sends various metrics about your host's memory, +network and disk activity to configured external metric servers. + +Currently supported are: + + * InfluxDB (HTTP) (see https://docs.influxdata.com/influxdb/v2/ ) + * InfluxDB (UDP) (see https://docs.influxdata.com/influxdb/v1/ ) + +The external metric server definitions are saved in +'/etc/proxmox-backup/metricserver.cfg', and can be edited through the web +interface. + +.. note:: + + Using HTTP is recommended as UDP support has been dropped in InfluxDB v2. + +InfluxDB (HTTP) plugin configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The plugin can be configured to use the HTTP(s) API of InfluxDB 2.x. +InfluxDB 1.8.x does contain a forwards compatible API endpoint for this v2 API. + +Since InfluxDB's v2 API is only available with authentication, you have +to generate a token that can write into the correct bucket and set it. + +In the v2 compatible API of 1.8.x, you can use 'user:password' as token +(if required), and can omit the 'organization' since that has no meaning in InfluxDB 1.x. + +You can also set the maximum batch size (default 25000000 bytes) with the +'max-body-size' setting (this corresponds to the InfluxDB setting with the +same name). + +InfluxDB (UDP) plugin configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Proxmox Backup Server can also send data via UDP. This requires the InfluxDB +server to be configured correctly. The MTU can also be configured here if +necessary. + +Here is an example configuration for InfluxDB (on your InfluxDB server): + +---- +[[udp]] + enabled = true + bind-address = "0.0.0.0:8089" + database = "proxmox" + batch-size = 1000 + batch-timeout = "1s" +---- + +With this configuration, the InfluxDB server listens on all IP addresses on +port 8089, and writes the data in the *proxmox* database. diff --git a/docs/sysadmin.rst b/docs/sysadmin.rst index 114ad4cbbe0e..d42b6a9b2af1 100644 --- a/docs/sysadmin.rst +++ b/docs/sysadmin.rst @@ -30,6 +30,8 @@ please refer to the standard Debian documentation. .. include:: certificate-management.rst +.. include:: external_metric_server.rst + .. include:: services.rst .. include:: command-line-tools.rst -- 2.39.2 _______________________________________________ pbs-devel mailing list pbs-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel