From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 114F76035A for ; Wed, 2 Dec 2020 10:21:20 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 7BC92191AA for ; Wed, 2 Dec 2020 10:21:19 +0100 (CET) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [212.186.127.180]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id C880F19077 for ; Wed, 2 Dec 2020 10:21:15 +0100 (CET) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 94374447EC for ; Wed, 2 Dec 2020 10:21:15 +0100 (CET) From: Dominik Csapak To: pve-devel@lists.proxmox.com Date: Wed, 2 Dec 2020 10:21:13 +0100 Message-Id: <20201202092113.15911-11-d.csapak@proxmox.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201202092113.15911-1-d.csapak@proxmox.com> References: <20201202092113.15911-1-d.csapak@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.300 Adjusted score from AWL reputation of From: address KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment RCVD_IN_DNSWL_MED -2.3 Sender listed at https://www.dnswl.org/, medium trust SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH docs 1/1] external metrics server: extend docs to explain http api X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Dec 2020 09:21:20 -0000 and mention that 1.8.x has a compatible api (and their differences) Signed-off-by: Dominik Csapak --- pve-external-metric-server.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/pve-external-metric-server.adoc b/pve-external-metric-server.adoc index 783e72c..eace999 100644 --- a/pve-external-metric-server.adoc +++ b/pve-external-metric-server.adoc @@ -56,3 +56,21 @@ Here is an example configuration for influxdb (on your influxdb server): With this configuration, your server listens on all IP addresses on port 8089, and writes the data in the *proxmox* database + +Alternatively, 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. + +To use it, set 'influxdbproto' to 'http' or 'https' (depending on your configuration). +By default, {pve} uses the organization 'proxmox' and the bucket/db 'proxmox' +(They can be set with the configuration 'organization' and 'bucket' respectively). + +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 HTTP Timeout (default is 1s) with the 'timeout' setting, +as well as the maximum batch size (default 25000000 bytes) with the +'max-body-size' setting (this corresponds to the InfluxDB setting with the +same name). -- 2.20.1